Configurare origini dati

Experience Manager Forms L’integrazione dei dati consente di configurare e connettersi a diverse origini dati. Sono supportati i seguenti tipi predefiniti:

• Database relazionali: MySQL, Microsoft SQL Server, IBM DB2, e Oracle RDBMS
• Servizi Web RESTful
• Servizi web basati su SOAP
• Servizi OData (versione 4.0)
• Microsoft® Dynamics
• ForzaVendite
• Archiviazione BLOB di Microsoft® Azure

L’integrazione dei dati supporta OAuth2.0(Codice di autorizzazione, Credenziali client), autenticazione di base e tipi di autenticazione con chiave API pronti all’uso e che consentono l’implementazione dell’autenticazione personalizzata per l’accesso ai servizi web. Mentre i servizi RESTful, SOAP e OData sono configurati in Experience Manager as a Cloud Service, JDBC per database relazionali e connettore per Experience Manager il profilo utente è configurato in Experience Manager console web.

Configurare il database relazionale

Prerequisiti

Prima di configurare i database relazionali utilizzando Experience Manager Configurazione della console Web, è obbligatorio:

• Abilitare la rete avanzata tramite l’API di Cloud Manager, in quanto le porte sono disattivate per impostazione predefinita.
• Aggiungere dipendenze driver JDBC in Maven.

Passaggi per configurare il database relazionale

È possibile configurare i database relazionali utilizzando Experience Manager Configurazione della console web. Effettua le seguenti operazioni:

1. Vai a Experience Manager console web in https://server:host/system/console/configMgr.

2. Individua Pool connessioni JDBC Day Commons configurazione. Tocca 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 classe Java™ per il driver JDBC
   • URI connessione JDBC
   • Nome utente e password per stabilire la connessione con il driver JDBC
   • Specificare una query SQL SELECT in 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)
   • Nome dell’origine dati

   Stringhe di esempio per la configurazione del database relazionale:

      "datasource.name": "sqldatasourcename-mysql",
      "jdbc.driver.class": "com.mysql.jdbc.Driver",
      "jdbc.connection.uri": "jdbc:mysql://$[env:AEM_PROXY_HOST;default=proxy.tunnel]:30001/sqldatasourcename"
   

   NOTA

   Fai riferimento a Connessioni SQL con DataSourcePool JDBC per informazioni più dettagliate.

4. Tocca Salva per salvare la configurazione.

Ora è possibile utilizzare il database relazionale configurato con il modello dati del modulo.

Configurare la cartella per le configurazioni del servizio cloud

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

Tutte le configurazioni del servizio cloud in Experience Manager sono consolidati in /conf cartella in Experience Manager archivio. Per impostazione predefinita, il conf la cartella contiene global cartella in cui è possibile creare le configurazioni di cloud service. Tuttavia, devi abilitarlo manualmente per le configurazioni cloud. Puoi anche creare ulteriori cartelle in conf per creare e organizzare le configurazioni di cloud service.

Per configurare la cartella per le configurazioni del servizio cloud:

1. Vai a Strumenti > Generale > Browser configurazioni.

   • Consulta la Browser configurazioni per ulteriori informazioni.

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. In Browser configurazioni, seleziona la global cartella e tocca Proprietà.

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

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

3. In Browser configurazioni, 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 Swagger file di definizione. Per configurare il servizio Web RESTful in Experience Manager as a Cloud Service, assicurati di disporre di Swagger file (Swagger versione 2.0) o Swagger file (Swagger versione 3.0) nel file system o nell'URL in cui è ospitato il file.

Configurazione dei servizi RESTful per la specifica API Open versione 2.0

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

   Consulta Configurare la cartella per le configurazioni del servizio cloud per informazioni sulla creazione e la configurazione di una cartella per le configurazioni di cloud service.

2. Tocca Crea per aprire Creazione guidata configurazione origine dati. Specifica un nome e, facoltativamente, un titolo per la configurazione, quindi seleziona Servizio RESTful dal Tipo di servizio a discesa, se necessario sfoglia e seleziona un’immagine di miniatura per la configurazione, quindi tocca Successivo.

