Bearbeiten von Formularen editing-forms

Wählen Sie im Menü Administration > Konfiguration > Formulare.

Klicken Sie oben rechts in der Liste auf die Schaltfläche Neu .

Geben Sie die Formulareigenschaften an:

• Geben Sie den Formularnamen und den Namespace an.

  Der Formularname und der Namespace können mit dem zugehörigen Datenschema übereinstimmen. Dieses Beispiel zeigt ein Formular für das Datenschema 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>

  Alternativ können Sie das Datenschema explizit im Attribut entity-schema angeben.

  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>

• Geben Sie den Titel an, der im Formular angezeigt werden soll.

• Geben Sie optional den Formulartyp an. Wenn Sie keinen Formulartyp angeben, wird standardmäßig der Konsolenbildschirmtyp verwendet.

  

  Wenn Sie ein mehrseitiges Formular entwerfen, können Sie den Formulartyp im Element <form> auslassen und den Typ in einem Container angeben.

Klicken Sie auf Speichern.

Fügen Sie die Formularelemente ein.

Verwenden Sie beispielsweise das Element <input> , um ein Eingabefeld einzufügen. Setzen Sie das Attribut xpath auf die Feldreferenz als XPath-Ausdruck. Weitere Informationen

Dieses Beispiel zeigt Eingabefelder basierend auf dem Schema nms:recipient .

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

Wenn das Formular auf einem bestimmten Schematyp basiert, können Sie die Felder für dieses Schema nachschlagen:

1. Klicken Sie auf Einfügen > Dokumentfelder.

   

2. Wählen Sie das Feld aus und klicken Sie auf OK.

   

Geben Sie optional den Feld-Editor an.

Jedem Datentyp ist ein standardmäßiger Feldeditor zugeordnet:

• Bei einem Feld vom Typ Datum zeigt das Formular einen Eingabekalender an.
• Bei einem Auflistungsfeld zeigt das Formular eine Auswahlliste an.

Sie können die folgenden Editor-Typen für Felder verwenden:

Weitere Informationen zu Speicherlistensteuerelementen.

Definieren Sie optional den Zugriff auf die Felder:

Beispiel:

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

Verwenden Sie optional Container, um Felder in Abschnitte zu gruppieren.

<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>

Ändern Sie das Attribut type des Elements <form> in iconbox:

<form […] type="iconbox">

Legen Sie für jede Formularseite einen Container fest:

1. Fügen Sie ein Element <container> als untergeordnetes Element des Elements <form> hinzu.

2. Verwenden Sie die Attribute label und img , um eine Beschriftung und ein Bild für das Symbol zu definieren.

   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>

Alternativ können Sie das Attribut type="frame" aus den vorhandenen <container> -Elementen entfernen.

Ändern Sie das Attribut type des Elements <form> in notebook:

<form […] type="notebook">

Fügen Sie für jede Formularseite einen Container hinzu:

1. Fügen Sie ein Element <container> als untergeordnetes Element des Elements <form> hinzu.
2. Verwenden Sie die Attribute label und img , um den Titel und das Bild für das Symbol zu definieren.

  <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>

Alternativ können Sie das Attribut type="frame" aus den vorhandenen <container> -Elementen entfernen.

Ändern Sie das Factory-Eingabeformular:

1. Wählen Sie im Menü Administration > Konfiguration > Formulare.
2. Wählen Sie ein Formular aus und ändern Sie es.

Sie können Factory-Datenschemata erweitern, Sie können jedoch keine Factory-Eingabeformulare erweitern. Es wird empfohlen, werksmäßige Eingabeformulare direkt zu ändern, ohne sie neu zu erstellen. Bei Softwareaktualisierungen werden Ihre Änderungen in den Werkseingangsformularen mit den Upgrades zusammengeführt. Wenn die automatische Zusammenführung fehlschlägt, können Sie die Konflikte lösen. Weitere Informationen

Wenn Sie beispielsweise ein Factory-Schema mit einem zusätzlichen Feld erweitern, können Sie dieses Feld zum zugehörigen Factory-Formular hinzufügen.

Erstellen Sie eine Validierungsfunktion in einer JS-Datei.

Beispiel:

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

In diesem Beispiel trägt die Funktion den Namen checkValue. Mit dieser Funktion wird der Datentyp recipient im Namespace nms überprüft. Der Wert, der überprüft wird, wird protokolliert. Wenn der Wert nicht gültig ist, wird eine Fehlermeldung protokolliert. Wenn der Wert gültig ist, wird der Wert 1 zurückgegeben.

Sie können den zurückgegebenen Wert verwenden, um das Formular zu ändern.

Fügen Sie im Formular das Element <soapCall> zum Element <leave> hinzu.

In diesem Beispiel wird ein SOAP-Aufruf verwendet, um die @valueToCheck -Zeichenfolge zu validieren:

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

In diesem Beispiel werden die Methode checkValue und der Dienst nms:recipient verwendet:

• Der Dienst ist der Namespace und der Datentyp.
• Die Methode ist der Funktionsname. Beim Namen wird zwischen Groß- und Kleinschreibung unterschieden.

Der Aufruf wird synchron ausgeführt.

Alle Ausnahmen werden angezeigt. Wenn Sie das Element <leave> verwenden, können Benutzer das Formular erst speichern, wenn die eingegebenen Informationen validiert wurden.