Commande IMPORT PRINT

Crée une table Analytics en définissant et en important un fichier image d'impression (rapport).

Syntaxe

IMPORT PRINT TO table nom_fichier_importation FROM nom_fichier_source <SERVER nom_profil> valeur_jeu_caractères <numéro_page_code> {[syntaxe_enregistrement] [syntaxe_champ] <...n>} <...n>
syntaxe_enregistrement ::=
RECORD nom_enregistrement type_enregistrement lignes_dans_enregistrement transparent [syntaxe_test] <...n>
syntaxe_test ::=
TEST inclure_exclure type_correspondance AT ligne_départ,position_départ,plage logique texte
syntaxe_champ ::=
FIELD nom type AT ligne_départ,position_départ SIZE longueur,lignes_dans_champ DEC valeur WID octets PIC format AS nom_affichage

Paramètres

Paramètres généraux

Nom Description
TO table

Nom de la table Analytics dans laquelle les données doivent être importées.

Remarque

La longueur des noms des tables est limitée à 64 caractères alphanumériques. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre.

nom_fichier_importation

Nom du fichier de données Analytics à créer.

Indiquez nom_fichier_importation sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple, "Factures.FIL".

Par défaut, le fichier de données (.FIL) est enregistré dans le dossier contenant le projet Analytics.

Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier de données dans un autre dossier existant :

  • "C:\données\Factures.FIL"
  • "données\Factures.FIL"

FROM nom_fichier_source

Nom du fichier de données source. nom_fichier_source doit être une chaîne entre guillemets.

Si le fichier de données source n'est pas enregistré dans le même répertoire que le projet Analytics, vous devez utiliser un chemin d'accès absolu ou un chemin d'accès relatif pour indiquer l'emplacement du fichier :

  • "C:\données\nom_fichier_source"
  • "donnéesnom_fichier_source"
SERVER nom_profil

optionnel

 Nom de profil du serveur contenant les données à importer.
valeur_jeu_caractères

L'ensemble de caractères utilisé pour coder le fichier image d'impression (rapport). Les valeurs suivantes sont prises en charge :

  • 0 : ASCII
  • 1 : EBCDIC
  • 2 : Unicode
  • 3 : Texte codé
numéro_page_code

optionnel

Si vous avez indiqué 3 (texte codé) pour valeur_jeu_caractères, saisissez également un numéro de page codé.

Paramètre RECORD

Informations de définition générales des enregistrements.

Remarque

Certaines informations de définition d'enregistrement sont indiquées à l'aide de codes numériques mappant vers les options dans l'Assistant de définition de données.

Dans les scripts, indiquez le code numérique et non le nom de l'option.

Nom Description

RECORD nom_enregistrement

Nom de l'enregistrement dans l'Assistant de définition de données.

Il est obligatoire d'indiquer nom_enregistrement dans la commande IMPORT PRINT, mais la valeur nom_enregistrement n'apparaît pas dans la table Analytics créée.

Dans l'Assistant de définition de données, Analytics fournit les noms par défaut basés sur le type d'enregistrement :

  • Détail
  • En-têten
  • Pied de pagen

Vous pouvez utiliser les noms par défaut ou indiquez des noms différents.

type_enregistrement

Les trois types d'enregistrement possibles lors de la définition d'un fichier Image d'impression :

  • 0 : détail
  • 1 : en-tête
  • 2 : pied de page

Remarque

Vous pouvez définir plusieurs jeux d'enregistrements d'en-tête et de pied de page dans une seule exécution d'IMPORT PRINT, mais vous pouvez définir un seul jeu d'enregistrements de détail uniquement.

lignes_dans_enregistrement

Nombre de lignes occupées par un enregistrement dans le fichier Image d'impression.

Vous pouvez définir des enregistrements sur une seule ligne ou sur plusieurs lignes à associer aux données dans le fichier.

transparent

Paramètre de transparence pour un enregistrement d'en-tête.

Remarque

