Show Menu
ARGOMENTI×

Configurare le origini dati

L'integrazione dei dati AEM Forms consente di configurare e connettersi a origini dati diverse. I seguenti tipi sono supportati out-of-the-box. Tuttavia, con poca personalizzazione, è possibile integrare anche altre origini dati.
  • Database relazionali - MySQL, Microsoft SQL Server, IBM DB2 e Oracle RDBMS
  • Profilo utente AEM
  • Servizi Web RESTful
  • Servizi Web basati su SOAP
  • Servizi OData
L'integrazione dei dati supporta tipi di autenticazione oututh2.0, autenticazione di base e chiave API out-of-the-box e consente l'implementazione dell'autenticazione personalizzata per l'accesso ai servizi Web. Mentre i servizi RESTful, SOAP e OData sono configurati in AEM cloud services, JDBC per i database relazionali e il connettore per il profilo utente AEM sono configurati nella console Web di AEM.

Configurare il database relazionale

Puoi configurare i database relazionali utilizzando la configurazione della console Web di AEM. Effettua le seguenti operazioni:
  1. Andate alla console Web di AEM all'indirizzo https://server:host/system/console/configMgr.
  2. Cerca la configurazione Apache Sling Connection Pooled DataSource . Toccate per aprire la configurazione in modalità di modifica.
  3. Nella finestra di dialogo di configurazione, specificate i dettagli per il database da configurare, ad esempio:
    • Nome dell'origine dati
    • Proprietà del servizio origine dati che memorizza il nome dell'origine dati
    • Nome della classe Java per il driver JDBC
    • URI connessione JDBC
    • Nome utente e password per stabilire la connessione con il driver JDBC
    Prima di configurare l'origine dati, assicurarsi di crittografare le informazioni riservate come password. Per crittografare:
    1. Accedete a https://' # : # '/system/console/crypto.
    2. Nel campo Testo ​normale, specificare la password o qualsiasi stringa da cifrare e fare clic su Proteggi .
    Il testo cifrato viene visualizzato nel campo Testo protetto che è possibile specificare nella configurazione.
  4. Abilitare Test su prestito o Test su ritorno per specificare che gli oggetti vengono convalidati prima di essere presi in prestito o restituiti da e verso il pool, rispettivamente.
  5. Specificare una query SQL SELECT nel campo Query di convalida per convalidare le connessioni dal pool. La query deve restituire almeno una riga. In base al database, specificate una delle seguenti opzioni:
    • SELECT 1 (MySQL e MS SQL)
    • SELECT 1 from dual (Oracle)
  6. Toccate Salva per salvare la configurazione.

Configurare il profilo utente di AEM

Puoi configurare il profilo utente AEM tramite la configurazione del connettore profilo utente nella console Web di AEM. Effettua le seguenti operazioni:
  1. Andate alla console Web di AEM all'indirizzo https://' # : # 'system/console/configMgr.
  2. Cerca integrazioni dati AEM Forms - Configurazione connettore profilo utente e tocca per aprire la configurazione in modalità di modifica.
  3. Nella finestra di dialogo Configurazione connettore profilo utente, potete aggiungere, rimuovere o aggiornare le proprietà del profilo utente. Le proprietà specificate saranno disponibili per l'uso nel modello dati del modulo. Utilizzate il formato seguente per specificare le proprietà del profilo utente:
    name=[property_name_with_location_in_user_profile],type=[property_type]
    Esempi:
    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    L'esempio * riportato sopra indica tutti i nodi sotto il profile/empLocation/ nodo nel profilo utente AEM nella struttura CRXDE. Ciò significa che il modello dati modulo può accedere alla city proprietà di tipo string presente in qualsiasi nodo sotto il profile/empLocation/ nodo. Tuttavia, i nodi che contengono la proprietà specificata devono seguire una struttura coerente.
  4. Toccate Salva per salvare la configurazione.

Configurare la cartella per le configurazioni del servizio cloud

