Création de connexions globales

Cas d'emploi

Partage de données

• Les connexions globales à Microsoft Azure Blob Storage peuvent être utilisées pour transférer la sortie des extractions et des packages d'extractions vers un conteneur de fichiers Microsoft Azure Blob Storage.
• Les connexions globales à Oracle Cloud ERP peuvent servir à transférer des données telles que des combinaisons de comptes, des ensembles de mappings et des ensembles de valeurs connexes pour l'import dans Financials Cloud.
• Vous pouvez employer les connexions globales à Oracle Cloud EPM aux fins suivantes :
  • Les applications universelles qui gèrent les processus métier Account Reconciliation peuvent utiliser les connexions globales pour envoyer des profils à la boîte de réception de l'application.
  • Les applications universelles qui gèrent les dimensions pour le processus métier Profitability and Cost Management peuvent utiliser les connexions globales pour envoyer des fichiers de métadonnées à profitinbox.
  • Envoyer des fichiers de mapping à une boîte de réception Data Management.

Validation et vérification

• Les connexions globales pour les validations externes vous permettent de valider les éléments de demande dans Cloud EDM à l'aide de règles métier et de données de référence qui résident dans un système externe. Reportez-vous à Validations personnalisées externes.
• Les connexions globales au service Oracle de vérification des adresses, des courriels et des numéros de téléphone vous permettent de vérifier les adresses dans les demandes. Reportez-vous à la section Intégration au service Oracle de vérification des adresses, des courriels et des numéros de téléphone.

Vous pouvez restreindre les types de connexion de sorte qu'ils ne puissent être utilisés que par des applications spécifiques dans Cloud EDM. Les connexions globales au service Oracle de vérification des adresses, des courriels et des numéros de téléphone servent à toutes les applications.

Création d'une connexion globale

Remarques

• Une fois que vous avez créé une connexion globale, vous pouvez l'utiliser dans une extraction. Vous pouvez utiliser une connexion globale dans plusieurs extractions, mais chaque extraction ne peut utiliser qu'une seule connexion globale.

  Remarque :

  Vous ne pouvez pas utiliser un type de connexion de service Oracle de vérification des adresses, des courriels et des numéros de téléphone dans une extraction.
• Vous ne pouvez pas modifier le type de connexion après avoir créé une connexion globale.

• Les connexions globales ne sont pas utilisées pour les imports et les exports d'application. Ce sont les informations de connexion d'application que vous indiquez lors de l'enregistrement de l'application qui sont utilisées à la place.

• Les paramètres indiqués pour une connexion globale sont déterminés par le type de connexion.
• Les connexions globales aux applications Oracle Cloud EPM et Oracle Cloud ERP prennent en charge l'authentification de base et OAuth2. Vous devez enregistrer un client OAuth2 pour chaque connexion globale. Reportez-vous à la section Utilisation d'OAuth2 pour les connexions d'application et globales.
• Les connexions globales à Oracle Object Storage prennent en charge l'authentification de base et l'authentification par clé de signature d'API.
• La connexion globale au service Oracle de vérification des adresses, des courriels et des numéros de téléphone prend uniquement en charge l'authentification OAuth2.
• Les connexions globales pour les validations externes prennent uniquement en charge l'authentification de base.

Pour créer une connexion globale, procédez comme suit :

1. Dans le cluster Connexions, cliquez sur Créer.
2. Sélectionnez le type de connexion :
   • Validation externe
   • Microsoft Azure Blob Storage
   • Service Oracle de vérification des adresses, des courriels et des numéros de téléphone

     Remarque :

     Vous ne pouvez créer qu'une seule connexion globale pour le service Oracle de vérification des adresses, des courriels et des numéros de téléphone.
   • Oracle Cloud EPM
   • Oracle Cloud ERP
   • Oracle Object Storage
3. Entrez le nom et, éventuellement, la description de la connexion, puis cliquez sur Créer.

   La connexion globale est affichée dans l'inspecteur de connexion.

