Utilizzo del repository AEM Forms

Esempi ed esempi in questo documento sono solo per AEM Forms in ambiente JEE.

Informazioni sul servizio Repository

Il servizio Repository fornisce servizi di archiviazione e gestione delle risorse ad AEM Forms. Quando gli sviluppatori creano un'applicazione AEM Forms, possono distribuire le risorse nell'archivio invece che nel file system. Le risorse possono includere qualsiasi tipo di materiale collaterale, inclusi moduli XML, PDF forms (inclusi i moduli Acrobat), frammenti di modulo, immagini, profili, criteri, file SWF, file DDX, schemi XML, file WSDL e dati di test.

Ad esempio, considera la seguente applicazione Forms denominata Applicazioni/FormsApplication:

ww_ww_formrepository

Tenere presente che nella cartella FormsFolder è presente un file denominato Loan.xdp. Per accedere a questa struttura del modulo, specificare il percorso completo (inclusa la versione): Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.

NOTA

Per informazioni sulla creazione di un'applicazione Forms tramite Workbench, vedere la Guida di Workbench.

Il percorso di una risorsa situata nell’archivio AEM Forms è:

Applications/Application-name/Application-version/Folder.../Filename

I seguenti valori mostrano alcuni esempi di valori URI:

  • Applications/AppraisalReport/1.0/Forms/FullForm.xdp
  • Applications/AnotherApp/1.1/Assets/picture.jpg
  • Applications/SomeApp/2.0/Resources/Data/XSDs/MyData.xsd
NOTA

È possibile sfogliare l’archivio AEM Forms utilizzando un browser web. Per sfogliare l'archivio, immetti il seguente URL in un browser Web https://[server name]:[server port]/repository. Puoi verificare i risultati di avvio rapido associati alla sezione Utilizzo dell’archivio AEM Forms utilizzando un browser web. Ad esempio, se aggiungi contenuto all’archivio AEM Forms, puoi visualizzarne il contenuto in un browser web. (Vedere Avvio rapido (modalità SOAP): Scrittura di una risorsa tramite l'API Java.)

L’API dell’archivio fornisce una serie di operazioni che è possibile utilizzare per memorizzare e recuperare informazioni dall’archivio. Ad esempio, puoi ottenere un elenco di risorse o recuperare risorse specifiche memorizzate nell’archivio quando una risorsa è necessaria durante l’elaborazione di un’applicazione.

NOTA

L’API dell’archivio non può essere utilizzata per interagire con Content Services (obsoleto). Per interagire con Content Services (obsoleto), utilizza l’API di gestione dei documenti.

Utilizzando l’API del servizio Repository, puoi eseguire le seguenti attività:

NOTA

Utilizzando l’API dell’archivio, non puoi gestire il controllo dell’accesso alle risorse, cercare risorse o specificare relazioni tra le risorse utilizzando un archivio ECM.

NOTA

Quando un PDF crittografato viene scritto nell’archivio, non è possibile utilizzare la funzione di estrazione della relazione automatica. In caso contrario, un PDF crittografato può essere archiviato nell'archivio e successivamente recuperato. Il recuperatore può scegliere di decrittografare il PDF dopo averlo recuperato dal repository.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Creazione di cartelle

Le cartelle (raccolte di risorse) vengono utilizzate per memorizzare gli oggetti (file o risorse) nei raggruppamenti organizzati. Le cartelle possono contenere risorse e altre cartelle, dette anche sottocartelle. Le risorse possono essere memorizzate solo in una cartella alla volta.

I file ereditano gli elenchi di controllo di accesso (ACL, Access Control List) dalle cartelle e le sottocartelle ereditano gli ACL dalle cartelle principali. Pertanto, le cartelle principali devono esistere prima di poter creare cartelle secondarie. L’IDE consente di interagire solo a livello di cartella per cartella, non a livello di singolo file. Non è possibile eseguire la versione delle cartelle e non è necessario farlo; una cartella non contiene dati stessi. Si tratta piuttosto solo di un contenitore per risorse che contengono dati. L'ACL predefinito è un'autorizzazione a livello di sistema, il che significa che gli utenti devono avere autorizzazioni a livello di sistema (lettura, scrittura, attraversamento, gestione delle ACL) finché qualcuno non gli dà le autorizzazioni per una particolare cartella. Le ACL funzionano solo nell'IDE.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per creare una cartella, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea il client di servizio.
  3. Crea la cartella.
  4. Scrivere la cartella nel repository.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.

Creare il client di servizio

Prima di poter creare una raccolta di risorse a livello di programmazione, è necessario stabilire una connessione e fornire le credenziali. Questa operazione viene eseguita creando un client di servizio.

Crea la cartella

Richiama il metodo del servizio Repository per creare la raccolta di risorse e compila la raccolta di risorse con informazioni identificative, tra cui UUID, nome della cartella e descrizione.

Scrivere la cartella nel repository

Richiama il metodo del servizio Repository per scrivere la raccolta di risorse, specificando l’URI della cartella target.

Consulta anche

Creare cartelle utilizzando l’API Java

Creare cartelle utilizzando l’API del servizio Web

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API del servizio archivio

Creare cartelle utilizzando l'API Java

Crea una cartella utilizzando l’API del servizio Repository (Java):

  1. Includi file di progetto

    Includi file di progetto nel percorso di classe del progetto Java.

  2. Creare il client di servizio

    Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory contenente proprietà di connessione.

  3. Crea la cartella

    Per creare una raccolta di risorse, è innanzitutto necessario creare un oggetto com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean.

    Richiama il metodo newResourceCollection dell'oggetto repositoryInfomodelFactoryBean e passa i seguenti parametri:

    • Identificatore UUID com.adobe.repository.infomodel.Id da assegnare alla risorsa.
    • Identificatore UUID com.adobe.repository.infomodel.Lid da assegnare alla risorsa.
    • Un java.lang.String contenente il nome della raccolta di risorse. Esempio, FormsFolder.

    Il metodo restituisce un oggetto com.adobe.repository.infomodel.bean.ResourceCollection che rappresenta la nuova cartella.

    Imposta la descrizione della cartella utilizzando il metodo setDescription e passa il seguente parametro:

    • Un String che descrive la raccolta di risorse. In questo esempio viene utilizzato "test Folder" .
  4. Scrivere la cartella nel repository

    Richiama il metodo writeResource dell'oggetto ResourceRepositoryClient e passa l'URI della cartella e l'oggetto ResourceCollection. Ad esempio, l’URI della cartella può essere il seguente valore /Applications/FormsApplication/1.0/.

    Il metodo restituisce un'istanza dell'oggetto com.adobe.repository.infomodel.bean.Resource appena creato. Ad esempio, è possibile recuperare il valore dell’identificatore della nuova risorsa richiamando il metodo getId dell’oggetto com.adobe.repository.infomodel.bean.Resource.

Consulta anche

Creazione di cartelle

Avvio rapido (modalità SOAP): Creazione di una cartella tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Crea cartelle utilizzando l'API del servizio Web

