Params Select field

Attribute	Description	Required
label	El texto que se muestra como etiqueta en la interfaz de usuario.	true
name	Un identificador único del campo. Dos campos no pueden tener el mismo nombre en la misma definición de tarea. El nombre debe ser único.	true
type	Valor del tipo. Tipos permitidos: - Simple (permite una sola elección). - Multiple (permite selecciones múltiples).	true
table	Nombre de la tabla de metadatos. La aplicación puede almacenar valores en una tabla de metadatos que puede usarse en esta consulta.	*
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
height	La altura del elemento HTML.	false
optionsQuery	Se usa una consulta de metadatos o una consulta SQL para obtener las opciones del select.	*

Precaución

Debe definirse una de estas opciones. De lo contrario, obtendrá un error. No puede combinar varias; solo se puede elegir una.

• * Hay dos opciones para obtener valores de opción:

• Elementos hijo:

Ejemplo básico de select

• Type es igual a simple.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE report-parameters PUBLIC "-//OpenKM//DTD Report Parameters 2.1//EN"
                                   "http://www.openkm.com/dtd/report-parameters-2.1.dtd">
<report-parameters>
  <select label="select label" name="select" type="simple">
    <option label="one" value="001" />
    <option label="two" value="002" />
    <option label="three" value="003" />
  </select>
</report-parameters>

Permitir selección múltiple

• Type es igual a multiple.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE report-parameters PUBLIC "-//OpenKM//DTD Report Parameters 2.1//EN"
                                   "http://www.openkm.com/dtd/report-parameters-2.1.dtd">
<report-parameters>
  <select label="select label" name="select" type="multiple">
    <option label="one" value="001" />
    <option label="two" value="002" />
    <option label="three" value="003" />
  </select>
</report-parameters>

Relación jerárquica

• Los valores de opción del campo “childrenSelect” tienen una relación padre con “parentSelect”. Se define mediante parentElement=“parentSelect”.
• El valor de opción “benefits” del campo “childrenSelect” tiene un valor padre “directives” en el campo “parentSelect”.

Relaciones de árbol:

• directives
  • benefits
  • eligibility
  • services
• handbook
  • basic
  • normal
  • advanced

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE report-parameters PUBLIC "-//OpenKM//DTD Report Parameters 2.1//EN"
                                   "http://www.openkm.com/dtd/report-parameters-2.1.dtd">
<report-parameters>
  <select label="Parent" name="parentSelect" type="simple">
    <option value="directives" label="Directives" />
    <option value="handbook" label="Handbook Paragraphs" />
  </select>
  <select label="Children" name="childrenSelect" type="simple" parentElement="parentSelect">
    <option value="benefits" label="Benefits" parentValue="directives" />
    <option value="elegibility" label="Eligibility" parentValue="directives" />
    <option value="services" label="Services" parentValue="directives" />
    <option value="basic" label="Basic" parentValue="handbook" />
    <option value="normal" label="Advanced" parentValue="handbook" />
    <option value="advanced" label="Normal" parentValue="handbook" />
  </select>
</report-parameters

Basado en consulta SQL

También podemos obtener estos valores de opción usando una consulta SQL. Esta sentencia SQL debería colocarse en el atributo optionsQuery, pero el atributo table debería estar vacío (de lo contrario, esta consulta es una consulta de metadatos). Tenga en cuenta que el primer elemento devuelto en cada fila es el valor de la opción, y el segundo es la etiqueta de la opción.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE report-parameters PUBLIC "-//OpenKM//DTD Report Parameters 2.1//EN"
                                   "http://www.openkm.com/dtd/report-parameters-2.1.dtd">
<report-parameters>
  <select label="country" name="country" type="simple"
          optionsQuery="select CT_ID, CT_NAME from COUNTRY order by CT_NAME" />
</report-parameters>

La tabla usada en este ejemplo se define de la siguiente manera:

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');

Basado en className

Para ayudar a obtener una lista de aplicaciones externas o para otros propósitos, se puede construir una clase que recupere los valores de opción de esos sistemas.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE report-parameters PUBLIC "-//OpenKM//DTD Report Parameters 2.1//EN"
                                   "http://www.openkm.com/dtd/report-parameters-2.1.dtd">
<report-parameters>
    <select label="select label" name="okp:consulting.select" type="simple"
            className="com.openkm.plugin.form.values.OptionSelectUserList" />
</report-parameters>

Para más información, lea Creating your own Option Select Values plugin.

Opciones sugeridas

Basándose en el analizador de contenido, la aplicación puede sugerir algunos valores de opción. En la interfaz de usuario, las opciones recomendadas se mostrarán en verde.

La aplicación tiene algunas implementaciones que pueden extenderse fácilmente.

• com.openkm.form.suggestion.DocumentContentContainsSuggestion: Obtiene sugerencias basadas en el contenido del documento (usa String.contains)
• com.openkm.form.suggestion.DocumentContentTokenizerSuggestion: Obtiene sugerencias basadas en el contenido del documento (usa StringTokenizer).
• com.openkm.form.suggestion.DocumentTermsSuggestion: Obtiene sugerencias basadas en los vectores de términos del documento.

Para más información, lea Creating your own Suggestion Analyzer.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE report-parameters PUBLIC "-//OpenKM//DTD Report Parameters 2.1//EN"
                                   "http://www.openkm.com/dtd/report-parameters-2.1.dtd">
<report-parameters>
    <select label="select label"  name="okp:consulting.select" type="multiple"
            suggestion="com.openkm.form.suggestion.DocumentContentContainsSuggestion">
        <option label="one" value="001" />
        <option label="two" value="002" />
        <option label="three" value="003" />
    </select>
</report-parameters>