Composer/Imprimer un doc. Word (LNCPRTDOC)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

La commande LNCPRTDOC permet de fusionner un modèle de document WORD, avec des données provenant de l'As400.

Top

Parameters

Keyword Description Choices Notes
DOC Nom du modèle de Document Character value, *CURRENT, *NEW Optional, Positional 1
FLR Dossier/répertoire du modèle Character value, *DFT, *NONE Optional, Positional 2
ROOT Racine du répertoire Character value, *DFT, *NONE Optional, Positional 3
MRGTYPE Type source de données fusion *NONE, *QRY, *FILE, *SQL, *DOC Optional, Positional 4
QRYDFN Fichier définition d'analyse Qualified object name Optional, Positional 5
Qualifier 1: Fichier définition d'analyse Name
Qualifier 2: Bibliothèque Name, *LIBL
FROMFILE Nom du fichier base de données Qualified object name Optional, Positional 6
Qualifier 1: Nom du fichier base de données Name
Qualifier 2: Bibliothèque Name, *LIBL
FROMMBR Membre du fichier Name, *FIRST Optional, Positional 7
COLHDG Noms des champs de fusion *NAME, *ALIAS, *COLHDG Optional, Positional 8
FROMSQL Requête SQL Character value Optional, Positional 9
OUTPUT Type de sortie *, *PRINT, *OUTPRN, *PDF, *EMAIL Optional, Positional 10
OUTPRN Fichier d'impression (.PRN) Character value, *DFT Optional, Positional 11
OUTSAVE Sauvegarder document généré *NO, *YES Optional, Positional 12
SHOWDOC Afficher le document généré *NO, *YES Optional, Positional 13
EXESRV Nom du PC serveur LAUNCHER Character value, *DFT, *DEV, *CURRENT Optional, Positional 14
ENDOPT Option de fin *ALL, *APP, *DOC, *CON, *NONE Optional, Positional 15
SAVDOC Nom du document à sauvegarder Character value Optional, Positional 16
SAVFLR Dossier du document sauvegardé Character value, *DFT, *NONE Optional, Positional 17
SAVFMT Format de Sauvegarde Document Character value, *NORMAL, *DOC, *HTM Optional, Positional 18
MRGSEL Type de fusion Word *LTR, *CAT, *NONE Optional, Positional 19
WORDPATH Répertoire par défaut de Word Character value, *DFT, *NONE Optional, Positional 20
DOCTMP Fich. de transfert temporaire Character value, *DFT Optional, Positional 21
WORDMRG Options de fusion WORD Element list Optional, Positional 22
Element 1: Nom du fichier d'entête Character value, *FILE
Element 2: Suppression des lignes vides *NO, *YES
EXECMRG Exécuter le publipostage *YES, *NO Optional, Positional 23
UNLINK Suppression des champs *NO, *YES Optional, Positional 24
OUTOPT Options de sortie Element list Optional, Positional 25
Element 1: Nom de l'imprimante Character value, *DFT
Element 2: Nombre d'exemplaires 1-99999, 1
Element 3: Nom du bac Character value
Element 4: Bac pour la 1ere page Character value
Element 5: Bac pour les pages suivantes Character value
Element 6: Impression directe *YES, *NO
OUTPDF Fichier PDF à générer Character value Optional, Positional 26
MAILOPT Options de messagerie OUTLOOK Element list Optional, Positional 27
Element 1: Colonne destin. du message Character value
Element 2: Sujet du message Character value
SELDOC Inutilisé. (compatibilité) F, S Optional, Positional 28
Top

Nom du modèle de document (DOC)

Indique le nom du modèle du document WORD à utiliser pour le publipostage.

Les valeurs possibles sont :

nom_du_document
Indiquer le nom du document.

Remarque :Il est possible de spécifier le chemin d'accès complet dans ce paramètre (exemple : D:\Racine\Répertoire\Document).

Dans ce cas, les paramètres FLR et ROOT doivent avoir la valeur *NONE.

Un chemin réseau sous la forme \\Serveur\Partage\répertoire\document peut être spécifié pour le paramètre DOC.

C:\MonDossier\MonDoc.doc est un nom valide.

*NEW
Un nouveau document vierge est créé.

