Editar formulários editing-forms

No menu, escolha Administration > Configuration > Input forms.

Clique no botão New na parte superior direita 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 esquema de dados 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>

  Como alternativa, você pode especificar explicitamente o esquema de dados no atributo 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>

• 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 você estiver criando um formulário multipáginas, poderá omitir o tipo de formulário no elemento <form> e especificar 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 elemento <input>. Defina o atributo xpath para a referência de campo como uma expressão XPath. Leia mais.

Este exemplo mostra campos de entrada com base no esquema nms:recipient.

<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 de 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 atributo type do elemento <form> para iconbox:

<form […] type="iconbox">

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

1. Adicione um elemento <container> como filho do elemento <form>.

2. Para definir um rótulo e uma imagem para o ícone, use os atributos label e 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>

Como alternativa, remova o atributo type="frame" dos elementos <container> existentes.

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

<form […] type="notebook">

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

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

  <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 o atributo type="frame" dos elementos <container> existentes.

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, o nome da função é checkValue. Esta função é usada para verificar o tipo de dados recipient no namespace nms. 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 o elemento <soapCall> ao elemento <leave>.

Neste exemplo, uma chamada SOAP é usada para validar a cadeia de caracteres @valueToCheck:

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

Neste exemplo, o método checkValue e o serviço nms:recipient 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 elemento <leave>, os usuários não poderão salvar o formulário até que as informações inseridas sejam validadas.