Gestire i metadati dei moduli

Panoramica 

I metadati facilitano la classificazione e l’organizzazione delle risorse e aiutano gli utenti che cercano una risorsa specifica.

Per impostazione predefinita, AEM Forms fornisce un set definito di metadati per ciascun tipo di risorsa. Oltre ai metadati predefiniti, puoi aggiungere metadati personalizzati a ciascuno dei tipi di risorse. AEM Forms consente inoltre di creare, gestire e scambiare in modo efficiente tutti i metadati per i moduli.

Se sei uno sviluppatore o un proprietario del sito, puoi personalizzare Forms Portal, l’interfaccia utente finale di AEM Forms per riflettere i metadati utilizzati nell’organizzazione. Per ulteriori informazioni su Forms Portal, consulta Introduzione alla pubblicazione di moduli su un portale.

Metadati in AEM Forms 

In AEM Forms, l’elenco delle proprietà di metadati associate a una risorsa dipende dal suo tipo. Inoltre, se aggiungi una proprietà di metadati personalizzata, questa viene aggiunta a tutte le risorse del tipo in cui sono stati aggiunti i metadati personalizzati.

Tipi di risorse 

In AEM Forms sono supportati i seguenti tipi di risorse:

  • Modelli di modulo (moduli XFA)
  • PDF forms
  • Documento (PDF semplici)
  • Moduli adattivi
  • Riferimenti
  • XFS

Elenco completo dei metadati

Di seguito è riportato un elenco completo delle proprietà dei metadati supportate in AEM Forms:

Nome proprietà Tipo risorsa Descrizione
Titolo Tutto tranne le risorse Nome visualizzato del modulo.
Descrizione Tutto tranne le risorse Descrizione del modulo. L'utente può specificare questo valore.
Tipo Tutti i bundle

Un valore di sola lettura che specifica il tipo di risorsa. Può avere uno dei seguenti valori:

  • Modello di modulo
  • Modulo PDF, modulo PDF (Acroform) o modulo PDF (Firmato)
  • Documento, documento (firmato)
  • Modulo adattivo
  • Risorsa
Creato Tutti i bundle Un valore di sola lettura che specifica l’ora di creazione delle risorse.
Data ultima modifica Tutti i bundle Un valore di sola lettura che specifica l’ora dell’ultima modifica della risorsa.
Autore Tutto tranne le risorse

Valore di sola lettura calcolato automaticamente in base al tipo di modulo.

  • PDF/Form template/Document - recuperato dal file binario caricato.
  • Modulo adattivo : accesso utente al momento della creazione del modulo.
Stato Tutto tranne le risorse

Valore di sola lettura che definisce uno dei seguenti stati di un modulo:

  • Nessun valore: Se un modulo non è mai stato pubblicato.
  • Pubblicato: Quando viene pubblicato un modulo.
  • Modificato: Quando un modulo è stato modificato dopo essere stato pubblicato una volta.
Data ultima pubblicazione Tutto tranne le risorse Valore di sola lettura che specifica l’ora dell’ultima pubblicazione del modulo.
Ora di attivazione/disattivazione pubblicazione Tutto tranne le risorse

Data e ora in cui è pianificata la pubblicazione automatica o l’annullamento della pubblicazione del modulo. L'utente imposta questo valore sulla modifica dei metadati.

  • L’ora di attivazione e disattivazione della pubblicazione deve essere successiva alla data corrente.
  • Il tempo di pubblicazione deve essere successivo al tempo di pubblicazione.
Invia URL

Modello di modulo

modulo PDF

Per configurare un URL specificato dall’utente per l’invio dei dati del modulo a un servlet.

L’URL di invio può essere configurato utilizzando uno dei seguenti metodi, elencati in ordine di precedenza:

  • Durante la creazione di un modulo XFA in AEM Forms Designer, specificare l’URL di invio direttamente in un modello di modulo utilizzando il pulsante Invia per HTTP.
  • Nell’interfaccia utente di AEM Forms, seleziona un modulo e specifica un URL di invio per la modifica delle proprietà dei metadati.
  • In Forms Portal, modifica il componente Ricerca e filtro e specifica un URL di invio nella scheda Collegamento modulo .
Profilo di rendering HTML Modello di modulo Profilo di rendering HTML utilizzato per il rendering di un modello di modulo in formato HTML.
Formato di rendering

Modello di modulo

Modulo adattivo

Questa opzione consente all’utente di specificare il formato di rendering del modulo quando i moduli vengono pubblicati:

  • HTML
  • PDF
  • Entrambe

Questa opzione viene utilizzata per limitare il formato di rendering dei moduli solo sul portale dei moduli in cui sono visibili all’utente finale.

Tag Tutto tranne le risorse Etichette associate al modulo per facilitare la ricerca rapida e semplice.
Riferimenti

Modulo adattivo

Modello di modulo

Risorsa

