Editar formulários editing-forms

No menu, escolha Administration > Configuration > Input forms.

Clique em New no canto superior direito da lista.

Especifique as propriedades do formulário:

• Especifique o nome do formulário e o namespace.

  O nome do formulário e o namespace podem corresponder ao esquema de dados relacionado. Este exemplo mostra um formulário para o cus:order esquema de dados:

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

  Como alternativa, você pode especificar explicitamente o schema de dados na entity-schema atributo.

  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>

• Especifique o rótulo a ser exibido no formulário.

• Opcionalmente, especifique o tipo de formulário. Se você não especificar um tipo de formulário, o tipo de tela do console será usado por padrão.

  

  Se estiver criando um formulário multipáginas, você poderá omitir o tipo de formulário no <form> e especifique o tipo em um contêiner.

Clique em Save.

Insira os elementos de formulário.

Por exemplo, para inserir um campo de entrada, use o <input> elemento. Defina o xpath atributo para a referência de campo como uma expressão XPath. Leia mais.

Este exemplo mostra campos de entrada com base na variável nms:recipient esquema.

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

Se o formulário for baseado em um tipo de esquema específico, você poderá pesquisar os campos deste esquema:

1. Clique em Insert > Document fields.

   

2. Selecione o campo e clique em OK.

   

Opcionalmente, especifique o editor de campos.

Um editor de campo padrão está associado a cada tipo de dados:

• Para um campo do tipo data, o formulário mostra um calendário de entrada.
• Para um campo do tipo lista discriminada, o formulário mostra uma lista de seleção.

Você pode usar estes tipos de editor de campo:

Leia mais sobre controles da lista de memória.

Opcionalmente, defina o acesso aos campos:

Exemplo:

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

Opcionalmente, use containers para agrupar campos em seções.

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

Altere o type atributo de <form> elemento para iconbox:

<form […] type="iconbox">

Defina um container para cada página de formulário:

1. Adicionar um <container> elemento como filho de <form> elemento.

2. Para definir um rótulo e uma imagem para o ícone, use o label e img atributos.

   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>

Como alternativa, remova a variável type="frame" atributo do existente <container> elementos.

Altere o type atributo de <form> elemento para notebook:

<form […] type="notebook">

Adicione um container para cada página de formulário:

1. Adicionar um <container> elemento como filho de <form> elemento.
2. Para definir o rótulo e a imagem do ícone, use o label e img atributos.

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

Como alternativa, remova a variável type="frame" atributo do existente <container> elementos.

Modifique o formulário de entrada de fábrica:

1. No menu, escolha Administration > Configuration > Input forms.
2. Selecione e modifique um formulário de entrada.

Você pode estender esquemas de dados de fábrica, mas não pode estender formulários de entrada de fábrica. Recomendamos que você modifique os formulários de entrada de fábrica diretamente sem recriá-los. Durante as atualizações de software, as modificações nos formulários de entrada de fábrica são mescladas com as atualizações. Se a mesclagem automática falhar, você poderá resolver os conflitos. Leia mais.

Por exemplo, se você estender um schema de fábrica com um campo adicional, poderá adicionar esse campo ao formulário de fábrica relacionado.

Crie uma função de validação em um arquivo JS.

Exemplo:

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

Neste exemplo, a função é chamada de checkValue. Esta função é usada para verificar a recipient tipo de dados no nms namespace. O valor que está sendo verificado é registrado em log. Se o valor não for válido, uma mensagem de erro será registrada. Se o valor for válido, o valor 1 será retornado.

Você pode usar o valor retornado para modificar o formulário.

No formulário, adicione a variável <soapCall> elemento para o <leave> elemento.

Neste exemplo, uma chamada SOAP é usada para validar o @valueToCheck string:

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

Neste exemplo, a variável checkValue e o nms:recipient serviço são usados:

• O serviço é o namespace e o tipo de dados.
• O método é o nome da função. O nome diferencia maiúsculas e minúsculas.

A chamada é executada de forma síncrona.

Todas as exceções são exibidas. Se você usar o <leave> elemento, os usuários não poderão salvar o formulário até que as informações inseridas sejam validadas.