Information 4.0 : Comment HOMAG utilise les informations de la documentation pour la commande de l'installation

Nouvelles exigences du service de développement : Paquets de données Doku pour le HOMAG-Service-Cloud

Après avoir mis en place la solution de publication basée sur DITA avec intégration SAP, HOMAG nous a contactés avec une nouvelle exigence. Le service de développement de HOMAG s'était adressé à l'équipe de la documentation technique pour savoir comment extraire du système de gestion des documents SAP les informations nécessaires à la description des erreurs et aux solutions correspondantes aux problèmes. L'objectif était de charger des paquets de données avec des informations appropriées dans le HOMAG-Cloud et de les relier aux machines. Les opérateurs de machineopératrices de machineopérateurs et opératrices de machineopérateur·rice·s de machine et techniciens de servicetechniciennes de servicetechniciens et techniciennes de servicetechnicien·e·s de service devraient alors être informés des problèmes sur une machine via l'application HOMAG ServiceAssist ou le HOMAG ServiceRemote et se voir proposer immédiatement les documents adéquats avec des propositions de solutions.

Pour ce faire, les développeursdéveloppeusesdéveloppeurs et développeusesdéveloppeur·se·s HOMAG ont déterminé dans une définition d'interface quelles informations devaient être fournies par la documentation technique afin d'établir le lien entre la machine et la documentation.

C'est là que c-rex.net, en tant qu'intégrateur système de longue date de HOMAG, a été sollicité et a mis en place une solution développée selon l'un de nos principes de base, à savoir "Utilise un standard quand il existe et adapte-le à tes besoins si nécessaire !".

Des normes, des normes, des normes ! XML, iiRDS, DITA

Comme nous nous sommes appuyés sur des normes dans la solution précédente pour la création et la publication automatique de documentation technique, à savoir iiRDS, nous voulions faire de même pour le développement de la nouvelle exigence. C'est pourquoi nous avons mappé la liste des métadonnées requises par rapport à l'intelligent information Request and Delivery StandardiiRDS). Enfin, la demande du service de développement portait sur l'échange d'informations entre deux systèmes différents. Et voilà ! Il y a presque eu un match à un contre un.

Il s'est donc avéré que le regroupement des informations et des documents demandés par le service de développement dans un iiRDS était la voie à suivre. Seules quelques adaptations ont dû être effectuées dans iiRDS et dans les iiRDS déjà établies chez HOMAG.

Qu'est-ce qui est couvert par l'iiRDS? Quelles extensions étaient nécessaires ?

Il y avait de nombreuses exigences pour le HOMAG-Cloud qui pouvaient être couvertes par iiRDS sans adaptation. Quelques exigences ont rendu nécessaire l'extension de la iiRDS.

Dans la solution en nuage visée, des informations devraient être fournies sur le pourcentage de réussite d'une solution proposée dans l'application de service pour d'autres utilisateursutilisateuresutilisateurs et utilisateuresutilisateur·e·s. Cette information ne figurait pas jusqu'à présent dans la documentation et n'avait pas d'équivalent approprié dans iiRDS. C'est pourquoi nous avons ajouté un custom-property à cet effet et ainsi étendu le iiRDS.

Nous avons réalisé cela grâce aux "docking points", qui servent à enregistrer des métadonnées issues d'autres normes (par ex. ECLASS) ou justement des structures custom pour les produits et les sous-ensembles. Et cela convenait parfaitement à l'environnement HOMAG. En effet, HOMAG réalise depuis des années une documentation orientée sur les sous-ensembles.

Comment se présente la mise en œuvre dans DITA ?

Dans l'étape suivante, nous avons examiné comment nous pouvions mettre cela en œuvre dans DITA. Pour cela, jetons un coup d'œil sur les iiRDS qui existaient déjà chez HOMAG.

D'une part, il y a les topicsspécialisés déjà :

• HomagFCR (Fault Cause Remedy) dérive du type de sujet standard "Troubleshooting".

• HomagTask dérive du type de sujet standard "Tâche".

De plus, il existe une MDETask spécialement conçue pour les informations de maintenance, avec laquelle la machine établit un lien direct avec la doc. Nous en avons déjà parlé dans notre premier article de blog sur la solution HOMAG.

Nous avons étendu les deux types de topics spécialisés, HomagFCR et HomagTask, de manière à ce que les écrivainsécrivainesécrivains et écrivainesécrivain·e·s de descriptions d'erreurs puissent d'une part saisir les métadonnées nécessaires et d'autre part établir des relations via des liens dans le "Remedy" vers les solutions.

Qu'est-ce que cela signifie concrètement pour le travail rédactionnel ?

• Les écrivainsécrivainesécrivains et écrivainesécrivain·e·s créent leurs contenus comme d'habitude et attribuent en plus des métadonnées dans le prologue du DITA-Topic.

• Les Remedy (remèdes) dans le FCR-Topic sont des étapes d'action que écrivainsécrivainesécrivains et écrivainesécrivain·e·s ne décrit pas directement dans le HomagFCR, mais insère en tant que référence croisée. Cette référence croisée établit la relation avec la tâche dans laquelle la solution (remède) est décrite.

Comment les données arrivent-elles dans le Service-Cloud HOMAG ?

Pour ce faire, nous avons étendu le processus de publication intégré dans FrameMaker, qui jusqu'à présent desservait déjà différents canaux de publication et mettait à disposition à cet effet des fichiers XLIFF, PDF, des fichiers de contrôle pour la machine et des diapositives de formation. Il génère maintenant un iiRDS pour le type de document "Correction d'erreurs" et le stocke dans SAP en plus des autres informations, en fonction des sous-ensembles.

Le HOMAG ServiceAssist récupère les informations dans SAP, où le iiRDS est stocké pour chaque module, et les importe dans l'application cloud, où l'accès correspondant et la transmission à l'application et au système CRM sont ensuite réglés.

Comment cela se présente-t-il pour utilisateursutilisateuresutilisateurs et utilisateuresutilisateur·e·s?

utilisateursutilisateuresutilisateurs et utilisateuresutilisateur·e·s reçoivent des propositions de solutions sur leur tablette ou leur smartphone. La base des informations affichées est toujours un iiRDS qui contient des contenus PDF et HTML se rapportant précisément à l'erreur sur la machine et mettant à disposition les solutions possibles pour celle-ci.

Vous pouvez voir l'utilisation de l'application HOMAG ici sur YouTube dans le canal HOMAG. Vous pouvez aussi essayer vous-même en téléchargeant l'application HOMAG serviceAssist sur l'AppStore.

Et chez vous ?

Avez-vous déjà une idée de la manière dont les métadonnées pour les iiRDS peuvent être saisies dans votre processus de publication d'informations techniques et mises à disposition de la machine et donc des opérateurs de machineopératrices de machineopérateurs et opératrices de machineopérateur·rice·s de machine en fonction de la situation grâce à des solutions semi-automatisées ou entièrement automatisées ? Ou une solution a-t-elle déjà été mise en œuvre chez vous ? N'hésitez pas à prendre contact avec nous.