Cómo modificar esquemas mediante Web Screen Painter

Utilice el diseñador de esquemas de Web Screen Painter para modificar el esquema de la base de datos de CA SDM. El diseñador de esquemas proporciona una interfaz de usuario gráfica que permite revisar y modificar este esquema. El siguiente diagrama muestra cómo modificar un esquema mediante Web Screen Painter:
casm173
Utilice el diseñador de esquemas de Web Screen Painter para modificar el esquema de la base de datos de CA SDM. El diseñador de esquemas proporciona una interfaz de usuario gráfica que permite revisar y modificar este esquema. El siguiente diagrama muestra cómo modificar un esquema mediante Web Screen Painter:
Diagrama que describe cómo personalizar el esquema mediante WSP
Diagram depicting how to customize schema using WSP
Siga los pasos siguientes:
Apertura del diseñador de esquemas en Web Screen Painter
Para empezar a trabajar con el diseñador de esquemas, asegúrese de tener instalado Web Screen Painter en el servidor de CA SDM. Para obtener más información acerca de la instalación de Web Screen Painter, consulte Instalación de Web Screen Painter.
Siga los pasos siguientes:
  1. Inicie sesión en el siguiente servidor de CA SDM donde está instalado Web Screen Painter, dependiendo de la configuración de CA SDM:
    • Convencional: Servidor principal
    • Disponibilidad avanzada: Servidor en segundo plano
  2. Empiece a utilizar Web Screen Painter con cualquiera de las siguientes acciones, en función del sistema operativo instalado en el servidor de CA SDM:
    • (Windows) En el menú Inicio, seleccione Archivos de programa, CA, CA SDM, Web Screen Painter.
    • (UNIX) Escriba el comando pdm_wsp con $NX_ROOT/bin en la ruta.
    Se abrirá la ventana de inicio de sesión de Web Screen Painter.
  3. Introduzca las credenciales de inicio de sesión.
  4. Seleccione Herramientas, Diseñador de esquemas.
    Aparecerá la ventana Diseñador de esquemas. En la parte izquierda de la ventana Diseñador de esquemas, aparecerá la base de datos de CA SDM con formato de árbol. Las tablas y columnas se muestran según su nombre de objeto. Además, si el nombre de visualización es diferente del nombre de objeto de la tabla o la columna, se mostrará el nombre de visualización entre paréntesis detrás del nombre de objeto.
