Bearbeiten von Formularen editing-forms

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

Klicken Sie auf Neu rechts oben in der Liste.

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 die 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 -Attribut.

  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 <form> -Element und geben Sie den Typ in einem Container an.

Klicken Sie auf Speichern.

Fügen Sie die Formularelemente ein.

Um beispielsweise ein Eingabefeld einzufügen, verwenden Sie die <input> -Element. Legen Sie die xpath -Attribut der Feldreferenz als XPath-Ausdruck zuweisen. Weitere Informationen

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

<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. Klicks 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:

Mehr dazu Speicherlistensteuerelemente.

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 die type -Attribut <form> Element zu iconbox:

<form […] type="iconbox">

Legen Sie für jede Formularseite einen Container fest:

1. Hinzufügen einer <container> -Element als untergeordnetes Element des <form> -Element.

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

   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 die type="frame" -Attribut aus dem vorhandenen <container> -Elemente.

Ändern Sie die type -Attribut <form> Element zu notebook:

<form […] type="notebook">

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

1. Hinzufügen einer <container> -Element als untergeordnetes Element des <form> -Element.
2. Um den Titel und das Bild für das Symbol zu definieren, verwenden Sie die label und img -Attribute.

  <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 die type="frame" -Attribut aus dem vorhandenen <container> -Elemente.

Ä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 erhält die Funktion den Namen checkValue. Mit dieser Funktion wird die recipient Datentyp in der nms Namespace. 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 die <soapCall> -Element zu <leave> -Element.

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

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

In diesem Beispiel wird die checkValue und nms:recipient -Dienst wird 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 die <leave> -Element verwenden, können Benutzer das Formular erst dann speichern, wenn die eingegebenen Informationen validiert wurden.