3. Specificare i dettagli seguenti per il servizio RESTful:

   • Seleziona URL o file da Sorgente Swagger e quindi specificare il Swagger URL al​ Swagger file di definizione o carica Swagger dal file system locale.

   • In base al​ Swagger Input sorgente., 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 nella Swagger sorgente.

     • 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.

   • Seleziona il tipo di autenticazione: Nessuno, OAuth2.0(Codice di autorizzazione, Credenziali client), autenticazione di base, chiave API o autenticazione personalizzata: per accedere al servizio RESTful e fornire di conseguenza 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 di queste opzioni dalla Posizione e specificare il nome dell'intestazione o il parametro di query nell' Nome parametro di conseguenza.

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

Configurare i servizi RESTful per la versione 3.0 delle specifiche API aperte

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

   Consulta Configurare la cartella per le configurazioni del servizio cloud per informazioni sulla creazione e la configurazione di una cartella per le configurazioni di cloud service.

2. Tocca Crea per aprire Creazione guidata configurazione origine dati. Specifica un nome e, facoltativamente, un titolo per la configurazione, quindi seleziona Servizio RESTful dal Tipo di servizio a discesa, se necessario sfoglia e seleziona un’immagine di miniatura per la configurazione, quindi tocca Successivo.

3. Specificare i dettagli seguenti per il servizio RESTful:

   • Seleziona URL o file da Sorgente Swagger e quindi specificare il Swagger 3.0 URL al​ Swagger file di definizione o carica Swagger dal file system locale.
   • In base al​ Swagger Input di origine, vengono visualizzate le informazioni di connessione con il server di destinazione.
   • Seleziona il tipo di autenticazione: Nessuno, OAuth2.0(Codice di autorizzazione, Credenziali client), autenticazione di base, chiave API o autenticazione personalizzata: per accedere al servizio RESTful e fornire di conseguenza 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 di queste opzioni dalla Posizione e specificare il nome dell'intestazione o il parametro di query nell' Nome parametro di conseguenza.

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

Alcune delle operazioni non supportate dalla versione 3.0 della specifica Open API dei servizi RESTful sono:

• Callback
• uno di/qualsiasi di
• Riferimento remoto
• Collegamenti
• Diversi corpi di richiesta per diversi tipi MIME per una singola operazione

Puoi consultare Specifiche OpenAPI 3.0 per informazioni dettagliate.

Configurazione client HTTP del modello dati modulo per ottimizzare le prestazioni

Experience Manager Forms il modello dati del modulo durante l’integrazione con i servizi web RESTful come origine dati include configurazioni client HTTP per l’ottimizzazione delle prestazioni.

Imposta le seguenti proprietà del Configurazione client HTTP modello dati modulo per origine dati REST per specificare l'espressione regolare:

• Utilizza il http.connection.max.per.route per impostare il numero massimo di connessioni consentite tra il modello di dati del modulo e i servizi web RESTful. Il valore predefinito è 20 connessioni.

• Utilizza il http.connection.max per specificare il numero massimo di connessioni consentite per ogni route. Il valore predefinito è 40 connessioni.

• Utilizza il http.connection.keep.alive.duration per specificare la durata per la quale una connessione HTTP persistente viene mantenuta attiva. Il valore predefinito è 15 secondi.

• Utilizza il http.connection.timeout per specificare la durata, per la quale Experience Manager Forms il server attende una connessione da stabilire. Il valore predefinito è 10 secondi.

• Utilizza il http.socket.timeout per specificare il periodo massimo di inattività tra due pacchetti di dati. Il valore predefinito è 30 secondi.

Il seguente file JSON mostra un esempio:

{
   "http.connection.keep.alive.duration":"15",
   "http.connection.max.per.route":"20",
   "http.connection.timeout":"10",
   "http.socket.timeout":"30",
   "http.connection.idle.connection.timeout":"15",
   "http.connection.max":"40"
}