Adición de tablas
Utilice el diseñador de esquemas para agregar una tabla en la base de datos.
Siga los pasos siguientes:
  1. Seleccione Editar, Agregar tabla.
    Aparecerá el cuadro de diálogo Agregar nueva tabla.
  2. Escriba el nombre de la tabla en el campo Nombre de nueva tabla y haga clic en Aceptar. Asegúrese de empezar el nombre de una tabla definida por el sitio por la letra "z" para evitar conflictos con posibles tablas estándares en el futuro.
    WSP agrega una "z" al principio del nombre de la tabla si resulta necesario.
  3. Rellene los campos siguientes según sea necesario:
    • Nombre
      (Solo lectura) Especifica el nombre de objeto de la tabla. Por ejemplo, el nombre de objeto de la tabla cr es “cr”.
    • Visualizar nombre
      Muestra el nombre sencillo de la tabla. Por ejemplo, el nombre para mostrar de la tabla cr es “Solicitud”. Es posible cambiar el nombre de visualización de una tabla con tan solo escribir un nombre nuevo en este campo.
    • Nombre de esquema
      (Solo lectura para tablas estándar) Muestra el nombre utilizado para hacer referencia a la tabla en las utilidades de CA SDM, como pdm_userload. En las tablas definidas por el departamento, el valor predeterminado del nombre de esquema es el nombre de objeto. Puede cambiar el nombre de esquema si se escribe otro valor en este campo.
    • Nombre DBMS
      Muestra el nombre utilizado para hacer referencia a la tabla en el DBMS físico. Se trata de un campo de solo lectura para todas las tablas. En el caso de las tablas definidas por el departamento, siempre coincide con el nombre de esquema.
    • Campo de visualización predeterminado (nombre común)
      Indica la columna mostrada en la interfaz de usuario para un campo que hace referencia a esta tabla. Por ejemplo, el campo del asignatario de una solicitud hace referencia a la tabla Contact. El nombre común de la tabla Contact es combo_name (apellidos, nombre y segundo nombre), por lo que el nombre combinado del contacto al que se hace referencia se muestra como el asignatario. No puede cambiar el valor de nombre común.
    • Campo de clave externa (atributo relacionado)
      Indica la columna almacenada en la base de datos para un campo que hace referencia a esta tabla. Por ejemplo, el campo del asignatario de una solicitud hace referencia a la tabla Contact. Puesto que el atributo relacionado de la tabla Contact es un ID, la columna del asignatario en una tabla Solicitud contendrá el ID del contacto al que se hace referencia. No puede cambiar el valor del atributo relacionado
    • Grupo de funciones
      Muestra el nombre del grupo que controla el nivel de acceso a los registros de esta tabla por parte de los usuarios. El tipo de acceso de cada contacto especifica si se tiene acceso de solo lectura o de edición a los datos incluidos en las tablas de cada grupo de funciones, o si no tiene ninguno. Puede cambiar el valor del atributo relacionado con tan solo seleccionar un valor nuevo de la lista desplegable.
    El diseñador de esquemas incluye una ficha Opciones avanzadas. La información contenida en esta ficha está destinada al personal de soporte y de campo de CA Technologies. No tendrá necesidad de recurrir a esta ficha para la mayor parte de usos del creador de esquemas, por lo que no se tratará con más detalle en este documento.
    La ficha Opciones avanzadas del cuadro de diálogo en la columna Diseñador de esquemas muestra información relevante únicamente para personas con conocimientos internos de CA SDM. Su contenido variará según el tipo de columna. Los valores de esta ficha solo deberían modificarse bajo la dirección de un empleado de CA. Si hay una tabla seleccionada, contiene los campos siguientes:
    • Desencadenantes activos
      Muestra los desencadenantes activos actualmente en el motor de objetos correspondiente a la columna. Los desencadenantes son programas pequeños que se ejecutan bajo la dirección del motor de objetos en momentos determinados durante la edición de columnas. La lista de desencadenantes activos incluye tanto desencadenantes estándar como definidos por el departamento (de modo que estos últimos aparecen enumerados en ambas listas de desencadenantes activos y de desencadenantes definidos por el departamento).
    • Desencadenantes definidos por el departamento
      Muestra los desencadenantes instalados en el departamento. Por ejemplo, puede tratarse de los desencadenantes activados como resultado de la instalación de la opción de CA SDM o de los que el servicio técnico de CA ha escrito para su departamento. La lista de desencadenantes activos incluye tanto desencadenantes estándar como definidos por el departamento (de modo que estos últimos aparecen enumerados en ambas listas de desencadenantes activos y de desencadenantes definidos por el departamento).
    • Especificación LRel
      Especifica una relación de muchos a muchos entre dos tablas, con el formato siguiente:
      tabla1 columna1 <> tabla2 columna2
      Aquí se indica que la LREL es una relación de muchos a muchos entre la tabla1 y la tabla2, donde la columna virtual columna1 contiene la relación en la tabla1 y la columna virtual columna2 contiene la relación en la tabla2.
    • Información de consulta xRel activa
      Muestra la especificación activa de la consulta que define una columna virtual BREL o QREL. Esta especificación tiene el formato majic del motor de objetos.
    • Información de consulta xRel definida por el departamento
      Permite modificar la consulta asociada con columnas BREL o QREL. Se recomienda modificar este campo sólo bajo la dirección de un empleado de CA.
    • Expresión derivada activa
      Muestra la especificación activa de la expresión que el motor de objetos utiliza para construir el valor de una columna virtual DERIVADA.
    • Información de consulta xRel definida por el departamento
      Permite modificar la expresión asociada con cualquier columna DERIVADA. Se recomienda modificar este campo sólo bajo la dirección de un empleado de CA.
    La ficha Domsets del cuadro de diálogo Tabla del creador de esquemas contiene lo siguiente:
    • MLIST_DYNAMIC
      Un domset dinámico sin cláusula WHERE.
    • MLIST_STATIC
      Un domset estático sin cláusula WHERE.
    • RLIST_DYNAMIC
      Un domset dinámico con una cláusula WHERE definida en la sección STANDARD_LISTS de la instrucción FACTORY.
    • RLIST_STATIC
      Un domset estático con una cláusula WHERE definida en la sección STANDARD_LISTS de la instrucción FACTORY.
    Si se hace doble clic en uno de los domsets, se abre el cuadro de diálogo Propiedades con los campos siguientes:
    • domset_name
    • fetch_columns
    • max_fetch
    • columnas de clasificación
      (
      Este es el único campo editable)
    • volatilidad
    • donde
  4. Lleve a cabo una de las siguientes acciones para guardar la tabla:
    • Si se trabaja en el sistema de prueba, seleccione Archivo, Guardar.
    • Si se trabaja en el sistema de producción, seleccione Archivo, Guardar y establecer en modo de prueba.
      Está selección guardará los cambios en la base de datos y se creará un archivo (wsptest.mods) en el servidor para definirlos en el motor de objetos. Este archivo se almacena en el subdirectorio site/mods/majic del directorio de instalación de CA SDM. Tras crear el archivo wsptest.mods, Web Screen Painter forzará el reciclaje del motor de objetos para que utilice los cambios nuevos. Esta operación puede llevar unos segundos o varios minutos, según la complejidad del esquema.
      Se mostrará un mensaje. Haga clic en Sí para continuar. El archivo wsptest.mods solo afecta al motor de objetos designado por la opción wsp_domsrvr. El resto de motores de objetos del servidor no procesan este archivo, el cual tampoco se distribuye a otros servidores. Además, las tablas y columnas nuevas en el modo de prueba se definen en el motor de objetos a modo de objetos locales. Esto significa que el motor de objetos las detecta y es posible utilizarlas en los formularios Web. No obstante, no existen en la base de datos y no afectan a otros usuarios. Los usuarios normales de CA SDM no utilizan el motor de objetos de WSP, por lo que no se ven afectados por las modificaciones del esquema que se están probando. Se habrá agregado la tabla.
