Configurare origini dati configure-data-sources

Versione
Collegamento articolo
AEM as a Cloud Service
Fai clic qui
AEM 6.5
Questo articolo

Integrazione dei dati

L’integrazione dei dati di AEM Forms consente di configurare e connettersi a diverse origini dati. Sono supportati i seguenti tipi pronti all’uso. Tuttavia, con una personalizzazione ridotta, puoi integrare anche altre origini dati.

  • Database relazionali: MySQL, Microsoft SQL Server, IBM DB2, Oracle RDBMS, postgreSQL e Sybase
  • Profilo utente AEM
  • Servizi Web RESTful
  • Servizi web basati su SOAP
  • Servizi OData

L'integrazione dei dati supporta OAuth2.0(Codice di autorizzazione, Credenziali client), l'autenticazione di base e i tipi di autenticazione con chiave API predefiniti e consente l'implementazione dell'autenticazione personalizzata per l'accesso ai servizi Web. Mentre i servizi RESTful, basati su SOAP e OData sono configurati nei Cloud Service AEM, JDBC per i database relazionali e il connettore per il profilo utente AEM sono configurati nella console web AEM.

Configurare il database relazionale configure-relational-database

È possibile configurare i database relazionali utilizzando Configurazione console Web AEM. Effettua le seguenti operazioni:

  1. Passa alla console Web AEM all'indirizzo https://server:host/system/console/configMgr.

  2. Cerca la configurazione dell'dell'origine dati in pool di connessione Apache Sling. Seleziona per aprire la configurazione in modalità di modifica.

  3. Nella finestra di dialogo di configurazione specificare i dettagli del database che si desidera configurare, ad esempio:

    • Nome dell’origine dati
    • Proprietà del servizio origine dati che memorizza il nome dell'origine dati
    • Nome classe Java per il driver JDBC
    • URI connessione JDBC
    • Nome utente e password per stabilire la connessione con il driver JDBC
    note note
    NOTE
    Prima di configurare l'origine dati, assicurarsi di crittografare informazioni riservate come le password. Per crittografare:
    1. Vai a https://'[server]:[porta]'/system/console/crypto.
    2. Nel campo Testo normale, specifica la password o qualsiasi stringa da crittografare e seleziona Protect.
    Il testo crittografato viene visualizzato nel campo Testo protetto che è possibile specificare nella configurazione.
  4. Abilitare Test su prestito o Test su restituzione per specificare che gli oggetti vengono convalidati prima di essere presi in prestito o restituiti rispettivamente da e al pool.

  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, specificare una delle seguenti opzioni:

    • SELECT 1 (MySQL e MS SQL)
    • SELECT 1 da dual (Oracle)
  6. Seleziona Salva per salvare la configurazione.

    note note
    NOTE
    Se il modello dati di Forms contiene un oggetto che è una parola chiave riservata per il database relazionale, può causare problemi di aggiunta, aggiornamento o recupero di dati. Evita quindi di utilizzare tali oggetti nel modello dati del modulo.

Configurare il profilo utente AEM configure-aem-user-profile

Puoi configurare il profilo utente AEM utilizzando la configurazione del connettore profilo utente nella console web AEM. Effettua le seguenti operazioni:

  1. Vai alla console Web AEM all'indirizzo https://'[server]:[porta]'system/console/configMgr.

  2. Cerca Integrazioni dati di AEM Forms - Configurazione connettore profilo utente e seleziona per aprire la configurazione in modalità di modifica.

  3. Nella finestra di dialogo Configurazione connettore profilo utente puoi aggiungere, rimuovere o aggiornare le proprietà del profilo utente. Le proprietà specificate sono disponibili per l'utilizzo nel modello dati del modulo. Utilizza il seguente formato 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
    note note
    NOTE
    * nell'esempio precedente denota tutti i nodi sotto il nodo profile/empLocation/ nel profilo utente AEM nella struttura CRXDE. Ciò significa che il modello dati del modulo può accedere alla proprietà city di tipo string presente in qualsiasi nodo sotto il nodo profile/empLocation/. Tuttavia, i nodi che contengono la proprietà specificata devono seguire una struttura coerente.
  4. Seleziona Salva per salvare la configurazione.

