Utilizzo dell’integrazione
Procedura dettagliata
Il video seguente descrive l’utilizzo del connettore:
Configurazione
Questa guida ti guiderà attraverso l’attivazione del connettore.
Installare il pacchetto di integrazione
Riceverai l’accesso al pacchetto di integrazione AEM. Sono disponibili due opzioni per installare l’integrazione:
- Installazione del pacchetto: diretta e meno coinvolta.
- Installazione POM - Più avanzata, ma può essere utile quando si utilizza AEM Cloud Manager e si aggiorna l'integrazione.
Installazione pacchetto
Per installare il pacchetto, scaricalo con il collegamento fornito nell’e-mail di onboarding. Per istruzioni dettagliate sull'installazione di un pacchetto AEM, fare clic qui.
Installazione POM
Per includere il connettore nel POM, eseguire la procedura seguente. Sostituisci nome utente e password con quelli ricevuti nell’e-mail di onboarding.
-
Aggiungi quanto segue al file
.cloudmanager/maven/settings.xml
nel progetto o a~/.m2/settings.xml
nel computer. SostituisciYOUR_USERNAME
con il nome utente eYOUR_PASSWORD
con la password fornita nell'e-mail di onboarding.note important IMPORTANT Se utilizzi Cloud Manager, l'approccio sicuro consiste nel seguire i passaggi qui descritti per archivi Maven protetti da password. code language-none <settings> ... <servers> ... <server> <id>repo.ea.adobe.net</id> <username>YOUR_USERNAME</username> <password>YOUR_PASSWORD</password> <filePermissions>BucketOwnerFullControl</filePermissions> <configuration> <wagonProvider>s3</wagonProvider> </configuration> </server> ... </servers> ... </settings>
-
Aggiungi quanto segue al file
pom.xml
del progetto:code language-none <project> ... <build> ... <extensions> ... <extension> <groupId>com.allogy.maven.wagon</groupId> <artifactId>maven-s3-wagon</artifactId> <version>1.2.0</version> </extension> ... </extensions> ... </build> ... <repositories> ... <repository> <id>repo.ea.adobe.net</id> <url>s3://repo.ea.adobe.net/release</url> <releases> <enabled>true</enabled> </releases> </repository> ... </repositories> ... </project>
-
Aggiungi quanto segue al file
all/pom.xml
del progetto. Sostituireproject.dependencies.dependency.version
con la versione appropriata eproject.build.plugins.plugin.configuration.embeddeds.embedded.target
con il percorso corretto.code language-none <project> ... <build> ... <plugins> ... <plugin> <groupId>org.apache.jackrabbit</groupId> <artifactId>filevault-package-maven-plugin</artifactId> ... <configuration> ... <embeddeds> ... <embedded> <groupId>com.adobe.acs.aemveeva</groupId> <artifactId>aem-veeva-connector.all</artifactId> <type>zip</type> <target>/apps/APP_NAME-packages/application/install</target> </embedded> ... </embeddeds> </configuration> </plugin> ... </plugins> ... </build> ... <dependencies> ... <dependency> <groupId>com.adobe.acs.aemveeva</groupId> <artifactId>aem-veeva-connector.all</artifactId> <version>1.0.5</version> <type>zip</type> </dependency> ... </dependencies> ... </project>
Configurazione cloud
Questa integrazione viene configurata creando una configurazione cloud nella cartella su cui funzionerà il connettore. Per creare una configurazione cloud, effettua le seguenti operazioni:
-
Passa alla configurazione cloud Veeva.
-
Crea una nuova configurazione cloud Veeva nella cartella appropriata e popola il come descritto nelle sezioni successive.
Scheda Configurazione
Compila quanto segue nella scheda di configurazione:
- Obbligatorio. Titolo per la configurazione del connettore Veeva Vault. Questo può essere un valore arbitrario. (esempio:
Veeva Vault Configuration
) - Obbligatorio. URL del dominio dell'istanza Veeva (esempio:
https://my-instance.veevavault.com/
) - Obbligatorio. ClientID richiesto per chiamare l’API Veeva Vault. Può essere un valore arbitrario ed è utilizzato principalmente per il debug. (esempio:
adobe-aem-vvtechpartner
) - Obbligatorio. Nome utente di Veeva Vault. Vedi Creazione utente Veeva.
- Obbligatorio. Password di Veeva Vault. Vedi Creazione utente Veeva.
Scheda I/O Adobe
Se il progetto deve generare PDF o immagini per le pagine, è necessaria questa scheda. Compila quanto segue nella scheda adobe io:
- Obbligatorio. L’endpoint di I/O Adobe per la creazione di immagini PDF fornito nell’e-mail di onboarding. (esempio:
https://my-namespace.adobeioruntime.net/api/v1/web/aem-veeva-serverless-0.0.2/trigger-action.json
) - Obbligatorio. Nome dell'azione per la generazione dell'immagine della pagina. Il valore deve essere
aem-veeva-integration/get-image-async
. - Obbligatorio. Nome dell’azione per la generazione di immagini html. Il valore deve essere
aem-veeva-integration/get-pdf-async-new
. - Obbligatorio. L’endpoint di I/O Adobe per ottenere lo stato della generazione fornito nell’e-mail di onboarding.(esempio:
https://my-namespace.adobeioruntime.net/api/v1/web/aem-veeva-serverless-0.0.2/get-state-value
) - Obbligatorio. Nome utente AEM da utilizzare per l'Adobe I/O. Vedi Creazione utente AEM.
- Obbligatorio. Password AEM da utilizzare per Adobe IO. Vedi Creazione utente AEM.
- Facoltativo. Il timeout predefinito prevede che la pagina risponda fino a un determinato intervallo di tempo dopo il quale il servizio AIO smette di tentare di ottenere una risposta. Il valore predefinito è
30000
. - Facoltativo. Il ritardo si verifica dopo che la pagina ha risposto con 200 per ritardare il rendering di tutte le immagini prima di acquisire una schermata. Il valore predefinito è
2000
. - Facoltativo. L’URL generato da Screenshot/PDF scadrà dopo il valore configurato in secondi.
- Facoltativo. Il servizio di generazione di PDF/screenshot I/O Adobe è asincrono. Il servizio AEM chiama l’endpoint di stato AIO per ottenere screenshot/PDF. Questa proprietà deciderà in millisecondi la pausa tra in ogni chiamata di stato. Il valore predefinito è
10000
. - Facoltativo. Numero massimo di tentativi per la chiamata di stato all’Adobe IO per ottenere screenshot/PDF. Il valore predefinito è
10
.
Scheda Avanzate
Compila quanto segue nella scheda Avanzate:
- Obbligatorio per la generazione di PDF/immagini. Pattern di nome file utilizzato per la creazione di PDF/immagini.
{name}
può essere impostato come modello. (esempio:{name}-screenshot
) - Facoltativo. I tipi di dispositivi per i quali sono necessarie schermate di pagina diverse da Desktop. I tipi validi includono
Tab (iPad)
eMobile (iPhone X)
. - Facoltativo. Il valore del tipo di rappresentazione in Veeva che rappresenta la rappresentazione precedente. (esempio:
web_ready__c
) - Obbligatorio per la generazione di PDF/immagini. Tipo di schermata da creare.
PDF
oImage
. - Obbligatorio per la generazione di PDF/immagini. Tipo di PDF da generare.
Print CSS Based PDF
oPixel Perfect Screenshot PDF
. - Obbligatorio per la generazione di PDF/immagini. Tipo di immagine da generare.
PNG
oJPEG
. - Obbligatorio. Flusso di lavoro da eseguire dopo il trigger di approvazione di Veeva Vault.
- Obbligatorio. Valore della proprietà Status che rappresenta Approvato. (esempio:
Approved for Distribution
) - Obbligatorio. Flusso di lavoro da eseguire dopo il trigger Rifiuto di Veeva Vault.
- Obbligatorio. Valore della proprietà Status che rappresenta Rifiutato/Non approvato. (esempio:
Rejected
) - Facoltativo. Nome proprietà per ID documento in Veeva Vault. Il valore predefinito è
id
. - Facoltativo. Nome proprietà per stato in Veeva Vault. Il valore predefinito è
status__v
. - Facoltativo. Nome proprietà per Data modifica documento. Il valore predefinito è
version_modified_date__v
. - Facoltativo. Nome della proprietà per l'URL della risorsa documento. Il valore predefinito sarà
external_id__v
. Se questo campo è già utilizzato, crea un campo diverso in Veeva e compila qui il nome del campo. Questo campo verrà utilizzato in Veeva per contenere il percorso della risorsa AEM. Questo è necessario per la sincronizzazione automatica dei metadati. - Facoltativo. Nome proprietà per numero di versione principale in Veeva Vault. Il valore predefinito è
major_version_number__v
. - Facoltativo. Nome della proprietà per il numero di versione secondario in Veeva Vault. Il valore predefinito è
minor_version_number__v
. - Facoltativo. Valore del tipo di relazione Veeva Vault. Tutte le risorse aggiunte alla pagina verranno rappresentate come correlate in base a questo valore. Il valore predefinito è
supporting_document__c
.
Scheda Pagina
Se sincronizzi le pagine, compila quanto segue nella scheda della pagina:
-
Obbligatorio. Mappa una proprietà da AEM a Veeva.
a. Nome della proprietà AEM. Selezionabile tra le proprietà AEM. (esempio:jcr:title
){name}
può essere modellato.
b. Il nome della proprietà Veeva immesso esattamente in esiste in Veeva. (esempio:name__v
)
c. Tipo di proprietà.Text
oMultiline Text
. -
Obbligatorio. Mappa una proprietà da Veeva a AEM.
a. Il nome della proprietà Veeva immesso esattamente in esiste in Veeva. (esempio:name__v
)
b. Nome della proprietà AEM. Selezionabile tra le proprietà AEM. (esempio:jcr:title
)
c. Tipo di proprietà.Text
oMultiline Text
.
Scheda Risorsa
Per sincronizzare le risorse, compila quanto segue nella scheda delle risorse:
-
Obbligatorio. Mappa una proprietà da AEM a Veeva.
a. Nome della proprietà AEM. Selezionabile tra le proprietà AEM. (esempio:/jcr:content/metadata/jcr:title
){name}
può essere modellato.
b. Il nome della proprietà Veeva immesso esattamente in esiste in Veeva. (esempio:name__v
)
c. Tipo di proprietà.Text
oMultiline Text
. -
Obbligatorio. Mappa una proprietà da Veeva a AEM.
a. Il nome della proprietà Veeva immesso esattamente in esiste in Veeva. (esempio:name__v
)
b. Nome della proprietà AEM. Selezionabile tra le proprietà AEM. (esempio:/jcr:content/metadata/jcr:title
)
c. Tipo di proprietà.Text
oMultiline Text
.
Configurazione aggiuntiva
Creazione di utenti AEM
Durante la generazione di PDF/immagini, è necessario creare un utente AEM per ottenere pagine dall’AEM. Per creare e assegnare autorizzazioni di sola lettura a un utente, utilizzare i collegamenti seguenti:
Se si utilizza AEM 6.5.5+:
Se si utilizzano Cloud Service AEM:
Le seguenti autorizzazioni sono necessarie per l’utente del servizio AEM sul contenuto che verrà convertito in PDF/Immagine e inviato a Veeva:
- Lettura
Quando crei utenti e imposti autorizzazioni, devi rispettare gli standard di sicurezza delle organizzazioni.
Creazione utente Veeva
Per utilizzare questa integrazione, è necessario creare un utente in Veeva Vault. Per creare un utente, effettua le seguenti operazioni:
-
Passa a Amministratore -> Utenti e gruppi -> Utenti Vault -> Crea
-
Compila gli input richiesti. La configurazione più semplice consiste nell'impostare
License Type
suFull User
eSecurity Profile
suVault Owner
. Al termine, salva.
Per i tipi di documenti Veeva specifici in uso sono necessarie le seguenti autorizzazioni:
- Creare/leggere documenti
- Crea/Leggi versioni
- Crea/aggiorna metadati
- Crea/aggiorna rappresentazioni
Quando crei utenti e imposti autorizzazioni, devi rispettare gli standard di sicurezza delle organizzazioni.