Editar formularios editing-forms

En el menú, elija Administration > Configuration > Input forms.

Haga clic en New en la parte superior derecha de la lista.

Especifique las propiedades del formulario:

• Especifique el nombre del formulario y el área de nombres.

  El nombre del formulario y el área de nombres pueden coincidir con el esquema de datos relacionado. Este ejemplo muestra un formulario para la cus:order esquema de datos:

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

  También puede especificar explícitamente el esquema de datos en la variable 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 la etiqueta que se mostrará en el formulario.

• De forma opcional, especifique el tipo de formulario. Si no especifica un tipo de formulario, se utiliza el tipo de pantalla de la consola de forma predeterminada.

  

  Si está diseñando un formulario de varias páginas, puede omitir el tipo de formulario en la <form> y especifique el tipo en un contenedor.

Haga clic en Save.

Inserte los elementos del formulario.

Por ejemplo, para insertar un campo de entrada, utilice el <input> Elemento. Configure las variables xpath a la referencia de campo como una expresión XPath. Más información.

Este ejemplo muestra campos de entrada basados en la variable nms:recipient esquema.

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

Si el formulario se basa en un tipo de esquema específico, puede buscar los campos de este esquema:

1. Clic Insert > Document fields.

   

2. Seleccione el campo y haga clic en OK.

   

De forma opcional, especifique el editor de campos.

Hay asociado un editor de campos predeterminado con cada tipo de datos:

• Para un campo de tipo fecha, el formulario muestra un calendario de entrada.
• Para un campo de tipo lista desglosada, el formulario muestra una lista de selección.

Puede utilizar estos tipos de editor de campos:

Más información sobre controles de lista de memoria.

De forma opcional, defina el acceso a los campos:

Ejemplo:

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

De forma opcional, utilice contenedores para agrupar campos en secciones.

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

Cambie el type atributo del <form> elemento a iconbox:

<form […] type="iconbox">

Establezca un contenedor para cada página de formulario:

1. Añadir un <container> como elemento secundario del elemento <form> Elemento.

2. Para definir una etiqueta y una imagen para el icono, utilice la variable label y 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, quite el type="frame" atributo del existente <container> elementos.

Cambie el type atributo del <form> elemento a notebook:

<form […] type="notebook">

Agregue un contenedor para cada página de formulario:

1. Añadir un <container> como elemento secundario del elemento <form> Elemento.
2. Para definir la etiqueta y la imagen del icono, utilice la variable label y 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, quite el type="frame" atributo del existente <container> elementos.

Modifique el formulario de entrada de fábrica:

1. En el menú, elija Administration > Configuration > Input forms.
2. Seleccione un formulario de entrada y modifíquelo.

Puede ampliar los esquemas de datos de fábrica, pero no puede ampliar los formularios de entrada de fábrica. Se recomienda modificar los formularios de entrada de fábrica directamente sin volver a crearlos. Durante las actualizaciones de software, las modificaciones realizadas en los formularios de entrada de fábrica se combinan con las actualizaciones. Si la combinación automática falla, puede resolver los conflictos. Más información.

Por ejemplo, si amplía un esquema de fábrica con un campo adicional, puede añadir este campo al formulario de fábrica relacionado.

Cree una función de validación en un archivo JS.

Ejemplo:

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

En este ejemplo, la función se denomina checkValue. Esta función se utiliza para comprobar el recipient tipo de datos en nms namespace. El valor que se está comprobando se registra. Si el valor no es válido, se registra un mensaje de error. Si el valor es válido, se devuelve el valor 1.

Puede utilizar el valor devuelto para modificar el formulario.

En el formulario, agregue <soapCall> al elemento <leave> Elemento.

En este ejemplo, se utiliza una llamada SOAP para validar el @valueToCheck cadena:

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

En este ejemplo, la variable checkValue y el método nms:recipient se utilizan estos servicios:

• El servicio es el área de nombres y el tipo de datos.
• El método es el nombre de la función. El nombre distingue entre mayúsculas y minúsculas.

La llamada se realiza sincrónicamente.

Se muestran todas las excepciones. Si usa el <leave> , los usuarios no podrán guardar el formulario hasta que se valide la información introducida.