Adición de columnas
Utilice el diseñador de esquemas para agregar una columna en la base de datos.
Siga estos pasos:
  1. Seleccione la tabla a la que se desea agregar una columna (o seleccione cualquiera de sus columnas existentes).
  2. Seleccione Editar, Agregar columna.
    Aparecerá el cuadro de diálogo Agregar nueva columna.
  3. Escriba el nombre de la columna en el campo Nombre de nueva columna y haga clic en Aceptar. Asegúrese de empezar el nombre de una columna por la letra "z" para evitar conflictos con posibles columnas estándares en el futuro.
    WSP verifica que se haya agregado el prefijo, pero agrega una z al inicio del nombre de la columna si fuera necesario.
  4. Rellene los campos siguientes según sea necesario:
    • Nombre
      (Solo visualización) Especifica el nombre de objeto de la columna. Por ejemplo, el nombre de objeto de la columna alt_phone de la tabla Contact es "alt_phone".
    • Visualizar nombre
      Muestra el nombre sencillo de la columna. Es posible cambiar el nombre para mostrar de una columna con tan solo escribir otro nombre en este campo. Por ejemplo, el nombre para mostrar de la columna alt_phone de la tabla Contact es "teléfono alternativo".
    • Nombre de esquema
      (Solo lectura para tablas estándar) Muestra el nombre utilizado para hacer referencia a la columna en las utilidades de CA SDM, como pdm_userload. En las tablas definidas por el departamento, el valor predeterminado del nombre de esquema es el nombre de objeto. El nombre de esquema se puede cambiar introduciendo otro valor en este campo.
    • Nombre DBMS
      (Solo lectura para todas las tablas) Muestra el nombre utilizado para hacer referencia a la tabla en el DBMS físico. En el caso de las tablas definidas por el sitio, el nombre del DBMS siempre coincide con el nombre del esquema.
    • Descripción
      Ofrece una descripción breve de la columna.
    • Tipo de campo
      (Solo lectura para todas las columnas estándar de las tablas estándar y las columnas guardadas definidas por el sitio) Especifica el tipo de datos de la columna. Puede especificar o cambiar el tipo de campo de las columnas definidas por el departamento con tan solo seleccionar un valor de la lista desplegable. La lista siguiente describe los tipos de campo disponibles:
      • INTEGER
        Indica un valor numérico.
      • STRING
        Indica una cadena de texto. El campo Longitud de la cadena indica el número de caracteres en una cadena.
      • DATE
        Indica una fecha y una hora. El valor entero almacenado en la base de datos contiene el número de segundos desde la medianoche del 1 de enero de 1970.
      • DURACIÓN
        Indica un período de tiempo. El valor almacenado en la base de datos es un número entero que contiene un número de segundos.
      • DOBLE
        Indica un número real (punto flotante).
      • SREL
        Indica una referencia de clave externa a otra tabla. El campo Tabla SREL especifica la tabla a la cual se hace referencia. El valor almacenado en la base de datos es el atributo relacionado de la tabla a la que se hace referencia, que puede ser un número entero o una cadena. El valor que se muestra en el producto es el nombre común de la fila incluida en la tabla a la que se hace referencia. Para obtener más información acerca de la configuración de los atributos de SREL con valores de clave externa, consulte Comandos de referencia de CA Service Desk Manager.
      • BREL
        Indica una columna virtual que representa el conjunto de todos los objetos con una SREL asociada a esta tabla. Solo existe en el motor de objetos; no está almacenado físicamente en la base de datos. Seleccione este tipo de campo únicamente bajo la dirección de un empleado de CA Technologies.
      • QREL
        Indica una columna virtual que representa un conjunto de objetos seleccionados por la cláusula WHERE en la ficha Opciones avanzadas. Solo existe en el motor de objetos; no está almacenado físicamente en la base de datos. Seleccione este tipo de campo únicamente bajo la dirección de un empleado de CA Technologies.
      • DERIVADA
        Indica una columna virtual construida por el motor de objetos a partir de los valores de otras columnas, bajo la dirección de una fórmula especificada en la ficha Opciones avanzadas. Solo existe en el motor de objetos; no está almacenado físicamente en la base de datos. Seleccione este tipo de campo únicamente bajo la dirección de un empleado de CA Technologies.
    • Longitud de cadena
      La longitud de una columna de cadena. Este campo se deja en blanco para las otras columnas. Es un campo de solo lectura en lo que respecta a todas las columnas estándar y a las columnas guardadas definidas por el departamento. Puede especificar o cambiar la longitud de las columnas CADENA nuevas definidas por el departamento con tan solo escribir un número entero entre 1 y 32767 en este campo.
    • Tabla SRel
      Se trata de la tabla a la que hace referencia una columna SREL. Este campo se deja en blanco para las otras columnas. Es un campo de solo lectura en lo que respecta a todas las columnas estándar y a las columnas guardadas definidas por el departamento. Puede especificar la tabla a la que hace referencia la columna de SREL nueva definida por el departamento con tan solo seleccionar un valor de la lista desplegable.
    • Valor predeterminado al crear
      Es el valor predeterminado asignado a esta columna al definir una fila nueva de la tabla. Debe ser un valor apropiado para el tipo de campo. Hay algunos valores de palabra clave disponibles para tipos de campos específicos:
      • AHORA
        Especifica la fecha y la hora actuales para la columna FECHA.
      • USUARIO
        Especifica el usuario activo para la columna SREL de la tabla Contact.
    • Valor configurado al guardar
      Es el valor asignado a esta columna al actualizar una fila de la tabla. Debe ser un valor apropiado para el tipo de campo. Hay algunos valores de palabra clave disponibles para tipos de campos específicos:
      • AHORA
        Especifica la fecha y la hora actuales para la columna FECHA.
      • USUARIO
        Especifica el usuario activo para la columna SREL de la tabla Contact.
    • Necesario
      Cuando está marcada, esta opción indica que se debe proporcionar un valor para la columna antes de guardar una fila de la tabla que la contiene. Esta opción puede definirse para columnas estándar y definidas por el departamento y podrá desactivar una opción que haya establecido anteriormente. Sin embargo, no podrá desactivar la opción de una columna estándar a menos que la haya establecido su departamento.
    • Actualizable solo para registro nuevo
      Cuando está marcada, esta opción indica que se solo se puede proporcionar un valor para esta columna durante la creación inicial de una fila de la tabla en que está incluida y, posteriormente, no podrá modificarse. Esta opción puede definirse para columnas estándar y definidas por el departamento y podrá desactivar una opción que haya establecido anteriormente. Sin embargo, no podrá desactivar la opción de una columna estándar a menos que la haya establecido su departamento.
    • Clave para pdm_userload
      Cuando está marcada, esta opción indica que esta columna es una de las columnas comprobadas por pdm_userload para determinar si constituye la actualización de una fila existente. Esta opción solo está disponible para columnas CADENA. Se trata de un campo de solo lectura para todas las columnas en tablas estándar.
    • Opciones de índice DBMS
      Estas opciones especifican las características de la columna que constituye el índice del DBMS físico. Solo están disponibles para columnas en tablas definidas por el departamento.
      • Exclusivo
        Indica que la columna es única en la tabla, es decir, que no puede contener dos filas con el mismo valor.
      • Ascendente
        Especifica que esta columna muestra el índice DBMS en orden ascendente. Las opciones Ascendente y Descendente se excluyen mutuamente.
      • Descendente
        Especifica que esta columna muestra el índice DBMS en orden descendente. Esta opción se excluye mutuamente con Ascendente.
    El diseñador de esquemas incluye una ficha Opciones avanzadas. La información contenida en esta ficha está destinada al personal de soporte y de campo de CA Technologies. No tendrá necesidad de recurrir a esta ficha para la mayor parte de usos del creador de esquemas, por lo que no se tratará con más detalle en este documento.
    La ficha Opciones avanzadas del cuadro de diálogo en la columna Diseñador de esquemas muestra información relevante únicamente para personas con conocimientos internos de CA SDM. Su contenido variará según el tipo de columna. Los valores de esta ficha solo deberían modificarse bajo la dirección de un empleado de CA. Si hay una tabla seleccionada, contiene los campos siguientes:
    • Desencadenantes activos
      Muestra los desencadenantes activos actualmente en el motor de objetos correspondiente a la columna. Los desencadenantes son programas pequeños que se ejecutan bajo la dirección del motor de objetos en momentos determinados durante la edición de columnas. La lista de desencadenantes activos incluye tanto desencadenantes estándar como definidos por el departamento (de modo que estos últimos aparecen enumerados en ambas listas de desencadenantes activos y de desencadenantes definidos por el departamento).
    • Desencadenantes definidos por el departamento
      Muestra los desencadenantes instalados en el departamento. Por ejemplo, puede tratarse de los desencadenantes activados como resultado de la instalación de la opción de CA SDM o de los que el servicio técnico de CA ha escrito para su departamento. La lista de desencadenantes activos incluye tanto desencadenantes estándar como definidos por el departamento (de modo que estos últimos aparecen enumerados en ambas listas de desencadenantes activos y de desencadenantes definidos por el departamento).
    • Especificación LRel
      Especifica una relación de muchos a muchos entre dos tablas, con el formato siguiente:
      tabla1 columna1 <> tabla2 columna2
      Aquí se indica que la LREL es una relación de muchos a muchos entre la tabla1 y la tabla2, donde la columna virtual columna1 contiene la relación en la tabla1 y la columna virtual columna2 contiene la relación en la tabla2.
    • Información de consulta xRel activa
      Muestra la especificación activa de la consulta que define una columna virtual BREL o QREL. Esta especificación tiene el formato majic del motor de objetos.
    • Información de consulta xRel definida por el departamento
      Permite modificar la consulta asociada con columnas BREL o QREL. Se recomienda modificar este campo sólo bajo la dirección de un empleado de CA.
    • Expresión derivada activa
      Muestra la especificación activa de la expresión que el motor de objetos utiliza para construir el valor de una columna virtual DERIVADA.
    • Información de consulta xRel definida por el departamento
      Permite modificar la expresión asociada con cualquier columna DERIVADA. Se recomienda modificar este campo sólo bajo la dirección de un empleado de CA.
    La ficha Domsets del cuadro de diálogo Tabla del creador de esquemas contiene lo siguiente:
    • MLIST_DYNAMIC
      Un domset dinámico sin cláusula WHERE.
    • MLIST_STATIC
      Un domset estático sin cláusula WHERE.
    • RLIST_DYNAMIC
      Un domset dinámico con una cláusula WHERE definida en la sección STANDARD_LISTS de la instrucción FACTORY.
    • RLIST_STATIC
      Un domset estático con una cláusula WHERE definida en la sección STANDARD_LISTS de la instrucción FACTORY.
    Si se hace doble clic en uno de los domsets, se abre el cuadro de diálogo Propiedades con los campos siguientes:
    • domset_name
    • fetch_columns
    • max_fetch
    • columnas de clasificación (Este es el único campo editable)
    • volatilidad
    • donde
  5. Lleve a cabo una de las siguientes acciones para guardar la columna:
    • Si se trabaja en el sistema de prueba, seleccione Archivo, Guardar.
    • Si se trabaja en el sistema de producción, seleccione Archivo, Guardar y establecer en modo de prueba.
      Está selección guardará los cambios en la base de datos y se creará un archivo (wsptest.mods) en el servidor para definirlos en el motor de objetos. Este archivo se almacena en el subdirectorio site/mods/majic del directorio de instalación de CA SDM. Tras crear el archivo wsptest.mods, Web Screen Painter forzará el reciclaje del motor de objetos para que utilice los cambios nuevos. Esta operación puede llevar unos segundos o varios minutos, según la complejidad del esquema.
      Se mostrará un mensaje. Haga clic en Sí para continuar. El archivo wsptest.mods solo afecta al motor de objetos designado por la opción wsp_domsrvr. El resto de motores de objetos del servidor no procesan este archivo, el cual tampoco se distribuye a otros servidores. Además, las tablas y columnas nuevas en el modo de prueba se definen en el motor de objetos a modo de objetos locales. Esto significa que el motor de objetos las detecta y es posible utilizarlas en los formularios Web. No obstante, no existen en la base de datos y no afectan a otros usuarios. Los usuarios normales de CA SDM no utilizan el motor de objetos de WSP, por lo que no se ven afectados por las modificaciones del esquema que se están probando.
    La columna se agregará a la tabla.
  6. Para acceder a los atributos agregados a través de la API de REST, ejecute el siguiente comando:
    • pdm_rest_util -newdeploy
      o
    • pdm_rest_util -undeploy
      y después
      pdm_rest_util -deploy
  7. Reinicie los servicios de CA SDM.