Cette option permet de préparer un nouveau modèle vierge, qui sera lié A une source de données, et qui sera ainsi prêt à être composé par L'utilisateur.

*CURRENT
Cette valeur n'est possible, que si la communication LAUNCHER/400 est déjà ouverte entre le travail courrant et le PC, et si un document est ouvert par un précédent appel à une commande de LAUNCHER/400. Voir le paramètre ENDOPT.
Top

Dossier (FLR)

Indique le nom du dossier ou répertoire, dans lequel se trouve le document.

Remarque :Ce paramètre est facultatif dans le cas ou le paramètre DOC est renseigné avec le chemin complet (D:\Racine\Répertoire\Document)

Le caractère '\' ne doit pas figurer à la fin du chemin saisi.

Un chemin réseau sous la forme \\Serveur\Partage\répertoire peut être spécifié pour le paramètre FLR.

Top

Racine des répertoires (ROOT)

Indique le chemin d'accès pour parvenir au dossier contenant les modèles.

Remarque :Ce paramètre est facultatif. S'il est spécifié, ce paramètre est utilisé pour construire le chemin vers le modèle de document (DOC).

Le caractère '\' ne doit pas figurer à la fin du chemin saisi.

Un chemin réseau sous la forme \\Serveur\Partage\répertoire peut être spécifié pour le paramètre ROOT.

Top

Type source de données fusion (MRGTYPE)

Spécifie le type de source de données à utiliser pour extraire les données de l'As400 en vue de la fusion vers le document Word.

Les valeurs possibles sont :

*NONE
Aucune fusion n'est faite. Le document sera affiché ou imprimé.
*QRY
Les données à fusionner sont issues d'une requête As400 (objet de type *QRYDFN).
*FILE
Les données à fusionner sont issues d'un fichier de base de données As400.
*SQL
Les données à fusionner sont issues d'une requête SQL.
*DOC
La source de données est définie au niveau du modèle de document Word.
Top

Analyse (QRYDFN)

Nom de l'analyse exécutée pour passer les données à fusionner. Une analyse est une demande de sélection et de copie d'un ou de plusieurs enregistrements d'un fichier, selon des critères établis. Indiquer *QRY pour le paramètre MRGTYPE.

Les valeurs possibles sont :

nom-de-la-définition-de-l'analyse
Indiquer le nom de l'analyse qui sera exécutée pour déplacer les données fusionnées.

Pour la bibliothèque les valeurs possibles sont :

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.
nom-de-la-bibliothèque
Indiquer le nom de la bibliothèque où se trouve l'analyse.
Top

Fichier données (FROMFILE)

Nom du fichier où se trouve le membre contenant les données à fusionner.

*FILE doit être indiqué à la zone Type de fusion (paramètre MRGTYPE).

Les valeurs possibles sont :

nom-du-fichier
Indiquer le nom du fichier contenant les données à fusionner.

Pour la bibliothèque, les valeurs possibles sont :

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.
nom-de-la-bibliothèque
Indiquer le nom de la bibliothèque où se trouve le fichier.
Top

Membre données (FROMMBR)

Nom du membre du fichier contenant les données à fusionner. Ce paramètre est accepté seulement lorsque MRGTYPE (*FILE) est indiqué.

Les valeurs possibles sont :

*FIRST
Le premier membre du fichier contient les données à fusionner.
*FILE
Le membre ayant le même nom que le fichier contient les données à fusionner.
*LAST
Le dernier membre du fichier contient les données à fusionner.
nom-du-membre
Indiquer le membre qui contient les données à fusionner. Un membre est un ensemble de données dans un fichier.
Top

Origine des noms de champs de fusion (COLHDG)

Word utilise les noms de colonnes de la source de donnée comme champs de fusion.

Les valeurs possibles sont:

*NAME
Les noms de champ du fichier de base de donnée seront utilisés par Word.
*ALIAS
Les noms longs ou Alias seront utilisés.
*COLHDG
Les entêtes de colonnes du fichier de base de données seront utilisés par Word.
Top

Requete SQL (FROMSQL)

Saisir une instruction SQL pour sélectionner les enregistrements à fusionner dans le document Word de destination.

Top

Type de sortie (OUTPUT)