S'applique aux enregistrements d'en-tête uniquement.

  • 0 : pas transparent
  • 1 : transparent

Les enregistrements d'en-tête transparents ne ventilent pas les enregistrements de détail multilignes.

Si un enregistrement d'en-tête ventile un enregistrement de détail multiligne dans le fichier source Image d'impression, ce qui peut se produire à l'endroit d'un saut de page, indiquer 1 (transparent) unifie l'enregistrement de détail dans la table Analytics créée.

Paramètre TEST

Critères de définition d'un jeu d'enregistrements dans le fichier Image d'impression. Vous pouvez avoir une ou plusieurs occurrences de TEST (8 max.) pour chaque occurrence de RECORD.

Remarque

Certains critères sont indiqués à l'aide des codes numériques mappant vers les options dans l'Assistant de définition de données (les noms des options sont indiqués entre parenthèses ci-dessous).

Dans les scripts, indiquez le code numérique et non le nom de l'option.

Nom Description
TEST inclure_exclure

Comment traiter la correspondance des données :

  • 0 : (Inclure) les données remplissant les critères sont incluses dans le jeu d'enregistrements
  • 1 : (Exclure) les données remplissant les critères sont exclues du jeu d'enregistrements
type_correspondance

Type de correspondance à effectuer :

  • 0 : (Corresp. exacte) : les enregistrements correspondants doivent contenir le caractère ou la chaîne de caractères à la ligne de départ spécifiée, à partir de la position spécifiée
  • 2 : (Alpha) les enregistrements correspondants doivent contenir un ou plusieurs caractères alphabétiques à la ligne de départ spécifiée, à la position de départ spécifiée ou à toutes les positions de la plage spécifiée
  • 3 : (Numérique) les enregistrements correspondants doivent contenir un ou plusieurs caractères numériques à la Ligne spécifiée, à la position de départ spécifiée ou à toutes les positions de la plage spécifiée
  • 4 : (Vide) les enregistrements correspondants doivent contenir un ou plusieurs espaces vides à la ligne de départ spécifiée, à la position de départ spécifiée ou à toutes les positions de la plage spécifiée
  • 5 : (Non vide) les enregistrements correspondants doivent contenir un ou plusieurs caractères non vides (y compris les caractères spéciaux) à la ligne de départ spécifiée, à la position de départ spécifiée ou à toutes les positions de la plage spécifiée
  • 7 : (Rechercher dans la ligne) les enregistrements correspondants doivent contenir le caractère ou la chaîne de caractères n'importe où sur la Ligne de départ spécifiée
  • 8 : (Rechercher dans la plage) les enregistrements correspondants doivent contenir le caractère ou la chaîne de caractères spécifié, à la ligne de départ spécifiée, n'importe où dans la plage spécifiée
  • 10 : (Modèle de texte) les enregistrements correspondants doivent contenir les caractères correspondant au schéma de caractères spécifié, à la ligne de départ spécifiée, à partir de la position spécifiée
AT ligne_départ; position_départ; plage
  • ligne_départ ligne d'un enregistrement auquel les critères s'appliquent

    Par exemple, si vous créez un modèle de texte qui fait correspondre les codes postaux et que ceux-ci apparaissent à la troisième ligne d'un enregistrement d'adresse de trois lignes, vous devez spécifier 3 dans ligne_départ.

    Remarque

    Pour les enregistrements d'une seule ligne, la valeur ligne_départ est toujours 1.

  • position_départ position d'octet de départ dans le fichier Image d'impression pour la comparaison vis-à-vis des critères
  • plage nombre d'octets à partir de la position d'octet de départ dans le fichier Image d'impression à utiliser dans la comparaison vis-à-vis des critères

    Si vous utilisez une position d'octet de départ uniquement, sans plage, indiquez 0 pour plage.

    Remarque

    Analytics non Unicode1 octet = 1 caractère
    Analytics Unicode, données ASCII étendu (ANSI)1 octet = 1 caractère
    Analytics Unicode, données Unicode2 octets = 1 caractère

    Pour les données Unicode, plage doit être un nombre d'octets pair. Par exemple, 50,59 (10 octets). Spécifier un nombre d'octets impair peut empêcher la bonne correspondance vis-à-vis des critères.
