Configurare origini dati

Integrazione dei dati

L’integrazione dei dati di AEM Forms consente di configurare e connettersi a diverse origini dati. I seguenti tipi sono supportati come predefiniti. Tuttavia, con poca personalizzazione, puoi integrare anche altre origini dati.

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

L’integrazione dei dati supporta i tipi di autenticazione predefiniti OAuth2.0, autenticazione di base e API Key e consente l’implementazione dell’autenticazione personalizzata per l’accesso ai servizi web. Mentre i servizi RESTful, basati su SOAP e OData sono configurati in AEM Cloud Services, JDBC per i database relazionali e il connettore per AEM profilo utente sono configurati in AEM console web.

Configurare il database relazionale

È possibile configurare database relazionali utilizzando AEM configurazione della console Web. Effettua le seguenti operazioni:

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

  2. Cerca Origine dati in pool di connessione Apache Sling configurazione. Tocca per aprire la configurazione in modalità di modifica.

  3. Nella finestra di dialogo di configurazione, specifica i dettagli del 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 di connessione JDBC
    • Nome utente e password per stabilire la connessione con il driver JDBC
    NOTA

    Prima di configurare l’origine dati, assicurati di crittografare le informazioni sensibili come le password. Per crittografare:

    1. Vai su https://'[server]:[porta]'/system/console/crypto.
    2. In Testo normale campo , specifica la password o qualsiasi stringa da crittografare e toccare Protect.

    Il testo crittografato viene visualizzato nel campo Testo protetto che è possibile specificare nella configurazione.

  4. Abilita Test su credito o Test al ritorno 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 Query di convalida campo per convalidare le connessioni dal pool. La query deve restituire almeno una riga. In base al database, specifica una delle seguenti opzioni:

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

    NOTA

    Se Forms Data Model contiene un oggetto riservato per il database relazionale, può verificarsi un problema di aggiunta, aggiornamento o recupero dei dati. Pertanto, evitare di utilizzare tali oggetti nel modello dati del modulo.

Configurare AEM profilo utente

È possibile configurare AEM profilo utente utilizzando la configurazione di User Profile Connector in AEM Web Console. Effettua le seguenti operazioni:

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

  2. Cerca Integrazioni dei dati AEM Forms - Configurazione del connettore del profilo utente e tocca 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’uso nel modello dati del modulo. Utilizza 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
    NOTA

    La * nell'esempio precedente denota tutti i nodi sotto il profile/empLocation/ in AEM profilo utente nella struttura CRXDE. Ciò significa che il modello dati del modulo può accedere al city proprietà di tipo string presenti in qualsiasi nodo sotto il profile/empLocation/ nodo. Tuttavia, i nodi che contengono la proprietà specificata devono seguire una struttura coerente.

  4. Tocca Salva per salvare la configurazione.

Configurare la cartella per le configurazioni del servizio cloud

NOTA

La configurazione della cartella dei servizi cloud è necessaria per configurare i servizi cloud per i servizi RESTful, SOAP e OData.

Tutte le configurazioni di servizi cloud in AEM sono consolidate nella variabile /conf in AEM archivio. Per impostazione predefinita, la conf la cartella contiene global in cui puoi creare configurazioni di servizi cloud. Tuttavia, devi abilitarlo manualmente per le configurazioni cloud. Puoi anche creare cartelle aggiuntive in conf per creare e organizzare configurazioni di servizi cloud.

Per configurare la cartella per le configurazioni del servizio cloud:

  1. Vai a Strumenti > Generale > Browser di configurazione.

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

    1. In Browser di configurazione, seleziona global tocca e fai clic su Proprietà.

    2. In Proprietà di configurazione finestra di dialogo, attiva Configurazioni cloud.

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

  3. In Browser di configurazione, tocca Crea.

  4. In Crea configurazione , specifica un titolo per la cartella e abilita Configurazioni cloud.

  5. Tocca 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 Specifiche Swagger in formato JSON o YAML in un file di definizione Swagger. Per configurare il servizio Web RESTful in AEM Cloud Services, accertati di disporre del file Swagger sul file system o dell’URL in cui è ospitato il file.

Per configurare i servizi RESTful, procedi come segue:

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

    Vedi 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. Tocca Crea per aprire Creazione guidata configurazione origine dati. Specifica un nome ed eventualmente un titolo per la configurazione, seleziona Servizio RESTful dal Tipo di servizio a discesa, se lo desideri, sfoglia e seleziona un’immagine in miniatura per la configurazione, quindi tocca Successivo.

  3. Specifica i seguenti dettagli per il servizio RESTful:

    • Selezionare URL o File dal menu a discesa Sorgente Swagger e quindi specificare l'URL Swagger nel file di definizione Swagger o caricare 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 schemi 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 di base: Prefisso URL per tutti i percorsi API. È un campo facoltativo.\

        Se necessario, modifica i valori precompilati per questi campi.

    • Seleziona il tipo di autenticazione — Nessuno, OAuth2.0, Autenticazione di base, Chiave API, Autenticazione personalizzata o Autenticazione reciproca — per accedere al servizio RESTful e, di conseguenza, fornisci i dettagli per l’autenticazione.

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

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

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

