Système cible : SAP
Cette page indique ce que Save2ERP attend d'un système SAP, et les informations à transmettre à l'administrateur du serveur Save2ERP.
Identifier le système
Chaque système SAP est identifié par son système logique, par exemple P01CLNT100. Ce nom est :
- écrit par SAP dans la propriété
S2E_SystemKeydes documents qu'il génère ; - utilisé par l'administrateur dans le nom des variables du serveur (
SAP_P01CLNT100_…, voir Configurer le serveur).
Les deux doivent être identiques.
Serveur OAuth2
Save2ERP utilise le serveur OAuth2 de SAP (transaction SOAUTH2), avec ces adresses, propres à chaque mandant :
| Service | Adresse |
|---|---|
| Autorisation | /sap/bc/sec/oauth2/authorize?sap-client=<mandant> |
| Jeton | /sap/bc/sec/oauth2/token?sap-client=<mandant> |
| Révocation (déconnexion) | /sap/bc/sec/oauth2/revoke?sap-client=<mandant> |
Dans SOAUTH2, déclarez un client OAuth2 pour Save2ERP :
- flux « authorization code » ; Save2ERP utilise aussi PKCE et le jeton de rafraîchissement ;
- adresse de retour : l'adresse publique du serveur Save2ERP suivie de
/auth/callback, par exemplehttps://save2erp.mon-entreprise.ch/auth/callback, à l'identique de la variableOAUTH_CALLBACK_URI; - scope : celui du service REST des pièces jointes ;
- un identifiant et un secret, transmis à l'administrateur de Save2ERP par un canal sûr.
Lors de sa première connexion, l'utilisateur voit la page d'autorisation de SAP et accepte que Word enregistre des documents en son nom. Avec l'authentification unique (SSO), il n'a en général pas à saisir de mot de passe.
Services REST
Les trois services obligatoires du contrat d'API doivent être exposés par SAP, sous une adresse de base commune (APIBASE), par exemple https://sap.mon-entreprise.ch:44300/rest. Save2ERP ajoute à chaque appel le paramètre sap-client avec le mandant.
Pour proposer le mode concepteur, SAP expose aussi deux services facultatifs : les droits de l'utilisateur (/attachments/permissions) et le XML des modèles (/attachments/readTemplateXml).
Si vos chemins diffèrent des chemins par défaut (/attachments, /attachments/check, /attachments/healthcheck, /attachments/permissions, /attachments/readTemplateXml), indiquez-les à l'administrateur.
Si une passerelle devant SAP exige une clé d'API, indiquez le nom de l'en-tête HTTP et sa valeur : Save2ERP l'ajoute à chaque appel.
Informations à transmettre à l'administrateur
| Information | Variable du serveur Save2ERP |
|---|---|
| Système logique | nom des variables : SAP_<système>_… |
| Environnement : SBX, DEV, QUAL ou PROD | SAP_<système>_ENV |
| SID | SAP_<système>_SID |
| Mandant | SAP_<système>_MANDT |
| Adresse de base des services REST | SAP_<système>_APIBASE |
| Adresse du serveur OAuth2 | SAP_<système>_OAUTH_SERVER |
| Identifiant et secret du client OAuth2 | SAP_<système>_OAUTH_CLIENT_ID, SAP_<système>_OAUTH_CLIENT_SECRET |
| Scope | SAP_OAUTH_SCOPE (ou SAP_<système>_OAUTH_SCOPE) |
| Chemins des services, s'ils diffèrent | SAP_<système>_ATTACHMENTS_PATH, _CHECK_PATH, _HEALTHCHECK_PATH, _PERMISSIONS_PATH, _TEMPLATE_PATH |
| Clé d'API d'une passerelle, si besoin | SAP_<système>_APIKEYNAME, SAP_<système>_APIKEY |
Si SAP utilise un certificat émis par une autorité interne, transmettez aussi le certificat de cette autorité : le serveur Save2ERP doit pouvoir le vérifier.
Messages
Les messages renvoyés par les services sont affichés tels quels dans Word : rédigez-les dans la langue de connexion SAP de l'utilisateur.