Editar formularios editing-forms

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

Haga clic en el botón 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 el esquema de datos 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>

  También puede especificar explícitamente el esquema de datos en el 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 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 el elemento <form> y especificar el tipo en un contenedor.

Haga clic en Save.

Inserte los elementos del formulario.

Por ejemplo, para insertar un campo de entrada, utilice el elemento <input>. Establezca el atributo xpath en la referencia de campo como una expresión XPath. Más información.

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

<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. Haga clic en 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>

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

<form […] type="iconbox">

Establezca un contenedor para cada página de formulario:

1. Agregue un elemento <container> como elemento secundario del elemento <form>.

2. Para definir una etiqueta y una imagen para el icono, use los atributos label y 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, quite el atributo type="frame" de los elementos <container> existentes.

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

<form […] type="notebook">

Agregue un contenedor para cada página de formulario:

1. Agregue un elemento <container> como elemento secundario del elemento <form>.
2. Para definir la etiqueta y la imagen para el icono, utilice los atributos label y 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, quite el atributo type="frame" de los elementos <container> existentes.

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 usa para comprobar el tipo de datos recipient en el espacio de nombres nms. 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 el elemento <soapCall> al elemento <leave>.

SOAP En este ejemplo, se usa una llamada de para validar la cadena @valueToCheck:

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

En este ejemplo, se utilizan el método checkValue y el servicio nms:recipient:

• 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 utiliza el elemento <leave>, los usuarios no podrán guardar el formulario hasta que se valide la información introducida.