Configurazione del client HTTP del modello dati modulo per ottimizzare le prestazioni

Experience Manager Forms modello di dati modulo 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 di dati del modulo, effettua le seguenti operazioni:

  1. Accedi a Experience Manager Forms Istanza autore come amministratore e vai a Experience Manager bundle della console web. L’URL predefinito è https://localhost:4502/system/console/configMgr.

  2. Tocca Configurazione client HTTP del modello dati modulo per l’origine dati REST.

  3. In Configurazione client HTTP del modello dati modulo per l’origine dati REST finestra di dialogo:

    • Specificare il numero massimo di connessioni consentite tra il modello dati del modulo e i servizi web RESTful nella Limite di connessione totale campo . Il valore predefinito è 20 connessioni.

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

    • Specifica la durata, per la quale una connessione HTTP persistente viene mantenuta in vita, nel Mantieni vivo campo . Il valore predefinito è 15 secondi.

    • Specifica la durata per la quale il Experience Manager Forms il server attende una connessione da stabilire, nel Timeout connessione campo . Il valore predefinito è 10 secondi.

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

Configurare i servizi Web SOAP

I servizi web basati su SOAP sono descritti utilizzando Specifiche WSDL (Web Services Description Language). Per configurare il servizio Web basato su SOAP in AEM Cloud Services, assicurati di disporre dell’URL WSDL per il servizio Web ed effettua le seguenti operazioni:

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

    Vedi 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. Tocca Crea per aprire Creazione guidata configurazione origine dati. Specifica un nome ed eventualmente un titolo per la configurazione, seleziona Servizio Web SOAP dal Tipo di servizio a discesa, se lo desideri, sfoglia e seleziona un’immagine in miniatura per la configurazione, quindi tocca Successivo.

  3. Specifica 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 menzionato in WSDL.

    • Selezionare il tipo di autenticazione - Nessuno, OAuth2.0, Autenticazione di base, Autenticazione personalizzata, Token X509 o Autenticazione reciproca - per accedere al servizio SOAP e, di conseguenza, fornire i dettagli per l’autenticazione.

      Se si seleziona Token X509 come tipo di autenticazione, configura il certificato X509. Per ulteriori informazioni, consulta Imposta certificati.
      Specifica l'alias KeyStore per il certificato X509 nel Alias chiave campo . Specifica l’ora, in secondi, fino a quando la richiesta di autenticazione non rimane valida, nel Tempo di vita campo . Facoltativamente, seleziona per firmare il corpo del messaggio o l’intestazione della marca temporale o entrambe.

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

  4. Tocca 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, accertati di disporre dell’URL principale del servizio e procedi come segue:

NOTA

Il modello dati del modulo supporta OData versione 4.
Per una guida dettagliata sulla configurazione di Microsoft Dynamics 365, online o on-premise, consulta Configurazione di Microsoft Dynamics OData.

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

    Vedi 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. Tocca Crea per aprire Creazione guidata configurazione origine dati. Specifica un nome ed eventualmente un titolo per la configurazione, seleziona Servizio OData dal Tipo di servizio a discesa, se lo desideri, sfoglia e seleziona un’immagine in miniatura per la configurazione, quindi tocca Successivo.

  3. Specifica i seguenti dettagli per il servizio OData:

    • URL principale del servizio per il servizio OData da configurare.
    • Seleziona il tipo di autenticazione (Nessuno, OAuth2.0, Autenticazione di base o Autenticazione personalizzata) per accedere al servizio OData e, di conseguenza, fornisci i dettagli per l’autenticazione.
    NOTA

    È necessario selezionare il tipo di autenticazione OAuth 2.0 per connettersi con i servizi Microsoft Dynamics utilizzando l’endpoint OData come radice del servizio.

  4. Tocca Crea per creare la configurazione cloud per il servizio OData.

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

Quando si abilita l’autenticazione reciproca per il modello dati modulo, sia l’origine dati che AEM server che esegue il modello dati modulo si autenticano reciprocamente prima di condividere i dati. È possibile 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. Carica la chiave privata (certificato) in AEM Forms server. Per caricare la chiave privata:
    1. Accedi al tuo AEM Forms come amministratore.
    2. Passa a Strumenti > Sicurezza > Utenti. Seleziona la fd-cloudservice utente e tocca Proprietà.
    3. Apri Keystore scheda , espandi Aggiungi chiave privata dal file KeyStore , carica il file KeyStore, specifica gli alias, le password e tocca Invia. Il certificato viene caricato. L’alias della chiave privata è menzionato nel certificato e impostato durante la creazione del certificato.
  2. Carica il certificato di attendibilità nell'archivio locale globale. Per caricare il certificato:
    1. Passa a Strumenti > Sicurezza > Archiviazione attendibile.
    2. Espandi la Aggiungi certificato dal file CER opzione, tocca Seleziona file di certificato, carica il certificato e tocca Invia.
  3. Configura SOAP o RESTful servizi web come origine dati e seleziona Autenticazione reciproca come tipo di autenticazione. Se si configurano più certificati autofirmati per fd-cloudservice utente, specifica il nome dell'alias chiave del certificato.

Passaggi successivi

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. Vedi Crea modello dati modulo per i dettagli.

In questa pagina