La configurazione della cartella dei servizi cloud è necessaria per configurare i servizi cloud per i servizi RESTful, SOAP e OData.
Tutte le configurazioni del servizio cloud in AEM sono consolidate nella /conf cartella dell’archivio AEM. Per impostazione predefinita, la conf cartella contiene la global cartella in cui è possibile creare configurazioni del servizio cloud. Tuttavia, è necessario abilitarlo manualmente per le configurazioni cloud. Potete anche creare ulteriori cartelle in conf per creare e organizzare le configurazioni del servizio cloud.
Per configurare la cartella per le configurazioni del servizio cloud:
  1. Scegliere Strumenti > Generale > Browser di configurazione.
  2. Effettuate le seguenti operazioni per abilitare la cartella globale per le configurazioni cloud o saltate questo passaggio per creare e configurare un'altra cartella per le configurazioni del servizio cloud.
    1. Nel browser ​Configurazione, selezionate la global cartella e toccate Proprietà .
    2. Nella finestra di dialogo Proprietà ​configurazione, abilita Configurazioni ​Cloud.
    3. Toccate Salva e chiudi per salvare la configurazione e uscire dalla finestra di dialogo.
  3. Nel browser ​Configurazione, toccate Crea .
  4. Nella finestra di dialogo Crea configurazione , specificate un titolo per la cartella e abilitate Cloud Configurations .
  5. Toccate Crea per creare la cartella abilitata per le configurazioni del servizio cloud.

Configurare i servizi Web RESTful

Il servizio Web RESTful può essere descritto utilizzando le specifiche Swagger in formato JSON o YAML in un file di definizione Swagger. Per configurare il servizio Web RESTful in AEM cloud services, accertatevi di disporre del file Swagger nel file system o dell'URL in cui è ospitato il file.
Per configurare i servizi RESTful, effettuate le seguenti operazioni:
  1. Vai a Strumenti > Servizi cloud > Origini dati. Toccate per selezionare la cartella in cui desiderate creare una configurazione cloud.
    Consultate Configurare la cartella per le configurazioni del servizio cloud per informazioni sulla creazione e la configurazione di una cartella per le configurazioni del servizio cloud.
  2. Toccate Crea per aprire la procedura guidata ​Crea configurazione origine dati. Specificate un nome ed eventualmente un titolo per la configurazione, selezionate RESTful Service dal menu a discesa Service Type (Tipo servizio), oppure, facoltativamente, sfogliate e selezionate una miniatura per la configurazione, quindi toccate Next (Avanti).
  3. Specificare i seguenti dettagli per il servizio RESTful:
    • Selezionate URL o File dal menu a discesa Sorgente swagger, quindi specificate l'URL Swagger per il file di definizione Swagger oppure caricate il file Swagger dal file system locale.
    • In base all'input Sorgente Swagger, i seguenti campi sono precompilati con valori:
      • Schema: I protocolli di trasferimento utilizzati dall'API REST. Il numero di tipi di schema visualizzati nell'elenco a discesa dipende dagli schemi definiti nell'origine Swagger.
      • Host: Il nome di dominio o l'indirizzo IP dell'host che fornisce l'API REST. È un campo obbligatorio.
      • Percorso di base: Prefisso URL per tutti i percorsi API. È un campo facoltativo.\
        Se necessario, modificate i valori precompilati per questi campi.
    • Selezionare il tipo di autenticazione — Nessuno, OAuth2.0, autenticazione di base, chiave API o autenticazione personalizzata — per accedere al servizio RESTful e fornire quindi i dettagli per l'autenticazione.
    Se selezionate Chiave ​API come tipo di autenticazione, specificate il valore per la chiave API. La chiave API può essere inviata come intestazione di richiesta o come parametro di query. Selezionate una di queste opzioni dall'elenco a discesa Posizione e specificate di conseguenza il nome dell'intestazione o il parametro di query nel campo Nome ​parametro.
  4. Toccate Crea per creare la configurazione cloud per il servizio RESTful.

