Aller au contenu

Prérequis ​

Fichiers remis par Swiss Computing ​

FichierRôle
Archive ZIP de l'application, ou image DockerLe serveur Save2ERP (voir Installer en production).
license.licLa licence de votre entreprise (voir Installer et renouveler la licence).
Manifeste (.xml)Déclare le complément dans Microsoft 365, avec l'adresse de votre serveur (voir Déployer dans Microsoft 365).

Serveur ​

  • Node.js 22.15 ou plus récent, sur Windows ou Linux. Ou bien Docker : l'image contient déjà Node.js.
  • HTTPS avec un certificat valide : Word refuse un complément servi en HTTP ou avec un certificat non reconnu. Le serveur peut gérer lui-même le certificat, ou se placer derrière un proxy HTTPS (voir Derrière un proxy HTTPS).
  • Un nom d'hôte dédié, par exemple save2erp.mon-entreprise.ch. Deux serveurs Save2ERP ne doivent pas partager le même nom d'hôte, sauf avec la variable COOKIE_PREFIX (voir Variables du .env).
  • Un compte de service qui peut lire le dossier de l'application et écrire dans ses dossiers logs/ et data/.
  • Une seule instance par client : avec une licence limitée, le registre des utilisateurs est un fichier local.

Réseau ​

DeVersPourquoi
Postes des utilisateurs (Word)Serveur Save2ERP, en HTTPSPages du panneau et envoi des documents.
Postes des utilisateursServeur OAuth2 du système cibleFenêtre de connexion de l'utilisateur.
Serveur Save2ERPServeur OAuth2 et API REST du système cibleJetons et envoi des documents.
Serveur Save2ERPlogin.microsoftonline.comVérification de l'identité Microsoft (licence limitée uniquement).

Si le système cible utilise un certificat émis par une autorité interne, le serveur Save2ERP doit la connaître : avec Docker, voir Docker.

Système cible ​

L'équipe du système cible doit fournir :

  • un client OAuth2 déclaré pour Save2ERP, avec l'adresse de retour du serveur (https://<serveur>/auth/callback), son identifiant, son secret et le scope à demander ;
  • les services REST de vérification et d'envoi des pièces jointes, selon le contrat d'API ;
  • des documents Word qui portent les propriétés de Save2ERP (voir Préparer les documents Word).

Microsoft 365 et Word ​

BesoinConcerne
Word pour Windows, Mac ou le web, avec un compte professionnel Microsoft 365Tous les utilisateurs.
Prise en charge de l'authentification imbriquée (ensemble d'API NestedAppAuth 1.1)Licence limitée en nombre d'utilisateurs. Sinon, le panneau affiche « Identification impossible ».
Ensemble d'API WordApi 1.3Bouton « Ouvrir une copie », masqué sur les versions plus anciennes.
Consentement administrateur à l'application Save2ERP dans Microsoft Entra IDLicence limitée (voir Déployer dans Microsoft 365).

Word pour le web fonctionne uniquement si le navigateur accepte les cookies tiers :

NavigateurWord pour le web
Chrome, EdgeFonctionne avec les réglages par défaut. Bloqué en navigation privée, si l'utilisateur bloque les cookies tiers, ou par une stratégie d'entreprise (BlockThirdPartyCookies).
SafariNon pris en charge : cookies tiers bloqués par défaut.
FirefoxNon pris en charge : cookies tiers isolés par défaut.

Word pour Windows et pour Mac ne sont pas concernés.