Configurare origini dati configure-data-sources

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

Integrazione dei 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®, postgreSQL 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 configure-relational-database

Prerequisiti

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

Passaggi per configurare un 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. Seleziona per aprire la configurazione in modalità di modifica.

    Pool di connettori JDBC

  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 configurare un database relazionale:

    code language-text
       "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"
    
    note note
    NOTE
    Consulta Connessioni SQL con DataSourcePool JDBC per informazioni più dettagliate.
  4. Seleziona 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 cloud-folder

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.

  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 seleziona Proprietà.

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

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

  3. In Browser configurazioni, seleziona Crea.

  4. In 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

I servizi web RESTful possono essere descritti 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 configure-restful-services-open-api-2.0

  1. Vai a Strumenti > Cloud Service > Origini dati. Seleziona 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. Seleziona 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 , sfogliare e selezionare un'immagine di miniatura per la configurazione e selezionare Successivo.

  3. Specificare i dettagli seguenti per il servizio RESTful:

    • Seleziona un URL o un 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. Seleziona Crea per creare la configurazione cloud per il servizio RESTful.

Configurare i servizi RESTful per la versione 3.0 delle specifiche API aperte configure-restful-services-open-api-3.0

  1. Vai a Strumenti > Cloud Service > Origini dati. Seleziona 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. Seleziona 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 , sfogliare e selezionare un'immagine di miniatura per la configurazione e selezionare Successivo.

  3. Specificare i dettagli seguenti per il servizio RESTful:

    • Seleziona un URL o un 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. Seleziona 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

Consulta Specifiche OpenAPI 3.0 per informazioni dettagliate.

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

Experience Manager Forms formare un modello dati 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. Seleziona 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 configure-soap-web-services

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 Service > Origini dati. Seleziona 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. Seleziona 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 , sfogliare e selezionare un'immagine di miniatura per la configurazione e selezionare 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. Seleziona Crea per creare la configurazione cloud per il servizio web SOAP.

Abilitare l'utilizzo delle istruzioni di importazione nel WSDL dei servizi Web SOAP enable-import-statements

È 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 config-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:

NOTE
Il modello dati del modulo supporta OData versione 4.
Per una guida dettagliata alla configurazione di Microsoft®® Dynamics 365, online o on-premise, vedi Microsoft® Dynamics Configurazione OData.
  1. Vai a Strumenti > Cloud Service > Origini dati. Seleziona 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. Seleziona 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 , sfogliare e selezionare un'immagine di miniatura per la configurazione e selezionare 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.

    note note
    NOTE
    Seleziona il tipo di autenticazione OAuth 2.0 con cui connetterti Microsoft®® Dynamics servizi che utilizzano l'endpoint OData come radice del servizio.
  4. Seleziona Crea per creare la configurazione cloud per il servizio OData.

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab