Description du processus de publication

Il est primordial de comprendre le processus de publication de bout en bout pour assurer une bonne implémentation personnalisée. En général, les compétences nécessaires pour atteindre cet objectif sont les suivantes :

• Vous êtes expérimenté dans l'administration et la configuration d'Arbortext Publishing Engine, y compris la Connexion au serveur PTC à Windchill PDMLink.

• Vous êtes expérimenté dans la création et le déploiement d'applications de type de document spécialisées pour Arbortext Editor et Publishing Engine, ainsi que dans l'utilisation du répertoire application.

L'installation, la configuration et le fonctionnement des éléments ci-après doivent se dérouler correctement pour que vous puissiez procéder aux implémentations personnalisées :

Les instructions d'installation et de configuration d'Arbortext Publishing Engine figurent dans les manuels Installing Servigistics Arbortext Publishing Engine (Installation de Servigistics Arbortext Publishing Engine) et Configuring Servigistics Arbortext Publishing Engine (Configuration de Servigistics Arbortext Publishing Engine), qui font partie de la documentation du Centre d'aide Arbortext Publishing Engine.

Les instructions pour le paramétrage de la connexion au serveur à partir de Windchill figurent dans le manuel Configuration de Windchill Service Information Manager et Windchill Service Parts, qui fait partie de la documentation Windchill Service Information Manager disponible dans le Centre d'aide Windchill et la section Documents de référence du site de PTC, à l'adresse :

• L'application Service com.ptc.arbortext.service doit être installée et activée sur le Serveur Arbortext PE. Par défaut, elle se trouve dans le répertoire application d'Arbortext Publishing Engine. Elle gère la transformation initiale du document XML d'entrée en cours de préparation pour la publication.

• Un type de document pour la gestion de la sortie de publication doit être installé et activé sur le Serveur Arbortext PE. Par défaut, un fichier exemple se trouve dans le répertoire application d'Arbortext Publishing Engine. L'application de type de document DITA Technical Information com.ptc.arbortext.techinfo est un exemple de travail de ce type de document distribué avec Arbortext Publishing Engine.

• La Connexion au serveur PTC à Windchill doit être configurée sur le Serveur Arbortext PE pour autoriser le Serveur Arbortext PE à récupérer des objets à partir de Windchill.

Les instructions de configuration de la Connexion au serveur PTC figurent dans le manuel Servigistics Arbortext Content Management Guide (Guide de gestion du contenu de Servigistics Arbortext), qui fait partie de la documentation Arbortext Publishing Engine.

• Un convertisseur SIS doit être configuré sur Windchill PDMLink afin que WVS puisse gérer les demandes de publication envoyées à Arbortext Publishing Engine à partir des structures d'information, des structures de publication et des listes d'articles.

Les instructions de configuration du convertisseur SIS figurent dans le manuel Configuration de Windchill Service Information Manager et Windchill Service Parts, qui fait partie de la documentation Windchill Service Information Manager.

• Les règles de publication WVS doivent être configurées sur Windchill PDMLink afin que les utilisateurs puissent choisir une règle de publication et que WVS puisse envoyer les paramètres de publication associés à Arbortext Publishing Engine. Les règles de publication doivent présenter un nom et un descriptif précis pour que l'utilisateur puisse les distinguer.

Les instructions de configuration des règles de publication figurent dans le manuel Configuration de Windchill Service Information Manager et Windchill Service Parts, qui fait partie de la documentation Windchill Service Information Manager.

• Une structure de publication, une structure d'information et, le cas échéant, une liste d'articles doivent être définies dans un produit de service. La publication générale WVS doit être opérationnelle avant l'utilisation des actions de publication.

• Une représentation publiée dans un format de sortie spécifié peut être créée à l'aide de l'option de menu, du menu de raccourcis ou du bouton de barre d'outils Publier la représentation. L'utilisateur spécifie le nom et la description de la publication, ainsi qu'une éventuelle règle de publication WVS. Le type de sortie et les différents paramètres de publication sont indiqués par la règle de publication WVS ou par le choix de l'utilisateur en cas de listes d'articles.

• L'option Publier la représentation permet la publication d'un paquet pour Servigistics InService. La publication de paquets génère un fichier appelé paquet, utilisé comme entrée dans InService. Le paquet est placé sur le Serveur Arbortext PE, dans un répertoire dans lequel InService peut le trouver. Le processus de publication de paquet ne renvoie aucun paquet à Windchill, mais renvoie des informations sur l'opération de publication de ce paquet.

• Le fichier de règles de publication WVS doit inclure des paramètres de convertisseur SIS définis pour pouvoir contrôler le processus de publication. Les paramètres et les exemples sont expliqués à la rubrique Paramètres du convertisseur de service.

1. Lorsqu'une action de publication est déclenchée à partir d'une structure de publication, d'une structure d'information ou d'une liste d'articles, plusieurs fichiers sont générés, compressés et envoyés par WVS dans un fichier appelé champ de données vers le Serveur Arbortext PE. Le nombre et le type de fichiers dépendent de la structure, de son contenu, du format de sortie spécifié et des spécifications de publication pour la tâche de publication demandée.

2. Windchill Service Information Manager crée un document XML généralisé à partir de la structure à envoyer au Serveur Arbortext PE.

Vous devez comprendre ce format XML généralisé pour transformer avec succès le document XML d'entrée en un format compatible avec la structure de votre type de document. Une feuille de style de transformation XSLT est fournie dans le cadre du traitement de l'application Service. Cette feuille de style XSLT est spécifiée à l'aide de l'un des paramètres de la règle de publication WVS.

3. Les spécifications de la règle de publication WVS sont converties en un fichier de spécification de la publication, envoyé au Serveur Arbortext PE dans le champ de données. Ses paramètres sont appliqués lors du processus de publication.

4. Les objets référencés par le document XML d'entrée, tels que les graphiques, sont envoyés à Arbortext Publishing Engine en tant que composants du champ de données, ou peuvent être récupérés à l'aide de la Connexion au serveur PTC sur Windchill PDMLink. Le choix est déterminé par un paramètre du convertisseur SIS.

5. Le document XML d'entrée, la spécification de publication et les objets référencés (si nécessaire) sont compressés dans un fichier de champ de données, avec un fichier XML manifeste décrivant le contenu du champ de données.

Le champ de données est ensuite envoyé en tant que type POST de requête HTTP au Serveur Arbortext PE pour traitement, à l'aide d'un appel de fonction f=acl géré par l'application Service.

6. L'application de service dispose de feuilles de style XSLT capables d'appliquer au document d'entrée XML généralisé un format compatible par défaut avec l'exemple de type de document DITA distribué, une liste d'articles illustrée ou un paquet InService.

7. Un type de document prenant en charge le document intermédiaire de l'application Service et capable de produire une sortie publiée ou un paquet doit être installé sur le Serveur Arbortext PE.

L'exemple de type de document DITA spécialisé Technical Information est distribué sur le Serveur Arbortext PE. Par défaut, il traite le contenu et le marquage généré par l'application Service par défaut et peut produire une sortie conformément à la spécification de publication.

L'application Technical Information est conçue pour la rédaction et la publication des informations relatives aux opérations de service et aux articles, sous la forme d'un exemple de type de document de travail. Tous les types de document personnalisé auraient besoin d'émuler les fonctions et actions intégrées dans l'application Technical Information.

8. Une fois que le champ de données a été reçu par le Serveur Arbortext PE, la demande est dirigée vers un Sous-processus Arbortext PE et traitée.

La spécification de publication doit indiquer la feuille de style de transformation XSLT qui convertit le document XML d'entrée généralisé en un marquage compatible avec le type de document spécifié. La feuille de style XSLT doit spécifier le type de document de sortie.

9. Le document XML d'entrée de la structure de publication, de la structure d'information, ou de la liste d'articles est transformé en structure de plan par l'application Service. Si la structure référence une liste d'articles, cette dernière est transformée en un format XML distinct appelé Définition d'article illustrée. Si seule une liste d'articles constitue l'entrée, elle est placée dans un fichier XML de structure de publication wrapper référençant la liste d'articles qui est transformée comme si elle avait été réellement référencée par une structure de publication.

10. Le Sous-processus Arbortext PE applique au document des filtres de pipeline propres au type de document de sortie, affecte un style et publie la sortie conformément à la feuille de style spécifiée (à l'aide du logiciel Arbortext APP et selon les spécifications de la feuille de style Arbortext Styler).

11. Le Serveur Arbortext PE rassemble la sortie publiée (ou un message d'erreur si le système en a généré un à la place), le journal du composeur (aux formats XML et HTML) et un manifeste identifiant le type de sortie, l'ID de processus, l'ID de transaction, ainsi que le nom et l'adresse IP du Serveur Arbortext PE, puis il compresse ces fichiers dans un fichier de réponse au format ZIP. Le fichier de réponse compressé est retourné au convertisseur SIS. Si la sortie est un paquet, le fichier de réponse ne l'inclut pas, mais comprend les informations relatives au chemin de ce paquet. Le paquet reste sur le Serveur Arbortext PE, dans le répertoire de destination, en attente de l'exécution d'autres actions par InService.

12. Le convertisseur SIS transmet le fichier ZIP de réponse retourné à WVS.

13. WVS fournit un lien d'accès au fichier ZIP contenant la représentation qui figure dans l'onglet Représentations. Si la représentation comprend un fichier PDF, vous pouvez configurer un délégué de post-publication pour extraire le PDF et l'intégrer sous forme de représentation dans Windchill PDMLink.