Spécifie si le document généré sera imprimé, ou non.

Les valeurs possibles sont :

*
Le document ne sera pas imprimé. Il sera affiché si le paramètre SHOWDOC a la valeur *YES.
*PRINT
Le document sera imprimé.
*OUTPRN
Le document sera imprimé vers un fichier d'impression (.PRN).
*PDF
Le document sera converti en format PDF. Le parametre OUTPDF doit être renseigné avec le chemin et le nom du fichier PDF à générer.
*EMAIL
Chaque lettre sera envoyée vers un destinataire de messagerie. Renseignez le paramètre MAILOPT pour indiquer le sujet et le nom de la colonne du fichier contenant les adresse de destainataires.

Cette fonction n'est displonible que avec un client de messagerie OUTLOOK.

Top

Fichier d'impression .PRN (OUTPRN)

Spécifie le chemin d'accès et le nom du fichier d'imprimante qui sera généré à l'impression du document. Ce paramètre est utilisé si le paramètre OUTPUT a la valeur *OUTPRN.

Les valeurs possibles sont :

*DFT
Le fichier de sortie fait référence au mot clé LNCPRN contenu dans le fichier LNCDFTP, dans lequel sont référencées toutes les valeurs initialisées par défaut.
Fichier-impression
Indiquer le fichier de sortie précédé du chemin d'accès.

Exemple : C:\LAUNCHER400\OUTPRN\DOCSAVE.PRN

Remarque :L'extension du fichier de sortie peut être indiqué par l'utilisateur mais reste cependant facultative.

Top

Sauvegarder le document généré (OUTSAVE)

Spécifie si le document résultant de la fusion doit être sauvegardé.

Les valeurs possibles sont :

*NO
Le document résolu n'est pas sauvegardé.
*YES
Le document résolu sera sauvegardé après la fusion. Le paramètre SAVDOC doit être renseigné.
Top

Afficher le document (SHOWDOC)

Indique si le document est affiché à l'écran.

Les valeurs possibles sont :

*NO
Le document résolu n'est pas montré à l'écran.
*YES
Le document résolu sera rendu visible à l'écran.
Top

Nom du serveur WORD (EXESRV)

Spécifie le nom du serveur sur lequel WORD doit être exécuté. Ce nom peut correspondre à un autre poste de travail. Le nom du Host ou l'adresse IP sont des choix valides.

Les valeurs possibles sont :

*DFT
Le traitement est exécuté sur le serveur référencé dans le fichier LNCDFTP réservé à la définition des options Launcher/400 (mot clé LNCSRV).
*DEV
Le traitement est exécuté sur le poste de l'utilisateur interactif courant.

Cette valeur ne pas être utilisée dans un travail soumis.

*CURRENT
Dans le cas ou la dernière connexion n'a pas été fermée (paramètre ENDOPT=*NO) lors de la dernière commande LNCPRTDOC, la connexion précédente est de nouveau utilisée.
adresse IP ou nom de l'hôte
La traitement est exécuté sur un PC du réseau, désigné ici par son nom d'hôte, ou son adresse TCP/IP.

Remarque :Il est impératif que le programme LAUNCHER/400 soit démarré sur le poste sur lequel les demandes sont exécutées.

Top

Option de fin (ENDOPT)

Indique quel éléments est fermé en fin de traitement de la commande.

Les valeurs possibles sont :

*ALL
La communication LAUNCHER entre le job et le serveur PC sera fermée. L'application pourra envoyer une autre commande LNCPRTDOC en spécifiant valeur *CURRENT au paramètre EXESRV
*APP
L'application sera fermée mais la communication LAUNCHER entre le job et le serveur P.C. restera ouverte.
*DOC
Le document sera fermé mais l'application et la communication LAUNCHER entre le job et le serveur P.C. resteront actives.
*CON
Seule la connexion LAUNCHER est fermée.
*NONE
La communication LAUNCHER entre le job et le serveur PC ne sera pas fermée ainsi que l'application et le document active.
Top

Nom du document à sauvegarder (SAVDOC)

Spécifie le nom sous lequel le document généré est sauvegardé.

Remarque :Ce paramètre peut contenir le chemin de répertoires au complet.

L'extension du document doit être indiquée dans le nom du document.