Modificación de columnas o tablas
Para modificar la información acerca de tablas o columnas, haga clic en una de ellas en el creador de esquemas e introduzca la información nueva en los campos adecuados. La información que se puede modificar depende del estado de la tabla o la columna:
  • Tablas estándar
    Se pueden modificar los campos Nombre para mostrar, Descripción y Grupo de funciones.
  • Columnas estándar
    Se pueden modificar los campos Nombre para mostrar y Descripción, así como los valores Valor predeterminado al crear y Valor configurado al guardar. Además, si las casillas Obligatorio o Actualizable solo para registro nuevo no están marcadas, es posible marcarlas. No se pueden eliminar estas opciones si se han establecido de forma predeterminada. Sin embargo, es posible deshacer los cambios realizados.
  • Tablas definidas por el departamento
    Si la tabla no se ha publicado, se pueden modificar todos los campos excepto el campo Nombre, que no se puede cambiar después de guardar la tabla nueva. Una vez publicada una tabla definida por el sitio, solo se pueden modificar los campos Visualizar nombre, Descripción y Grupo de funciones.
  • Columnas definidas por el departamento
    Si la columna se ha publicado, se pueden modificar todos los campos excepto el campo Nombre, que no se puede cambiar después de guardar la columna nueva. Una vez publicada una columna definida por el sitio, solo se pueden modificar los campos Visualizar nombre y Descripción, los valores correspondientes a Valor predeterminado al crear y Valor configurado al guardar, las casillas Obligatorio, Actualizable solo para registro nuevo y Clave para pdm_userload, y las opciones de índice DBMS.
