La commande LNCPRTDOC permet de composer un document à partir d’un modèle Word, et des données d’un fichier ou d’une requête de l’AS/400.
La commande peut réaliser les opérations suivantes :
• Fusion du modèle et des données
• Sauvegarde du document résolu
• Impression du document résolu
• Affichage du document
Il est conseillé d’utiliser des modèles de documents Word (*.dot, *.dotx) .
L’aide en ligne disponible sur l’AS400 peut être plus complète pour la commande LNCPRTDOC.
Paramètres
|
Nom du modèle de Document |
DOC |
|
|
|
Dossier / répertoire du modèle |
FLR |
*DFT |
|
|
Racine du répertoire |
ROOT |
*DFT |
|
|
Type source de données fusion |
MRGTYPE |
*NONE |
|
|
Fichier d'origine |
FROMFILE |
|
|
|
Bibliothèque |
|
*LIBL |
|
|
Membre d'origine |
FROMMBR |
*FIRST |
|
|
Requête SQL |
FROMSQL |
'SELECT * FROM' |
|
|
Analyse |
FROMQRY |
|
|
|
Bibliothèque |
|
*LIBL |
|
|
Type de sortie |
OUTPUT |
* |
|
|
Sauvegarder document généré |
OUTSAVE |
*NO |
|
|
Afficher le document généré |
SHOWDOC |
*NO |
|
|
Nom du PC serveur LAUNCHER |
EXESRV |
*DFT |
|
|
Option de fin |
ENDOPT |
*ALL |
|
|
Répertoire par défaut de Word |
WORDPATH |
*DFT |
|
|
Exécuter le publipostage |
EXECMRG |
*YES |
|
|
Suppression des champs |
NLINK |
*YES |
|
Détails
La commande LNCPRTDOC permet de fusionner un modèle de document
WORD, avec des données provenant de l'AS/400.
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
Indiquez le nom du document.
Remarque : Il est possible de spécifier le chemin d'accès complet dans ce paramètre.
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é.
*NEW
Un nouveau document vierge est créé.
Cette option permet de préparer un nouveau modèle vierge, qui
sera lié à 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 courant 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.
Dossier/répertoire du modèle (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.
Racine du répertoire (ROOT)
Indique le chemin d'accès pour parvenir aux répertoires des modèles
ou des documents résolus sauvegardés.
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) et vers le document à sauvegarder (SAVDOC).
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.
Type source de données fusion (MRGTYPE)
Spécifie le type de source de données à utiliser pour extraire les données de
l'AS/400 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 AS/400 (objet
de type *QRYDFN).
*FILE
Les données à fusionner sont issues d'un fichier de base de données AS/400.
*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.
Fichier d'origine (FROMFILE)
Indique le nom et la bibliothèque du fichier base de données à
utiliser. Ce
paramètre est utilisé lorsque le paramètre MRGTYPE est défini sur
*FILE.
Le fichier base de données peut
être physique ou logique.
Pour la bibliothèque, les valeurs possibles sont les suivantes :
*LIBL
La recherche est effectuée dans toutes les bibliothèques
utilisateur et système de la liste des bibliothèques du travail
jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
Le fichier base de données est recherché dans la bibliothèque
en cours du travail, si celle-ci n'est pas précisée.
Membre d'origine (FROMMBR)
Indique le nom du membre fichier base de données, à utiliser.
Ce paramètre est utilisé lorsque le paramètre MRGTYPE est
défini sur *FILE.
Les valeurs possibles sont les suivantes :
*FIRST
Le premier membre du fichier base de données est copié.
nom-membre
Indique le nom du membre du fichier base de données d'origine.
Requête SQL (FROMSQL)
Saisir la requête SQL pour extraire les données.
MRGTYPE = *SQL.
Analyse (FROMQRY)
Spécifie le nom de la
requête à utiliser pour obtenir les données.
Ce paramètre est utilisé lorsque le paramètre MRGTYPE est défini sur *QRY.
Nom de la requête
Entrez le nom de la requête.
Les valeurs de bibliothèque possible sont:
* LIBL
La liste de bibliothèques
est explorée pour trouver la bibliothèque
où se trouve le fichier de requête.
Nom de la bibliothèque
Entrez le nom de la bibliothèque contenant le fichier de requête.
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.
Le document sera imprimé.
*OUTPRN
Le document sera imprimé dans un fichier d'impression(PRN).
Le document sera converti en format PDF.
Le paramètre OUTPDF doit être renseigné avec le chemin et le nom du
fichier PDF à générer.
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 des destinataires.
Cette fonction n'est disponible que avec un client de messagerie OUTLOOK.
Fichier d’impression (OUTPRN)
Spécifie le chemin et le nom du fichier sur lequel imprimer, lorsque le paramètre
OUTPUT est défini sur la valeur *OUTPRN.
Sauvegarder 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é.
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.
Nom du serveur Launcher (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 Office (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=*NONE dans 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 soit démarré
sur le poste sur lequel les demandes sont exécutées.
Option de fin (ENDOPT)
Indique si la communication LAUNCHER Office sera fermée après
traitement de la commande LNCPRTDOC et précise quel élément doit
être fermé.
Les valeurs possibles sont :
*ALL
La communication LAUNCHER entre le job et le serveur PC sera
fermée. L’application Word et le document sont aussi fermés.
*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.
*NONE
La communication LAUNCHER entre le job et le serveur PC ne sera
pas fermée ainsi que l'application et le document actif.
L'application pourra envoyer une autre commande
LNCPRTDOC en spécifiant la valeur *CURRENT au paramètre EXESRV
Nom du document à enregistrer (SAVDOC)
Spécifie le nom du nouveau document à enregistrer après le publipostage.
Remarque: Ce paramètre peut contenir le chemin du répertoire complet.
L'extension du fichier doit être définie.
Exemple : MyResultLetter.docx
Répertoire de sauvegarde. (SAVFLR)
Spécifie le dossier ou le répertoire dans lequel le document résolu sera enregistré.
Les valeurs possibles sont:
*DFT
La valeur par défaut du fichier LNCDFTP, pour le mot clé LNCSAV, sera utilisée.
Nom de dossier
Le chemin du dossier ou du répertoire est spécifié.
Remarque: le caractère '\' ne doit pas être saisi à la fin de la chaîne.
*NONE
Spécifie que le paramètre SAVDOC contient le chemin du répertoire.
Type de fusion Word (MRGSEL)
Spécifie le type de fusion que Word utilisera.
Les valeurs possibles sont:
*LTR
Le mot fusion est une lettre.
Une lettre est créée pour chaque enregistrement de la source de données.
Les lettres sont séparées les unes des autres par un "Form Feed".
*CAT
La fusion de mots est un catalogue.
Un seul document est créé, avec tous les enregistrements de la source de données.
*NONE
Le type de fusion est défini dans le modèle Word.
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.
Fichier de transfert temporaire (DOCTMP)
Les données sont transférées dans un fichier temporaire sur le PC.
Le nom de fichier et le chemin d'accès à ce fichier peuvent être définis.
Valeurs possibles :
*DFT
La valeur du mot clé LNCTMP dans le fichier LNCDFTP est utilisée.
nom fichier temporaire
Définit le chemin et le nom du fichier temporaire à utiliser.
Word merge options (WORDMRG))
Several options are available.
Header file
Specifies the name of a file containing the fields names for the data source.
Possible values are :
*FILE
The fields names come from the AS/400 database file.
Header-file-name
Enter a PC file name containing the names of the fields.
Suppress blank lines
In the document, when a line containing merge fields is blank
after the mail merge, Word can suppress it.
Possible values are :
*NO
The blank lines are kept in the resolved document.
*YES
The blank lines are deleted from the resolved document.
Exécuter le publipostage (EXECMRG)
Indique si le publipostage doit être effectué ou seulement préparé.
Les valeurs possibles sont :
*YES
Le publipostage est exécuté.
*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.
Exemple
LNCPRTDOC SELDOC(F) DOC('%LNCDIR%\Samples\sp_cust.docx') FLR(*NONE) ROOT(*NONE) MRGTYPE(*FILE) FROMFILE(SP_CUST) SHOWDOC(*YES) EXESRV(*DEV)