Préparer la connexion au système ERP

Pour vous connecter au système ERP, vous devez :

Satisfait à certains prérequis
Obtenir l'URL du catalogue WSDL ou d'événements
Affecter les rôles requis à un utilisateur
Configurer ERP pour les abonnements aux événements
Vérifier la procédure de téléchargement des fichiers

Prérequis pour la création d'une connexion

Vous devez remplir les conditions préalables suivantes pour créer une connexion avec l'adaptateur Oracle Enterprise Resource Planning Cloud.

Prérequis	Description
S'abonner à Oracle Enterprise Resource Planning Cloud.	Cette action vous permet de créer un compte utilisateur Oracle Enterprise Resource Planning Cloud avec les privilèges appropriés. Vous spécifiez ce compte utilisateur lors de la création d'une connexion Oracle Enterprise Resource Planning Cloud sur la page Connexions.
Obtenez l'URL WSDL de service de catalogue Oracle Enterprise Resource Planning Cloud nécessaire ou l'URL de catalogue d'événements.	Vous devez indiquer un WSDL de service de catalogue de services Oracle Enterprise Resource Planning Cloud obligatoire (pour accéder aux business objects) et éventuellement une URL de catalogue d'événements (pour l'abonnement aux événements).
Affectez des rôles à l'utilisateur.	Assurez-vous que l'utilisateur Fusion Applications dispose des rôles requis. Ces rôles sont obligatoires pour activer des abonnements d'événement ou sélectionner des business objects.
S'abonner aux événements dans Oracle Enterprise Resource Planning Cloud	Pour vous abonner à des événements Oracle Enterprise Resource Planning Cloud dans une intégration, vous devez créer une clé CSF. Créez la clé CSF à partir de l'instance Oracle SOA Composer située dans le domaine Oracle Fusion Applications Supply Chain Management (SCM).
Chargez des fichiers en masse et insérez des données dans des tables d'application Oracle Enterprise Resource Planning Cloud.	L'adaptateur Oracle Enterprise Resource Planning Cloud prend en charge le chargement de données en masse dans Oracle Enterprise Resource Planning Cloud via l'intégration au système Universal Content Management (UCM). UCM permet de charger en masse des fichiers et d'insérer des données dans des tables d'application Oracle Enterprise Resource Planning Cloud.
Télécharger des fichiers vers Oracle WebCenter Content	L'adaptateur Oracle Enterprise Resource Planning Cloud prend en charge le chargement de fichiers vers Oracle WebCenter Content.

Les étapes permettant d'accomplir ces prérequis sont décrites dans les sections suivantes.

Obtenir le WSDL du service Oracle Enterprise Resource Planning Cloud

Vous devez obtenir le WSDL du catalogue de services Oracle Enterprise Resource Planning Cloud pour accéder à l'adaptateur entrant et sortant, et le configurer pour qu'il utilise soit des business objects, soit des services fonctionnels.

Pour configurer l'adaptateur Oracle Enterprise Resource Planning Cloud, vous devez disposer du WSDL serviceCatalog. Le WSDL serviceCatalog est un catalogue de tous les services affichés par l'instance Oracle Enterprise Resource Planning Cloud. Le catalogue présente les services de tous les modules, tels que le service financier, la gestion de projets, la gestion des commandes, la gestion des stocks, etc.

Pour Oracle Enterprise Resource Planning Cloud, version 12 et antérieure, le WSDL du catalogue de services est le suivant :

https://ERP Host Name/fndAppCoreServices/ServiceCatalogService?wsdl

Pour Oracle Enterprise Resource Planning Cloud, version 13, le WSDL du catalogue de services est le suivant :

https://ERP Host Name.fs.<data center>.oraclecloud.com/fscmService/ServiceCatalogService?WSDL

Affecter les rôles requis à un utilisateur d'intégration

Pour utiliser l'adaptateur Oracle Enterprise Resource Planning Cloud dans une intégration, vous devez affecter des rôles spécifiques à un utilisateur d'intégration.

La console de sécurité permet de gérer la sécurité de l'application, comme les rôles, les utilisateurs, les certificats et les tâches d'administration. L'accès à la console de sécurité est fourni par le rôle de gestionnaire de sécurité prédéfini. Accédez à la console de sécurité de l'une des manières suivantes :

Utilisez les tâches Gérer les rôles fonctionnels ou Gérer les responsabilités dans la zone de travail Configuration et maintenance.
Sélectionnez Navigateur > Outils > Console de sécurité.

Les rôles requis sont répertoriés dans la section Mise en route de cette solution.

Configurer Oracle Enterprise Resource Planning Cloud pour les abonnements d'événement

Vous devez créer une clé CSF pour vous abonner aux événements dans Oracle Enterprise Resource Planning Cloud. Cette clé est requise par la structure du gestionnaire d'événements lorsqu'elle appelle l'intégration. Les informations d'identification et de connexion de l'intégration sont gérées par la clé CSF. Créez la clé CSF dans Oracle SOA Composer.

Veillez à indiquer correctement les informations suivantes lors de la création de la clé CSF:

Créez le nom de clé CSF. Le nom doit être une combinaison de l'ID de service Oracle Identity Cloud Service et du nom de l'instance d'intégration.
1. Dans l'angle supérieur droit d'Oracle Integration, cliquez sur , puis sélectionnez A propos de.
2. Copiez la valeur de domaine d'identité (par exemple, idcs-638a2ce020e60c2881 ) et la valeur d'instance de service (par exemple, oic1575 ).
3. Assemblez d'abord la valeur de clé CSF avec le domaine d'identité et la seconde instance de service (aucun espace entre) : idcs-638a2ce020e60c2881oic1575 ).
Créez la clé CSF avec le compte utilisateur Oracle Integration auquel vous vous connectez à Oracle Integration et non le nom utilisateur créé lorsque vous vous êtes abonné à Oracle Enterprise Resource Planning Cloud.
Assurez-vous que le mot de passe de la clé CSF n'a pas expiré.

Configurer Oracle Enterprise Resource Planning Cloud :

Connectez-vous à Oracle SOA Composer avec un utilisateur disposant du rôle d'administrateur SOA. Obtenez le nom d'hôte et le port auprès de l'administrateur.
Par exemple :
Dans la version 12:
```
http://ERP_domain_URL:port/soa/composer
```
Dans la version 13:
```
 https://ERP instance name.fa.data center.oraclecloud.com/soa/composer
```
Cliquez sur Gérer la sécurité.
Ajoutez le nom de la clé CSF.
Indiquez le nom utilisateur et le mot de passe que vous entrez pour vous connecter à Oracle Integration.
N'entrez pas le nom utilisateur et le mot de passe créés lors de votre abonnement à Oracle Enterprise Resource Planning Cloud. L'utilisateur Oracle Integration doit exister dans Oracle Integration et le rôle ServiceUser lui a été affecté. L'entrée de clé CSF dans l'infrastructure Oracle Enterprise Resource Planning Cloud stocke les informations d'identification Oracle Integration utilisées par Oracle Enterprise Resource Planning Cloud. Lorsqu'Oracle Fusion Applications Cloud Service envoie des demandes sortantes à Oracle Integration (lors de l'exécution), il envoie les informations d'identification (nom utilisateur et mot de passe) de ce compte pour authentification.
Cliquez sur Inscrire.

Charger des fichiers en masse et insérer des données dans des tables d'application Oracle Enterprise Resource Planning Cloud

Vous devez satisfaire les prérequis suivants pour le chargement de fichiers en masse et l'insertion de données dans les tables d'application Oracle Enterprise Resource Planning Cloud.

Créez un utilisateur semblable à l'utilisateur de connexion d'adaptateur ERP Cloud sur la page Mon service. Cet utilisateur est lié au domaine de sécurité Oracle Integration WebLogic. Le nom utilisateur doit correspondre exactement au nom utilisateur Oracle ERP Cloud. Le mot de passe et l'adresse électronique peuvent être tous les éléments suivants : Veillez à sélectionner les rôles appropriés pour l'utilisateur Oracle ERP Cloud dans l'application Oracle ERP Cloud. L'utilisateur doit disposer des rôles SOAOperator et Intégration.
Importez les certificats nécessaires. Dans le navigateur, entrez l'URL WSDL du catalogue de services :
- Pour les versions 12 et antérieures :
```
 https://hostname:port/fndAppCoreServices/ServiceCatalogService?WSDL
```
- Pour la version 13:
```
https://hostname:port/fscmService/ServiceCatalogService?WSDL
```
Dans le langage WSDL, accédez à la section des certificats X509, qui se trouve dans l'élément <dsig:x509Data>.
Par exemple :

Description de l'illustration erp_certificates.png
Copiez la première et la seconde chaîne de certificat dans deux fichiers distincts. Par exemple, erp_cert1.cer et erp_cert2.cer.
Dans la boîte de dialogue Télécharger un certificat d'Oracle Integration, importez les deux certificats en tant que types de certificat de protection des messages et entrez des alias uniques.
Pour le chargement en masse des fichiers et l'insertion de données dans les tables d'application Oracle ERP Cloud, veillez à respecter les recommandations suivantes (c'est-à-dire le fichier de propriétés du fichier ZIP à télécharger vers Universal Content Management (UCM). Cette étape n'est requise que pour un callback ERP Cloud lors de l'exécution du travail.
- Le fichier manifeste attend les détails du processus d'import au format suivant :
```
job package name,job def name,manifest file name,job parameters (comma separated)
```
  Par exemple :
```
oracle/apps/ess/financials/payables/invoices/transactions,APXIIMPT,AP,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,INVOICE
```
- Le nom du fichier manifeste doit être un préfixe du nom du fichier ZIP réel s'il contient _. Sinon, il doit simplement s'agir du nom. Par exemple, si le nom du fichier ZIP est AP_301.zip, le nom du fichier manifeste doit être AP.properties et la troisième valeur du manifeste doit être le nom du fichier manifeste. Si le nom du fichier ZIP est AP.zip, le nom du fichier manifeste doit être AP.properties et la troisième valeur du manifeste doit être le nom du fichier manifeste.
- Un seul travail est pris en charge par action d'appel. Vous pouvez disposer de plusieurs entrées dans le fichier de propriétés de manifeste pour importer des données de la table d'interface vers les tables d'applications par lots de 10 (jusqu'à 5 pour le traitement parallèle). Par exemple, le fichier de données d'import de journal contient 10 livres. Le fichier de propriétés contient 10 entrées dont le nom de livre unique est un paramètre. Une fois le fichier de données chargé dans la table d'interface, le traitement d'importation comporte 10 sous-processus pour chaque livre.
Les prérequis suivants permettent de configurer l'intégration qui utilise la fonctionnalité d'import en masse :
Mettez en correspondance les paramètres suivants avec l'adaptateur Oracle ERP Cloud :
- Mettez en correspondance le paramètre ICSFileReference avec le paramètre File Reference de l'autre adaptateur (par exemple, l'adaptateur FTP, l'adaptateur REST ou l'adaptateur utilisé avec le paramètre ICSFileReference).
- Mappez le paramètre FileName du schéma source avec le schéma cible (le schéma cible est le schéma d'import en masse Oracle ERP Cloud). L'élément FileName doit être unique pour chaque demande.