DocumentazioneAEM as a Cloud ServiceGuida utente

Configurare origini dati configure-data-sources

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Principiante
  • Utente
  • Sviluppatore
Versione
Collegamento articolo
AEM 6.5
Fai clic qui
AEM as a Cloud Service
Questo articolo

Integrazione dei dati

L'integrazione dei dati di Experience Manager Forms 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
  • Salesforce
  • Archiviazione BLOB di Microsoft® Azure

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 nell'as a Cloud Service Experience Manager, JDBC per i database relazionali e il connettore per il profilo utente Experience Manager sono configurati nella console Web Experience Manager.

Configurare il database relazionale configure-relational-database

Prerequisiti

Prima di configurare i database relazionali utilizzando la configurazione della console Web Experience Manager, è necessario:

Passaggi per configurare un database relazionale

È possibile configurare i database relazionali utilizzando la configurazione della console Web Experience Manager. Effettua le seguenti operazioni:

  1. Vai alla console Web Experience Manager in https://server:host/system/console/configMgr.

  2. Individuare la configurazione dei pool di connessioni JDBC Day Commons. 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 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)

    • 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
    Per informazioni più dettagliate, vedere Connessioni SQL con DataSourcePool JDBC.

  4. Seleziona Salva per salvare la configurazione.

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

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 consolidate nella cartella /conf nell'archivio Experience Manager. 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

I servizi Web RESTful possono essere descritti utilizzando Specifiche Swagger in formato JSON o YAML in un file di definizione Swagger. Per configurare il servizio Web RESTful in Experience Manager as a Cloud Service, verificare di disporre del file Swagger (Swagger versione 2.0) o del file Swagger (Swagger versione 3.0) nel file system o dell'URL in cui è ospitato il file.

Configurare i 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.

    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:

    • Selezionare un URL o un file dal menu a discesa Swagger Source e specificare di conseguenza Swagger URL nel file di definizione ​ Swagger o caricare il file Swagger dal file system locale.

    • In base all'input di Source ​ Swagger, i campi seguenti 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 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, 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.

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

Configurare i servizi RESTful per la specifica API Open versione 3.0 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.

    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:

    • Selezionare un URL o un file dal menu a discesa Swagger Source e specificare di conseguenza Swagger 3.0 URL nel file di definizione ​ Swagger o caricare il file Swagger dal file system locale.
    • In base all'input di Source ​ Swagger, vengono visualizzate le informazioni di connessione con il server di destinazione.
    • Selezionare il tipo di autenticazione, ovvero 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, 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.

  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

Per informazioni dettagliate, vedere la specifica OpenAPI 3.0.

Configurazione del client HTTP Form Data Model (FDM) per ottimizzare le prestazioni fdm-http-client-configuration

Experience Manager Forms forma un modello dati durante l'integrazione con i servizi Web RESTful come origine dati include configurazioni client HTTP per l'ottimizzazione delle prestazioni.

Impostare le seguenti proprietà della configurazione client HTTP del modello dati Form per l'origine dati REST per specificare l'espressione regolare:

  • Utilizzare la proprietà http.connection.max.per.route per impostare il numero massimo di connessioni consentite tra il modello dati del modulo (FDM) e i servizi Web RESTful. Il valore predefinito è 20 connessioni.

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

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

  • Utilizzare la proprietà http.connection.timeout per specificare la durata dell'attesa di connessione da parte del server Experience Manager Forms. Il valore predefinito è 10 secondi.

  • Utilizzare la proprietà 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. Selezionare Configurazione client HTTP modello dati modulo per origine dati REST.

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

    • Specifica il numero massimo di connessioni consentite tra il modello dati del modulo (FDM) e i servizi Web RESTful nel campo Limite connessione 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 è due 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). Experience Manager Forms non supporta il modello WSDL in stile RPC.

Per configurare il servizio Web basato su SOAP in Experience Manager as a Cloud Service, 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 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 in WSDL dei servizi Web SOAP. Per impostazione predefinita, in questo campo non è presente alcun valore. Experience Manager blocca pertanto tutte le istruzioni di importazione disponibili in WSDL. Se si specifica .* come valore in questo campo, Experience Manager consente tutte le istruzioni di importazione.

Impostare la proprietà importAllowlistPattern della configurazione Modello dati modulo SOAP Servizi Web Import Inserisce nell'elenco Consentiti per specificare l'espressione regolare. Il seguente file JSON mostra un esempio:

{
  "importAllowlistPattern": ".*"
}

Per impostare i valori di una configurazione, Genera configurazioni OSGi utilizzando l'SDK AEM e distribuisci la configurazione nell'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, verificare di disporre dell'URL principale del servizio e procedere come segue:

NOTE
Il modello dati modulo supporta OData versione 4.
Per una guida dettagliata alla configurazione di Microsoft®® Dynamics 365, online o on-premise, vedere Microsoft® Dynamics Configurazione 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, Chiave API o Autenticazione personalizzata, per accedere al servizio OData e fornire 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.

    note note
    NOTE
    Selezionare 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.

Passaggi successivi next-steps

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

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