Configurare la cartella per le configurazioni del servizio cloud cloud-folder

NOTE
Per configurare i servizi cloud per i servizi RESTful, SOAP e OData è necessaria la configurazione della cartella Servizi cloud.

Tutte le configurazioni dei servizi cloud in AEM sono consolidate nella cartella /conf nell'archivio AEM. Per impostazione predefinita, la cartella conf contiene la cartella global in cui è possibile creare configurazioni del servizio cloud. Tuttavia, devi abilitarlo manualmente per le configurazioni cloud. È inoltre possibile creare cartelle aggiuntive in conf per creare e organizzare le configurazioni del servizio cloud.

Per configurare la cartella per le configurazioni del servizio cloud:

  1. Vai a Strumenti > Generale > Browser configurazioni.

  2. Effettua le seguenti operazioni per abilitare la cartella globale per le configurazioni cloud oppure ignora questo passaggio per creare e configurare un’altra cartella per le configurazioni del servizio cloud.

    1. Nel Browser configurazioni, selezionare la cartella global e selezionare Proprietà.

    2. Nella finestra di dialogo Proprietà configurazione, abilita Configurazioni cloud.

    3. Seleziona Salva e chiudi per salvare la configurazione e uscire dalla finestra di dialogo.

  3. Nel Browser configurazioni, selezionare Crea.

  4. Nella finestra di dialogo Crea configurazione, specifica un titolo per la cartella e abilita Configurazioni cloud.

  5. Seleziona Crea per creare la cartella abilitata per le configurazioni del servizio cloud.

Configurare i servizi web RESTful configure-restful-web-services

È possibile descrivere il servizio Web RESTful utilizzando le specifiche Swagger in formato JSON o YAML in un file di definizione Swagger. Per configurare il servizio Web RESTful nei servizi cloud AEM, accertati di disporre del file Swagger sul file system o dell’URL in cui è ospitato il file.

Per configurare i servizi RESTful, effettuare le seguenti operazioni:

  1. Vai a Strumenti > Cloud Service > Origini dati. Seleziona per selezionare la cartella in cui desideri creare una configurazione cloud.

    Per informazioni sulla creazione e la configurazione di una cartella per le configurazioni del servizio cloud, consulta Configurare la cartella per le configurazioni del servizio cloud.

  2. Selezionare Crea per aprire la Creazione guidata configurazione Data Source. Specifica un nome e, facoltativamente, un titolo per la configurazione. Seleziona Servizio RESTful dal menu a discesa Tipo di servizio. Se necessario, sfoglia e seleziona un'immagine di anteprima per la configurazione, quindi seleziona Avanti.

  3. Specificare i dettagli seguenti per il servizio RESTful:

    • Selezionate URL o File dal menu a discesa Swagger Source, quindi specificate l'URL Swagger nel file di definizione Swagger o caricate il file Swagger dal file system locale.

    • In base all’input di Swagger Source, i seguenti campi sono precompilati con i valori:

      • Schema: 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 serve l’API REST. È un campo obbligatorio.
      • Percorso base: prefisso URL per tutti i percorsi API. È un campo facoltativo.
        Se necessario, modifica i valori precompilati per questi campi.
    • Selezionare il tipo di autenticazione, ovvero Nessuno, OAuth2.0(Codice di autorizzazione, Credenziali client), Autenticazione di base, Chiave API, Autenticazione personalizzata o Autenticazione reciproca, per accedere al servizio RESTful e fornire di conseguenza i dettagli per l'autenticazione.

    Se si seleziona Chiave API come tipo di autenticazione, specificare il valore per la chiave API. La chiave API può essere inviata come intestazione di richiesta o come parametro di query. Seleziona una di queste opzioni dall'elenco a discesa Posizione e specifica di conseguenza il nome dell'intestazione o il parametro della query nel campo Nome parametro.

    Se si seleziona Autenticazione reciproca come tipo di autenticazione, vedere Autenticazione reciproca basata su certificato per i servizi Web RESTful e SOAP.

  4. Seleziona Crea per creare la configurazione cloud per il servizio RESTful.

