Activation des services API sur SAP S/4HANA Cloud, Private Edition

Lors de la création d'intégrations personnalisées ou standard avec SAP S/4HANA® Private Cloud, le simple fait d'accorder des autorisations aux utilisateurs ne représente que la moitié du travail. Les interfaces cibles doivent être explicitement activées et publiées dans les cadres de communication du système.

Les environnements SAP S/4HANA utilisent trois architectures de communication distinctes : OData V2, OData V4 et SOAP Web Services. Comme elles s'exécutent sur des moteurs techniques distincts, elles sont activées à l'aide de transactions différentes.

Ce guide fournit un schéma directeur simple pour la publication des points de terminaison requis pour les données financières, les données de projet et les données de base.

Partie 1 : Activation des services OData V2 (Transaction /IWFND/MAINT_SERVICE)

Les API SAP REST traditionnelles utilisent l'architecture OData V2. Ces services doivent être ajoutés au catalogue de services de votre système et liés à un alias système pour activer leurs URL.

Inventaire des services Target V2

Cette méthode permet de vérifier et d'activer les services suivants :

• Plan comptable :API_CHARTOFACCOUNTS_SRV

• Comptes GL dans le plan comptable :API_GLACCOUNTINCHARTOFACCOUNTS_SRV

• Code de l'entreprise :API_COMPANYCODE_SRV

• Rapprochement bancaire :API_CN_BANK_RECONCILIAITON_SRV

• Partenaire commercial :API_BUSINESS_PARTNER

• Enterprise Project :API_ENTERPRISE_PROJECT_SRV (Veillez à ce que la version soit définie sur 0002 lors de la configuration)

• Processus de facturation des fournisseurs :API_SUPPLIERINVOICE_PROCESS_SRV

• Pièces jointes :API_CV_ATTACHMENT_SRV

• Éléments de documents comptables :API_OPLACCTGDOCITEMCUBE_SRV

• Éléments WBS :API_FINWBSELEMENT_SRV

• Commandes internes :API_INTERNALORDER_SRV

• Centre de profit :API_PROFITCENTER_SRV

Étapes d'activation

1. Exécutez la transaction /IWFND/MAINT_SERVICE dans le SAP GUI.

2. Consultez le tableau Catalogue des services. Si un service de la liste d'inventaire est manquant, cliquez sur le bouton Ajouter un service dans la barre d'outils supérieure.

3. Sur l'écran suivant, saisissez LOCAL dans le champ Alias de système.

4. Collez le nom technique de votre service cible (par exemple, API_COMPANYCODE_SRV) dans le champ Nom du service technique et appuyez sur Entrée.

5. Sélectionnez la ligne du service correspondant dans la grille des résultats de la recherche et cliquez sur Ajouter les services sélectionnés.

6. Dans la fenêtre contextuelle, attribuez un paquet (ou choisissez $TMP pour les tests locaux, non transportés) et confirmez.

7. Revenez à l'écran principal du catalogue, sélectionnez le service que vous venez d'ajouter et vérifiez sous Nœuds ICF (en bas à gauche) que le voyant d'état est vert. S'il est rouge, cliquez sur Nœud ICF > Activer.

Partie 2 : Publication des groupes de services OData V4 (Transaction /IWFND/V4_ADMIN)

Les applications S/4HANA modernes s'appuient sur l'architecture OData V4 haute performance. Contrairement à la version 2, les points d'extrémité OData V4 sont publiés en tant que groupes de services consolidés.

Inventaire des groupes de services Target V4

Publier les points d'extrémité de nouvelle génération suivants à l'aide du moteur de passerelle OData V4 :

Étapes d'activation

1. Exécutez la transaction /IWFND/V4_ADMIN dans le SAP GUI.

2. Dans la barre d'outils supérieure, cliquez sur le bouton Publier les groupes de services.

3. Saisissez LOCAL dans le champ Alias de système.

4. Saisissez votre ID de groupe de services cible à partir du tableau ci-dessus (par exemple, API_COST_CENTER) et cliquez sur Obtenir les groupes de services.

5. Sélectionnez l'élément de ligne du groupe de services dans la grille et cliquez sur Publier les groupes de services.

6. Fournissez une description si vous y êtes invité, sélectionnez votre paquet de développement (ou $TMP) et attribuez une demande de transport personnalisée si les règles de transport de votre paysage l'exigent.

7. Cliquez sur Confirmer. Le groupe de services apparaît maintenant dans votre catalogue V4 actif.

Partie 3 : Configuration simplifiée des services Web (via SOAMANAGER)

Pour le traitement des documents transactionnels et les transmissions de données en masse (comme la comptabilisation des écritures de journal ou le traitement des relevés bancaires), S/4HANA utilise des services Web SOAP entrants. Au lieu de cliquer sur un assistant de déploiement complexe pour chaque interface, vous pouvez les activer toutes en même temps à l'aide du gestionnaire de configuration simplifié.

Inventaire des services Web SOAP cibles

Activez les canaux de communication pour ces interfaces backend spécifiques :

• Comptabilisation des relevés bancaires :BANKSTATEMENTPOST_IN

• Effacement groupé des écritures comptables :JOURNALENTRYBULKCLEARINGREQUES

• Confirmation de l'écriture au journal :JOURNALENTRYCREATEREQUESTCONFI

Étapes de la configuration

1. Exécutez la transaction SOAMANAGER dans votre interface graphique SAP. Cela ouvrira automatiquement la console d'administration SOA Manager dans votre navigateur web.

2. Accédez à l'outil de configuration du service Web simplifié (situé sous l'onglet Administration des services) .

3. Dans le champ Modèle de recherche en haut de l'écran, tapez JOURNAL* (ou ciblez un service spécifique dans la liste) et cliquez sur Accéder.

4. Localisez vos services cibles dans les lignes de la grille.

5. Pour chaque service, il suffit de cocher les cases des colonnes Nom d'utilisateur/mot de passe (de base) et Certificat client X.509.

6. Cliquez sur le bouton Enregistrer dans la barre d'outils en haut à gauche.

Le système activera immédiatement les points d'extrémité et affichera un message d'activation réussie au bas de l'écran, de sorte que les interfaces seront immédiatement prêtes à recevoir des données.

Prochaines étapes

• Configuration d'un utilisateur technique dans SAP S/4HANA Cloud, Private Edition