Definición XML de metadatos

Los metadatos de la aplicación se basan en una definición XML formal. El DTD (Document Type Definition) 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 property-groups PUBLIC "-//OpenKM//DTD Property Groups 2.5//EN"
                                 "http://www.openkm.com/dtd/property-groups-2.5.dtd">
<property-groups>

</property-groups>

El DOCTYPE es una definición formal de algún DTD. En el ejemplo anterior, property-groups-2.5.dtd.
El XML comienza con la etiqueta y termina con . Dentro de esta jerarquía se definen los grupos de metadatos.

Definición de un grupo de metadatos

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE property-groups PUBLIC "-//OpenKM//DTD Property Groups 2.5//EN"
                                 "http://www.openkm.com/dtd/property-groups-2.5.dtd">
<property-groups>
  <property-group label="Consulting" name="okg:consulting">

  </property-group>
</property-groups>

Cada bloque …</property-group identifica el inicio y el fin de una nueva definición de grupo de metadatos.
Cada grupo de metadatos tiene una etiqueta (label), utilizada por la interfaz de usuario: Consulting.
Cada grupo de metadatos tiene un nombre único, okg:consulting.
El nombre del grupo de metadatos siempre debe comenzar por “okg:” (OpenKM Group).
No deben utilizarse caracteres especiales en el nombre.

Atributo	Descripción	Obligatorio
label	El texto que se muestra como etiqueta en la interfaz de usuario.	true
name	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:”. Utilice únicamente letras, números y guion bajo: “0-9a-zA-Z_”.	true
visiable	Muestra u oculta los metadatos. Los valores permitidos son: - true. - false. Por defecto los metadatos son visibles.	false
readonly	Los valores de los metadatos no pueden modificarse desde la interfaz de usuario, solo desde la API. Los valores permitidos son: - true. - false. Por defecto los metadatos son modificables.	false
defaultValueClassName	Establece una clase JAVA personalizada para fijar los valores iniciales por defecto.	false

Ejemplo básico

Tipos de campo disponibles:

Checkbox
Input
Iframe
Select
Separator
Suggestbox
Text
TextArea

Más información sobre los elementos de tipo de campo en Campos de metadatos

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE property-groups PUBLIC "-//OpenKM//DTD Property Groups 2.5//EN"
                                 "http://www.openkm.com/dtd/property-groups-2.5.dtd">
<property-groups>
  <property-group label="Consulting" name="okg:consulting">
    <input label="Input label" name="okp:consulting.input1" />
    <separator label="Separator label" name="okp:consulting.separator" />
    <input label="Input label" name="okp:consulting.input2" />
  </property-group>
</property-groups>

Utilizar un DTD del sistema de archivos

Si el servidor no tiene acceso a Internet, el archivo DTD debe ser accesible de algún modo; 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/property-groups-2.5.dtd">

En el ejemplo, /home/openkm/property-groups-2.5.dtd es la ruta del archivo en el sistema de archivos.