Comprobación de las modificaciones de esquema
Puede poner a prueba las modificaciones realizadas en los esquemas y crear, actualizar y ver formularios Web haciendo uso de los mismos antes de implementar dichos cambios en la base de datos física. La aplicación de cambios en el modo de prueba define las modificaciones en el motor de objetos sin almacenar la información físicamente en la base de datos. El uso del modo de prueba en este caso podría influir en operaciones que otros usuarios lleven a cabo, por lo que solo estará disponible si su instalación incluye las opciones wsp_domsrvr y wsp_webengine, que sirven para dedicar un motor de objetos a Web Screen Painter.
Si desea aplicar los cambios en modo de prueba, seleccione Guardar y establecer en modo de prueba en el menú Archivo. Las modificaciones se guardarán en la base de datos y se creará un archivo en el servidor (en el que se ha iniciado la sesión) para definir los cambios en el motor de objetos. Este archivo se llama wsptest.mods y se encuentra en el subdirectorio site/mods/majic del directorio de instalación de CA SDM.
Tras crear el archivo wsptest.mods, Web Screen Painter forzará el reciclaje del motor de objetos para que utilice los cambios nuevos. Esta operación puede llevar unos segundos o varios minutos, según la complejidad del esquema.
Una vez completado el reciclaje del motor de objetos, las modificaciones realizadas en el esquema estarán disponibles y podrá utilizarlas y probarlas en formularios Web creados con Web Screen Painter. La información de las tablas y columnas en modo de prueba solo se conservará en almacenamiento interno en el motor de objetos de Web Screen Painter. Otros usuarios del sistema no podrán verla ni se verán afectados por ella en modo alguno.
Publicación de las modificaciones de esquema
Cuando esté satisfecho con las modificaciones realizadas en el esquema, podrá publicarlas para ponerlas a disposición del resto de los usuarios. WSP almacena las tablas y las columnas nuevas o actualizadas en las tablas wsptbl y wspcol de la base de datos, respectivamente.
Siga los pasos siguientes:
  1. Cree o actualice los archivos que describen el esquema modificado para el motor de objetos y para los programas de utilidades de CA SDM. WSP crea los siguientes archivos en el motor Web designado por la opción wsp_webengine (cuyo valor predeterminado es web:local):
    • wsp.mods
      Describe todos los cambios del esquema gestionado por Web Screen Painter para el motor de objetos.
    • wsp_schema.sch
      Describe todas las tablas y columnas gestionadas por Web Screen Painter.
    • wsp_index.sch
      Describe los índices la DBMS para las tablas gestionadas por Web Screen Painter.
    • wsp.altercol
      Recopila los nombres de las columnas nuevas creadas por Web Screen Painter que aún no se han definido en el DBMS.
    • wsp.altertbl
      Recopila los nombres de las tablas nuevas creadas por Web Screen Painter que aún no se han definido en el DBMS. Asimismo, Web Screen Painter distribuye el archivo wsp.mods a todos los servidores de CA SDM que disponen de un motor de objetos.
  2. Seleccione Archivo, Guardar y Publicar.
    Se crean los archivos necesarios en los servidores de CA SDM, sin reciclar ninguno de ellos. Así, los archivos nuevos no tendrán un impacto inmediato en otros usuarios. Sin embargo, los archivos creados empezarán a utilizarse la próxima vez que se reciclen los servicios de CA SDM.
  3. Si se está utilizando la
    configuración convencional
    , complete los pasos siguientes:
    • Cierre los servicios de CA SDM en el servidor principal y ejecute el comando siguiente:
      pdm_publish
      Este comando modifica la DBMS física para que incluya la información sobre el nuevo esquema.
      El proceso pdm_publish en ejecución tiene un impacto significativo en otros usuarios. Asegúrese de planificar cuidadosamente la publicación de los cambios del esquema. Se recomienda el uso de órdenes de cambios de CA SDM para planificar la publicación planificada del esquema y obtener su aprobación.
  4. Si está utilizando la
    configuración de disponibilidad avanzada
    , complete los pasos siguientes:
    1. Ejecute el siguiente comando en el servidor de fondo para notificar a todos los usuarios activos que utilicen la automatización de soporte que guarden su trabajo:
      sa_server_notifier [-h] | [-q seconds] | [-c]
      • -h
        Muestra la página de ayuda.
      • -q segundos
        Esta opción indica a un servidor local (de fondo) que utilice el modo de inactividad en un período especificado. Este intervalo corresponde al número de segundos previos a la desconexión del servidor. No se puede utilizar esta opción para un servidor en espera o de aplicaciones.
      • -c
        Esta opción cancela una solicitud de modo de inactividad que se ha enviado previamente.
      Se mostrará un mensaje emergente a todos los usuarios activos mediante la automatización de soporte en el servidor de fondo. Este mensaje notifica a los usuarios el cierre del servidor y el tiempo restante planificado para que este se produzca. Los usuarios deben guardar su trabajo y cerrar sesión dentro del plazo planificado.
    2. Cierre los servicios de CA SDM en el servidor de fondo.
      No reinicie los servicios de CA SDM del servidor en espera o de aplicaciones después guardar y publicar en WSP. Esta acción corrompe la configuración de disponibilidad avanzada. Si se detienen los servicios de CA SDM en el servidor en espera o de aplicaciones y desea iniciar dichos servicios, ejecute el comando pdm_server_control –v en los servidores para suprimir el control de versiones antes de iniciar los servicios de CA SDM.
      Si el servidor de fondo produce un error durante la actividad de publicación, asegúrese de recuperar los cambios de WSP. Para obtener más información, consulte el tema Recuperación de cambios de Web Screen Painter durante un fallo en el servidor de fondo.
    3. Ejecute el siguiente comando en el servidor en espera que desea promover como el nuevo servidor de fondo:
      pdm_server_control -b
      • -b
        Indica a un servidor en espera local que se convierta en el servidor de fondo. El servidor en espera debe estar en ejecución. De lo contrario, se inicia, pero no se producirá ninguna conmutación por error. Para iniciar una conmutación por error, se debe ejecutar el comando de nuevo.
      El servidor de fondo se cierra automáticamente y el servidor en espera se promueve como el nuevo servidor de fondo. Este cambio no afecta a las sesiones del usuario final. Las actualizaciones en curso (si las hubiera) se almacenan y retrasan hasta que vuelva a conectarse el nuevo servidor de fondo.
    4. Ejecute el siguiente comando en el servidor de fondo original (ahora, el servidor en espera) para actualizar la DBMS con los cambios del esquema:
      pdm_publish
      El comando pdm_publish crea un archivo de control que provoca que tras el inicio de CA SDM se detenga la sincronización del servidor en espera con el servidor de fondo. Esta acción es necesaria para mantener los cambios del archivo del esquema que realizó pdm_publish. Este comando realiza opcionalmente la segunda conmutación por error tras la publicación correcta de los cambios del esquema. El siguiente mensaje se muestra al usuario al final de la publicación correcta:
      Do you want pdm_publish to start CA Service Desk Manager in this standby server and perform fail-over(Y/N)?
      • Si se indica que sí, pdm_publish inicia los servicios de CA SDM en el servidor en espera y realiza la conmutación por error de forma automática. Avance hasta el paso G para aplicar los cambios del esquema en todos los servidores de aplicaciones.
      • Si se indica que no, vaya al paso E.
    5. Inicie los servicios de CA SDM en el servidor en espera (servidor de fondo original).
      El inicio detecta el archivo de control que crea pdm_publish, pero no sincroniza el servidor en espera con el servidor de fondo. Esta falta de sincronización conserva los cambios que realice pdm_publish para este inicio.
      asegúrese de seguir estas instrucciones de manera exacta, ya que si ocurre un fallo en la conmutación por error en el servidor de fondo original después de pdm_publish, se pueden dañar los servicios.
    6. Ejecute el siguiente comando en el servidor en espera (servidor de fondo original) para convertirlo de nuevo en el servidor de fondo:
      pdm_server_control -b
      Este comando también suprime el archivo de control, para que el control de versiones funcione normalmente cuando este servidor se convierta otra vez en un servidor en espera.
    7. Ejecute el siguiente comando en los servidores de aplicaciones:
      pdm_server_control -q interval -s server_name
      • -q interval -s server_name
        Indica a un servidor de aplicaciones local o remoto que utilice el modo de inactividad en un período especificado. Este intervalo corresponde al número de segundos previos a la desconexión del servidor. Al utilizar esta opción sin server_name, se indica al servidor local que utilice el modo inactivo. No se puede utilizar esta opción para un servidor de fondo o en espera.
      Se muestra un mensaje emergente a todos los usuarios activos del servidor de aplicaciones especificado. Este mensaje notifica a los usuarios el cierre del servidor y el tiempo restante planificado para que este se produzca. Los usuarios deben guardar su trabajo y cerrar sesión dentro del plazo planificado. Los usuarios se conectan al servidor de aplicaciones actualizado para reanudar su trabajo.
    8. Reinicie todos los servidores en espera.