logique

Relations logiques entre les critères :

  • 0 : (Et) le critère actuel et le critère suivant sont associés avec un AND logique
  • 1 : (Ou) le critère actuel et le critère suivant sont associés avec un OR logique
  • 4 : (Nouveau groupe > Et) le critère actuel est le dernier d'un groupe de critères logiques et le groupe actuel et le groupe suivant sont liés avec un AND logique
  • 5 : (Nouveau groupe > Ou) le critère actuel est le dernier d'un groupe de critères logiques et le groupe actuel et le groupe suivant sont liés avec un OR logique
  • 7 : (Fin) le critère actuel est le dernier d'un groupe de critères logiques
texte

Caractères littéraux ou génériques par rapport auxquels les associer :

  • Pour Corresp. exacte, Rechercher dans la ligne ou Rechercher dans la plage indique le caractère ou la chaîne de caractères qui identifie de manière unique le jeu d'enregistrements dans le fichier image d'impression
  • Pour Modèle de texte indique le schéma de caractères qui identifie de manière unique le jeu d'enregistrements dans le fichier image d'impression

    L'option Modèle de texte utilise la même syntaxe que la Fonction MAP( ).

Pour les autres correspondances, texte est une chaîne de caractères vide "".

Paramètres FIELD

Informations de définition de champ.

Nom Description
FIELD nom type

Les champs individuels à importer à partir du fichier de données source, y compris le nom et le type de données du champ. Pour empêcher l'importation d'un champ, ne l'indiquez pas.

Pour plus d'informations sur le type, consultez la rubrique Identificateurs des types de données de champ.
AT ligne_départ; position_départ
  • ligne_départ ligne de départ du champ dans l'enregistrement dans le fichier Image d'impression

    Pour les enregistrements multilignes dans un fichier PDF, ligne_départ vous permet de commencer un champ à n'importe quelle ligne de l'enregistrement. ligne_départ est toujours 1 si lignes_dans_enregistrement est 1.

  • position_départ position d'octet de départ du champ dans le fichier Image d'impression

    Remarque

    Analytics non Unicode1 octet = 1 caractère
    Analytics Unicode, données ASCII étendu (ANSI)1 octet = 1 caractère
    Analytics Unicode, données Unicode2 octets = 1 caractère
SIZE longueur, lignes_dans_champ
  • longueur longueur du champ en octets dans le format de la table Analytics

    Remarque

    Analytics non Unicode1 octet = 1 caractère
    Analytics Unicode, données ASCII étendu (ANSI)1 octet = 1 caractère
    Analytics Unicode, données Unicode2 octets = 1 caractère

    Pour les données Unicode, spécifiez uniquement un nombre d'octets pair. Indiquer un nombre d'octets impair peut entraîner l'affichage incorrect des caractères.

  • lignes_dans_champ nombre de lignes occupées par une seule valeur de champ dans le fichier Image d'impression

    Vous pouvez définir des champs unilignes ou multilignes pour associer les données du fichier.

    Remarque

    Le nombre de lignes spécifié pour un champ ne peut pas dépasser le nombre de lignes spécifié pour l'enregistrement contenant le champ.
DEC valeur

Nombre de décimales contenues par les champs numériques
WID octets

Largeur d'affichage du champ en nombre d'octets.

La valeur indiquée contrôle la largeur d'affichage du champ dans les vues et rapports Analytics. La largeur d'affichage n'altère jamais les données ; elle peut toutefois masquer des données si elle est plus courte que la longueur du champ.
PIC format

Remarque

S'applique aux champs numériques ou DateHeure.

  • champs numériques format d'affichage des valeurs numériques dans les vues et rapports Analytics
  • champs DateHeure format physique des valeurs DateHeure dans les données source (ordre des caractères date et heure, séparateurs, etc.)

    Remarque

    Pour les champs DateHeure, le format doit correspondre exactement au format physique dans les données source. Par exemple, si les données source sont 12/31/2014, vous devez saisir la date au format "MM/JJ/AAAA".

