Versione | Collegamento articolo |
---|---|
AEM as a Cloud Service | Fai clic qui |
AEM 6.5 | Questo articolo |
L’integrazione dei dati di AEM Forms consente di configurare e connettersi a diverse origini dati. Sono supportati i seguenti tipi pronti all’uso. Tuttavia, con una personalizzazione ridotta, puoi integrare anche altre origini dati.
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-based e OData sono configurati nei Cloud Service AEM, JDBC per i database relazionali e il connettore per il profilo utente AEM sono configurati nella console web AEM.
È possibile configurare i database relazionali utilizzando Configurazione console Web AEM. Effettua le seguenti operazioni:
Vai alla console web dell’AEM all’indirizzo https://server:host/system/console/configMgr
.
Cerca Origine dati in pool di connessione Apache Sling configurazione. Tocca per aprire la configurazione in modalità di modifica.
Nella finestra di dialogo di configurazione specificare i dettagli del database che si desidera configurare, ad esempio:
Prima di configurare l'origine dati, assicurarsi di crittografare informazioni riservate come le password. Per crittografare:
Il testo crittografato viene visualizzato nel campo Testo protetto che è possibile specificare nella configurazione.
Abilita Test su prestito o Test al ritorno per specificare che gli oggetti vengono convalidati prima di essere presi in prestito o restituiti rispettivamente da e al pool.
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:
Tocca Salva per salvare la configurazione.
Se il modello dati di Forms contiene un oggetto che è una parola chiave riservata per il database relazionale, può causare problemi di aggiunta, aggiornamento o recupero di dati. Evita quindi di utilizzare tali oggetti nel modello dati del modulo.
Puoi configurare il profilo utente AEM utilizzando la configurazione del connettore profilo utente nella console web AEM. Effettua le seguenti operazioni:
Vai alla console web dell’AEM all’indirizzo https://'[server]:[porta]'system/console/configMgr.
Cerca Integrazioni dei dati di AEM Forms - Configurazione del connettore del profilo utente e tocca per aprire la configurazione in modalità di modifica.
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'utilizzo nel modello dati del modulo. Utilizza il seguente formato 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
Il * nell’esempio precedente indica tutti i nodi sotto il profile/empLocation/
nodo nel profilo utente AEM nella struttura CRXDE. Significa che il modello dati del modulo può accedere a city
proprietà di tipo string
presente in qualsiasi nodo sotto profile/empLocation/
nodo. Tuttavia, i nodi che contengono la proprietà specificata devono seguire una struttura coerente.
Tocca Salva per salvare la configurazione.
Per configurare i servizi cloud per i servizi RESTful, SOAP e OData è necessaria la configurazione della cartella Servizi cloud.
Tutte le configurazioni dei servizi cloud in AEM sono consolidate in /conf
cartella nell’archivio AEM. 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:
Vai a Strumenti > Generale > Browser configurazioni.
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.
In Browser configurazioni, seleziona la global
cartella e tocca Proprietà.
In Proprietà di configurazione finestra di dialogo, abilita Configurazioni cloud.
Tocca Salva e chiudi per salvare la configurazione e uscire dalla finestra di dialogo.
In Browser configurazioni, tocca Crea.
In Crea configurazione , specifica un titolo per la cartella e abilita Configurazioni cloud.
Tocca Crea per creare la cartella abilitata per le configurazioni del servizio cloud.
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 nei servizi cloud AEM, accertati di disporre del file Swagger sul file system o dell’URL in cui è ospitato il file.
Per configurare i servizi RESTful, effettuare le seguenti operazioni:
Vai a Strumenti > Cloud Service > 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.
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.
Specificare i dettagli seguenti per il servizio RESTful:
Selezionate URL o File dal menu a discesa Origine Swagger, quindi specificate l'URL Swagger nel file di definizione Swagger o caricate il file Swagger dal file system locale.
In base all’input di Sorgente Swagger, 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 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.
Seleziona il tipo di autenticazione: Nessuno, OAuth2.0(Codice di autorizzazione, Credenziali client), autenticazione di base, chiave API, autenticazione personalizzata o autenticazione reciproca 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.
Se si seleziona Autenticazione reciproca come tipo di autenticazione, consulta Autenticazione reciproca basata su certificato per i servizi web RESTful e SOAP.
Tocca Crea per creare la configurazione cloud per il servizio RESTful.
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.
Per configurare il client HTTP del modello dati modulo, effettua le seguenti operazioni:
Accedi a Experience Manager Forms Crea istanza come amministratore e passa a Experience Manager bundle della console web. L’URL predefinito è https://localhost:4502/system/console/configMgr.
Tocca Configurazione client HTTP modello dati modulo per origine dati REST.
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 è 2 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.
I servizi web basati su SOAP sono descritti utilizzando Specifiche di Web Services Description Language (WSDL). Per configurare il servizio Web basato su SOAP nei servizi cloud AEM, verificare di disporre dell'URL WSDL per il servizio Web e procedere come segue:
Vai a Strumenti > Cloud Service > 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.
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.
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, autenticazione personalizzata, token X509 o autenticazione reciproca per accedere al servizio SOAP e fornire di conseguenza i dettagli per l'autenticazione.
Se si seleziona Token X509 come tipo di autenticazione, configura il certificato X509. Per ulteriori informazioni, consulta Configurare i certificati.
Specifica l’alias KeyStore per il certificato X509 in Alias chiave campo. Specifica il tempo, in secondi, rimanente la validità della richiesta di autenticazione, nel Time To Live campo. Facoltativamente, seleziona per firmare il corpo del messaggio o l’intestazione della marca temporale o entrambi.
Se si seleziona Autenticazione reciproca come tipo di autenticazione, consulta Autenticazione reciproca basata su certificato per i servizi web RESTful e SOAP.
Tocca Crea per creare la configurazione cloud per il servizio web SOAP.
Un servizio OData è identificato dall'URL radice del servizio. Per configurare un servizio OData nei servizi cloud AEM, accertarsi di disporre dell'URL principale del servizio ed eseguire le operazioni seguenti:
Il modello dati del modulo supporta OData versione 4.
Per una guida dettagliata alla configurazione di Microsoft Dynamics 365, online o on-premise, consulta Configurazione Microsoft Dynamics OData.
Vai a Strumenti > Cloud Service > 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.
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.
Specificare i dettagli seguenti per il servizio OData:
È necessario selezionare il tipo di autenticazione OAuth 2.0 per connettersi ai servizi Microsoft Dynamics utilizzando l’endpoint OData come radice del servizio.
Tocca Crea per creare la configurazione cloud per il servizio OData.
Quando si abilita l'autenticazione reciproca per il modello dati modulo, sia l'origine dati che il server AEM che esegue il modello dati modulo autenticano l'identità dell'altro 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:
fd-cloudservice
utente e tocca Proprietà.fd-cloudservice
utente, specifica il nome dell’alias chiave per il certificato.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.