Elenco delle risorse (altri moduli o risorse) a cui è correlato il modulo. Tali attività possono rientrare in due categorie:

  • Riferimenti: Risorse a cui fa riferimento il modulo corrente.
  • di cui: Risorse che fanno riferimento alla risorsa corrente.

Queste risorse vengono visualizzate come collegamenti e i relativi metadati sono accessibili direttamente facendo clic su di esse.

Selezione del modello di modulo (XDP/XSD) Modulo adattivo

Specifica il modello di modulo utilizzato per la creazione del modulo adattivo. Questa proprietà può avere i seguenti valori:

  • Modello di modulo: Un modello di modulo viene selezionato tra quelli esistenti nella directory archivio. Questo valore può essere aggiornato.
  • Schema XML: Viene caricato un file XSD. Questo valore può essere aggiornato.
  • Nessuna
Una volta selezionato, è possibile aggiornare un modello di modulo ma non rimuoverlo.

Visualizzare i metadati del modulo

Le risorse dispongono di valori di proprietà esistenti che possono essere visualizzati in modalità di sola lettura. Questi metadati vengono creati al momento del caricamento del modulo o della creazione del modulo.

  1. Andate alla posizione della risorsa per la quale desiderate visualizzare i metadati.

  2. Apri la pagina delle proprietà utilizzando uno dei seguenti modi:

    1. Fai clic sull'icona Visualizza proprietà e_reviewmode_properties_n da Azioni rapide.

      NOTA

      Azioni rapide sono gli elementi azione visualizzati sopra una miniatura al passaggio del mouse.

    2. Selezionare il modulo e fare clic sull'icona Visualizza proprietà e_reviewmode_properties_n visualizzata nella barra degli strumenti.

    3. Passa alla pagina dei dettagli del modulo facendo clic sulla miniatura del modulo quando non è attiva la modalità di selezione. Ora fai clic sull'icona occhio aem6forms_eye_viewon in alto a destra, quindi fai clic su Proprietà nell'elenco sottostante.

  3. Nella pagina delle proprietà visualizzata viene visualizzato uno schema contenente solo le proprietà dei metadati che contengono un certo valore.

    La pagina delle proprietà presenta una barra degli strumenti contenente due icone di azione:

    • Modifica: aem6forms_edit Modifica i valori delle proprietà dei metadati
    • Visualizza: aem6forms_eye_viewon Passa alla pagina dei dettagli del modulo, che apre il modulo in modalità di anteprima.

    La porzione di contenuto è divisa in due parti:

    • Il pannello a sinistra contiene una miniatura del modulo
    • Il pannello a destra contiene le proprietà dei metadati in modalità di sola lettura, distribuite su varie schede.

Aggiungere/aggiornare i valori dei metadati del modulo

È possibile modificare il valore delle proprietà dei metadati esistenti o aggiungere nuovi valori a un campo di proprietà dei metadati esistente (ad esempio, quando un campo di metadati è vuoto).

Aggiornare i valori delle proprietà dei metadati

  1. Segui i passaggi indicati nella sezione precedente per aprire la pagina delle proprietà in cui è possibile visualizzare i metadati esistenti del modulo selezionato.

  2. Dalla barra degli strumenti, fai clic sull'icona di modifica aem6forms_edit per modificare la modalità della pagina da sola lettura a lettura/scrittura.

  3. La pagina delle proprietà visualizzata contiene uno schema contenente un insieme di campi di input modificabili e testo statico.

  4. Le proprietà visualizzate nel testo statico sono quelle che non è possibile modificare.

  5. Puoi passare ad altre schede per trovare i campi di input per le proprietà dei metadati posizionate sotto di esse.

    Questa pagina dispone di una barra degli strumenti contenente due icone di azione diverse da quelle in modalità di visualizzazione:

    • Annulla: aem6forms_close Annulla le modifiche apportate ai valori delle proprietà dei metadati fino ad ora
    • Fatto: aem6forms_check Salvare tutte le modifiche apportate ai valori delle proprietà dei metadati fino ad ora

    Entrambe queste azioni indirizzano l’utente alla modalità di sola lettura della pagina delle proprietà contenente i valori aggiornati.

Aggiornare la miniatura del modulo 

Il pannello a sinistra nella pagina delle proprietà visualizza la miniatura del modulo. Per impostazione predefinita, la miniatura visualizzata è quella generata al momento della creazione del modulo (modulo adattivo) o al momento del caricamento del modulo.

Per tutti i tipi di modulo, puoi caricare un’immagine facendo clic su Carica immagine e sfogliando un file di immagine nella directory locale. L’immagine selezionata viene utilizzata come miniatura invece di quella predefinita.

Per i moduli adattivi, sono disponibili funzionalità aggiuntive che consentono all’utente di generare una miniatura come istantanea dell’anteprima del modulo adattivo corrente. Poiché AEM Forms supporta anche la creazione di moduli adattivi, l’anteprima del modulo adattivo può cambiare ogni volta che si modifica il modulo adattivo. Questa funzionalità per generare una miniatura consente di ottenere una nuova miniatura per il modulo adattivo in base allo stato di anteprima corrente. Fai clic su Genera anteprima per eseguire questa azione.