Le format doit être placé entre guillemets.
AS nom_affichage

Le nom d'affichage (titre de la colonne) pour le champ dans la vue dans la nouvelle table Analytics.

Indiquez le nom_affichage sous forme de chaîne entre guillemets. Utilisez un point-virgule (;) entre les mots si vous souhaitez insérer un saut de ligne dans le titre de la colonne.

AS est requis lors de la définition de FIELD. Pour que le nom d'affichage soit identique au champ nom, saisissez une valeur nom_affichage vide à l'aide de la syntaxe suivante : AS "". Vérifiez qu'il n'y a aucune espace entre les deux guillemets doubles.

Exemples

Importation de données à partir d'un fichier image d'impression (fichier de rapport)

Vous importez des données à partir du fichier Image d'impression (Rapport), Report.txt.

Un enregistrement d'en-tête et un jeu d'enregistrements de détail, avec cinq champs, est créé dans la table Analytics créée, Rapport_stocks :

IMPORT PRINT TO Rapport_stocks "Rapport_stocks.FIL" FROM "Rapport.txt" 0 RECORD "Entête1" 1 1 0 TEST 0 0 AT 1,17,0 7 ":" FIELD "Champ_1" C AT 1,19 SIZE 2,1 DEC 0 WID 2 PIC "" AS "Classe prod" FIELD "Champ_2" C AT 1,24 SIZE 31,1 DEC 0 WID 31 PIC "" AS "Description prod" RECORD "Détail" 0 1 0 TEST 0 0 AT 1,59,59 7 "." FIELD "Champ_3" X AT 1,6 SIZE 9,1 DEC 0 WID 9 PIC "" AS "ID élément" FIELD "Champ_4" C AT 1,16 SIZE 24,1 DEC 0 WID 24 PIC "" AS "Desc. élément" FIELD "Champ_5" N AT 1,40 SIZE 10,1 DEC 0 WID 10 PIC "" AS "Disponible" FIELD "Champ_6" N AT 1,50 SIZE 12,1 DEC 2 WID 12 PIC "" AS "Coût" FIELD "Champ_7" N AT 1,62 SIZE 12,1 DEC 2 WID 12 PIC "" AS "Total"

Remarques

Remarque

Pour plus d'informations sur le fonctionnement de cette commande, consultez le Aide d'Analytics.

Identificateurs des types de données de champ

Le tableau ci-dessous répertorie les lettres que vous devez utiliser lorsque vous indiquez type pour FIELD. Chaque lettre correspond à un type de données Analytics.

Par exemple, si vous définissez un champ Nom, qui requiert un type de données caractère, vous devez indiquer « C » : FIELD "Nom" C.

Pour obtenir plus d'informations, consultez la section Types de données Analytics.

Remarque

Lorsque vous utilisez l'Assistant de définition de données pour définir une table qui comprend des champs EBCDIC, Unicode ou ASCII, ces derniers se voient automatiquement attribuer la lettre « C » (pour le type CHARACTER).

Lorsque vous saisissez manuellement une instruction IMPORT ou que vous modifiez une instruction IMPORT existante, vous pouvez remplacer les lettres « E » ou « U » par des champs EBCDIC ou Unicode.

Lettre

Type de données Analytics

A

ACL

B

BINARY

C

CHARACTER

D

DATETIME

E

EBCDIC

F

FLOAT

G

ACCPAC

I

IBMFLOAT

K

UNSIGNED

L

LOGICAL

N

PRINT

P

PACKED

Q

BASIC

R

MICRO

S

CUSTOM

T

PCASCII

U

UNICODE

V

VAXFLOAT

X

NUMERIC

Y

UNISYS

Z

ZONED

[ Retour au début ]

Guide de création de scripts ACL 14.1