Crea una cartella utilizzando l’API del servizio Repository (servizio Web):

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizzi la WSDL del repository utilizzando base64.
    • Fare riferimento all'assembly client Microsoft .NET.
  2. Creare il client di servizio

    Utilizzando l'assembly client Microsoft .NET, creare un oggetto RepositoryServiceService richiamando il relativo costruttore predefinito. Imposta la relativa proprietà Credentials utilizzando un oggetto System.Net.NetworkCredential contenente il nome utente e la password.

  3. Crea la cartella

    Crea la cartella utilizzando il costruttore predefinito per la classe ResourceCollection e passa i seguenti parametri:

    • Un oggetto Id, creato richiamando il costruttore predefinito per la classe Id e assegnato al campo Resource dell'oggetto id.
    • Un oggetto Lid, creato richiamando il costruttore predefinito per la classe Lid e assegnato al campo Resource dell'oggetto lid.
    • Una stringa contenente il nome dell’insieme di risorse, assegnato al campo Resource dell’oggetto name. Il nome utilizzato in questo esempio è "testfolder".
    • Una stringa contenente la descrizione dell’insieme di risorse, che viene assegnata al campo Resource dell’oggetto description. La descrizione utilizzata in questo esempio è "test folder".
  4. Scrivere la cartella nel repository

    Richiama il metodo writeResource dell'oggetto RepositoryServiceService e passa i seguenti parametri:

    • Percorso in cui creare la cartella.
    • L'oggetto ResourceCollection che rappresenta la cartella.
    • Passa null per gli altri due parametri.

Consulta anche

Creazione di cartelle

Richiamo di AEM Forms con codifica Base64

Scrittura delle risorse

Puoi creare risorse in una determinata posizione nell’archivio. La dimensione naturale del file è soggetta a limitazioni del database e al timeout della sessione. Per la configurazione predefinita, i file sono limitati a 25 MB. Per aumentare o ridurre la dimensione massima del file, è necessario modificare la configurazione del database.

La scrittura di risorse equivale all’archiviazione dei dati nell’archivio. Una volta scritta una risorsa nell’archivio, questa diventa accessibile a tutti i client nell’ecosistema dell’archivio. Quando scrivi risorse nell’archivio, come schemi XML, file XDP e file XSD, i contenuti vengono analizzati in base al tipo MIME. Se il tipo MIME è supportato, il parser determina se esiste una relazione implicita con altri contenuti. Ad esempio, se un foglio di stile CSS ha un URL relativo che fa riferimento a un CSS comune, si prevede di inviare anche il CSS comune nell’archivio. La relazione tra le due risorse viene memorizzata come relazione in sospeso per un periodo non regolabile di 30 giorni. Quando invii il CSS comune all’archivio entro un periodo di 30 giorni, la relazione viene formata.

Quando crei una risorsa, l’elenco di controllo accessi (ACL) viene ereditato dalla cartella principale. La cartella principale dispone di autorizzazioni a livello di sistema fino alla creazione di una risorsa o di una cartella iniziale, in cui alla risorsa o alla cartella vengono assegnate le autorizzazioni ACL predefinite.

Puoi scrivere le risorse in modo programmatico utilizzando l’API Java del servizio Repository o l’API del servizio Web.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per scrivere una risorsa, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un client del servizio Repository.
  3. Specifica l’URI della risorsa da leggere.
  4. Leggi la risorsa .

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.

Creare il client di servizio

Prima di poter leggere una risorsa in modo programmatico, è necessario stabilire una connessione e fornire le credenziali. Questa operazione viene eseguita creando un client di servizio.

Specifica l’URI della cartella di destinazione per la risorsa

Crea una stringa contenente l’URI della risorsa da leggere. La sintassi include le barre, come in questo esempio: "/percorso/cartella".

Creare la risorsa

Richiama il metodo del servizio Repository per creare la risorsa e compila la risorsa con informazioni identificative, compreso il suo UUID, il nome della risorsa e la descrizione.

Specifica il contenuto della risorsa

Richiama il metodo del servizio Repository per creare il contenuto della risorsa e archiviarlo nella risorsa.

Scrivere la risorsa nella cartella di destinazione

Richiama il metodo del servizio Repository per scrivere la risorsa, specificando l’URI della cartella di destinazione.

Consulta anche

Scrivere risorse utilizzando l’API Java

Creazione di risorse tramite l’API del servizio Web

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API del servizio archivio

Scrivere risorse utilizzando l'API Java

Scrivere una risorsa utilizzando l’API del servizio Repository (Java):

  1. Includi file di progetto

    Includi file JAR client nel percorso di classe del progetto Java.

  2. Creare il client di servizio

    Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory contenente proprietà di connessione.

  3. Specifica l’URI della cartella di destinazione per la risorsa

    Specifica l’URI della cartella di destinazione per la risorsa. In questo caso, poiché la risorsa denominata testResource verrà memorizzata nella cartella denominata testFolder, l’URI della cartella è "/testFolder". L’URI viene memorizzato come oggetto java.lang.String.

  4. Creare la risorsa

    Per creare una risorsa, è innanzitutto necessario creare un oggetto com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean.

    Richiama il metodo newResource dell'oggetto RepositoryInfomodelFactoryBean, che crea un oggetto com.adobe.repository.infomodel.bean.Resource. In questo esempio vengono forniti i seguenti parametri:

    • Un oggetto com.adobe.repository.infomodel.Id, creato richiamando il costruttore predefinito per la classe Id.
    • Un oggetto com.adobe.repository.infomodel.Lid, creato richiamando il costruttore predefinito per la classe Lid.
    • Una java.lang.String contenente il nome file della risorsa.

    Per specificare la descrizione della risorsa, richiamare il metodo setDescription dell’oggetto Resource e passare una stringa contenente la descrizione. In questo esempio, la descrizione è "test resource".

  5. Specifica il contenuto della risorsa

    Per creare contenuto per la risorsa, richiamare il metodo newResourceContent dell’oggetto com.adobe.repository.infomodel.bean.ResourceContent che restituisce un oggetto RepositoryInfomodelFactoryBean. Aggiungi contenuto all’oggetto ResourceContent . In questo esempio, questa operazione viene eseguita eseguendo le seguenti attività:

    • Richiamare il metodo setDataDocument dell'oggetto ResourceContent e passare un oggetto com.adobe.idp.Document
    • Richiamo del metodo setSize dell'oggetto ResourceContent e trasmissione delle dimensioni in byte dell'oggetto Document

    Aggiungi il contenuto alla risorsa richiamando il metodo setContent dell’oggetto ResourceContent e passando l’oggetto Resource . Per ulteriori informazioni, consulta Riferimento API di AEM Forms.

  6. Scrivere la risorsa nella cartella di destinazione

    Richiama il metodo writeResource dell'oggetto ResourceRepositoryClient e passa l'URI della cartella, nonché l'oggetto Resource.

Consulta anche

Scrittura delle risorse

Avvio rapido (modalità SOAP): Scrittura di una risorsa tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Scrivere risorse utilizzando l'API del servizio Web

