Creazione di connessioni globali

Le connessioni globali consentono a Oracle Fusion Cloud Enterprise Data Management di eseguire l'integrazione con sistemi esterni. Alcuni tipi di connessione globale vengono utilizzati per condividere dati con applicazioni esterne, mentre altri vengono utilizzati per inviare dati a servizi esterni per la convalida e la verifica.

Sono supportati i seguenti tipi di connessione:

Convalida esterna: consente di inviare le informazioni sulla richiesta a un sistema esterno tramite una chiamata all'API REST e di ricevere le informazioni sulla convalida.
Archiviazione BLOB di Azure di Microsoft: consente di inviare i dati a un contenitore di file di Microsoft Azure Blob Storage.
Verifica indirizzi, e-mail e telefono Oracle: consente di verificare gli indirizzi nelle richieste connettendosi a un servizio di verifica esterno.
Oracle Cloud EPM: invia dati alla posta in entrata di Enterprise Performance Management per l'utilizzo da parte di un processo di importazione di metadati.
Oracle Cloud ERP: invia dati a un account documento di Universal Content Management (UCM) per l'utilizzo da parte di un processo di importazione di dati basati su file (FBDI, File Based Data Import).
Memorizzazione oggetti Oracle: utilizzata come adattatore tecnologico per sistemi esterni per uso più generico.

Casi d'uso

Condivisione dei dati

Le connessioni globali a Archiviazione BLOB di Azure di Microsoft possono essere utilizzate per trasferire l'output da estrazioni e pacchetti di estrazione in un contenitore di file di Microsoft Azure Blob Storage.
Le connessioni globali a Oracle Cloud ERP possono essere utilizzate per trasferire dati quali combinazioni di account, set di mapping e set di valori correlati per l'importazione in Financials Cloud.
Le connessioni globali a Oracle Cloud EPM possono essere utilizzate nei modi illustrati di seguito.
- Le applicazioni Universali che gestiscono il processo aziendale Riconciliazione conti possono utilizzare le connessioni globali per inviare i profili alla posta in entrata dell'applicazione.
- Le applicazioni Universali che gestiscono le dimensioni per il processo aziendale Profitability and Cost Management possono utilizzare le connessioni globali per inviare i file di metadati alla cartella profitinbox.
- Per inviare i file di mapping alla posta in entrata Data Management

Convalida e verifica

Le connessioni globali per le convalide esterne consentono di convalidare elementi richiesta in Cloud EDM utilizzando le regole business e i dati di riferimento che risiedono in un sistema esterno. Fare riferimento a Convalide customizzate esterne.
Le connessioni globali al servizio Verifica indirizzi, e-mail e telefono Oracle consentono di verificare gli indirizzi nelle richieste. Fare riferimento alla sezione Integrazione con il servizio Verifica indirizzi, e-mail e telefono Oracle.

È possibile limitare i tipi di connessione in modo che possano essere utilizzati solo da applicazioni specifiche in Cloud EDM. Le connessioni globali al servizio Verifica indirizzi, e-mail e telefono Oracle si applicano a tutte le applicazioni.

Creazione di una connessione globale

Nota:

Per creare connessioni globali è necessario essere un Amministratore servizi.

Considerazioni

Dopo la creazione di una connessione globale, sarà possibile utilizzarla in un'estrazione. È possibile utilizzare una connessione globale in più estrazioni, ma ogni estrazione può utilizzare solo una connessione globale.

Nota:
Non è possibile utilizzare un tipo di connessione di Verifica indirizzi, e-mail e telefono Oracle in un'estrazione.
Non è possibile cambiare il tipo di connessione dopo avere creato una connessione globale.
Le connessioni globali non vengono utilizzate per le importazioni ed esportazioni delle applicazioni. Vengono invece utilizzate le informazioni di connessione all'applicazione specificate durante la registrazione di quest'ultima.
I parametri specificati per una connessione globale sono determinati dal tipo di connessione.
Le connessioni globali alle applicazioni Oracle Cloud EPM e Oracle Cloud ERP supportano l'autenticazione di base e OAuth 2. È necessario registrare un client OAuth 2 per ogni connessione globale. Fare riferimento alla sezione Utilizzo di OAuth2 per le connessioni applicazione e le connessioni globali.
Le connessioni globali alla memorizzazione oggetti Oracle supportano l'autenticazione di base e l'autenticazione con la chiave di firma API.
La connessione globale a Verifica indirizzi, e-mail e telefono Oracle supporta solo l'autenticazione OAuth2.
Le connessioni globali per le convalide esterne supportano solo l'autenticazione di base.

Per creare una connessione globale, procedere come segue:

Dal cluster Connessioni fare clic su Crea.
Selezionare il tipo di connessione:
- Convalida esterna
- Archiviazione BLOB di Azure di Microsoft
- Verifica indirizzi, e-mail e telefono Oracle
  
  Nota:
  È possibile creare una sola connessione globale per Verifica indirizzi, e-mail e telefono Oracle.
- Oracle Cloud EPM
- Oracle Cloud ERP
- Memorizzazione oggetti Oracle
Immettere un nome e, facoltativamente, una descrizione per la connessione, quindi fare clic su Crea.
La connessione globale viene visualizzata nell'inspector delle connessioni.