Exemple : fichier généré par PC 002.doc

Top

Dossier du document sauvegardé (SAVFLR)

Spécifie le répertoire dans lequel le document résolu sera sauvegardé.

Les valeurs possibles sont :

*DFT
Le chemin d'accès (Root et Dossier) pour accéder au document spécifié au paramètre SAVDOC est mentionné dans le fichier LNCDFTP réservé à la définition des valeurs initialisées par défaut.

Le mot clé LNCSAV est utilisé pour substituer la valeur initiale *DFT.

dossier_du_document_sauveg.
Le chemin d'accès complet doit-être mentionné (Root\Dossier)

Remarque :Le caractère '\' ne doit pas figurer à la fin du chemin saisi.

*NONE
Indiquer *NONE dans le cas ou le chemin d'accès complet (Root\Flr) est déjà renseigné au paramètre SAVDOC.
Top

Format Sauvegarde du document (SAVFMT)

Spécifie dans quel format est sauvegardé le Document résultat.

Les valeurs possibles sont les suivantes :

*NORMAL
Le document sera sauvegardé dans le format par défaut défini par Word. sur la station ou le serveur Windows.

Avec Word 2007, le document sera sauvegardé en format DOCX.

*DOC
Le document sera sauvegardé dans le format DOC compatible avec toute versions de Word.
*HTM
Top

Type de fusion WORD (MRGSEL)

Indique le type de fusion à réaliser dans WORD pour le publipostage.

Les valeurs possibles sont :

*LTR
La fusion est effectuée dans une lettre type.

Un document est composé pour chaque enregistrements de la source de données.

*CAT
La fusion est effectuée dans un document de type catalogue.

Un seul document est composé à partir de tous les enregistrements de la source de données.

*NONE
Le type de fusion est celui déjà défini pour le modèle de document Word.

Dans une fusion de type catalogue, tous les enregistrements du fichier de donnée sont fusionnés dans un seul document résultat, sans insertion de saut de page en fin.

Top

Répertoire par défaut de Word (WORDPATH)

Indique le chemin du répertoire utilisé par Word pour inclure des documents ou des objets externes.

Les valeurs possibles sont :

*DFT
Le répertoire utilisé par défaut par l'application WORD fait référence au mot clé LNCDIR référencé dans le fichier LNCDFTP.
répertoire_par_défaut
Indiquer le nom du répertoire utilisé par WORD par défaut.

Remarque :Le nom complet du chemin d'accès (Root/Dossier) doit être spécifié.

*NONE
Si *NONE est spécifié, le répertoire WORD utilisé par défaut correspond au répertoire défini dans les options WORD.
Top

Fich. de transfert temporaire (DOCTMP)

Lorsqu'un publipostage est demandé, les données de l'As400 sont envoyés sur le P.C. dans un fichier texte.

Les valeurs possibles sont :

*DFT
Le nom du fichier temporaire réservé au transfert des données de l'As400 vers le P.C. , est le nom mentionné dans le mot clé LNCTMP présent dans le fichier LNCDFTP.
nom_du_fichier_temporaire
Indiquer le nom du fichier temporaire utilisé pour le transfert des données As400 vers le P.C..

Remarque :Le nom du fichier doit obligatoirement être précédé du nom complet du chemin d'accès et si l'extension .TXT n'est pas indiqué, cela peut provoquer quelques problèmes.

Il faut aussi faire attention à ne pas utiliser un nom fixe dans le cas ou plusieurs traitements sont effectués simultanément sur un même P.C..

Le paramètre spécial %CONID% répond à ce problème. (voir documentation à ce sujet).

Top

Options fusion WORD (WORDMRG)

Différentes options sont offertes pour le publipostage WORD.

Nom du fichier d'entête
Spécifie le nom du fichier d'entête affecté au publipostage.

Les valeurs possibles sont :

*FILE
Les entêtes de champs sont issues du fichier As400.
nom_du_fichier_entête
Indiquer le nom du fichier P.C. au format .TXT contenant les entêtes des champs.
Suppression lignes vides
Lorsque tous les champs insérés dans un document de publipostage sont à vide pour un enregistrement donné, il est possible d'ignorer cette ligne.

Les valeurs possibles sont :

