Formulieren bewerken editing-forms

Kies in het menu Administration > Configuration > Input forms.

Klik op de knop New boven aan de lijst.

Geef de formuliereigenschappen op:

• Geef de naam van het formulier en de naamruimte op.

  De formuliernaam en de naamruimte kunnen overeenkomen met het gerelateerde gegevensschema. In dit voorbeeld wordt een formulier getoond voor de cus:order gegevensschema:

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

  U kunt het gegevensschema ook expliciet opgeven in het dialoogvenster entity-schema kenmerk.

  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>

• Geef het label op dat op het formulier moet worden weergegeven.

• Geef desgewenst het formuliertype op. Als u geen formuliertype opgeeft, wordt standaard het schermtype voor de console gebruikt.

  

  Als u een formulier met meerdere pagina's ontwerpt, kunt u het formuliertype weglaten in het dialoogvenster <form> en geeft u het type op in een container.

Klik op Save.

Voeg de formulierelementen in.

Als u bijvoorbeeld een invoerveld wilt invoegen, gebruikt u de opdracht <input> element. Stel de xpath kenmerk aan de veldverwijzing als een XPath-expressie. Meer informatie.

In dit voorbeeld worden invoervelden weergegeven op basis van de nms:recipient schema.

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

Als het formulier is gebaseerd op een specifiek schematype, kunt u de velden voor dit schema opzoeken:

1. Klikken Insert > Document fields.

   

2. Selecteer het veld en klik op OK.

   

Geef desgewenst de veldeditor op.

Een standaardeditor voor velden wordt aan elk gegevenstype gekoppeld:

• Voor een datumveld wordt in het formulier een invoerkalender weergegeven.
• Voor een veld van het type opsomming wordt in het formulier een selectielijst weergegeven.

U kunt de volgende veldeditortypen gebruiken:

Meer informatie over besturingselementen voor geheugenlijsten.

U kunt ook toegang tot de velden definiëren:

Voorbeeld:

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

U kunt containers ook gebruiken om velden te groeperen in secties.

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

Wijzig de type kenmerk van de <form> element naar iconbox:

<form […] type="iconbox">

Stel een container in voor elke formulierpagina:

1. Voeg een <container> element as a child of the <form> element.

2. Als u een label en een afbeelding voor het pictogram wilt definiëren, gebruikt u de opdracht label en img kenmerken.

   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>

U kunt ook de knop type="frame" kenmerk van het bestaande <container> elementen.

Wijzig de type kenmerk van de <form> element naar notebook:

<form […] type="notebook">

Voeg een container toe voor elke formulierpagina:

1. Voeg een <container> element as a child of the <form> element.
2. Als u het label en de afbeelding voor het pictogram wilt definiëren, gebruikt u de opdracht label en img kenmerken.

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

U kunt ook de knop type="frame" kenmerk van het bestaande <container> elementen.

Het fabrieksinvoerformulier wijzigen:

1. Kies in het menu Administration > Configuration > Input forms.
2. Selecteer een invoerformulier en wijzig dit.

U kunt schema's met fabrieksgegevens uitbreiden, maar u kunt geen formulieren met fabrieksinvoer uitbreiden. We raden u aan fabrieksinvoerformulieren rechtstreeks te wijzigen zonder ze opnieuw te maken. Tijdens software-upgrades worden uw wijzigingen in de fabrieksinvoerformulieren samengevoegd met de upgrades. Als het automatisch samenvoegen mislukt, kunt u de conflicten oplossen. Meer informatie.

Als u bijvoorbeeld een fabrieksschema met een extra veld uitbreidt, kunt u dit veld toevoegen aan het gerelateerde fabrieksformulier.

Maak een validatiefunctie in een JS-bestand.

Voorbeeld:

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

In dit voorbeeld wordt de functie benoemd checkValue. Deze functie wordt gebruikt om de recipient gegevenstype in het dialoogvenster nms naamruimte. De waarde die wordt gecontroleerd wordt geregistreerd. Als de waarde niet geldig is, wordt een foutbericht geregistreerd. Als de waarde geldig is, wordt de waarde 1 geretourneerd.

U kunt de geretourneerde waarde gebruiken om het formulier te wijzigen.

Voeg in het formulier de <soapCall> aan de <leave> element.

In dit voorbeeld wordt een SOAP-aanroep gebruikt om de @valueToCheck tekenreeks:

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

In dit voorbeeld wordt checkValue en de nms:recipient de dienst wordt gebruikt:

• De dienst is namespace en het gegevenstype.
• De methode is de functienaam. De naam is hoofdlettergevoelig.

De vraag wordt uitgevoerd synchroon.

Alle uitzonderingen worden weergegeven. Als u het <leave> , kunnen gebruikers het formulier pas opslaan nadat de ingevoerde gegevens zijn gevalideerd.