Configurazione client HTTP del modello dati modulo per ottimizzare le prestazioni fdm-http-client-configuration

Il modello dati del modulo Experience Manager Forms durante l'integrazione con i servizi Web RESTful come origine dati include configurazioni client HTTP per l'ottimizzazione delle prestazioni.
Per configurare il client HTTP del modello dati modulo, effettua le seguenti operazioni:

  1. Accedi all'istanza Autore Experience Manager Forms come amministratore e passa a Experience Manager bundle della console Web. URL predefinito: https://localhost:4502/system/console/configMgr.

  2. Selezionare Configurazione client HTTP modello dati modulo per origine dati REST.

  3. Nella finestra di dialogo Configurazione client HTTP del modello dati modulo ​ per l'origine dati REST:

    • Specifica il numero massimo di connessioni consentite tra il modello di dati del modulo e i servizi Web RESTful nel campo Limite di connessioni in totale. Il valore predefinito è 20 connessioni.

    • Specificare il numero massimo di connessioni consentite per ogni route nel campo Limite di connessioni per ogni route. Il valore predefinito è 2 connessioni.

    • Nel campo Keep alive specificare la durata per la quale una connessione HTTP persistente viene mantenuta attiva. Il valore predefinito è 15 secondi.

    • Nel campo Timeout connessione specificare la durata dell'attesa di una connessione da parte del server Experience Manager Forms. Il valore predefinito è 10 secondi.

    • Specificare il periodo di tempo massimo per l'inattività tra due pacchetti di dati nel campo Timeout socket. Il valore predefinito è 30 secondi.

Configurare i servizi web dell’SOAP configure-soap-web-services

I servizi Web basati su SOAP sono descritti utilizzando le specifiche WSDL (Web Services Description Language). Per configurare il servizio Web basato su SOAP nei servizi cloud AEM, verificare di disporre dell'URL WSDL per il servizio Web e procedere come segue:

  1. Vai a Strumenti > Cloud Service > Origini dati. Seleziona per selezionare la cartella in cui desideri creare una configurazione cloud.

    Per informazioni sulla creazione e la configurazione di una cartella per le configurazioni del servizio cloud, consulta Configurare la cartella per le configurazioni del servizio cloud.

  2. Selezionare Crea per aprire la Creazione guidata configurazione Data Source. Specifica un nome e, facoltativamente, un titolo per la configurazione. Seleziona Servizio Web SOAP dal menu a discesa Tipo di servizio. Se necessario, sfoglia e seleziona un'immagine di anteprima per la configurazione, quindi seleziona Avanti.

  3. Specificare quanto segue per il servizio Web SOAP:

    • URL WSDL per il servizio Web.

    • Endpoint servizio. Specificare un valore in questo campo per sostituire l'endpoint del servizio indicato in WSDL.

    • Selezionare il tipo di autenticazione, ovvero Nessuno, OAuth2.0(Codice di autorizzazione, Credenziali client), Autenticazione di base, Autenticazione personalizzata, Token X509 o Autenticazione reciproca, per accedere al servizio SOAP e fornire i dettagli per l'autenticazione.

      Se si seleziona X509 Token come tipo di autenticazione, configurare il certificato X509. Per ulteriori informazioni, vedere Configurare i certificati.
      Specificare l'alias KeyStore per il certificato X509 nel campo Alias chiave. Nel campo Durata specificare il tempo, in secondi, fino a quando la richiesta di autenticazione non rimane valida. Facoltativamente, seleziona per firmare il corpo del messaggio o l’intestazione della marca temporale o entrambi.

      Se si seleziona Autenticazione reciproca come tipo di autenticazione, vedere Autenticazione reciproca basata su certificato per i servizi Web RESTful e SOAP.

  4. Seleziona Crea per creare la configurazione cloud per il servizio Web SOAP.