Recuperación de cambios de Web Screen Painter durante un fallo en el servidor de fondo
Se pueden recuperar los cambios de esquema de MDB cuando el servidor de fondo produce un fallo durante la actividad de publicación.
Se recomienda no realizar los pasos de recuperación directamente en el entorno de producción. Asegúrese de que primero se validan en el entorno de desarrollo o de prueba.
Siga los pasos siguientes:
  • Si el servidor de fondo se bloquea antes de su publicación, los últimos cambios del esquema guardados se conservan en MDB. Se conecta al nuevo servidor de fondo y se reanudan sus tareas de publicación.
  • Si el servidor de fondo se bloquea después de la publicación, realice estas acciones:
    1. Detenga los servicios de CA SDM en el servidor de fondo bloqueado.
    2. Seleccione un servidor en espera que desee promover como el nuevo servidor de fondo.
    3. Copie los siguientes archivos del servidor de fondo bloqueado en la misma ubicación en el servidor en espera:
      • "$NX_ROOT$/site/mods/majic/wsp.mods"
      • "$NX_ROOT$/site/mods/wsp.altertbl"
      • "$NX_ROOT$/site/mods/wsp.altercol"
      • "$NX_ROOT$/site/mods/wsp_index.sch"
      • "$NX_ROOT$/site/mods/wsp_schema.sch
    4. Ejecute el siguiente comando en el servidor en espera para publicar los cambios del esquema y realizar la conmutación por error automática:
      pdm_publish
    5. Indique que sí en el mensaje que aparece tras la publicación correcta de los cambios del esquema.
      Los servicios de CA SDM se inician en el servidor en espera.
      Si la conmutación por error automática no se produce, ejecute el comando pdm_server_control -b del servidor en espera para promoverlo como el nuevo servidor en segundo plano.
    6. Active el modo de inactividad y recicle todos los servidores de aplicaciones. Reinicie todos los servidores en espera. Para obtener más información, consulte el tema Publicación de las modificaciones de esquema.
