Formulieren bewerken editing-forms

Kies in het menu Administration > Configuration > Input forms .

Klik op de knop New rechtsboven in 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 ziet u een formulier voor het 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 kenmerk entity-schema .

  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 element <form> en het type opgeven in een container.

Klik op Save.

Voeg de formulierelementen in.

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

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

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

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

1. Klik op 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:

Lees meer over controles van de geheugenlijst.

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 het kenmerk type van het element <form> in iconbox :

<form […] type="iconbox">

Stel een container in voor elke formulierpagina:

1. Voeg een element <container> toe als een onderliggend element van het element <form> .

2. Als u een label en een afbeelding voor het pictogram wilt definiëren, gebruikt u de kenmerken label en 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>

U kunt ook het kenmerk type="frame" verwijderen uit de bestaande <container> -elementen.

Wijzig het kenmerk type van het element <form> in notebook :

<form […] type="notebook">

Voeg een container toe voor elke formulierpagina:

1. Voeg een element <container> toe als een onderliggend element van het element <form> .
2. Gebruik de kenmerken label en img om het label en de afbeelding voor het pictogram te definiëren.

  <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 het kenmerk type="frame" verwijderen uit de 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 heeft de functie de naam checkValue . Deze functie wordt gebruikt om het gegevenstype recipient in de naamruimte nms te controleren. 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 het element <soapCall> toe aan het element <leave> .

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

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

In dit voorbeeld worden de methode checkValue en de service nms:recipient 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 element <leave> gebruikt, kunnen gebruikers het formulier pas opslaan nadat de ingevoerde gegevens zijn gevalideerd.