Definición de formularios de Workflow

Los formularios de workflow se basan en una definición XML formal. El DTD (Document Type Definition) define la estructura y los elementos y atributos permitidos 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, el DTD es workflow-forms-2.6.dtd.
El XML empieza con la etiqueta y termina con . Dentro de este elemento se declaran las definiciones de las tareas de formulario del workflow.

Definición de formulario de tarea de workflow

<?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 tarea de formulario de workflow.
Cada tarea tiene un nombre único, “evaluate price”.
No use caracteres especiales en el nombre.

Atributo	Descripción	Obligatorio
task	Identificador único de la tarea. Dos tareas de formulario no pueden tener el mismo nombre. El nombre debe ser único. No use caracteres especiales en el nombre de la tarea. Sugerimos (0-9a-zA-Z_).	true
defaultValueClassName	Establece una clase Java personalizada para fijar valores iniciales por defecto.	false

Ejemplo básico

Tipos de campo disponibles:

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

Más información sobre los elementos de tipo de campo en Workflow fields

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

Usar un DTD del sistema de ficheros

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

<!DOCTYPE workflow-forms PUBLIC "-//OpenKM//DTD Workflow Forms 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 archivo.