Bearbeiten von Formularen editing-forms

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

Klicken Sie oben rechts in Liste auf „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 cus:order Datenschema:

  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 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 auf dem 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 <form> auslassen und den Typ in einem Container angeben.

Klicken Sie auf Speichern.

Fügen Sie die Formularelemente ein.

Um beispielsweise ein Eingabefeld einzufügen, verwenden Sie das <input>. Legen Sie das xpath-Attribut als XPath-Ausdruck auf den Feldverweis fest. Weitere Informationen

Dieses Beispiel zeigt Eingabefelder, die auf dem nms:recipient basieren.

<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 Einfügen > Dokumentfelder.

   

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

   

Geben Sie optional den Feldeditor an.

Jedem Datentyp ist ein Standardeditor für Felder zugeordnet:

• Für ein Feld vom Typ Datum zeigt das Formular einen Eingabekalender an.
• Für ein Feld vom Typ Auflistung zeigt das Formular eine Auswahlliste an.

Sie können die folgenden Typen von Feldeditoren verwenden:

Lesen Sie mehr über Eingabefeld mit Speicherliste.

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 type des <form> Elements in iconbox:

<form […] type="iconbox">

Legen Sie einen Container für jede Formularseite fest:

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

2. Um eine Beschriftung und ein Bild für das Symbol zu definieren, verwenden Sie die Attribute label und 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>

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

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

<form […] type="notebook">

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

1. Fügen Sie ein <container> Element als untergeordnetes Element des <form> Elements hinzu.
2. Um die Beschriftung und das Bild für das Symbol zu definieren, verwenden Sie die Attribute label und 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>

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

Ändern des werkseitigen Eingabeformulars:

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

Sie können Factory-Datenschemata erweitern, aber nicht Factory-Eingabeformulare. Es wird empfohlen, die werkseitigen Eingabeformulare direkt zu ändern, ohne sie neu zu erstellen. Bei Software-Upgrades werden Ihre Änderungen in den werkseitigen Eingabeformularen mit den Upgrades zusammengeführt. Wenn die automatische Zusammenführung fehlschlägt, können Sie die Konflikte auflösen. Weitere Informationen

Wenn Sie beispielsweise ein Factory-Schema mit einem zusätzlichen Feld erweitern, können Sie dieses Feld dem 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 recipient Datentyp im nms-Namespace überprüft. Der zu überprüfende Wert wird protokolliert. Wenn der Wert ungü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 <soapCall> Element zum <leave> Element 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 checkValue-Methode und der nms:recipient-Service verwendet:

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

Der Aufruf erfolgt synchron.

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