Gestire i metadati del modulo

Panoramica 

I metadati semplificano 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 ogni tipo di risorsa. Oltre ai metadati predefiniti, puoi aggiungere metadati personalizzati a ciascun tipo di risorsa. AEM Forms offre inoltre i mezzi giusti per creare, gestire e scambiare tutti questi metadati in modo efficiente per i moduli.

Se sei uno sviluppatore o un proprietario del sito, puoi personalizzare Forms Portal, l’interfaccia utente finale di AEM Forms, in modo che rifletta i metadati utilizzati nella tua 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à dei metadati associate a una risorsa dipende dal suo tipo. Inoltre, se aggiungi una proprietà di metadati personalizzata, questa viene aggiunta in tutte le risorse del tipo a 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 flat)
  • Moduli adattivi
  • Riferimenti
  • XFS

Ampio elenco di metadati

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

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

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 (Signed)
  • Documento, Documento (Firmato)
  • Modulo adattivo
  • Risorsa
Creato Tutti i bundle Valore di sola lettura che specifica l’ora di creazione della risorsa.
Data ultima modifica Tutti i bundle Valore di sola lettura che specifica l’ora dell’ultima modifica apportata alla risorsa.
Autore Tutto tranne la risorsa

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

  • PDF/Modello modulo/Documento: recuperato dal file binario caricato.
  • Modulo adattivo: utente connesso al momento della creazione del modulo.
Stato Tutto tranne la risorsa

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

  • Nessun valore: se un modulo non è mai stato pubblicato.
  • Pubblicato: quando un modulo viene pubblicato.
  • Modificato: quando un modulo è stato modificato dopo essere stato pubblicato una volta.
Data ultima pubblicazione Tutto tranne la risorsa Valore di sola lettura che specifica l'ora dell'ultima pubblicazione del modulo.
Ora di attivazione/disattivazione pubblicazione Tutto tranne la risorsa

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

  • L'ora di attivazione e disattivazione della pubblicazione deve essere successiva alla data corrente.
  • L'ora di disattivazione della pubblicazione deve essere successiva all'ora di attivazione della 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:

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

Modello di modulo

Modulo adattivo

Questa opzione consente di specificare il formato di rendering del modulo al momento della pubblicazione dei moduli:

  • HTML
  • PDF
  • Entrambi

Questa opzione viene utilizzata per limitare il formato di rendering dei moduli solo nel portale dei moduli in cui sono visibili all'utente finale.
Tag Tutto tranne la risorsa Etichette associate al modulo per facilitare la ricerca.
Riferimenti

Modulo adattivo

Modello di modulo

Risorsa

Elenco delle risorse (altre forme o risorse) a cui è correlato questo modulo. Queste risorse possono rientrare nelle due categorie seguenti:

  • Riferimenti: risorse a cui fa riferimento il modulo corrente.
  • Con riferimento da: risorse che fanno riferimento alla risorsa corrente.

Queste risorse vengono visualizzate come collegamenti e i relativi metadati sono accessibili direttamente facendo clic su di essi.
Selezione del modello del modulo (XDP/XSD) Modulo adattivo

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

  • Modello di modulo: viene selezionato un modello di modulo tra quelli esistenti nel repository. Questo valore può essere aggiornato.
  • Schema XML: viene caricato un file XSD. Questo valore può essere aggiornato.
  • Nessuno
Un modello di modulo selezionato può essere aggiornato ma non rimosso.