*NO
Les lignes vides sont présentes dans le document final.
*YES
Les lignes vides sont exclues du document final.
Top

Exécuter le publipostage (EXECMRG)

Indique si le publipostage doit être effectué ou seulement préparé.

Les valeurs possibles sont :

*YES
Le publipostage est excuté, un nouveau document est composé.
*NO
Le publipostage n'est pas exécuté. Les liaisons avec la source de données et d'entête sont préparées; Le modèle peut être complété sous Word.
Top

Suppression des champs (UNLINK)

Indique si les champs sont supprimés pendant le publipostage.

Les valeurs possibles sont :

*YES
Les champs du document Word résultat sont supprimés pendant le publipostage. Ces champs peuvent être aussi bien les champs de type 'calcul' (par exemple date du jour) que des champs plus évolués (par exemple l'inclusion d'un autre document).

Les champs supprimés sont remplacés par leur valeur correspondante.

*NO
Les champs sont conservés.
Top

Options de sortie (OUTOPT)

Différentes options sont offertes pour les sorties sur imprimantes.

Nom de l'imprimante
Spécifie le nom de l'imprimante sur laquelle les éditions doivent sortir.

Les valeurs possibles sont :

*DFT
L'imprimante par défaut est utilisée.
nom-de-l'imprimante
Donner le nom de l'imprimante utilisée pour la sortie des états.

Les syntaxes suivantes sont valides :

HP LaserJet 2200 PCL 6 (pour une imprimante locale)

\\SERVEUR\HP LaserJet 2200 PCL 6 (pour une imprimante réseau sur 'SERVEUR')

Le nom de l'imprimante correspond au nom visible lorsque l'utilisateur actionne le sous menu Imprimer du menu Fichier à partir de WORD.

Nombre d'exemplaires
Spécifie le nombre de copies pour l'édition.

Ce nombre doit correspondre à une valeur comprise entre 1 et 99999.

Nom du bac
Spécifie le nom du bac utilisé pour l'édition.
ID bac pour 1ère page
Spécifie l'identifiant du bac pour la première page.
ID bac pour pages suivantes
Spécifie l'identifiant du bac pour les pages suivantes.
Impression directe
Par défaut, Word crée un nouveau document qui est imprimé ou sauvé. Si l'impression directe est choisie, le publipostage se fait directement vers l'imprimante. Cette option est utile quand les volumes de données à fusionner sont importants.
Top

Fichier PDF de sortie (OUTPDF)

Spécifie le chemin d'accès et le nom du fichier PDF qui sera généré en sortie.

Ce paramètre est utilisé si le paramètre OUTPUT a la valeur *PDF.

Indiquer le fichier de sortie précédé du chemin d'accès.

Exemple : C:\LAUNCHER400\OUTPUT\DOC001.PDF

Top

Options de messagerie OUTLOOK (MAILOPT)

Avec le client de messagerie OUTLOOK, les documents fusionnés peuvent être envoyés vers leur destinataires, par courrier électronique. L'adresse des destinataires doit se trouver dans une colonne de la source de données.

Colonne Destinataire
Spécifie le nom de la colonne dans la source de donnée, contenant l'adresse du destinataire de chaque message.
Sujet du message
Texte du sujet ou objet pour chaque message envoyé.
Top

Sélection du document (SELDOC)

Ce paramètre permet de sélectionner le document manuellement (saisie obligatoire) ou automatiquement (sélection du document à partir de l'explorateur Windows).

Ce paramètre est obligatoire.

Les valeurs possibles sont :

F
La valeur F (comme FREE) vous permet d'obtenir l'invite pour saisir le nom du document, son dossier ainsi que son chemin d'accès.
S
La valeur S (comme SELECT) vous permet de sélectionner automatiquement le nom du document par l'intermédiaire de l'explorateur Windows renvoyée à l'écran.

Il est donc possible dans ce cas de parcourir les différents dossiers de son disque local (ou disques réseaux) pour y retrouver le modèle de document.

Remarque :L'utilisation du choix S n'est valable qu'à partir de la ligne de commandes As400. Lors de la création d'un programme CL, ce choix ne fonctionne pas et F est obligatoire.

Top

Examples

None
Top

Error messages

Unknown
Top