Fare clic su Modifica e specificare i parametri per la connessione. I parametri specificati dipendono dal tipo di connessione.

Parametri della convalida esterna:

Campo	Descrizione
Posizione	URL dell'endpoint REST di convalida esterna. Viene eseguita un'operazione `GET` per eseguire il test della connessione e viene eseguita un'operazione `POST` per eseguire una convalida. Esempio: `https://externalhostname.example.com/api/rest/externalValidation`
Nome utente/password	Credenziali per l'autenticazione di base.
Dimensione massima batch	Numero massimo di nodi che devono essere convalidati dal sistema esterno in un singolo batch. Fino a 10.000. Il valore predefinito è 1.000.
Numero massimo processi concorrenti	Numero massimo di processi di convalida concorrenti che devono essere eseguiti dal sistema esterno. Fino a 3. Il valore predefinito è 1.

Parametri di Archiviazione BLOB di Azure di Microsoft Azure:

Campo	Descrizione
Posizione	URL dell'account Archiviazione BLOB di Azure di Microsoft. Ad esempio: `https://myblobstorageaccount.blob.core.windows.net` Nota: l'URL deve contenere il nome dell'account Archiviazione BLOB di Azure (`myblobstorageaccount` nell'esempio qui sopra). Questo account deve disporre dell'assegnazione ruolo Collaboratore ai dati del BLOB di archiviazione in Azure.
ID tenant	ID tenant per la registrazione dell'applicazione nel tenant Microsoft Azure.
ID client	ID applicazione (client) di un'entità del servizio nel tenant Microsoft Azure.
Segreto client	Valore del segreto client nel tenant Microsoft Azure.
Nome contenitore predefinito	Contenitore di memorizzazione dati in cui scrivere i dati nel tenant Microsoft Azure. Il contenitore deve esistere nel tenant Azure.
Cartella secondaria predefinita	Facoltativo: cartella secondaria all'interno del contenitore in cui scrivere i dati nel tenant Microsoft Azure. Nota: se la cartella secondaria specificata non esiste, verrà creata quando l'estrazione o il pacchetto di estrazione viene eseguito in questa connessione. È possibile specificare altre cartelle secondarie utilizzando il carattere barra (/) (ad esempio, `Application/Extract Data`).

Parametri di Verifica indirizzi, e-mail e telefono Oracle:

Campo	Descrizione
Posizione	URL del server Verifica indirizzi, e-mail e telefono Oracle Ad esempio: `https://mydataservice-myidentitydomain.data.us2.oraclecloud.com` Attenzione: Se si incolla l'indirizzo dal browser, non includere il contesto (ad esempio, `/data/ui`) nell'URL.
ID client	ID client OAuth da utilizzare per la connessione al servizio di verifica indirizzo. Nota: è necessario creare credenziali client OAuth per il servizio Verifica indirizzi, e-mail e telefono Oracle. Fare riferimento a Come iniziare con Verifica indirizzi, e-mail e telefono in Utilizzo di Verifica indirizzi, e-mail e telefono Oracle.
Segreto client	Segreto client OAuth da utilizzare per la connessione al servizio di verifica indirizzo.

Parametri di Oracle Cloud EPM:

Campo	Descrizione
Posizione	URL per la cartella in entrata EPM. Ad esempio: `https://acme-test-epmidm.epm.us-phoenix-1.ocs.oraclecloud.com` Attenzione: Se si incolla l'indirizzo dal browser, non includere il contesto (ad esempio, `/epmcloud`) nell'URL.
Tipo di autenticazione	Selezionare un'opzione. Base: utilizzare le credenziali utente fornite per l'autenticazione. OAuth: utilizza ID e token OAuth 2 per l'autenticazione. (Disponibile solo per ambienti con architettura Oracle Cloud Infrastructure (OCI)/Gen 2.) Utilizzo di OAuth2 per le connessioni applicazione e le connessioni globali
Cartella predefinita (facoltativa)	Cartella predefinita per l'invio dei file di estrazione negli ambienti Cloud EPM: Cartella in entrata dell'applicazione predefinita Planning, FreeForm, Financial Consolidation and Close, Enterprise Profitability and Cost Management Cartella Data Management (ad esempio `inbox/repository`) Cartella posta in entrata Profitability and Cost Management (ad esempio `profitinbox`)
Parametri di autenticazione di base:
Nome utente/password	Credenziali necessarie per l'autenticazione di base
Dominio di Identity (facoltativo)	Dominio di Identity da aggiungere davanti al nome utente durante l'autorizzazione.
Parametri di autenticazione OAuth:
ID client	ID client per il client creato per le connessioni globali.
Token di accesso	Token di accesso per il client creato per le connessioni globali.
Token di aggiornamento	Token di aggiornamento per il client creato per le connessioni globali.

Parametri di Oracle Cloud ERP:

