Tema anterior: Variables de listaTema siguiente: Variables de operación


Operaciones de servidor compatibles

A fin de permitirle integrar las páginas Web de CA SDM en sus páginas Web se admiten las siguientes operaciones:

CREATE_NEW

Proporciona una interfaz genérica para permitir al usuario crear una fila en una tabla especificada. Debe especificarse el nombre de objeto y, de forma predeterminada, se emplea una plantilla llamada detail_xxx_edit.htmpl para el objeto xxx. Puede anular el archivo .htmpl si especifica la propiedad HTMPL.

Especificadores obligatorios:

FÁBRICA=objectname

Especificadores opcionales:

ALG_PRESET=expresión_predefinida
ALG_PRESET_REL=expresión_predefinida
CREATE_ALG=tipo_registro_actividades
HTMPL=zdetailxxx_fábrica.htmpl
KEEP.nombre_atributo=valor
PRESET=expresión_predefinida
PRESET_REL=expresión predefinida
SET.nombre_atributo=valor
use_template=1 | 0 (0 es el valor predeterminado)

Nota: Para usar el especificador HTMPL con CREATE_NEW, el formulario al que se hace referencia debe tener un nombre conforme con la convención de nombres zdetailxxx_fábrica.htmpl. El nombre debe comenzar por la cadena zdetail, seguida de cualquier carácter alfanumérico (incluida una cadena nula) y, a continuación, de un guion bajo y del nombre de la fábrica.

ENDSESSION o LOGOUT

Finaliza la sesión iniciada en ese momento. ENDSESSION es la operación preferible.

GENERIC_LIST

Proporciona una interfaz genérica para permitir al usuario mostrar una lista a partir de cualquier tabla de la base de datos. Debe especificarse el nombre de objeto y, de forma predeterminada, se emplea una plantilla llamada list_xxx.htmpl para el objeto xxx. Puede anular el archivo .htmpl si especifica la propiedad HTMPL.

Especificadores obligatorios:

FÁBRICA=objectname
KEEP.nombre_atributo=valor

DISPLAY_FORM

Proporciona una interfaz genérica para permitir al usuario mostrar cualquier formulario personalizado.

Especificadores obligatorios:

HTMPL=archivo_htmpl

Nota: DISPLAY_FORM reemplaza a JUST_GRONK_IT. Las implementaciones existentes pueden continuar utilizando JUST_GRONK_IT, que funciona exactamente igual a DISPLAY_FORM. DISPLAY_FORM es la operación preferible.

MENU

Muestra la página de menú principal, que se define en el archivo web.cfg en la propiedad Menu.

Especificadores opcionales:

HTMPL=archivo_menú

archivo_menú es el nombre de un archivo de menú principal alternativo.

PAGE_EXTENSION

Permite al administrador Web especificar más extensiones para la interfaz.

Especificadores obligatorios:

NAME=archivo_html

archivo_html es uno de los nombres de archivo que se enumeran en la directiva UserPageExtensions del archivo de configuración.

Especificadores opcionales:

REQUIRES_LOGIN=1

Si está presente, primero aparecerá una página de inicio de sesión si el usuario no ha iniciado sesión aún. Si se omitió o estableció en cero, el archivo se muestra sin comprobar si el usuario está conectado actualmente.

RELOG

Muestra la página de inicio de sesión.

SEARCH

Proporciona una interfaz genérica para permitir la búsqueda de tablas en la base de datos. Esta operación supone que se ha creado un search_ xxx.htmpl apropiado, donde xxx es el nombre de objeto, tal como se define en los archivos .maj del directorio majic en bopcfg.

Nota: Para obtener más información, consulte la Guía de referencia técnica de CA SDM. De forma predeterminada, los resultados de esta búsqueda se muestran en list_xxx.htmpl, aunque podría omitirse si se especifica la propiedad HTMPL.

Especificadores obligatorios:

FACTORY=nombre-objeto
QBE.op.nombre_atributo=valor

Especificadores opcionales:

ALG_PRESET=expresión_predefinida
ALG_PRESET_REL=expresión_predefinida
CREATE_ALG=tipo_registro_actividades
HTMPL=archivo_list_htmpl
KEEP.nombre_atributo=valor

SEC_REFRESH

Actualiza la información de acceso del usuario procedente del subsistema de seguridad. A los usuarios que cuentan con privilegio de modificación (para el grupo funcional admin) se les proporciona, en la pantalla de menú, un hipervínculo para esta operación. Después de actualizar el privilegio de acceso de un usuario mediante el programa de seguridad, esta operación proporciona un medio de actualizar la información de acceso. (Esta operación actualiza la información de seguridad correspondiente a todos los usuarios).

Nota: La actualización de la seguridad es un proceso asíncrono. Cuando se termine la actualización de seguridad, aparecerá un mensaje en el archivo de registro estándar (stdlog).

SET_MENU

El comportamiento de esta operación es el mismo que el de la operación MENU cuando MENU se utiliza con la variable HTMPL. La única diferencia radica en que esta operación definirá también el formulario de menú predeterminado como el formulario de menú especificado con la propiedad HTMPL.

Especificadores obligatorios:

HTMPL=archivo_htmpl

Nota: Este especificador anulará la operación MENU definida en el archivo web.cfg hasta que se reinicie el servicio Web.

SHOW_DETAIL

Proporciona una interfaz genérica que permite al usuario mostrar un detalle de sólo lectura de una fila en una tabla especificada. Es preciso especificar el nombre de ID persistente (desde el que se infiere el nombre de objeto). De forma predeterminada se emplea una plantilla llamada detail_xxx_ro.htmpl para el objeto xxx. El archivo .htmpl puede anularse si se especifica la propiedad HTMPL.

Especificadores obligatorios:

PERSID=persistentid

Especificadores opcionales:

ALG_PRESET=expresión_predefinida
ALG_PRESET_REL=expresión_predefinida
CREATE_ALG=tipo_registro_actividades
HTMPL=archivo_detail_htmpl_sólolectura

UPDATE

Proporciona una interfaz genérica que hace posible editar cualquier tabla. Debe introducirse el ID y el nombre de objeto y se le mostrará al usuario un formulario de detalle que éste puede editar. De forma predeterminada, el usuario cuenta con acceso exclusivo al registro durante dos minutos y se le garantiza que los cambios pasan a la base de datos si se envían en este tiempo.

Especificadores obligatorios:

PERSID=ID-persistente o
SET.id=ID-de-fila-que-actualizarFACTORY=nombre-objeto

Especificadores opcionales:

NEXT_PERSID=persistentid (del registro para mostrar después de una actualización correcta)
KEEP.nombre_atributo=valor
KEY.nombre_atributo=valor
HTMPL=zdetailxxx_fábrica.htmpl

Nota: Para usar el especificador HTMPL con UPDATE, el formulario al que se hace referencia debe tener un nombre conforme con la convención de nombres zdetailxxx_fábrica.htmpl. El nombre debe comenzar por la cadena "zdetail", seguida de cualquier carácter alfanumérico (incluida una cadena nula) y, a continuación, de un guión bajo y del nombre de fábrica.

Nota: Para obtener información sobre web.cfg, consulte la Guía de administración.