Configurare origini dati

Integrazione dei dati

Experience Manager Forms L'integrazione dei dati consente di configurare e connettersi a diverse origini dati. I seguenti tipi sono supportati come predefiniti:

  • Servizi web RESTful
  • Servizi web basati su SOAP
  • Servizi OData (versione 4.0)
  • Microsoft Dynamics
  • ForzaVendita
  • Archiviazione BLOB di Microsoft Azure

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 Experience Manager as a Cloud Service e connettore per Experience Manager il profilo utente è configurato in Experience Manager console web.

NOTA

Experience Manager Forms non supporta il database relazionale.

Configurare la cartella per le configurazioni del servizio cloud

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

Tutte le configurazioni del servizio cloud in Experience Manager sono consolidate nelle /conf cartella in Experience Manager 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 Swagger file di definizione. Per configurare il servizio Web RESTful in Experience Manager as a Cloud Service, assicurati di avere Swagger file (Swagger versione 2.0) nel file system o nell'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:

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

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

      • 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 o Autenticazione personalizzata — 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.

  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.

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

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

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

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

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

  • Utilizza la http.socket.timeout per specificare il periodo di tempo massimo per l'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"
}

Per impostare i valori di una configurazione, Generare configurazioni OSGi utilizzando l’SDK AEMe distribuire la configurazione all'istanza di Cloud Service.

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). Experience Manager Forms non supportano il modello WSDL di stile 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 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 o Autenticazione personalizzata, per accedere al servizio SOAP e, di conseguenza, fornire i dettagli per l’autenticazione.

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

Abilitare l’utilizzo di istruzioni di importazione in WSDL dei servizi Web SOAP

È 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, questo campo non contiene 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 la importAllowlistPattern proprietà Inserire nell'elenco Consentiti di importazione servizi Web SOAP del modello per dati modulo configurazione 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 AEMe distribuire la configurazione all'istanza di Cloud Service.

Configurare i servizi OData

Un servizio OData è identificato dall'URL principale del servizio. Per configurare un servizio OData in Experience Manager as a Cloud Service, accertati di disporre dell'URL principale del servizio ed effettua le seguenti operazioni:

NOTA

Il modello dati del modulo supporta OData versione 4.
Guida dettagliata alla configurazione Microsoft Dynamics 365, on-line o on-premise, vedi Microsoft Dynamics Configurazione 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, Chiave API o Autenticazione personalizzata — per accedere al servizio OData 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.

    NOTA

    È necessario selezionare il tipo di autenticazione OAuth 2.0 con cui connettersi 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 appena configurate. Vedi Crea modello dati modulo per i dettagli.

In questa pagina