4. Cliquez sur Modifier et indiquez les paramètres de la connexion. Les paramètres que vous indiquez sont dépendants du type de connexion :
   • Paramètres de validation externe :

     Champ	Description
     Emplacement	URL de l'adresse REST de validation externe. Une opération GET est effectuée pour tester la connexion et une opération POST est exécutée pour exécuter une validation. Exemple : https://externalhostname.example.com/api/rest/externalValidation
     Nom d'utilisateur/Mot de passe	Informations d'identification pour l'authentification de base.
     Taille maximale de lot	Nombre maximal de noeuds devant être validés par le système externe dans un seul lot (jusqu'à 10 000). La valeur par défaut est 1 000.
     Nombre maximal de processus simultanés	Nombre maximal de processus de validation simultanés devant être exécutés par le système externe (jusqu'à 3). La valeur par défaut est 1.

   • Paramètres Microsoft Azure Blob Storage :

     Champ	Description
     Emplacement	URL du compte Microsoft Azure Blob Storage. Par exemple : https://myblobstorageaccount.blob.core.windows.net Remarque : l'URL doit contenir le nom de votre compte Azure Blob Storage (myblobstorageaccount dans l'exemple ci-dessus). Ce compte doit disposer de l'affectation de rôle Contributeur aux données Blob du stockage dans Azure.
     ID de locataire	ID de locataire pour l'enregistrement de l'application dans le locataire Microsoft Azure.
     ID de client	ID d'application (client) d'un principal de service dans le locataire Microsoft Azure.
     Clé secrète de client	Valeur de la clé secrète de client dans le locataire Microsoft Azure.
     Nom du conteneur par défaut	Conteneur de stockage de données dans lequel écrire des données dans le locataire Microsoft Azure. Le conteneur doit exister dans le locataire Azure.
     Sous-dossier par défaut	Facultatif : sous-dossier du conteneur dans lequel écrire des données dans le locataire Microsoft Azure. Remarque : si le sous-dossier que vous indiquez n'existe pas, il sera créé lorsque l'extraction ou le package d'extractions sera exécuté sur cette connexion. Vous pouvez spécifier d'autres sous-dossiers à l'aide de la barre oblique (/) (par exemple, Application/Extract Data).

   • Paramètres pour le service Oracle de vérification des adresses, des courriels et des numéros de téléphone :

     Champ	Description
     Emplacement	URL du serveur Oracle de vérification des adresses, des courriels et des numéros de téléphone. Par exemple : https://mydataservice-myidentitydomain.data.us2.oraclecloud.com Prudence : Si vous collez l'adresse à partir de votre navigateur, n'incluez pas le contexte (par exemple, /data/ui) dans votre URL.
     ID de client	ID de client OAuth à utiliser lors de la connexion au service de vérification des adresses. Remarque : vous devez créer des informations d'identification de client OAuth pour le service Oracle de vérification des adresses, des courriels et des numéros de téléphone. Reportez-vous à la section Premiers pas avec le service de vérification des adresses, des courriels et des numéros de téléphone du guide Utilisation du service Oracle de vérification des adresses, des courriels et des numéros de téléphone.
     Clé secrète de client	Clé secrète de client OAuth à utiliser lors de la connexion au service de vérification des adresses.

   • Paramètres Oracle Cloud EPM :

     Champ	Description
     Emplacement	URL de la boîte de réception EPM. Par exemple : https://acme-test-epmidm.epm.us-phoenix-1.ocs.oraclecloud.com Prudence : Si vous collez l'adresse à partir de votre navigateur, n'incluez pas le contexte (par exemple, /epmcloud) dans votre URL.
     Type d'authentification	Sélectionnez l'une des options suivantes : De base : utilisez les informations d'identification utilisateur fournies pour vous authentifier. OAuth : utilisez les jetons et les ID OAuth2 pour vous authentifier. (Uniquement disponible pour les environnements sur une architecture Oracle Cloud Infrastructure [OCI]/Gen 2.) Utilisation d'OAuth2 pour les connexions d'application et globales
     Dossier par défaut (Facultatif)	Dossier par défaut vers lequel envoyer les fichiers d'extraction dans les environnements Cloud EPM : Boîte de réception d'application par défaut Planning, FreeForm, Financial Consolidation and Close, Enterprise Profitability and Cost Management Dossier Data Management (par exemple, inbox/repository) Boîte de réception Profitability and Cost Management (par exemple, profitinbox)
     Paramètres d'authentification de base :
     Nom d'utilisateur/Mot de passe	Informations d'identification requises pour l'authentification de base.
     Domaine d'identité (facultatif)	Domaine d'identité à ajouter devant le nom d'utilisateur lors de l'autorisation.
     Paramètres d'authentification OAuth :
     ID de client	ID du client créé pour les connexions globales.
     Jeton d'accès	Jeton d'accès du client créé pour les connexions globales.
     Jeton d'actualisation	Jeton d'actualisation du client créé pour les connexions globales.

   • Paramètres Oracle Cloud ERP :

     Champ	Description
     Emplacement	URL du serveur EPM. Par exemple : https://erp.mycloud.com
     Type d'authentification	Sélectionnez l'une des options suivantes : De base : utilisez les informations d'identification utilisateur fournies pour vous authentifier. OAuth : utilisez les jetons et les ID OAuth2 pour vous authentifier. (Uniquement disponible pour les environnements sur une architecture Oracle Cloud Infrastructure [OCI]/Gen 2.) Utilisation d'OAuth2 pour les connexions d'application et globales
     Compte de document par défaut	Dossier d'Oracle Cloud ERP dans lequel extraire le fichier. Par exemple, fin/generalLedger/import.
     Paramètres d'authentification de base :
     Nom d'utilisateur/Mot de passe	Informations d'identification requises pour l'authentification de base.
     Domaine d'identité (facultatif)	Domaine d'identité à ajouter devant le nom d'utilisateur lors de l'autorisation.
     Paramètres d'authentification OAuth :
     URL de jeton IDCS	Serveur d'authentification du fournisseur. Permet d'échanger un code d'autorisation pour un jeton d'accès.
     ID de client	ID du client créé pour les connexions globales.
     Portée	Fournit une méthode pour régir le volume d'accès accordé à un jeton Web JSON.
     Alias de certificat	Alias indiqué lors de l'import du certificat dans Cloud ERP.
     Chargement de clé privée	Fichier de certificat importé dans Cloud ERP. Cliquez sur Emplacement de fichier de téléchargement pour charger le fichier. Le fichier doit avoir l'extension .PEM.

   • Paramètres Oracle Object Storage :

     Champ	Description
     Emplacement	URL Swift du bucket Oracle Object Storage Cloud. Le format de l'URL est https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace, où : host name utilise le type d'API Swift. Par exemple, swiftobjectstorage. region_identifier est la région d'hébergement Oracle Cloud Infrastructure (OCI). Par exemple, us-phoenix-1. Reportez-vous à la section Régions et domaines de disponibilité. namespace est le conteneur de niveau supérieur pour tous les buckets et les objets. Un nom unique d'espace de noms Object Storage généré par le système et immuable est affecté à chaque locataire Oracle Cloud Infrastructure au moment de la création de compte. Conseil : L'URL Swift de la banque d'objets Oracle doit inclure la version et l'espace de noms. N'incluez pas de barre oblique de fin dans le paramètre Emplacement.
     Type d'authentification	Sélectionnez la méthode d'authentification de base ou par clé de signature d'API.
     De base
     Nom d'utilisateur/Mot de passe	Informations d'identification requises pour l'authentification. Procédez comme suit : Générez un jeton d'authentification (reportez-vous à la section Procédure de création d'un jeton d'authentification de la documentation Oracle Cloud Infrastructure). Pour Nom d'utilisateur, entrez le nom d'utilisateur OCI pour lequel le jeton d'authentification a été généré. Pour Mot de passe, entrez le jeton d'authentification généré. Ce paramètre respecte la casse.
     Clé de signature d'API
     OCID de location OCID utilisateur Empreinte de clé publique Chargement de clé privée	Informations d'identification requises pour une clé de signature d'API, comme suit : Dans la console Oracle Cloud, générez une clé de signature d'API. Reportez-vous à la section Procédure de génération d'une clé de signature d'API dans le guide du développeur Oracle Cloud Infrastructure. A partir de la console, téléchargez la clé privée et enregistrez-la dans votre répertoire .oci, puis cliquez sur Ajouter. Les paramètres de la clé de signature sont affichés dans la console. Copiez les paramètres suivants à partir de la console et collez-les dans Cloud EDM : Dans OCID de location, collez la valeur de location. Dans OCID utilisateur, collez la valeur d'utilisateur. Dans Empreinte de clé publique, collez la valeur d'empreinte. Dans Chargement de clé privée, cliquez sur Charger et chargez le fichier de clé privée que vous avez téléchargé à l'étape b.
     Stockage temporaire par défaut (facultatif) Remarque : ce champ est requis pour tester votre connexion.	Conteneur permettant de stocker le fichier extrait dans l'espace de noms du stockage d'objet. Ce paramètre respecte la casse.
     Sous-dossier par défaut (facultatif)	Sous-dossier du stockage temporaire par défaut dans lequel écrire le fichier d'extraction. Si le sous-dossier que vous indiquez n'existe pas, il est créé. Ce paramètre respecte la casse.

5. (Facultatif) Dans Applications prises en charge, cliquez sur Spécifié, puis sélectionnez les applications pouvant utiliser la connexion globale.
6. Cliquez sur Tester la connexion pour valider les détails de connexion.

   Remarque :

   Pour les connexions à Oracle Object Storage, vous devez entrer un stockage temporaire par défaut afin de tester la connexion.
7. Cliquez sur Enregistrer.

   Remarque :

   Vous devez résoudre l'ensemble des problèmes de toutes les connexions pour pouvoir enregistrer les connexions. Si des champs requis sont manquants dans les détails d'une connexion, un indicateur est affiché sur cette connexion et une erreur apparaît signalant que des connexions présentent des problèmes devant être résolus.

Pour supprimer une connexion globale, dans la colonne Actions, cliquez sur , puis sur Supprimer. Vous ne pouvez pas supprimer une connexion globale qui est utilisée par une extraction. Vous ne pouvez pas supprimer une connexion globale de service Oracle de vérification des adresses, des courriels et des numéros de téléphone si elle est utilisée par une propriété d'adresse.