Visualizza metadati modulo

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

  1. Passa alla posizione della risorsa di cui desideri visualizzare i metadati.

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

    1. Fare clic su Visualizza proprietà e_reviewmode_properties_n da Azioni rapide.

      NOTA

      Le Azioni rapide sono le azioni che vengono visualizzate su una miniatura al passaggio del mouse.

    2. Selezionare il modulo e fare clic su Visualizza proprietà e_reviewmode_properties_n nella barra degli strumenti.

    3. Passare alla pagina dei dettagli del modulo facendo clic sulla miniatura del modulo quando non è attiva la modalità di selezione. A questo punto, fai clic su aem6forms_eye_viewon icona a forma di occhio in alto a destra, quindi fare 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à include una barra degli strumenti contenente due icone di azione:

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

    La porzione di contenuto è divisa in due parti:

    • Il pannello sinistro contiene la miniatura del modulo
    • Il pannello a destra contiene proprietà di metadati in modalità di sola lettura, distribuite tra varie schede.

Aggiungi/aggiorna valori metadati modulo

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

Aggiorna valori proprietà 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 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 una combinazione 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 posizionati sotto di esse.

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

    • Annulla: aem6forms_close Annulla eventuali modifiche apportate ai valori delle proprietà dei metadati
    • Fine: aem6forms_check Salva tutte le modifiche apportate ai valori delle proprietà dei metadati

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

Aggiornare la miniatura del modulo

Nel pannello sinistro della pagina delle proprietà viene visualizzata 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 la ricerca di un file di immagine dalla 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 l’authoring di moduli adattivi, l’anteprima del modulo adattivo potrebbe cambiare ogni volta che lo si modifica. Questa funzionalità per generare una miniatura consente di ottenere una nuova miniatura per il modulo adattivo in base allo stato di anteprima corrente. Clic Genera anteprima per eseguire questa azione.

NOTA
  • Utilizza 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 ritagliata.
  • Una volta caricata o generata una nuova immagine, la miniatura viene sostituita da questa immagine e non può essere ripristinata all'immagine precedente.

Aggiungere metadati personalizzati

Oltre ai metadati forniti come predefiniti, AEM Forms supporta nuovi metadati personalizzati.

Viene fornito uno strumento (Editor schema metadati) per definire lo schema per il layout dei metadati, ovvero il layout di ciò che viene visualizzato nel Proprietà pagina 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 schema metadati per aggiungere proprietà personalizzate.

  1. Accedi a Strumenti > Risorse > Schemi metadati.

  2. Clic moduli dai moduli schema elencati.

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

    NOTA

    Questi schemi contengono proprietà di metadati che vengono fornite come predefinite e non devono essere modificate (selezionando la casella di controllo e facendo clic su modifica nella barra degli strumenti) per evitare problemi funzionali.

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

  5. Seleziona la casella di controllo accanto a extendedmetadata e quindi fare clic sul pulsante modifica aem6forms_edit nella barra degli strumenti.

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

    Editor schema metadati per tipo di modulo adattivo

    Editor metadati

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

    2. La sezione bloccata non è modificabile e contiene campi per tutte le proprietà di metadati fornite come predefiniti.

    3. È possibile aggiungere altre schede facendo clic sul simbolo +.

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

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

Aggiungi proprietà metadati personalizzata nell’editor 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 sul pannello sinistro e posizionarlo in una posizione comoda.

    NOTA

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

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

    1. Specifica un’Etichetta campo da utilizzare come nome visualizzato sopra il campo inserito nello schema (ad esempio: Reparto)

    2. Nel campo Mappa su proprietà puoi visualizzare un valore precompilato "./jcr:content/metadata/default'. Modificare il ‘predefinito" al nome di proprietà desiderato, utilizzato per memorizzare la proprietà nell’archivio crx (ad esempio: "./jcr:content/metadata/department')

      NOTA

      Non modificare il prefisso ‘./jcr:content/metadata/’, che definisce il percorso in cui è 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. Compila altre impostazioni in base alle esigenze. Ad esempio: seleziona l’opzione Obbligatorio se desideri rendere obbligatorio il campo.

    4. Per eliminare un campo aggiunto, selezionarlo e quindi fare clic sul pulsante Elimina delete-1 icona.

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

  5. Clic Fine dopo aver apportato tutte le modifiche.

    È stata aggiunta 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