NOTA
  • Usa un'immagine quadrata per la miniatura. Quando si utilizza un’immagine non quadrata e si visualizza la miniatura nella vista a elenco, la miniatura appare troncata.
  • Una volta caricata o generata una nuova immagine, la miniatura viene sostituita da questa immagine e non può essere reimpostata sull’immagine precedente.

Aggiungere metadati personalizzati 

Oltre ai metadati forniti out-of-the-box, AEM Forms supporta nuovi metadati personalizzati.

È disponibile uno strumento (Editor schema metadati) per definire lo schema per il layout dei metadati; ovvero il layout di ciò che viene visualizzato nella pagina Proprietà di un modulo. L’Editor schema metadati consente di aggiungere o modificare uno schema personalizzato per le risorse.

AEM Forms espone gli schemi di metadati dei tipi di moduli supportati in questo strumento. In questo modo, puoi accedere a questi schemi e utilizzare la funzionalità fornita nell’editor dello schema dei metadati per aggiungere proprietà personalizzate.

  1. Passa a Strumenti > Risorse > Schemi di metadati.

  2. Fai clic su forms dai moduli dello schema elencati.

  3. Dall’elenco visualizzato, fai clic sul tipo di risorsa per il quale desideri aggiungere metadati personalizzati.

    NOTA

    Questi schemi contengono proprietà di metadati predefinite che non possono essere modificate o modificate (selezionando la casella di controllo e facendo clic su Modifica dalla barra degli strumenti) per evitare problemi di funzionalità.

  4. Qualsiasi tipo di risorsa su cui hai fatto clic apre un elenco contenente l’opzione extendedmetadata . Modifica lo schema.

  5. Seleziona la casella di controllo accanto a extendedmetadata, quindi fai clic sull'icona di modifica aem6forms_edit visualizzata nella barra degli strumenti.

  6. AEM Forms apre l’editor schema metadati/il generatore di moduli del tipo di risorsa selezionato (in questo caso modulo adattivo).

    Editor schema metadati per tipo di modulo adattivo

Fare clic per ingrandire

  1. Il pannello a sinistra contiene sezioni a schede in cui i campi vengono posizionati e il pannello a destra visualizza tutti i componenti dell’interfaccia utente disponibili e le proprietà del campo selezionato dal pannello a sinistra.

  2. La sezione bloccata non è modificabile e contiene campi per tutte le proprietà dei metadati fornite in modalità predefinita.

  3. Per aggiungere altre schede, fai clic sul simbolo + .

  4. Puoi aggiungere un campo personalizzato del tipo desiderato trascinando il componente campo dalla sezione Genera modulo nella pagina schema.

  5. Le specifiche di questo campo possono essere fornite nella sezione Impostazioni dopo aver fatto clic sul campo.

Aggiungi proprietà metadati personalizzate nell’editor dello schema 

  1. Passa alla scheda (esistente o nuova) in cui desideri aggiungere la proprietà personalizzata.

  2. Trascina un componente del tipo desiderato dalla sezione Genera modulo a sinistra e posiziona in una posizione comoda.

    NOTA

    Non è possibile spostare le sezioni bloccate, ma è possibile posizionare il componente in uno qualsiasi degli spazi vuoti.

  3. Fai clic su un componente appena trascinato. Nella scheda Impostazioni visualizzata nel pannello a destra, compila le informazioni per i campi seguenti:

    1. Specifica un'etichetta campo da utilizzare come nome visualizzato sopra il campo inserito nello schema (ad esempio: Dipartimento)

    2. Nel campo Mappa su proprietà è possibile visualizzare un valore precompilato './jcr:content/metadata/default'. Cambia l'oggetto ‘default’ con un nome di proprietà desiderato, che viene utilizzato per memorizzare la proprietà nell'archivio crx (ad esempio: "./jcr:content/metadata/dipartimento')

      NOTA

      Non modificare il prefisso ‘./jcr:content/metadata/’ definisce il percorso in cui viene memorizzata la proprietà.

      Inoltre, il nome della proprietà deve essere univoco per evitare di scrivere valori per due o più proprietà nella stessa posizione nell’archivio. Pertanto, si consiglia di modificare il valore "default".

    3. Riempire altre impostazioni in base ai requisiti. Ad esempio: seleziona l’opzione Obbligatorio se desideri rendere il campo obbligatorio.

    4. Per eliminare un campo aggiunto, selezionalo e fai clic sull’icona Elimina elimina-1 .

  4. Se necessario, segui i passaggi 1-3 per aggiungere un’altra proprietà.

  5. Fai clic su Fine dopo aver apportato tutte le modifiche.

    È stata aggiunta correttamente una proprietà di metadati personalizzata.

Tutti i moduli adattivi in AEM Forms ora contengono questa proprietà di metadati aggiuntiva. Puoi modificarlo dalla pagina delle proprietà.

In questa pagina