Aller au contenu

Préparer les documents Word ​

Save2ERP ne peut envoyer qu'un document qui sait où il doit être enregistré. Cette information est stockée dans des propriétés personnalisées du document Word, que le système cible renseigne lorsqu'il génère le document.

Les propriétés ​

PropriétéObligatoireRôle
S2E_SystemKeyOuiSystème cible, par exemple P01CLNT100. Doit correspondre à un système déclaré dans le .env (variables SAP_P01CLNT100_…).
S2E_ObjectTypeOuiType de l'objet auquel joindre le document.
S2E_ObjectKeyOuiIdentifiant de l'objet.
S2E_FileNameNonNom de fichier proposé à l'utilisateur. Il passe avant le nom du fichier Word, qui peut contenir un compteur ajouté par Windows (« Courrier (3).docx »).
S2E_TemplateIdNonIdentifiant du modèle Word dans le système cible : le mode concepteur est proposé sur ce document.
S2E_LabelsShownNonÉcrite par Save2ERP, jamais par le système cible : le document affiche les libellés des balises (mode concepteur) et ne peut pas être sauvegardé.

Ces propriétés sont invisibles pour l'utilisateur dans le document. Elles sont conservées dans la copie créée par le bouton « Ouvrir une copie ».

Ce qui se passe si elles manquent ​

SituationMessage dans le panneau
S2E_SystemKey absente (document vierge, créé à la main…)Document non reconnu
Système absent du .envSystème inconnu
Système déclaré mais incompletSystème mal configuré
S2E_ObjectType ou S2E_ObjectKey absenteDocument incomplet, au moment de l'envoi

Vérifier les propriétés d'un document ​

Dans Word pour Windows : Fichier › Informations › Propriétés › Propriétés avancées › onglet Personnalisation. Les propriétés S2E_… et leurs valeurs y sont listées.

Pour un test, vous pouvez aussi les ajouter à la main dans cet onglet, sur un document quelconque.

Mode concepteur ​

Dans un modèle Word dont le contenu vient du système cible, les valeurs de l'objet (client, adresse, lignes d'une offre…) sont des contrôles de contenu liés à une partie XML du document. Le mode concepteur remplace ces valeurs par le libellé de chaque balise (« Raison sociale du client », « Date de l'offre »…) : le concepteur du modèle repère ainsi d'où vient chaque information.

L'icône du mode concepteur s'affiche dans le panneau, à droite de l'icône du système et au-dessus de la roue crantée, si :

  • le système cible accorde à l'utilisateur le droit de concepteur de modèles. Ce droit est lu à la connexion : s'il vient d'être accordé, l'utilisateur doit se déconnecter puis se reconnecter ;
  • le document porte la propriété S2E_TemplateId.

Un clic sur l'icône affiche les libellés et la vue « Mode concepteur » : tant qu'elle est affichée, le document ne peut être ni sauvegardé, ni copié. Le bouton « Sortir du mode concepteur » réaffiche les valeurs de l'objet et revient à la vue d'envoi.

Un document ne peut jamais être sauvegardé avec les libellés

Tant que les libellés sont affichés, le document porte la propriété S2E_LabelsShown. Même enregistré puis rouvert, il s'ouvre sur la vue « Mode concepteur », et la sauvegarde reste refusée jusqu'au retour aux valeurs.

Pas de mode concepteur dans Word sur le web

Word sur le web ne met pas à jour les contrôles de contenu liés à la partie XML du document : il les affiche, mais ne les actualise pas quand le XML change. Cette limitation de Microsoft empêche le mode concepteur de fonctionner : dans Word sur le web, l'icône n'est pas proposée. Un document laissé avec les libellés s'y ouvre sur la vue « Mode concepteur », sans bouton de sortie ; pour réafficher les valeurs, ouvrez-le dans l'application Word de bureau.

MessageCause
Document incompletS2E_TemplateId absente, ou S2E_ObjectType / S2E_ObjectKey absente pour revenir aux valeurs.
Modèle non reconnuLe document n'a pas la partie XML du modèle renvoyé par le système cible.
Mode concepteur indisponibleLe système cible ne fournit pas le service des modèles.
Changement d'affichage impossibleRefus du système cible (droit de concepteur, accès à l'objet, modèle inconnu…), avec son message.

Côté système cible ​

C'est le système cible qui doit renseigner ces propriétés lorsqu'il génère le document, et fournir les services du mode concepteur s'il le propose : voir Implémenter les services et Système cible : SAP.