Configurare i servizi Web SOAP

I servizi Web basati su SOAP sono descritti utilizzando le specifiche WSDL ( Web Services Description Language). Per configurare il servizio Web basato su SOAP in AEM cloud services, verificare di disporre dell'URL WSDL per il servizio Web ed effettuare le seguenti operazioni:
  1. Vai a Strumenti > Servizi cloud > Origini dati. Toccate per selezionare la cartella in cui desiderate creare una configurazione cloud.
    Consultate Configurare la cartella per le configurazioni del servizio cloud per informazioni sulla creazione e la configurazione di una cartella per le configurazioni del servizio cloud.
  2. Toccate Crea per aprire la procedura guidata ​Crea configurazione origine dati. Specificate un nome ed eventualmente un titolo per la configurazione, selezionate SOAP Web Service dal menu a discesa Service Type (Tipo servizio), oppure, facoltativamente, sfogliate e selezionate una miniatura per la configurazione, quindi toccate Next (Avanti).
  3. Specificate quanto segue per il servizio Web SOAP:
    • URL WSDL per il servizio Web.
    • Endpoint servizio. Specificate un valore in questo campo per ignorare l'endpoint del servizio indicato in WSDL.
    • Selezionare il tipo di autenticazione — Nessuno, OAuth2.0, autenticazione di base, autenticazione personalizzata o token X509 — per accedere al servizio SOAP e fornire di conseguenza i dettagli per l'autenticazione.
      Se selezionate Token X509 come tipo di autenticazione, configurate il certificato X509. Per ulteriori informazioni, vedere Configurare i certificati . Specificate l'alias KeyStore per il certificato X509 nel campo Alias ​chiave. Specificate il tempo, in secondi, fino a quando la richiesta di autenticazione non rimane valida, nel campo Tempo di vita . Facoltativamente, selezionare per firmare il corpo del messaggio, l'intestazione della marca temporale o entrambe.
  4. Toccate Crea per creare la configurazione cloud per il servizio Web SOAP.

Configurare i servizi OData

Un servizio OData è identificato dall'URL principale del servizio. Per configurare un servizio OData in AEM cloud services, accertatevi di disporre dell'URL radice del servizio per il servizio ed effettuate le seguenti operazioni:
Per una guida dettagliata sulla configurazione di Microsoft Dynamics 365, in linea o in locale, vedere Configurazione di Microsoft Dynamics OData.
  1. Vai a Strumenti > Servizi cloud > Origini dati. Toccate per selezionare la cartella in cui desiderate creare una configurazione cloud.
    Consultate Configurare la cartella per le configurazioni del servizio cloud per informazioni sulla creazione e la configurazione di una cartella per le configurazioni del servizio cloud.
  2. Toccate Crea per aprire la procedura guidata ​Crea configurazione origine dati. Specificate un nome ed eventualmente un titolo per la configurazione, selezionate OData Service dal menu a discesa Service Type (Tipo servizio), oppure, facoltativamente, sfogliate e selezionate una miniatura per la configurazione, quindi toccate Next (Avanti).
  3. Specificate i seguenti dettagli per il servizio OData:
    • URL radice del servizio per il servizio OData da configurare.
    • Selezionare il tipo di autenticazione — Nessuno, OAuth2.0, autenticazione di base o autenticazione personalizzata — per accedere al servizio OData e fornire quindi i dettagli per l'autenticazione.
    È necessario selezionare il tipo di autenticazione OAuth 2.0 per connettersi con i servizi di Microsoft Dynamics utilizzando l'endpoint OData come radice del servizio.
  4. Toccate Crea per creare la configurazione cloud per il servizio OData.

Passaggi successivi

Hai configurato le origini dati. È quindi possibile creare un modello dati del modulo o, se è già stato creato un modello dati del modulo senza un'origine dati, è possibile associarlo alle origini dati appena configurate. Per informazioni dettagliate, vedere Creazione di un modello dati modulo.