Configurare i servizi OData config-odata

Un servizio OData è identificato dall'URL radice del servizio. Per configurare un servizio OData nei servizi cloud AEM, accertarsi di disporre dell'URL principale del servizio ed eseguire le operazioni seguenti:

NOTE
Il modello dati del modulo supporta OData versione 4.
Per una guida dettagliata alla configurazione di Microsoft Dynamics 365, online o on-premise, vedere Configurazione di Microsoft Dynamics OData.
  1. Vai a Strumenti > Cloud Service > Origini dati. Seleziona per selezionare la cartella in cui desideri creare una configurazione cloud.

    Per informazioni sulla creazione e la configurazione di una cartella per le configurazioni del servizio cloud, consulta Configurare la cartella per le configurazioni del servizio cloud.

  2. Selezionare Crea per aprire la Creazione guidata configurazione Data Source. Specifica un nome e, facoltativamente, un titolo per la configurazione. Seleziona Servizio OData dal menu a discesa Tipo di servizio. Se necessario, sfoglia e seleziona un'immagine di anteprima per la configurazione, quindi seleziona Successivo.

  3. Specificare i dettagli seguenti per il servizio OData:

    • URL principale del servizio per il servizio OData da configurare.
    • Selezionare il tipo di autenticazione, ovvero Nessuno, OAuth2.0(Codice di autorizzazione, Credenziali client), Autenticazione di base o Autenticazione personalizzata, per accedere al servizio OData e fornire i dettagli per l'autenticazione.
    note note
    NOTE
    Seleziona il tipo di autenticazione OAuth 2.0 per connettersi ai servizi Microsoft Dynamics utilizzando l’endpoint OData come radice del servizio.
  4. Selezionare Crea per creare la configurazione cloud per il servizio OData.

Autenticazione reciproca basata su certificato per i servizi web RESTful e SOAP mutual-authentication

Quando si abilita l'autenticazione reciproca per il modello dati modulo, sia l'origine dati che il server AEM che esegue il modello dati modulo autenticano l'identità dell'altro prima di condividere i dati. Puoi utilizzare l’autenticazione reciproca per le connessioni basate su REST e SOAP (origini dati). Per configurare l’autenticazione reciproca per un modello di dati modulo nell’ambiente AEM Forms:

  1. Caricare la chiave privata (certificato) nel server AEM Forms. Per caricare la chiave privata:

    1. Accedi al server AEM Forms come amministratore.
    2. Passa a Strumenti > Sicurezza > Utenti. Selezionare l'utente fd-cloudservice e selezionare Proprietà.
    3. Apri la scheda Registro chiavi, espandi l'opzione Aggiungi chiave privata dal file registro chiavi, carica il file registro chiavi, specifica alias, password e seleziona Invia. Il certificato è stato caricato. L’alias della chiave privata viene menzionato nel certificato e impostato durante la creazione del certificato.
  2. Carica il certificato di attendibilità nell'archivio fonti attendibili globale. Per caricare il certificato:

    1. Passa a Strumenti > Sicurezza > Archivio attendibile.
    2. Espandere l'opzione Aggiungi certificato da file CER, selezionare Seleziona file certificato, caricare il certificato e selezionare Invia.
  3. Configura i servizi Web SOAP o RESTful come origine dati e seleziona Autenticazione reciproca come tipo di autenticazione. Se si configurano più certificati autofirmati per l'utente fd-cloudservice, specificare il nome dell'alias chiave per il certificato.

Passaggi successivi next-steps

Hai configurato le origini dati. Successivamente è possibile creare un modello dati modulo oppure, se è già stato creato un modello dati modulo senza un'origine dati, è possibile associarlo alle origini dati configurate. Per ulteriori dettagli, vedere Crea modello dati modulo.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2