1. Tocca Configurazione client HTTP modello dati modulo per origine dati REST.

2. In Configurazione client HTTP modello dati modulo per origine dati REST finestra di dialogo:

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

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

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

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

   • Specifica il periodo massimo di inattività tra due pacchetti di dati nella Timeout socket campo. Il valore predefinito è 30 secondi.

Configurare i servizi web SOAP

I servizi web basati su SOAP sono descritti utilizzando Specifiche di Web Services Description Language (WSDL). Experience Manager Forms non supportano il modello WSDL di tipo RPC.

Per configurare il servizio Web basato su SOAP in Experience Manager as a Cloud Service, assicurati di disporre dell’URL WSDL per il servizio Web e procedi come segue:

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

   Consulta Configurare la cartella per le configurazioni del servizio cloud per informazioni sulla creazione e la configurazione di una cartella per le configurazioni di cloud service.

2. Tocca Crea per aprire Creazione guidata configurazione origine dati. Specifica un nome e, facoltativamente, un titolo per la configurazione, quindi seleziona Servizio web SOAP dal Tipo di servizio a discesa, se necessario sfoglia e seleziona un’immagine di miniatura per la configurazione, quindi tocca Successivo.

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.

   • Seleziona il tipo di autenticazione: Nessuno, OAuth2.0(Codice di autorizzazione, Credenziali client), autenticazione di base o autenticazione personalizzata: per accedere al servizio SOAP e fornire i dettagli per l'autenticazione.

4. Tocca Crea per creare la configurazione cloud per il servizio web SOAP.

Abilitare l'utilizzo delle istruzioni di importazione nel WSDL dei servizi Web SOAP

È possibile specificare un'espressione regolare che funga da filtro per gli URL assoluti consentiti come istruzioni di importazione nel WSDL dei servizi Web SOAP. Per impostazione predefinita, in questo campo non è presente alcun valore. Di conseguenza, Experience Manager blocca tutte le istruzioni di importazione disponibili in WSDL. Se si specifica .* come valore in questo campo, Experience Manager consente tutte le istruzioni di importazione.

Imposta il importAllowlistPattern proprietà del Modello dati modulo SOAP Web Services Importa Inserisco nell'elenco Consentiti per specificare l'espressione regolare. Il seguente file JSON mostra un esempio:

{
  "importAllowlistPattern": ".*"
}

Per impostare i valori di una configurazione: Generare configurazioni OSGi utilizzando l’SDK per AEM, e distribuire la configurazione all’istanza di Cloud Service.

Configurare i servizi OData

Un servizio OData è identificato dall'URL radice del servizio. Per configurare un servizio OData in Experience Manager as a Cloud Service, assicurati di disporre dell’URL principale del servizio 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.

   Consulta Configurare la cartella per le configurazioni del servizio cloud per informazioni sulla creazione e la configurazione di una cartella per le configurazioni di cloud service.

2. Tocca Crea per aprire Creazione guidata configurazione origine dati. Specifica un nome e, facoltativamente, un titolo per la configurazione, quindi seleziona Servizio OData dal Tipo di servizio a discesa, se necessario sfoglia e seleziona un’immagine di miniatura per la configurazione, quindi tocca Successivo.

3. Specificare i dettagli seguenti per il servizio OData:

   • URL principale del servizio per il servizio OData da configurare.
   • Seleziona il tipo di autenticazione: Nessuno, OAuth2.0(Codice di autorizzazione, Credenziali client), autenticazione di base, chiave API o autenticazione personalizzata: per accedere al servizio OData e fornire di conseguenza 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 di queste opzioni dalla Posizione e specificare il nome dell'intestazione o il parametro di query nell' Nome parametro di conseguenza.

   NOTA

   Devi selezionare il tipo di autenticazione OAuth 2.0 con cui connetterti Microsoft® Dynamics servizi che utilizzano l'endpoint OData come radice del servizio.

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

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

Risorse Business.Adobe.com