Definición de formularios de workflow

Los formularios de workflow se basan en una definición XML formal. La 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 alguna DTD. En el ejemplo anterior, 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 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 formulario de tarea de workflow.
Cada tarea tiene un nombre único, “evaluate price”.
No deben utilizarse caracteres especiales en el nombre.

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

Ejemplo básico

Tipos de campo disponibles:

Checkbox
Button
Download
Input
Iframe
Select
Separator
Suggestbox
Text
TextArea
Upload

Más información sobre los elementos de tipo de campo en Campos 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">
    <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>

Utilizar una DTD del sistema de archivos

Si el servidor no tiene acceso a Internet, el archivo 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.5//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 archivos al archivo.