Definición de formularios de flujo de trabajo

Los formularios de flujo de trabajo se basan en una definición XML formal. El DTD (Document Type Definition, definición de tipo de documento) define la estructura y los elementos y atributos válidos de un documento XML.

Esqueleto XML básico

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE workflow-forms PUBLIC "-//OpenKM//DTD Workflow Forms 2.6//EN"
                                "http://www.openkm.com/dtd/workflow-forms-2.6.dtd">
<workflow-forms>

</workflow-forms>

El DOCTYPE es una definición formal de un DTD. En el ejemplo anterior se utiliza workflow-forms-2.6.dtd.
El XML comienza con la etiqueta y termina con . Dentro de esta jerarquía se definen los grupos de metadatos.

Definición del formulario de una tarea de flujo de trabajo

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE workflow-forms PUBLIC "-//OpenKM//DTD Workflow Forms 2.0//EN"
                                "http://www.openkm.com/dtd/workflow-forms-2.0.dtd">
<workflow-forms>
  <workflow-form task="evaluate price">

  </workflow-form>
</workflow-forms>

Cada bloque … identifica el inicio y el fin de una nueva definición de formulario de tarea de flujo de trabajo.
Cada tarea tiene un nombre único, “evaluate price”.
No utilice caracteres especiales en el nombre.

Atributo	Descripción	Obligatorio
task	Identificador único del campo. Dos grupos de metadatos no pueden tener el mismo nombre. El nombre debe ser único. El nombre debe comenzar por “okg:”. No utilice caracteres especiales en el nombre de la tarea. Sugerimos (0-9a-zA-Z_).	true
defaultValueClassName	Establece una clase Java personalizada para definir los valores por defecto iniciales.	false

Ejemplo básico

Tipos de campo disponibles:

Checkbox
Button
Download
Input
Iframe
Select
Separator
Suggestbox
Text
TextArea
Upload
VerticalPanel
HorizontalPanel

Encontrará más información sobre los elementos de tipo de campo en Campos de flujo de trabajo

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE workflow-forms PUBLIC "-//OpenKM//DTD Workflow Forms 2.0//EN"
                                "http://www.openkm.com/dtd/workflow-forms-2.0.dtd">
<workflow-forms>
  <workflow-form task="evaluate price">
    <input label="Purchase price" name="price" data="price" readonly="true" />
    <textarea label="Purchase description" name="description" data="description" readonly="true" />
    <button name="approve" label="Approve" transition="approve"/>
    <button name="deny" label="Deny" transition="deny"/>
  </workflow-form>
</workflow-forms>

Uso de un DTD en el sistema de ficheros

Si el servidor no tiene acceso a Internet, el fichero DTD debe ser accesible de alguna forma; por ejemplo, puede almacenar una copia en su servidor de aplicaciones.

<!DOCTYPE property-groups PUBLIC "-//OpenKM//DTD Property Groups 2.6//EN"
                                 "file:///home/openkm/workflow-forms-2.6.dtd">

En el ejemplo, /home/openkm/workflow-forms-2.6.dtd es la ruta del sistema de ficheros al fichero.