Anulación de las modificaciones de esquema
Si cambia de idea acerca de las modificaciones de esquema después de colocarlas en el modo de prueba, puede recuperar la versión publicada del esquema. La anulación de modificaciones del esquema puede afectar a otros usuarios. Por ello, esta opción solamente está disponible si la instalación incluye las opciones wsp_domsrvr y wsp_webengine para dedicar un motor de objetos y un motor web en WSP.
Siga los pasos siguientes:
Seleccione Archivo, Anular modo de prueba.
WSP elimina el archivo wsptest.mods, lo que provoca que el motor de objetos de WSP vuelva a utilizar la versión publicada del esquema.
Tras suprimir el archivo wsptest.mods, WSP hace que el motor de objetos se recicle para que vuelva a generar el esquema interno. Esta operación puede llevar unos segundos o varios minutos, según la complejidad del esquema.
Una vez que se ha reciclado el motor de objetos, el esquema activo vuelve a ser el correspondiente a la versión publicada.
Los cambios realizados en los formularios web modificados para trabajar con el esquema nuevo no se revertirán de forma automática, por lo que es posible que no funcionen correctamente con el esquema publicado.
Modificación de las columnas definidas por el sitio después de la publicación
Una vez publicadas las modificaciones de esquema definidas por el sitio, WSP las trata como si fueran el esquema estándar y restringe la realización de más cambios. Se puede suprimir una columna definida por el sitio o cambiar la longitud de una columna de cadenas definida por el sitio actualizando manualmente la DBMS y el esquema externo a WSP. A continuación se debe ejecutar el script pdm_wspupd para actualizar la tabla wspcol de la base de datos para sincronizar WSP con los cambios externos.
Siga los pasos siguientes:
  1. Inicie sesión en el siguiente servidor, en función de la configuración de CA SDM:
    • Convencional: Servidor principal
    • Disponibilidad avanzada: Servidor en segundo plano
  2. Busque el subdirectorio site/mods en el directorio de instalación de CA SDM.
    Cree una copia de seguridad del archivo wsp_schema.sch en una ubicación distinta del subdirectorio site/mods para evitar el procesamiento de los archivos duplicados.
  3. Edite el archivo wsp_schema.sch para suprimir las columnas definidas por el sitio no deseadas o cambiar la longitud de las columnas STRING definidas por el sitio. Estas actualizaciones son los únicos cambios que se pueden realizar mediante este procedimiento. Se puede utilizar cualquier editor de texto estándar para editar el archivo wsp_schema.sch.
    Si se hubiera especificado alguna de las opciones de índice (como, UNIQUE) para suprimir una columna, edite el archivo wsp_index.sch y elimine las referencias a la columna. Si la columna fuera la única columna indizada de la tabla, quite todas las referencias a la tabla de wsp_index.sch.
  4. Edite archivo majic/wsp.mods con las mismas modificaciones de wsp_schema.sch:
    • Suprima las columnas no deseadas definidas por el sitio.
    • Cambie la longitud de las columnas STRING definidas por el sitio.
  5. Introduzca el comando siguiente en el símbolo del sistema:
    pdm_wspupd
    La secuencia de comandos pdm_wspupd lee el archivo wsp_schema.sch y lo compara con la tabla wspcol de la base de datos, tras lo cual escribe una línea en la consola por cada diferencia detectada. Por ejemplo, consulte el siguiente resultado:
    PDM_WSPUPD - Update wspcol table from wsp_schema.sch Reading wsp_schema.sch to for current DBMS information... Reading wspcol table for WSP schema information... String column zSalesOrg.description length changed from 350 to 400 Column zSalesOrg.sym not found in wsp_schema.sch - deleting wspcol row pdm_wspupd found 1 WSP-maintained column(s) to update and 1 to delete. Please verify that your DBMS has been manually updated to correspond to wsp_schema.sch, then reply Y to update wspcol or anything else to cancel.
  6. Compruebe que los cambios detectados por pdm_wspupd correspondan exactamente a los cambios realizados en wsp_schema.sch.. Si coinciden, escriba
    Y
    para confirmar los cambios.
    Después de confirmar la actualización, el script recurre a las utilidades estándar de CA SDM para actualizar la tabla wspcol. A continuación, el creador de esquemas mostrará los cambios.
  7. Detenga los servidores de CA SDM.
  8. Mediante la utilidad apropiada para el DBMS, altere la definición DBMS de las columnas modificadas:
    • Suprima cualquier columna de la base de datos eliminada de wsp_schema.sch.
    • Cambie la longitud de base de datos de cualquier columna de cadenas modificada en wsp_schema.sch.
    Observe que los cambios realizados en el DBMS correspondan exactamente a los cambios realizados en wsp_schema.sch.
  9. Publique las modificaciones del esquema.
  10. Inicie los servidores de CA SDM.