Prérequis
Fichiers remis par Swiss Computing
| Fichier | Rôle |
|---|---|
| Archive ZIP de l'application, ou image Docker | Le serveur Save2ERP (voir Installer en production). |
license.lic | La 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 variableCOOKIE_PREFIX(voir Variables du .env). - Un compte de service qui peut lire le dossier de l'application et écrire dans ses dossiers
logs/etdata/. - Une seule instance par client : avec une licence limitée, le registre des utilisateurs est un fichier local.
Réseau
| De | Vers | Pourquoi |
|---|---|---|
| Postes des utilisateurs (Word) | Serveur Save2ERP, en HTTPS | Pages du panneau et envoi des documents. |
| Postes des utilisateurs | Serveur OAuth2 du système cible | Fenêtre de connexion de l'utilisateur. |
| Serveur Save2ERP | Serveur OAuth2 et API REST du système cible | Jetons et envoi des documents. |
| Serveur Save2ERP | login.microsoftonline.com | Vé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
| Besoin | Concerne |
|---|---|
| Word pour Windows, Mac ou le web, avec un compte professionnel Microsoft 365 | Tous 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.3 | Bouton « Ouvrir une copie », masqué sur les versions plus anciennes. |
| Consentement administrateur à l'application Save2ERP dans Microsoft Entra ID | Licence limitée (voir Déployer dans Microsoft 365). |
Word pour le web fonctionne uniquement si le navigateur accepte les cookies tiers :
| Navigateur | Word pour le web |
|---|---|
| Chrome, Edge | Fonctionne 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). |
| Safari | Non pris en charge : cookies tiers bloqués par défaut. |
| Firefox | Non pris en charge : cookies tiers isolés par défaut. |
Word pour Windows et pour Mac ne sont pas concernés.