Campo Suggestbox de metadatos

Esta es una implementación del típico componente de caja de sugerencias AJAX:

Attribute	Description	Required
label	El texto se muestra como etiqueta en la interfaz de usuario.	true
name	Un identificador único del campo. Dos campos de metadatos no pueden tener el mismo nombre. El nombre debe ser único. El nombre debe empezar por “okp:”. Es buena práctica usar el nombre del grupo de metadatos como base para el nombre del campo. Por ejemplo, use “okg:consulting” como nombre de grupo; el nombre de campo “okp:consulting.suggestbox” se forma cambiando “okg” por “okp”. Eso ayuda a encontrar el grupo de metadatos a partir del nombre del campo. Use solo letras, números y guiones bajos: “0-9a-zA-Z_”.	true
width	El ancho del elemento HTML. En el caso de KCenter, la interfaz debe usar valores de ancho basados en %, por ejemplo: - width=“50%” funcionará - width=“100px” se ignorará en la interfaz de KCenter.	false
description	Descripción general.	false
filterQuery	Una consulta SQL para filtrar los datos. Use {0} para insertar la entrada del usuario.	*
valueQuery	Una consulta SQL para obtener el valor de un identificador. Use {0} para insertar el identificador.	*
className	Se usa una clase para obtener las opciones seleccionadas.	*
filterMinLen	El número mínimo de caracteres en la entrada para empezar a filtrar resultados.	true
dialogTitle	El título del diálogo HTML.	true
readonly	El campo no puede modificarse en la interfaz de usuario. Por defecto, el valor es “false”.	false
dbColumnSize	Establece el tamaño del campo de la base de datos donde se almacena el valor. Por defecto, los campos se almacenan en una columna de base de datos con un tamaño de 128 caracteres. Como la longitud de sus datos podría ser mayor de 128 caracteres, el administrador debería actualizar el tamaño de columna por defecto. Consulte la sección de documentación Metadata XML definition para una explicación detallada del almacenamiento de metadatos en la base de datos de OpenKM.
defaultAccess	Política de acceso de seguridad por defecto. Por defecto, se establece en “grant”, así que todos los usuarios verán la propiedad.

* Hay tres formas de obtener los valores de la suggestbox (usar una de ellas es obligatorio):
Elementos hijos:

Basado en filterQuery y valueQuery

Ahora filterQuery y valueQuery pueden ser consultas SQL normales.

Crear la tabla COUNTRY:

create table COUNTRY (
  CT_ID varchar(2),
  CT_NAME varchar(32),
  primary key(CT_ID)
);

insert into COUNTRY (CT_ID, CT_NAME) values ('es', 'Spain');
insert into COUNTRY (CT_ID, CT_NAME) values ('pt', 'Portugal');
insert into COUNTRY (CT_ID, CT_NAME) values ('it', 'Italy');

Definición de metadatos:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE property-groups PUBLIC "-//OpenKM//DTD Property Groups 3.10//EN"
                                 "http://www.openkm.com/dtd/property-groups-3.10.dtd">
<property-groups>
  <property-group label="Consulting" name="okg:consulting">
   <suggestbox label="country" name="okp:consulting.suggestbox"
       width="200px" dialogTitle="Choose country" filterMinLen="3"
      filterQuery="select ct_id, ct_name from COUNTRY where ct_name like '%{0}%' order by ct_name"
      valueQuery="select ct_id, ct_name from COUNTRY where ct_id='{0}'" />
  </property-group>
</property-groups>

Basado en className

Para ayudar a obtener una lista desde aplicaciones externas u otros propósitos, se puede construir su propia clase para obtener los valores de opción de esos sistemas.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE property-groups PUBLIC "-//OpenKM//DTD Property Groups 3.10//EN"
                                 "http://www.openkm.com/dtd/property-groups-3.10.dtd">
<property-groups>
  <property-group label="Consulting" name="okg:consulting">
   <suggestbox label="country" name="okp:consulting.suggestbox"
       width="200px" dialogTitle="Choose country" filterMinLen="3"
      className="com.openkm.plugin.form.values.SuggestBoxUserList" />
  </property-group>
</property-groups>

Para más información, lea Creating your own Suggestbox plugin