Scrivere una risorsa utilizzando l’API del servizio Repository (servizio Web):

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizzi la WSDL del repository utilizzando base64.
    • Fare riferimento all'assembly client Microsoft .NET.
  2. Creare il client di servizio

    Utilizzando l'assembly client Microsoft .NET, creare un oggetto RepositoryServiceService richiamando il relativo costruttore predefinito. Imposta la relativa proprietà Credentials utilizzando un oggetto System.Net.NetworkCredential contenente il nome utente e la password.

  3. Specifica l’URI della cartella di destinazione per la risorsa

    Specifica l’URI della cartella di destinazione per la risorsa. In questo caso, poiché la risorsa denominata testResource verrà memorizzata nella cartella denominata testFolder, l’URI della cartella è "/testFolder". Quando si utilizza un linguaggio conforme a Microsoft .NET Framework (ad esempio, C#), memorizzare l’URI in un oggetto System.String.

  4. Creare la risorsa

    Per creare una risorsa, richiamare il costruttore predefinito per la classe Resource. In questo esempio, le seguenti informazioni vengono memorizzate nell'oggetto Resource :

    • Un oggetto com.adobe.repository.infomodel.Id, creato richiamando il costruttore predefinito per la classe Id e assegnato al campo Resource dell'oggetto id.
    • Un oggetto com.adobe.repository.infomodel.Lid, creato richiamando il costruttore predefinito per la classe Lid e assegnato al campo Resource dell'oggetto lid.
    • Una stringa contenente il nome file della risorsa, che viene assegnata al campo name dell’oggetto Resource. Il nome utilizzato in questo esempio è "testResource".
    • Una stringa contenente la descrizione della risorsa, assegnata al campo description dell’oggetto Resource. La descrizione utilizzata in questo esempio è "test resource".
  5. Specifica il contenuto della risorsa

    Per creare contenuto per la risorsa, richiamare il costruttore predefinito per la classe ResourceContent . Quindi aggiungi il contenuto all’oggetto ResourceContent . In questo esempio, questa operazione viene eseguita eseguendo le seguenti attività:

    • Assegnazione di un oggetto BLOB contenente un documento al campo ResourceContent dell'oggetto dataDocument.
    • Assegnazione delle dimensioni in byte dell'oggetto BLOB al campo ResourceContent dell'oggetto size.

    Aggiungi il contenuto alla risorsa assegnando l’oggetto ResourceContent al campo Resource dell’oggetto content.

  6. Scrivere la risorsa nella cartella di destinazione

    Richiama il metodo writeResource dell'oggetto RepositoryServiceService e passa l'URI della cartella, nonché l'oggetto Resource. Passa null per gli altri due parametri.

Consulta anche

Scrittura delle risorse

Richiamo di AEM Forms con codifica Base64

Risorse di elenco

Puoi individuare le risorse elencando le risorse. Viene eseguita una query sull’archivio per trovare tutte le risorse correlate a una determinata raccolta di risorse.

Una volta organizzate le risorse, è possibile esaminare la struttura creata visualizzando un particolare ramo della struttura, come si farebbe in un sistema operativo.

Le risorse di elenco operano per relazione: Le risorse sono membri di cartelle. L'appartenenza è rappresentata da una relazione di tipo "membro di". Quando elenchi le risorse in una determinata cartella, esegui una query per individuare le risorse correlate a una determinata cartella dalla relazione "membro di". Le relazioni sono direzionali: un membro di una relazione ha un'origine che è membro del target. L'origine è la risorsa; la destinazione è la cartella principale.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per elencare le risorse, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea il client di servizio.
  3. Specifica il percorso della cartella.
  4. Recupera l’elenco delle risorse.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.

Creare il client di servizio

Prima di poter creare una raccolta di risorse a livello di programmazione, è necessario stabilire una connessione e fornire le credenziali. Questa operazione viene eseguita creando un client di servizio.

Specifica il percorso della cartella

Crea una stringa contenente il percorso della cartella contenente le risorse. La sintassi include le barre, come in questo esempio: "/percorso/cartella".

Recupera l’elenco delle risorse

Richiama il metodo del servizio Repository per recuperare l’elenco delle risorse, specificando il percorso della cartella target.

Consulta anche

Elencare le risorse utilizzando l’API Java

Elencare risorse tramite l’API del servizio Web

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API del servizio archivio

Elencare le risorse utilizzando l'API Java

Elencare le risorse utilizzando l’API del servizio Repository (Java):

  1. Includi file di progetto

    Includi file JAR client nel percorso di classe del progetto Java.

  2. Creare il client di servizio

    Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory contenente proprietà di connessione.

  3. Specifica il percorso della cartella

    Specifica l’URI della raccolta di risorse da interrogare. In questo caso, il relativo URI è "/testFolder". L’URI viene memorizzato come oggetto java.lang.String.

  4. Recupera l’elenco delle risorse

    Richiama il metodo listMembers dell'oggetto ResourceRepositoryClient e passa l'URI della cartella.

    Il metodo restituisce un java.util.List di com.adobe.repository.infomodel.bean.Resource oggetti che costituiscono l'origine di un com.adobe.repository.infomodel.bean.Relation di tipo Relation.TYPE_MEMBER_OF e che hanno come destinazione l'URI di raccolta delle risorse. Puoi eseguire iterazioni in questo percorso List per recuperare ciascuna delle risorse. In questo esempio vengono visualizzati il nome e la descrizione di ciascuna risorsa.

Consulta anche

Elencare le risorse.

Avvio rapido (modalità SOAP): Inserimento di risorse nell’elenco tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Elencare le risorse utilizzando l'API del servizio Web

Elencare le risorse utilizzando l'API del servizio Repository (servizio Web):

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizzi la WSDL del repository.
    • Fare riferimento all'assembly client Microsoft .NET.
  2. Creare il client di servizio

    Utilizzando l'assembly client Microsoft .NET, creare un oggetto RepositoryServiceService richiamando il relativo costruttore predefinito. Imposta la relativa proprietà Credentials utilizzando un oggetto System.Net.NetworkCredential contenente il nome utente e la password.

  3. Specifica il percorso della cartella

    Specifica una stringa contenente l’URI della cartella da interrogare. In questo caso, il relativo URI è "/testFolder". Quando si utilizza un linguaggio conforme a Microsoft .NET Framework (ad esempio, C#), memorizzare l’URI in un oggetto System.String.

  4. Recupera l’elenco delle risorse

    Richiama il metodo listMembers dell'oggetto RepositoryServiceService e passa l'URI della cartella come primo parametro. Passa null per gli altri due parametri.

    Il metodo restituisce una matrice di oggetti che possono essere inseriti in oggetti Resource. È possibile eseguire iterazioni attraverso l’array di oggetti per recuperare ciascuna delle risorse correlate. In questo esempio vengono visualizzati il nome e la descrizione di ciascuna risorsa.

Consulta anche

Elencare le risorse.

Richiamo di AEM Forms con codifica Base64

Lettura delle risorse

Puoi recuperare risorse da una determinata posizione nell’archivio per leggerne il contenuto e i metadati. Il flusso di lavoro è preceduto da un modulo di inizializzazione. Il processo dispone di tutte le autorizzazioni necessarie per leggere il modulo. Il sistema recupera il modulo dati e legge il contenuto dal repository. L’archivio consente l’accesso al contenuto e ai metadati (la possibilità di sapere che la risorsa esiste).

L’archivio dispone dei seguenti quattro tipi di autorizzazioni:

  • traverse: consente di elencare le risorse; ovvero per leggere i metadati delle risorse, ma non il contenuto delle risorse
  • leggi: consente di leggere il contenuto delle risorse
  • scrivi: consente di scrivere il contenuto delle risorse
  • gestione degli elenchi di controllo accessi (ACL): consente di manipolare ACL sulle risorse

Gli utenti possono eseguire i processi solo quando dispongono delle autorizzazioni necessarie per eseguire il processo. Per eseguire la sincronizzazione con l’archivio, gli utenti IDE devono disporre di autorizzazioni di lettura e lettura. Le ACL si applicano solo in fase di progettazione perché il runtime si verifica all'interno del contesto di sistema.

Puoi leggere le risorse in modo programmatico utilizzando l’API Java del servizio Repository o l’API del servizio Web.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per leggere una risorsa, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un client del servizio Repository.
  3. Specifica l’URI della risorsa da leggere.
  4. Leggi la risorsa .

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.

Creare il client di servizio

Prima di poter leggere una risorsa in modo programmatico, è necessario stabilire una connessione e fornire le credenziali. Questa operazione viene eseguita creando un client di servizio.

Specifica l’URI della risorsa da leggere

Crea una stringa contenente l’URI della risorsa da leggere. La sintassi include le barre, come in questo esempio: "/percorso/risorsa".

Leggi la risorsa

Richiama il metodo del servizio Repository per leggere la risorsa, specificando l'URI.

Consulta anche

Leggi le risorse tramite l’API Java

Lettura delle risorse tramite l’API del servizio Web

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API del servizio archivio

Leggi le risorse utilizzando l'API Java

Leggi una risorsa utilizzando l’API del servizio Repository (Java):

  1. Includi file di progetto

    Includi file JAR client nel percorso di classe del progetto Java.

  2. Creare il client di servizio

    Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory contenente proprietà di connessione.

  3. Specifica l’URI della risorsa da leggere

    Specifica un valore stringa che rappresenta l’URI della risorsa da recuperare. Ad esempio, supponendo che la risorsa sia denominata testResource che si trovi in una cartella denominata testFolder, specifica /testFolder/testResource.

  4. Leggi la risorsa

    Richiama il metodo readResource dell’oggetto ResourceRepositoryClient e passa l’URI della risorsa come parametro. Questo metodo restituisce un'istanza Resource che rappresenta la risorsa.

Consulta anche

Lettura delle risorse

Avvio rapido (modalità SOAP): Lettura di una risorsa tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Lettura delle risorse tramite l'API del servizio Web

Leggi una risorsa utilizzando l’API del servizio Repository (servizio Web):

  1. Includi file di progetto

  2. Creare il client di servizio

    Utilizzando l'assembly client Microsoft .NET, creare un oggetto RepositoryServiceService richiamando il relativo costruttore predefinito. Imposta la relativa proprietà Credentials utilizzando un oggetto System.Net.NetworkCredential contenente il nome utente e la password.

  3. Specifica l’URI della risorsa da leggere

    Specifica una stringa contenente l’URI della risorsa da recuperare. In questo caso, poiché la risorsa denominata testResource si trova nella cartella denominata testFolder, il relativo URI è "/testFolder/testResource". Quando si utilizza un linguaggio conforme a Microsoft .NET Framework (ad esempio, C#), memorizzare l’URI in un oggetto System.String.

  4. Leggi la risorsa

    Richiama il metodo readResource dell’oggetto RepositoryServiceService e passa l’URI della risorsa come primo parametro. Passa null per gli altri due parametri.

Consulta anche

Lettura delle risorse

Richiamo di AEM Forms con codifica Base64

Aggiornamento delle risorse

Puoi recuperare e aggiornare il contenuto delle risorse nella directory archivio. Quando aggiorni le risorse, il controllo di accesso a tali risorse rimane invariato tra le versioni. Quando si esegue un aggiornamento, è possibile incrementare la versione principale. Se non scegli di incrementare la versione principale, la versione secondaria viene aggiornata automaticamente.

Quando aggiorni una risorsa, la nuova versione viene creata in base agli attributi di risorsa specificati. Quando aggiorni una risorsa, specifichi due parametri importanti: l’URI di destinazione e un’istanza di risorsa contenente tutti i metadati aggiornati. È importante notare che se non stai modificando un dato attributo (ad esempio, il nome), l'attributo è ancora richiesto nell'istanza passata. Le relazioni create durante l’analisi del contenuto vengono aggiunte alla versione specifica e non vengono portate avanti a meno che non sia specificato.

Ad esempio, se aggiorni un file XDP che contiene riferimenti ad altre risorse, verranno registrati anche tali riferimenti aggiuntivi. Supponiamo che form.xdp versione 1.0 abbia due riferimenti esterni: un logo e un foglio di stile e successivamente si aggiorna form.xdp in modo che ora abbia tre riferimenti: un logo, un foglio di stile e un file di schema. Durante l'aggiornamento, il repository aggiungerà la terza relazione (al file di schema) alla sua tabella di relazione in sospeso. Una volta che il file di schema è presente nell'archivio, la relazione viene formata automaticamente. Tuttavia, se form.xdp versione 2.0 non utilizza più il logo, la versione 2.0 di form.xdp non avrà alcuna relazione con il logo.

Tutte le operazioni di aggiornamento sono atomiche e transazionali. Ad esempio, se due utenti leggono la stessa risorsa ed entrambi decidono di aggiornare la versione 1.0 alla versione 2.0, uno avrà successo e uno di loro avrà esito negativo, verrà mantenuta l’integrità dell’archivio e a entrambi verrà visualizzato un messaggio di conferma del successo o dell’errore. Se la transazione non si esegue il commit, eseguirà il rollback in caso di errore del database e si verificherà il timeout o il rollback a seconda del server dell'applicazione.

Puoi aggiornare programmaticamente le risorse utilizzando l’API Java del servizio Repository o l’API del servizio Web.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per aggiornare una risorsa, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un client del servizio Repository.
  3. Recupera la risorsa da aggiornare.
  4. Aggiorna la risorsa.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.

Creare il client di servizio

Prima di poter leggere una risorsa in modo programmatico, è necessario stabilire una connessione e fornire le credenziali. Questa operazione viene eseguita creando un client di servizio.

Recupera la risorsa da aggiornare

Leggi la risorsa . Per ulteriori informazioni, vedere Lettura delle risorse.

Aggiorna la risorsa

Imposta le nuove informazioni nella risorsa e richiama il metodo del servizio Repository per aggiornare la risorsa, specificando l’URI, la risorsa aggiornata e la modalità di aggiornamento delle informazioni sulla versione.

Consulta anche

Aggiornare le risorse utilizzando l’API Java

Aggiornare le risorse utilizzando l’API del servizio Web

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API del servizio archivio

Aggiornare le risorse utilizzando l'API Java

Aggiornare una risorsa utilizzando l’API del servizio Repository (Java):

  1. Includi file di progetto

    Includi file JAR client nel percorso di classe del progetto Java.

  2. Creare il client di servizio

    Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory contenente proprietà di connessione.

  3. Recupera la risorsa da aggiornare

    Specifica l’URI della risorsa da recuperare e leggere. In questo esempio, l’URI della risorsa è "/testFolder/testResource".

  4. Aggiorna la risorsa

    Aggiornare le informazioni relative all’oggetto Resource. In questo esempio, per aggiornare la descrizione, richiamare il metodo setDescription dell’oggetto Resource e passare la nuova stringa di descrizione come parametro.

    Quindi richiama il metodo updateResource dell'oggetto ServiceClientFactory e passa i seguenti parametri:

    • Un oggetto java.lang.String contenente l’URI della risorsa.
    • L'oggetto Resource contenente le informazioni aggiornate sulla risorsa.
    • Un valore boolean che indica se aggiornare la versione principale o secondaria. In questo esempio, viene trasmesso un valore di true per indicare che la versione principale deve essere incrementata.

Consulta anche

Aggiornamento delle risorse

Avvio rapido (modalità SOAP): Aggiornamento di una risorsa tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Aggiornare le risorse utilizzando l'API del servizio Web

Aggiornare una risorsa utilizzando l’API Repository (servizio Web):

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizzi la WSDL del repository.
    • Fare riferimento all'assembly client Microsoft .NET.
  2. Creare il client di servizio

    Utilizzando l'assembly client Microsoft .NET, creare un oggetto RepositoryServiceService richiamando il relativo costruttore predefinito. Imposta la relativa proprietà Credentials utilizzando un oggetto System.Net.NetworkCredential contenente il nome utente e la password.

  3. Recupera la risorsa da aggiornare

    Specifica l’URI della risorsa da recuperare e legge la risorsa. In questo esempio, l’URI della risorsa è "/testFolder/testResource". Per ulteriori informazioni, vedere Lettura delle risorse.

  4. Aggiorna la risorsa

    Aggiornare le informazioni relative all’oggetto Resource. In questo esempio, per aggiornare la descrizione, assegnare un nuovo valore al campo Resource dell’oggetto description.

  5. Richiama il metodo updateResource dell'oggetto RepositoryServiceService e passa i seguenti parametri:

    • Un oggetto System.String contenente l’URI della risorsa.
    • L'oggetto Resource contenente le informazioni aggiornate sulla risorsa.
    • Un valore boolean che indica se aggiornare la versione principale o secondaria. In questo esempio, viene trasmesso un valore di true per indicare che la versione principale deve essere incrementata.
    • Passa null per i due parametri rimanenti.

Consulta anche

Aggiornamento delle risorse

Richiamo di AEM Forms con codifica Base64

Ricerca di risorse

È possibile creare query utilizzate per cercare risorse nell’archivio, inclusi cronologia, risorse correlate e proprietà.

È possibile recuperare le risorse correlate per determinare le dipendenze tra un modulo e i relativi frammenti. Ad esempio, se si dispone di un modulo è possibile determinare quali frammenti o risorse esterne utilizza. Se disponi di un’immagine, puoi anche scoprire quali moduli utilizzano l’immagine. Puoi anche cercare risorse correlate utilizzando un filtro basato sulle proprietà. Ad esempio, è possibile cercare tutti i moduli che utilizzano un’immagine con un nome specificato o trovare un’immagine utilizzata da un modulo con un nome specifico. Puoi anche eseguire ricerche utilizzando le proprietà delle risorse. Ad esempio, è possibile eseguire una query per trovare tutte le maschere o le risorse il cui nome inizia con una stringa che può includere i caratteri jolly ’%’ e ’_’. Ricorda che le ricerche basate sulle proprietà non sono basate sulle relazioni; tali ricerche si basano sul presupposto che tu disponga di conoscenze specifiche su una determinata risorsa.

Istruzioni di query

Una query contiene una o più istruzioni collegate logicamente con condizioni. Un istruzione è costituito da un operando a sinistra, un operatore e un operando a destra. Inoltre, puoi specificare l’ordinamento da utilizzare per i risultati della ricerca. L' ordinamento contiene informazioni equivalenti a una clausola SQL ORDER BY ed è composto da elementi che contengono gli attributi su cui si è basata la ricerca, nonché un valore che indica se utilizzare l'ordine crescente o decrescente.

Puoi cercare le risorse in modo programmatico utilizzando l’API Java del servizio Repository. Al momento, non è possibile utilizzare l’API del servizio Web per cercare le risorse.

Comportamento dell'ordinamento

L’ordinamento non viene rispettato quando si richiama il metodo searchProperties dell’oggetto ResourceRepositoryClient e si specifica un ordinamento. Ad esempio, si supponga di creare una risorsa con tre proprietà personalizzate, in cui i nomi degli attributi sono name, secondName e asecondName. Successivamente, crei un elemento di ordinamento sul nome dell'attributo e imposta il valore ascending su true.

Quindi si richiama il metodo searchProperties dell'oggetto ResourceRepositoryClient e si passa all'ordinamento. La ricerca restituisce la risorsa corretta, con le tre proprietà . Tuttavia, le proprietà non vengono ordinate in base al nome dell'attributo. Vengono restituiti nell’ordine in cui sono stati aggiunti: name, secondName e asecondName.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per cercare le risorse, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un client del servizio Repository.
  3. Specifica la cartella di destinazione per la ricerca.
  4. Specifica gli attributi utilizzati nella ricerca.
  5. Crea la query utilizzata nella ricerca.
  6. Crea l’ordinamento per i risultati della ricerca.
  7. Cerca le risorse.
  8. Recupera le risorse dal risultato della ricerca.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.

Creare il client di servizio

Prima di poter leggere una risorsa in modo programmatico, è necessario stabilire una connessione e fornire le credenziali. Questa operazione viene eseguita creando un client di servizio.

Specifica la cartella di destinazione per la ricerca

Crea una stringa contenente il percorso di base da cui eseguire la ricerca. La sintassi include le barre, come in questo esempio: "/percorso/cartella".

Specifica gli attributi utilizzati nella ricerca

Puoi basare la ricerca sugli attributi contenuti nelle risorse. Specifica i valori degli attributi su cui eseguire la ricerca.

Crea la query utilizzata nella ricerca

Crea una query utilizzando istruzioni e condizioni. Ogni istruzione specifica l'attributo su cui basare la ricerca, la condizione da utilizzare e il valore dell'attributo da utilizzare nella ricerca.

Creare l’ordinamento dei risultati della ricerca

L’ordinamento è composto da elementi, ciascuno dei quali contiene uno degli attributi utilizzati nella ricerca e un valore che indica se deve essere utilizzato l’ordine crescente o decrescente.

Cercare le risorse

Cerca le risorse utilizzando la cartella, la query e l’ordinamento. Inoltre, indicare la profondità della ricerca e un limite superiore al numero di risultati da restituire.

Recupera le risorse dal risultato della ricerca

Itera l’elenco delle risorse restituite ed estrae le informazioni per un’ulteriore elaborazione.

Consulta anche

Cercare risorse utilizzando l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API del servizio archivio

Cerca risorse utilizzando l’API Java

Cerca una risorsa utilizzando l’API del servizio Repository (Java):

  1. Includi file di progetto

    Includi file JAR client nel percorso di classe del progetto Java.

  2. Creare il client di servizio

    Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory contenente proprietà di connessione.

  3. Specifica la cartella di destinazione per la ricerca

    Specificare l'URI del percorso di base da cui eseguire la ricerca. In questo esempio, l’URI della risorsa è /testFolder.

  4. Specifica gli attributi utilizzati nella ricerca

    Specifica i valori degli attributi su cui eseguire la ricerca. Gli attributi esistono all’interno di un oggetto com.adobe.repository.infomodel.bean.Resource. In questo esempio, la ricerca verrà condotta sull'attributo name; pertanto, viene utilizzato un java.lang.String contenente il nome dell'oggetto Resource, che in questo caso è testResource.

  5. Crea la query utilizzata nella ricerca

    Per creare una query, creare un oggetto com.adobe.repository.query.Query richiamando il costruttore predefinito per la classe Query e aggiungere istruzioni alla query.

    Per creare un'istruzione, richiamare il costruttore per la classe com.adobe.repository.query.Query.Statement e trasmettere i seguenti parametri:

    • Un operando sinistro contenente la costante attributo della risorsa. In questo esempio, poiché il nome della risorsa viene utilizzato come base per la ricerca, viene utilizzato il valore statico Resource.ATTRIBUTE_NAME.
    • Operatore che contiene la condizione utilizzata nella ricerca dell’attributo. L'operatore deve essere una delle costanti statiche nella classe Query.Statement . In questo esempio viene utilizzato il valore statico Query.Statement.OPERATOR_BEGINS_WITH.
    • Un operando a destra contenente il valore dell’attributo su cui eseguire la ricerca. In questo esempio, viene utilizzato l’attributo name, a String contenente il valore "testResource".

    Specificare lo spazio dei nomi dell'operando di sinistra richiamando il metodo setNamespace dell'oggetto Query.Statement e passando uno dei valori statici contenuti nella classe com.adobe.repository.infomodel.bean.ResourceProperty. In questo esempio viene utilizzato ResourceProperty.RESERVED_NAMESPACE_REPOSITORY.

    Aggiungi ogni istruzione alla query richiamando il metodo addStatement dell’oggetto Query.Statement e passando l’oggetto Query.

  6. Creare l’ordinamento dei risultati della ricerca

    Per specificare l'ordinamento utilizzato nei risultati della ricerca, creare un oggetto com.adobe.repository.query.sort.SortOrder richiamando il costruttore predefinito per la classe SortOrder e aggiungere elementi all'ordinamento.

    Per creare un elemento per l'ordinamento, richiamare uno dei costruttori per la classe com.adobe.repository.query.sort.SortOrder.Element. In questo esempio, poiché il nome della risorsa viene utilizzato come base per la ricerca, il valore statico Resource.ATTRIBUTE_NAME viene utilizzato come primo parametro e l’ordine crescente (un valore boolean di true) viene specificato come secondo parametro.

    Aggiungi ogni elemento all’ordinamento richiamando il metodo addSortElement dell’oggetto SortOrder e passando l’oggetto SortOrder.Element.

  7. Cercare le risorse

    Per cercare resources in base alle proprietà dell'attributo, richiama il metodo ResourceRepositoryClient dell'oggetto searchProperties e passa i seguenti parametri:

    • Un String contenente il percorso base da cui eseguire la ricerca. In questo caso, viene utilizzato "/testFolder".
    • Query utilizzata nella ricerca.
    • Profondità della ricerca. In questo caso, com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE viene utilizzato per indicare che deve essere utilizzato il percorso di base e tutte le relative cartelle.
    • Un valore int che indica la prima riga da cui selezionare il set di risultati non di paging. In questo esempio viene specificato 0.
    • Un valore int che indica il numero massimo di risultati da restituire. In questo esempio viene specificato 10.
    • Ordine utilizzato nella ricerca.

    Il metodo restituisce un java.util.List di oggetti Resource nell'ordinamento specificato.

  8. Recupera le risorse dal risultato della ricerca

    Per recuperare le risorse contenute nel risultato della ricerca, eseguire iterazioni attraverso List e creare un cast di ciascun oggetto in un Resource per estrarre le relative informazioni. In questo esempio viene visualizzato il nome di ogni risorsa.

Consulta anche

Ricerca di risorse

Avvio rapido (modalità SOAP): Ricerca di risorse tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Creazione di relazioni tra risorse

Puoi specificare le relazioni tra le risorse nella directory archivio. Ci sono tre tipi di relazioni:

  • Dipendenza: una relazione in cui una risorsa dipende da altre risorse, il che significa che tutte le relative risorse sono necessarie nell’archivio.
  • Appartenenza (file system): una relazione in cui una risorsa si trova all'interno di una determinata cartella.
  • Personalizzato: una relazione specificata tra le risorse. Ad esempio, se una risorsa è stata dichiarata obsoleta e un’altra è stata introdotta nell’archivio, puoi specificare una relazione di sostituzione personalizzata.

Puoi creare relazioni personalizzate. Ad esempio, se si memorizza un file HTML nel repository e questo utilizza un'immagine, è possibile specificare una relazione personalizzata per correlare il file HTML con l'immagine (poiché di solito solo i file XML sono associati alle immagini utilizzando una relazione di dipendenza definita dal repository). Un altro esempio di relazione personalizzata è se desideri creare una visualizzazione diversa dell’archivio con una struttura ad albero a grafico ciclico invece che una struttura ad albero. Puoi definire un grafico circolare insieme a un visualizzatore per attraversare tali relazioni. Infine, puoi indicare che una risorsa sostituisce un’altra risorsa anche se le due risorse sono completamente diverse. In tal caso, puoi definire un tipo di relazione al di fuori dell’intervallo riservato e creare una relazione tra queste due risorse. La tua applicazione sarebbe l'unico cliente in grado di rilevare ed elaborare la relazione e potrebbe essere utilizzato per condurre ricerche su tale relazione.

Puoi specificare a livello di programmazione le relazioni tra le risorse utilizzando l’API Java del servizio archivio o l’API del servizio Web.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per specificare una relazione tra due risorse, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un client del servizio Repository.
  3. Specifica gli URI delle risorse da correlare.
  4. Crea la relazione.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.

Creare il client di servizio

Prima di poter leggere una risorsa in modo programmatico, è necessario stabilire una connessione e fornire le credenziali. Questa operazione viene eseguita creando un client di servizio.

Specifica gli URI delle risorse da correlare

Crea stringhe contenenti gli URI della risorsa da correlare. La sintassi include le barre, come in questo esempio: "/percorso/risorsa".

Creare la relazione

Richiamare il metodo del servizio Repository per creare e specificare il tipo di relazione.

Consulta anche

Creare risorse sulle relazioni utilizzando l’API Java

Creare risorse sulle relazioni utilizzando l’API del servizio Web

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API del servizio archivio

Creare risorse sulle relazioni utilizzando l'API Java

Crea risorse sulle relazioni utilizzando l’API Java del servizio Repository ed esegui le seguenti attività:

  1. Includi file di progetto

    Includi file JAR client nel percorso di classe del progetto Java.

  2. Creare il client di servizio

    Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory contenente proprietà di connessione.

  3. Specifica gli URI delle risorse da correlare

    Specifica gli URI delle risorse da correlare. In questo caso, poiché le risorse sono denominate testResource1 e testResource2 e si trovano nella cartella testFolder, i relativi URI sono "/testFolder/testResource1" e "/testFolder/testResource2". Gli URI vengono memorizzati come oggetti java.lang.String. In questo esempio, le risorse vengono scritte per la prima volta nella directory archivio e i relativi URI vengono recuperati. Per ulteriori informazioni sulla scrittura di una risorsa, consulta Scrittura di risorse.

  4. Creare la relazione

    Richiama il metodo createRelationship dell'oggetto ResourceRepositoryClient e passa i seguenti parametri:

    • URI della risorsa di origine.
    • URI della risorsa di destinazione.
    • Il tipo di relazione, che è una delle costanti statiche della classe com.adobe.repository.infomodel.bean.Relation. In questo esempio, viene stabilita una relazione di dipendenza specificando il valore Relation.TYPE_DEPENDANT_OF.
    • Un valore boolean che indica se la risorsa di destinazione viene aggiornata automaticamente all'identificatore basato su com.adobe.repository.infomodel.Id della nuova risorsa head. In questo esempio, a causa della relazione di dipendenza, viene specificato il valore true.

    È inoltre possibile recuperare un elenco delle risorse correlate per una determinata risorsa richiamando il metodo getRelated dell’oggetto ResourceRepositoryClient e passando i seguenti parametri:

    • URI della risorsa per la quale recuperare le risorse correlate. In questo esempio viene specificata la risorsa di origine ( "/testFolder/testResource1").
    • Un valore boolean che indica se la risorsa specificata è la risorsa di origine nella relazione. In questo esempio, il valore true è specificato perché questo è il caso.
    • Il tipo di relazione, che è una delle costanti statiche della classe Relation. In questo esempio, una relazione di dipendenza viene specificata utilizzando lo stesso valore utilizzato in precedenza: Relation.TYPE_DEPENDANT_OF.

    Il metodo getRelated restituisce un java.util.List di oggetti Resource attraverso il quale è possibile iterare per recuperare ciascuna delle risorse correlate, casting gli oggetti contenuti in List in Resource così come si fa. In questo esempio, testResource2 deve essere incluso nell’elenco delle risorse restituite.

Consulta anche

Creazione di relazioni tra risorse

Avvio rapido (modalità SOAP): Creazione di relazioni tra le risorse tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Creare risorse sulle relazioni utilizzando l'API del servizio Web

Creare risorse sulle relazioni utilizzando l’API Repository (servizio Web):

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizzi la WSDL del repository.
    • Fare riferimento all'assembly client Microsoft .NET.
  2. Creare il client di servizio

    Utilizzando l'assembly client Microsoft .NET, creare un oggetto RepositoryServiceService richiamando il relativo costruttore predefinito. Imposta la relativa proprietà Credentials utilizzando un oggetto System.Net.NetworkCredential contenente il nome utente e la password.

  3. Specifica gli URI delle risorse da correlare

    Specifica gli URI delle risorse da correlare. In questo caso, poiché le risorse sono denominate testResource1 e testResource2 e si trovano nella cartella testFolder, i relativi URI sono "/testFolder/testResource1" e "/testFolder/testResource2". Quando si utilizza un linguaggio conforme a Microsoft .NET Framework (ad esempio, C#), gli URI vengono memorizzati come oggetti System.String. In questo esempio, le risorse vengono scritte per la prima volta nella directory archivio e i relativi URI vengono recuperati. Per ulteriori informazioni sulla scrittura di una risorsa, consulta Scrittura di risorse.

  4. Creare la relazione

    Richiama il metodo createRelationship dell'oggetto RepositoryServiceService e passa i seguenti parametri:

    • URI della risorsa di origine.
    • URI della risorsa di destinazione.
    • Tipo di relazione. In questo esempio, viene stabilita una relazione di dipendenza specificando il valore 3.
    • Un valore boolean che indica se è stato specificato il tipo di relazione. In questo esempio viene specificato il valore true.
    • Un valore boolean che indica se la risorsa di destinazione viene aggiornata automaticamente all'identificatore basato su Id della nuova risorsa head. In questo esempio, a causa della relazione di dipendenza, viene specificato il valore true.
    • Un valore boolean che indica se è stata specificata l'intestazione di destinazione. In questo esempio viene specificato il valore true.
    • Passa null per l’ultimo parametro.

    È inoltre possibile recuperare un elenco delle risorse correlate per una determinata risorsa richiamando il metodo getRelated dell’oggetto RepositoryServiceService e passando i seguenti parametri:

    • URI della risorsa per la quale recuperare le risorse correlate. In questo esempio viene specificata la risorsa di origine ( "/testFolder/testResource1").
    • Un valore boolean che indica se la risorsa specificata è la risorsa di origine nella relazione. In questo esempio, il valore true è specificato perché questo è il caso.
    • Un valore boolean che indica se la risorsa di origine è stata specificata. In questo esempio, viene fornito il valore true .
    • Matrice di numeri interi contenente i tipi di relazione. In questo esempio, viene specificata una relazione di dipendenza utilizzando lo stesso valore nell'array utilizzato in precedenza: 3.
    • Passa null per i due parametri rimanenti.

    Il metodo getRelated restituisce un array di oggetti che possono essere inseriti in oggetti Resource attraverso i quali è possibile eseguire iterazioni per recuperare ciascuna delle risorse correlate. In questo esempio, testResource2 deve essere incluso nell’elenco delle risorse restituite.

Consulta anche

Creazione di relazioni tra risorse

Richiamo di AEM Forms con codifica Base64

Blocco delle risorse

È possibile bloccare una risorsa o un insieme di risorse per l'uso esclusivo da parte di un particolare utente o per uso condiviso tra più di un utente. Un blocco condiviso indica che qualcosa succederà alla risorsa, ma non impedisce a nessun altro di intraprendere azioni con tale risorsa. Un blocco condiviso dovrebbe essere considerato un meccanismo di segnalazione. Un blocco esclusivo significa che l’utente che ha bloccato la risorsa cambierà la risorsa e il blocco assicura che nessun altro possa farlo finché l’utente non avrà più bisogno dell’accesso alla risorsa e non avrà rilasciato il blocco. Se un amministratore del repository sblocca una risorsa, tutti i blocchi esclusivi e condivisi su tale risorsa verranno automaticamente rimossi. Questo tipo di azione è destinato alle situazioni in cui un utente non è più disponibile e non ha sbloccato la risorsa.

Quando una risorsa è bloccata, quando visualizzi la scheda Risorse di Workbench viene visualizzata un’icona a forma di lucchetto, come illustrato di seguito.

lr_lr_lockrepository

Puoi controllare programmaticamente l’accesso alle risorse utilizzando l’API Java del servizio Repository o l’API del servizio Web.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per bloccare e sbloccare le risorse, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un client del servizio Repository.
  3. Specifica l’URI della risorsa da bloccare.
  4. Blocca la risorsa.
  5. Recupera i blocchi per la risorsa.
  6. Sblocca la risorsa

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.

Creare il client di servizio

Prima di poter leggere una risorsa in modo programmatico, è necessario stabilire una connessione e fornire le credenziali. Questa operazione viene eseguita creando un client di servizio.

Specifica l’URI della risorsa da bloccare

Crea una stringa contenente l’URI della risorsa da bloccare. La sintassi include le barre, come in questo esempio: "/percorso/risorsa".

Bloccare la risorsa

Richiama il metodo del servizio Repository per bloccare la risorsa, specificando l'URI, il tipo di blocco e la profondità di blocco.

Recupera i blocchi per la risorsa

Richiama il metodo del servizio Repository per recuperare i blocchi per la risorsa, specificando l’URI.

Sblocca la risorsa

Richiama il metodo del servizio Repository per sbloccare la risorsa, specificando l'URI.

Consulta anche

Bloccare le risorse utilizzando l’API Java

Blocco delle risorse tramite l’API del servizio Web

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API del servizio archivio

Bloccare le risorse utilizzando l'API Java

Bloccare le risorse utilizzando l’API del servizio Repository (Java):

  1. Includi file di progetto

    Includi file JAR client nel percorso di classe del progetto Java.

  2. Creare il client di servizio

    Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory contenente proprietà di connessione.

  3. Specifica l’URI della risorsa da bloccare

    Specifica l’URI della risorsa da bloccare. In questo caso, poiché la risorsa denominata testResource si trova nella cartella denominata testFolder, il relativo URI è "/testFolder/testResource". L’URI viene memorizzato come oggetto java.lang.String.

  4. Bloccare la risorsa

    Richiama il metodo lockResource dell'oggetto ResourceRepositoryClient e passa i seguenti parametri:

    • URI della risorsa.
    • L'ambito di blocco. In questo esempio, poiché la risorsa verrà bloccata per uso esclusivo, l’ambito del blocco viene specificato come com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE.
    • La profondità di blocco. In questo esempio, poiché il blocco viene applicato solo alla risorsa in questione e nessuno dei membri o degli elementi secondari, la profondità di blocco viene specificata come Lock.DEPTH_ZERO.
    NOTA

    La versione sovraccaricata del metodo lockResource che richiede quattro parametri genera un'eccezione. Assicurati di utilizzare il metodo lockResource che richiede tre parametri come mostrato in questa procedura dettagliata.

  5. Recupera i blocchi per la risorsa

    Richiama il metodo getLocks dell’oggetto ResourceRepositoryClient e passa l’URI della risorsa come parametro. Il metodo restituisce un elenco di oggetti Lock attraverso i quali è possibile eseguire iterazioni. In questo esempio, il proprietario del blocco, la profondità e l’ambito vengono stampati per ogni oggetto richiamando rispettivamente i metodi getOwnerUserId, getDepth e getType di ciascun oggetto Lock.

  6. Sblocca la risorsa

    Richiama il metodo unlockResource dell’oggetto ResourceRepositoryClient e passa l’URI della risorsa come parametro. Per ulteriori informazioni, consulta Riferimento API di AEM Forms.

Consulta anche

Blocco delle risorse

Avvio rapido (modalità SOAP): Blocco di una risorsa tramite API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Bloccare le risorse utilizzando l'API del servizio Web

Bloccare le risorse utilizzando l’API del servizio Repository (servizio Web):

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizzi il Repository WSDL utilizzando Base64.
    • Fare riferimento all'assembly client Microsoft .NET.
  2. Creare il client di servizio

    Utilizzando l'assembly client Microsoft .NET, creare un oggetto RepositoryServiceService richiamando il relativo costruttore predefinito. Imposta la relativa proprietà Credentials utilizzando un oggetto System.Net.NetworkCredential contenente il nome utente e la password.

  3. Specifica l’URI della risorsa da bloccare

    Specifica una stringa contenente l’URI della risorsa da bloccare. In questo caso, poiché la risorsa denominata testResource si trova nella cartella testFolder, il relativo URI è "/testFolder/testResource". Quando si utilizza un linguaggio conforme a Microsoft .NET Framework (ad esempio, C#), memorizzare l’URI in un oggetto System.String.

  4. Bloccare la risorsa

    Richiama il metodo lockResource dell'oggetto RepositoryServiceService e passa i seguenti parametri:

    • URI della risorsa.
    • L'ambito di blocco. In questo esempio, poiché la risorsa verrà bloccata per uso esclusivo, l’ambito del blocco viene specificato come 11.
    • La profondità di blocco. In questo esempio, poiché il blocco viene applicato solo alla risorsa in questione e nessuno dei membri o degli elementi secondari, la profondità di blocco viene specificata come 2.
    • Un valore int che indica il numero di secondi fino alla scadenza del blocco. In questo esempio viene utilizzato il valore di 1000.
    • Passa null per l’ultimo parametro.
  5. Recupera i blocchi per la risorsa

    Richiama il metodo getLocks dell’oggetto RepositoryServiceService e passa l’URI della risorsa come primo parametro e null come secondo parametro. Il metodo restituisce una matrice object contenente oggetti Lock attraverso i quali è possibile eseguire iterazioni. In questo esempio, il proprietario del blocco, la profondità e l’ambito vengono stampati per ogni oggetto accedendo rispettivamente ai campi Lock, ownerUserId, depth e type di ciascun oggetto.

  6. Sblocca la risorsa

    Richiama il metodo unlockResource dell’oggetto RepositoryServiceService e passa l’URI della risorsa come primo parametro e null come secondo parametro.

Consulta anche

Blocco delle risorse

Richiamo di AEM Forms con codifica Base64

Eliminazione delle risorse

Puoi eliminare programmaticamente le risorse da una determinata posizione nell’archivio utilizzando l’API Java (SOAP) del servizio Repository.

Quando elimini una risorsa, l’eliminazione è normalmente permanente, anche se in alcuni casi gli archivi ECM possono memorizzare le versioni della risorsa in base ai loro meccanismi della cronologia. Pertanto, quando elimini una risorsa, è importante essere sicuri che non sarà più necessaria. I motivi comuni per eliminare una risorsa includono la necessità di aumentare lo spazio disponibile nel database. Puoi eliminare una versione di una risorsa, ma in tal caso devi specificare l’identificatore della risorsa e non il relativo identificatore logico (LID) o il relativo percorso. Se elimini una cartella, tutto ciò che si trova in tale cartella, incluse le sottocartelle e le risorse, verrà eliminato automaticamente.

Le risorse correlate non vengono eliminate. Ad esempio, se si dispone di un modulo che utilizza il file logo.gif ed elimini logo.gif, nella tabella delle relazioni in sospeso verrà memorizzata una relazione. In alternativa, in caso di versione obsoleta, imposta lo stato dell’oggetto dell’ultima versione su obsoleto.

Un'operazione di eliminazione non è sicura per le transazioni nei sistemi ECM. Ad esempio, se tenti di eliminare 100 risorse e l’operazione non riesce sulla 50° risorsa, le prime 49 istanze verranno eliminate ma il resto no. In caso contrario, il comportamento predefinito è il rollback (non impegno).

NOTA

Quando si utilizza il metodo com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources() con l'archivio ECM (EMC Documentum Content Server e IBM FileNet P8 Content Manager), la transazione non verrà ripristinata se l'eliminazione non riesce per una delle risorse specificate, il che significa che i file che sono stati eliminati non possono essere eliminati.

NOTA

Per ulteriori informazioni sul servizio Repository, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi

Per eliminare una risorsa, effettua le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un client del servizio Repository.
  3. Specifica l’URI della risorsa da eliminare.
  4. Elimina la risorsa.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.

Creare il client di servizio

Prima di poter leggere una risorsa in modo programmatico, è necessario stabilire una connessione e fornire le credenziali. Questa operazione viene eseguita creando un client di servizio.

Specifica l’URI della risorsa da eliminare

Crea una stringa contenente l’URI della risorsa da eliminare. La sintassi include le barre, come in questo esempio: "/percorso/risorsa". Se la risorsa da eliminare è una cartella, l’eliminazione sarà ricorsiva.

Elimina la risorsa

Richiama il metodo del servizio Repository per eliminare la risorsa, specificando l'URI.

Consulta anche

Eliminare le risorse utilizzando l’API Java

Eliminare le risorse tramite l’API del servizio Web

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API del servizio archivio

Eliminare le risorse utilizzando l’API Java (SOAP)

Eliminare una risorsa utilizzando l’API Repository (Java):

  1. Includi file di progetto

    Includi file JAR client nel percorso di classe del progetto Java.

  2. Creare il client di servizio

    Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory contenente proprietà di connessione.

  3. Specifica l’URI della risorsa da eliminare

    Specifica l’URI della risorsa da recuperare. In questo caso, poiché la risorsa denominata testResourceToBeDeleted si trova nella cartella denominata testFolder, il relativo URI è /testFolder/testResourceToBeDeleted. L’URI viene memorizzato come oggetto java.lang.String. In questo esempio, la risorsa viene scritta per la prima volta nella directory archivio e viene recuperato il relativo URI. Per ulteriori informazioni sulla scrittura di una risorsa, consulta Scrittura di risorse.

  4. Elimina la risorsa

    Richiama il metodo deleteResource dell’oggetto ResourceRepositoryClient e passa l’URI della risorsa come parametro.

Consulta anche

Eliminazione delle risorse

Avvio rapido (modalità SOAP): Ricerca di risorse tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Eliminare le risorse utilizzando l'API del servizio Web

Eliminare una risorsa utilizzando l’API Repository (servizio Web):

  1. Includi file di progetto

    • Creare un assembly client Microsoft .NET che utilizzi il Repository WSDL utilizzando Base64.
    • Fare riferimento all'assembly client Microsoft .NET.
  2. Creare il client di servizio

    Utilizzando l'assembly client Microsoft .NET, creare un oggetto RepositoryServiceService richiamando il relativo costruttore predefinito. Imposta la relativa proprietà Credentials utilizzando un oggetto System.Net.NetworkCredential contenente il nome utente e la password.

  3. Specifica l’URI della risorsa da eliminare

    Specifica l’URI della risorsa da recuperare. In questo caso, poiché la risorsa denominata testResourceToBeDeleted si trova nella cartella denominata testFolder, il relativo URI è "/testFolder/testResourceToBeDeleted". In questo esempio, la risorsa viene scritta per la prima volta nella directory archivio e viene recuperato il relativo URI. Per ulteriori informazioni sulla scrittura di una risorsa, consulta Scrittura di risorse.

  4. Elimina la risorsa

    Richiama il metodo deleteResources dell’oggetto RepositoryServiceService e passa una matrice System.String contenente l’URI della risorsa come primo parametro. Passa null per il secondo parametro.

Consulta anche

Eliminazione delle risorse

Richiamo di AEM Forms con codifica Base64

In questa pagina