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é | Obligatoire | Rôle |
|---|---|---|
S2E_SystemKey | Oui | Système cible, par exemple P01CLNT100. Doit correspondre à un système déclaré dans le .env (variables SAP_P01CLNT100_…). |
S2E_ObjectType | Oui | Type de l'objet auquel joindre le document. |
S2E_ObjectKey | Oui | Identifiant de l'objet. |
S2E_FileName | Non | Nom 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_TemplateId | Non | Identifiant du modèle Word dans le système cible : le mode concepteur est proposé sur ce document. |
S2E_LabelsShown | Non | É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
| Situation | Message dans le panneau |
|---|---|
S2E_SystemKey absente (document vierge, créé à la main…) | Document non reconnu |
Système absent du .env | Système inconnu |
| Système déclaré mais incomplet | Système mal configuré |
S2E_ObjectType ou S2E_ObjectKey absente | Document 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.
| Message | Cause |
|---|---|
| Document incomplet | S2E_TemplateId absente, ou S2E_ObjectType / S2E_ObjectKey absente pour revenir aux valeurs. |
| Modèle non reconnu | Le document n'a pas la partie XML du modèle renvoyé par le système cible. |
| Mode concepteur indisponible | Le système cible ne fournit pas le service des modèles. |
| Changement d'affichage impossible | Refus 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.