Modificare i moduli editing-forms

Scegliere Administration > Configuration > Input forms dal menu.

Fare clic sul pulsante New in alto a destra nell'elenco.

Specificare le proprietà del modulo:

• Specifica il nome del modulo e lo spazio dei nomi.

  Il nome del modulo e lo spazio dei nomi possono corrispondere allo schema di dati correlato. Questo esempio mostra un modulo per lo schema dati cus:order:

  code language-xml
  <form entitySchema="xtk:form" img="xtk:form.png" label="Order" name="order" namespace="cus" type="iconbox" xtkschema="xtk:form"> […] </form>

  In alternativa, è possibile specificare esplicitamente lo schema dati nell'attributo entity-schema.

  code language-xml
  <form entity-schema="cus:stockLine" entitySchema="xtk:form" img="xtk:form.png" label="Stock order" name="stockOrder" namespace="cus" xtkschema="xtk:form"> […] </form>

• Specificare l'etichetta da visualizzare nel modulo.

• Facoltativamente, specificare il tipo di modulo. Se non si specifica un tipo di modulo, per impostazione predefinita viene utilizzato il tipo di schermata della console.

  

  Se si progetta un modulo multipagina, è possibile omettere il tipo di modulo nell'elemento <form> e specificare il tipo in un contenitore.

Fai clic su Save.

Inserire gli elementi del modulo.

Ad esempio, per inserire un campo di input, utilizzare l'elemento <input>. Impostare l'attributo xpath sul riferimento di campo come espressione XPath. Ulteriori informazioni.

Questo esempio mostra i campi di input basati sullo schema nms:recipient.

<input xpath="@firstName"/>
<input xpath="@lastName"/>

Se il modulo è basato su un tipo di schema specifico, è possibile cercare i campi per questo schema:

1. Fare clic su Insert > Document fields.

   

2. Selezionare il campo e fare clic su OK.

   

Facoltativamente, specifica l’editor di campi.

A ciascun tipo di dati è associato un editor di campi predefinito:

• Per un campo di tipo data, nel modulo viene visualizzato un calendario di input.
• Per un campo di tipo enumerazione, il modulo mostra un elenco di selezione.

Puoi utilizzare i seguenti tipi di editor di campi:

Ulteriori informazioni sui controlli elenco memoria.

Facoltativamente, definisci l’accesso ai campi:

Esempio:

<container type="enabledGroup" enabledIf="@gender=1">
  […]
</container>
<container type="enabledGroup" enabledIf="@gender=2">
  […]
</container>

Facoltativamente, utilizza i contenitori per raggruppare i campi in sezioni.

<container type="frame" label="Name">
   <input xpath="@firstName"/>
   <input xpath="@lastName"/>
</container>
<container type="frame" label="Contact details">
   <input xpath="@email"/>
   <input xpath="@phone"/>
</container>

Modificare l'attributo type dell'elemento <form> in iconbox:

<form […] type="iconbox">

Impostare un contenitore per ogni pagina del modulo:

1. Aggiungere un elemento <container> come elemento figlio dell'elemento <form>.

2. Per definire un'etichetta e un'immagine per l'icona, utilizzare gli attributi label e img.

   code language-xml
   <form entitySchema="xtk:form" name="Service provider" namespace="nms" type="iconbox" xtkschema="xtk:form"> <container img="xtk:properties.png" label="General"> <input xpath="@label"/> <input xpath="@name"/> […] </container> <container img="nms:msgfolder.png" label="Details"> <input xpath="@address"/> […] </container> <container img="nms:supplier.png" label="Services"> […] </container> </form>

In alternativa, rimuovere l'attributo type="frame" dagli elementi <container> esistenti.

Modificare l'attributo type dell'elemento <form> in notebook:

<form […] type="notebook">

Aggiungi un contenitore per ogni pagina modulo:

1. Aggiungere un elemento <container> come elemento figlio dell'elemento <form>.
2. Per definire l'etichetta e l'immagine per l'icona, utilizzare gli attributi label e img.

  <form entitySchema="xtk:form" name="Service provider" namespace="nms" type="notebook" xtkschema="xtk:form">
      <container label="General">
          <input xpath="@label"/>
          <input xpath="@name"/>
          […]
      </container>
      <container label="Details">
          <input xpath="@address"/>
          […]
      </container>
      <container label="Services">
          […]
      </container>
  </form>

In alternativa, rimuovere l'attributo type="frame" dagli elementi <container> esistenti.

Modificare il modulo di input di fabbrica:

1. Scegliere Administration > Configuration > Input forms dal menu.
2. Selezionare un modulo di input e modificarlo.

È possibile estendere gli schemi di dati di fabbrica, ma non i moduli di input di fabbrica. È consigliabile modificare direttamente i moduli di input di fabbrica senza ricrearli. Durante gli aggiornamenti del software, le modifiche nei moduli di input di fabbrica vengono unite agli aggiornamenti. Se l'unione automatica non riesce, è possibile risolvere i conflitti. Ulteriori informazioni.

Ad esempio, se si estende uno schema di fabbrica con un campo aggiuntivo, è possibile aggiungere questo campo al relativo modulo di fabbrica.

Crea una funzione di convalida in un file JS.

Esempio:

function nms_recipient_checkValue(value)
{
  logInfo("checking value " + value)
  if (…)
  {
    logError("Value " + value + " is not valid")
  }
  return 1
}

In questo esempio, la funzione è denominata checkValue. Questa funzione viene utilizzata per controllare il tipo di dati recipient nello spazio dei nomi nms. Il valore che viene controllato viene registrato. Se il valore non è valido, viene registrato un messaggio di errore. Se il valore è valido, viene restituito il valore 1.

È possibile utilizzare il valore restituito per modificare il modulo.

Nel modulo, aggiungi l'elemento <soapCall> all'elemento <leave>.

In questo esempio, viene utilizzata una chiamata SOAP per convalidare la stringa @valueToCheck:

<form name="recipient" (…)>
(…)
  <leave>
    <soapCall name="checkValue" service="nms:recipient">
      <param exprIn="@valueToCheck" type="string"/>
    </soapCall>
  </leave>
</form>

In questo esempio vengono utilizzati il metodo checkValue e il servizio nms:recipient:

• Il servizio è lo spazio dei nomi e il tipo di dati.
• Il metodo è il nome della funzione. Il nome distingue tra maiuscole e minuscole.

La chiamata viene eseguita in modo sincrono.

Vengono visualizzate tutte le eccezioni. Se si utilizza l'elemento <leave>, gli utenti non potranno salvare il modulo finché le informazioni immesse non saranno convalidate.