Redigera formulär editing-forms

Välj Administration > Configuration > Input forms på menyn.

Klicka på knappen New överst till höger i listan.

Ange formuläregenskaperna:

• Ange formulärnamnet och namnutrymmet.

  Formulärnamnet och namnutrymmet kan matcha det relaterade dataschemat. I det här exemplet visas ett formulär för databasschemat 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>

  Du kan också uttryckligen ange dataschemat i attributet 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>

• Ange etiketten som ska visas i formuläret.

• Du kan också ange formulärtypen. Om du inte anger någon formulärtyp används skärmtypen för konsolen som standard.

  

  Om du utformar ett flersidigt formulär kan du utelämna formulärtypen i elementet <form> och ange typen i en behållare.

Klicka på Save.

Infoga formulärelementen.

Om du till exempel vill infoga ett inmatningsfält använder du elementet <input>. Ange attributet xpath som fältreferens som ett XPath-uttryck. Läs mer.

I det här exemplet visas indatafält baserade på schemat nms:recipient.

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

Om formuläret baseras på en viss schematyp kan du söka efter fälten för det här schemat:

1. Klicka på Insert > Document fields.

   

2. Markera fältet och klicka på OK.

   

Du kan även ange fältredigeraren.

En standardredigerare för fält är associerad med varje datatyp:

• För datumfält visar formuläret en indatakalender.
• För ett uppräkningstypfält visas en urvalslista i formuläret.

Du kan använda dessa fältredigerartyper:

Läs mer om minneslistkontroller.

Du kan även definiera åtkomst till fälten:

Exempel:

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

Du kan också använda behållare för att gruppera fält i avsnitt.

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

Ändra attributet type för elementet <form> till iconbox:

<form […] type="iconbox">

Ange en behållare för varje formulärsida:

1. Lägg till ett <container>-element som underordnat element till elementet <form>.

2. Om du vill definiera en etikett och en bild för ikonen använder du attributen label och 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>

Du kan också ta bort attributet type="frame" från de befintliga <container>-elementen.

Ändra attributet type för elementet <form> till notebook:

<form […] type="notebook">

Lägg till en behållare för varje formulärsida:

1. Lägg till ett <container>-element som underordnat element till elementet <form>.
2. Använd attributen label och img för att definiera ikonens etikett och bild.

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

Du kan också ta bort attributet type="frame" från de befintliga <container>-elementen.

Ändra fabriksinmatningsformuläret:

1. Välj Administration > Configuration > Input forms på menyn.
2. Markera ett inmatningsformulär och ändra det.

Du kan utöka fabriksdatamappningar, men du kan inte utöka fabriksinmatningsformulär. Vi rekommenderar att du ändrar fabriksinmatningsformulär direkt utan att återskapa dem. Vid uppgraderingar sammanfogas ändringarna i fabriksinmatningsformulären med uppgraderingarna. Om den automatiska sammanfogningen misslyckas kan du lösa konflikterna. Läs mer.

Om du till exempel utökar ett fabriksschema med ett extra fält kan du lägga till det här fältet i det relaterade fabriksformuläret.

Skapa en valideringsfunktion i en JS-fil.

Exempel:

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

I det här exemplet heter funktionen checkValue. Den här funktionen används för att kontrollera datatypen recipient i namnutrymmet nms. Värdet som kontrolleras loggas. Om värdet inte är giltigt loggas ett felmeddelande. Om värdet är giltigt returneras värdet 1.

Du kan använda det returnerade värdet för att ändra formuläret.

Lägg till elementet <soapCall> i elementet <leave> i formuläret.

I det här exemplet används ett SOAP-anrop för att validera strängen @valueToCheck:

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

I det här exemplet används metoden checkValue och tjänsten nms:recipient:

• Tjänsten är namnutrymmet och datatypen.
• Metoden är funktionsnamnet. Namnet är versalkänsligt.

Anropet utförs synkront.

Alla undantag visas. Om du använder elementet <leave> kan användarna inte spara formuläret förrän den angivna informationen har validerats.