Aller au contenu

Comment fonctionne Save2ERP ​

Save2ERP se compose de deux parties :

  • un complément Word, qui affiche le panneau Save2ERP dans Word pour Windows, Mac ou le web ;
  • un serveur Save2ERP, installé par votre entreprise (ou hébergé pour elle). Il sert les pages du panneau, gère la connexion des utilisateurs au système cible et lui transmet les documents.

Le système cible est le système de gestion (ERP) dans lequel les documents sont enregistrés, par exemple SAP.

Architecture ​

┌────────────────┐       ┌──────────────────┐       ┌──────────────────┐
│ Word           │ HTTPS │ Serveur Save2ERP │ HTTPS │ Système cible    │
│ panneau        │ ────► │ pages, OAuth2,   │ ────► │ serveur OAuth2   │
│ Save2ERP       │       │ relais vers l'API│       │ API REST         │
└────────────────┘       └──────────────────┘       └──────────────────┘
  • Le panneau ne contacte jamais le système cible directement : toutes les demandes passent par le serveur Save2ERP. La page de test /test suit le même chemin, depuis un navigateur.
  • La connexion au système cible utilise OAuth2 avec PKCE. Le jeton obtenu reste sur le serveur, chiffré dans un cookie que le navigateur ne peut pas lire (voir Sécurité et données).
  • Avec une licence limitée en nombre d'utilisateurs, le panneau obtient l'identité Microsoft de l'utilisateur pour le compter (voir Installer et renouveler la licence).

Le système est imposé par le document ​

Le document Word généré par le système cible contient des propriétés personnalisées invisibles pour l'utilisateur, dont S2E_SystemKey, qui désigne le système (par exemple P01CLNT100). L'utilisateur ne choisit donc jamais le système : c'est le document qui l'impose (voir Préparer les documents Word).

Le serveur n'accepte que les systèmes déclarés dans sa configuration (voir Configurer le serveur). Pendant une session, il verrouille le système : un document d'un autre système affiche « Changement de système détecté » jusqu'à ce que l'utilisateur se déconnecte. Un document de test ne peut ainsi jamais être envoyé par erreur en production avec la même session.

Déroulement d'un envoi ​

  1. L'utilisateur ouvre le panneau. Le serveur vérifie sa licence et, pour une licence limitée, l'utilisateur.
  2. Le panneau lit le système du document et demande la page d'envoi au serveur.
  3. Sans session valable, le panneau affiche la page de connexion : une fenêtre s'ouvre sur le serveur OAuth2 du système cible, l'utilisateur s'identifie et autorise Word. Le serveur reçoit le jeton et le conserve, chiffré, dans un cookie.
  4. L'utilisateur clique sur le bouton de sauvegarde. Le panneau demande au système cible, via le serveur, si un fichier du même nom existe déjà, et lit le document dans Word en même temps.
  5. Le panneau envoie le document au serveur, qui le transmet au système cible avec le jeton. Le résultat s'affiche dans le panneau.

Le serveur renouvelle le jeton automatiquement avant son expiration. Si le système cible refuse le renouvellement, l'utilisateur doit se reconnecter. S'il ne répond pas, la session est conservée et l'utilisateur peut réessayer plus tard.

Deux modes d'utilisation ​

ModeAdresseUsage
Officeouvert depuis le ruban de WordUtilisation normale : envoi du document.
Page de testhttps://<serveur>/test, dans un navigateurDiagnostic, sans Word : vérifier la connexion OAuth2 et l'API du système cible (voir Diagnostiquer un problème).

La page de test reste accessible sans licence valide, pour pouvoir diagnostiquer une installation.