Modificare i moduli editing-forms

Dal menu, scegli Administration > Configuration > Input forms.

Fai clic su 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 cus:order schema dati:

  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 nel entity-schema attributo.

  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 nel <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, utilizza <input> elemento. Imposta il xpath attributo al riferimento di campo come espressione XPath. Ulteriori informazioni.

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

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

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

1. Clic Insert > Document fields.

   

2. Seleziona il campo e fai 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 su 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 il type attributo del <form> elemento a iconbox:

<form […] type="iconbox">

Impostare un contenitore per ogni pagina del modulo:

1. Aggiungi un <container> elemento come elemento figlio di <form> elemento.

2. Per definire un’etichetta e un’immagine per l’icona, utilizza label e img attributi.

   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, rimuovi il type="frame" attributo esistente <container> elementi.

Modificare il type attributo del <form> elemento a notebook:

<form […] type="notebook">

Aggiungi un contenitore per ogni pagina modulo:

1. Aggiungi un <container> elemento come elemento figlio di <form> elemento.
2. Per definire l’etichetta e l’immagine dell’icona, utilizza la label e img attributi.

  <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, rimuovi il type="frame" attributo esistente <container> elementi.

Modificare il modulo di input di fabbrica:

1. Dal menu, scegli Administration > Configuration > Input forms.
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 recipient tipo di dati in nms spazio dei nomi. 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 <soapCall> elemento al <leave> elemento.

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

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

In questo esempio, la proprietà checkValue e il nms:recipient servizio utilizzato:

• 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 <leave> , gli utenti non potranno salvare il modulo finché le informazioni immesse non saranno convalidate.