Campo	Descrizione
Posizione	URL per il server EPM. Ad esempio: `https://erp.mycloud.com`
Tipo di autenticazione	Selezionare un'opzione. Base: utilizzare le credenziali utente fornite per l'autenticazione. OAuth: utilizza ID e token OAuth 2 per l'autenticazione. (Disponibile solo per ambienti con architettura Oracle Cloud Infrastructure (OCI)/Gen 2.) Utilizzo di OAuth2 per le connessioni applicazione e le connessioni globali
Account documento predefinito	Cartella in cui estrarre il file in Oracle Cloud ERP. Ad esempio, `fin/generalLedger/import`.
Parametri di autenticazione di base:
Nome utente/password	Credenziali necessarie per l'autenticazione di base
Dominio di Identity (facoltativo)	Dominio di Identity da aggiungere davanti al nome utente durante l'autorizzazione.
Parametri di autenticazione OAuth:
URL token IDCS	Server di autenticazione del provider. Utilizzato per scambiare un codice di autorizzazione per un token di accesso.
ID client	ID client per il client creato per le connessioni globali.
Ambito	Fornisce un metodo per gestire il livello di accesso concessa a un JSON Web Token.
Alias certificato	Alias specificato quando il certificato è stato importato in Cloud ERP.
Caricamento chiave privata	File di certificato importato in Cloud ERP. Fare clic su Posizione file di caricamento per caricare il file. Il file deve avere l'estensione `.PEM`.

Parametri Oracle Object Storage:

Campo	Descrizione
Posizione	URL Swift del bucket Oracle Object Storage Cloud. Il formato dell'URL è `https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace`, dove: `host name` (con il tipo di API Swift) è ad esempio `swiftobjectstorage`. `region_identifier` è l'infrastruttura Oracle Cloud (OCI) di hosting, ad esempio `us-phoenix-1`. Fare riferimento alla sezione Aree e domini di disponibilità. `namespace` è il contenitore di livello superiore di tutti i gruppi e oggetti. Ad ogni tenant dell'infrastruttura Oracle Cloud viene assegnato il nome di uno spazio dei nomi di memorizzazione degli oggetti immutabile e generato dal sistema in fase di creazione dell'account. Suggerimento: L'URL Swift dell'area di memorizzazione oggetti Oracle deve includere la versione e lo spazio dei nomi. Non includere una barra alla fine del parametro della posizione.
Tipo di autenticazione	Selezionare il metodo di autenticazione Base o Chiave di firma API.
Base
Nome utente/password	Credenziali necessarie per l'autenticazione, come indicato di seguito. Generare un token di autenticazione (fare riferimento alla sezione Per creare un token di autenticazione nella documentazione di Oracle Cloud Infrastructure). Per Nome utente, immettere il nome utente OCI per il quale è stato generato il token di autenticazione. Per Password, immettere il token di autenticazione generato. Questo parametro fa distinzione tra maiuscole e minuscole.
Chiave di firma API
OCID tenancy OCID utente Impronta digitale chiave pubblica Caricamento chiave privata	Credenziali necessarie per una chiave di firma API, come indicato di seguito. Nella console Oracle Cloud generare una chiave di firma API. Fare riferimento a Come generare una chiave di firma API nella guida per sviluppatori Oracle Cloud Infrastructure. Dalla console scaricare la chiave privata e salvarla nella directory `.oci`, quindi fare clic su Aggiungi. I parametri per la chiave di firma vengono visualizzati nella console. Copiare i parametri riportati di seguito dalla console e incollarli in Cloud EDM. In OCID tenancy incollare il valore tenancy dalla console. In OCID utente incollare il valore Utente dalla console. In Impronta chiave pubblica incollare il valore Impronta dalla console. In Caricamento chiave privata fare clic su Carica e caricare il file di chiave privata scaricato nel passo b.
Bucket predefinito (facoltativo) Nota: questo campo è obbligatorio per eseguire il test della connessione.	Contenitore in cui memorizzare il file estratto nello spazio dei nomi per la memorizzazione oggetti. Questo parametro fa distinzione tra maiuscole e minuscole.
Cartella secondaria predefinita (facoltativa)	Cartella secondaria del bucket predefinito in cui scrivere il file di estrazione. Se la cartella secondaria che si specifica non esiste, verrà creata. Questo parametro fa distinzione tra maiuscole e minuscole.

(Facoltativo): In Applicazioni supportate fare clic su Specificati, quindi selezionare le applicazioni che possono utilizzare questa connessione globale.
Fare clic su Test della connessione per convalidare i dettagli della connessione.

Nota:
Per le connessioni di Memorizzazione oggetti Oracle è necessario immettere un bucket predefinito per testare la connessione.
Fare clic su Salva.

Nota:
Prima di poter salvare le connessioni, è necessario risolvere tutti i relativi problemi. Se mancano campi obbligatori nei dettagli di qualsiasi connessione, per tale connessione vengono visualizzati un indicatore e un errore che indica la presenza di problemi da risolvere in una o più connessioni.

Per eliminare una connessione globale, dalla colonna Azioni fare clic su e quindi su Elimina. Non è possibile eliminare una connessione globale che viene utilizzata da un'estrazione. Non è possibile eliminare una connessione globale Verifica indirizzi, e-mail e telefono Oracle se è utilizzata da una proprietà indirizzo.