Modificación de la lista de estados de la solicitud

Este artículo contiene los siguientes temas:
casm173
Este artículo contiene los siguientes temas:
Cada servicio y opción de servicio de la solicitud tienen un estado. Además, la solicitud tiene un estado global. CA Service Catalog ofrece una amplia lista de valores de estado de forma predeterminada. Se pueden modificar los valores de estado para las fases de aprobación y cumplimiento del ciclo de vida de la solicitud mediante la edición del archivo requestshared.xml. También se puede cambiar la ortografía de los valores de estado existentes.
Se mantienen los valores de estado de la solicitud en el archivo requestshared.xml. Este archivo puede diferir conforme al idioma que se selecciona para el sistema. El archivo se encuentra en una carpeta diferente para cada idioma. Por ejemplo, para inglés (icusen), el archivo requestshared.xml XXXX se ubica en la carpeta USM_HOME\view\webapps\usm\locale\icusen\request.
El estado de solicitud de
toda
la solicitud es visible en la página Acciones pendientes. Los estados de solicitud de los elementos individuales de la solicitud están visibles en la lista desplegable Estado del elemento de las páginas de interfaz de usuario relacionadas con la solicitud: Detalles de la solicitud, Aprobar solicitud, Solicitud de cumplimiento y Forzar solicitud. Las actualizaciones que se realicen en los valores de estado de solicitud del archivo requestshared.xml se reflejan en las opciones que los usuarios observan en las páginas.
Siga los pasos siguientes:
  1. Realice una copia de seguridad del archivo original requestshared.xml y guárdelo como referencia.
  2. (Opcional) Modifique los valores del estado existente o agregue estados de solicitud adicionales.
  3. (Opcional) Restrinja los cambios de estado disponibles para un elemento de solicitud en función de su estado.
    De forma predeterminada, siempre están disponibles todas las opciones (todos los estados) para un elemento, hasta que se haya completado toda la solicitud. En otras palabras, se puede cambiar el estado de elementos de solicitud en cualquier valor en cualquier momento. Sin embargo, su organización, opcionalmente, puede restringir las opciones de menú disponibles para un elemento de solicitud en función del estado.
  4. Compruebe que los cambios realizados aparecen correctamente reflejados en las pantallas de la interfaz de usuario relacionada con la solicitud.
    En la lista desplegable Estado del elemento en las páginas de la interfaz de usuario relacionada con la solicitud, el estado se indica mediante un asterisco (*).
Cuando hayan agregado y utilizado los valores numéricos de estado a la lista predeterminada, estos
no
podrán eliminarse.
Revisión del archivo requestshared.xml
Familiarícese con el archivo requestshared.xml, de la manera siguiente:
  • Entienda el propósito de las secciones principales del archivo: request_header, request_item, request_item_approval_action y request_item_fulfillment_action.
  • Tenga en cuenta que los valores de estado de estas secciones deben permanecer sincronizados.
  • Tenga en cuenta que el orden de los estados en las listas desplegables de estado de la GUI coincide con el orden de los estados en el archivo requestshared.xml. Por ejemplo, supongamos que se define el estado 800 (Rechazado) sobre el estado de 600 (Aprobado) en este archivo. En este caso, el estado Rechazado aparece por encima del estado Aprobado en las listas desplegables de estado de la GUI.
  • Revise los comentarios en línea y tenga en cuenta los valores de estado
    de reserva
    .
  • Revise los intervalos de los valores de estado personalizados para ver qué intervalos están reservados para los tipos específicos de los valores de estado.
No
modifique ni suprima las líneas de apertura ni de cierre que definen los estados predeterminados en el archivo requestshared.xml. Incluso al modificar los estados, estas líneas deben permanecer tal y como se muestran. Este requisito es aplicable tanto a la sección <request_item_approval> como a <request_item_fulfillment>. Estas líneas ayudan a garantizar el comportamiento del estado correspondiente cuando las personalizaciones no se utilizan o se definen incorrectamente.
- <custom_menu current_status_value="default"> status lines </custom_menu>
Secciones principales
Las secciones principales del archivo requestshared.xml son las siguientes:
  • request_header
    Mantiene todos los valores de estado posibles para toda la solicitud.
  • request_item
    Mantiene todos los valores de estado posibles de un elemento específico (por ejemplo, un elemento de opciones de servicio o un grupo de opciones de servicio) en una solicitud.
  • request_item_approval_action
    Mantiene todos los valores de estado posibles de un elemento específico en una solicitud cuando la solicitud se ha enviado pero no se ha aprobado ni rechazado.
  • request_item_fulfillment_action
    Mantiene todos los valores de estado posibles de un elemento específico en una solicitud, cuando la solicitud se ha aprobado pero todavía no se ha procesado.
La lista de posibles valores de estado debe estar sincronizada en las secciones request_header y request_item: deben tener los mismos valores con el mismo significado.
Todos los valores de las secciones request_item_approval_action y request_item_fulfillment_action deben tener un valor coincidente en las secciones request_header y request_item. El valor en las secciones request_item_approval_action y request_item_fulfillment_action debe ser un conjunto completo o un subconjunto de los valores en las secciones request_header y request_item.
Intervalos para los valores de estado personalizados
Al agregar un nuevo estado de solicitud en el archivo requestshared.xml, defínalo dentro del intervalo que se ha especificado para los estados personalizados:
  • 300 a 399: personalizar estado
    Enviar
  • 500 a 599: personalizar estado
    Aprobación pendiente
  • 900 a 990: personalizar estado
    Aprobado
Adición de un estado de solicitud adicional
Se puede modificar la lista de estados de la solicitud mediante la adición de estados de solicitud. Una finalidad común es la aprobación o rechazo de una solicitud por un departamento específico. Por ejemplo, el Departamento de Finanzas.
Siga los pasos siguientes:
  1. Edite el archivo requestshared.xml para el idioma del sistema en un editor de texto. Por ejemplo, para inglés, edite el archivo que se ubica en la carpeta USM_HOME\view\webapps\usm\locale\icusen\request.
  2. Agregue una línea, incluyendo el número y el texto para el nuevo estado en las siguientes secciones: <request_header> y <request_item>.
  3. Seleccione un valor de estado numérico en el intervalo adecuado para los valores de estado personalizados del estado que se agregará.
    Si es posible, limite el texto del valor de estado a 40 caracteres. El texto que contenga más de 40 caracteres se podrá truncar en las listas del menú desplegable de estado y en los campos del estado de solicitud. En tales casos, la cadena de texto completo se muestra a los usuarios del catálogo
    solo
    en el texto de información sobre herramientas.
  4. Copie esta línea en la sección o secciones personalizadas o dónde desee que aparezcan. Entre los ejemplos se incluye , ,
    y .
  5. Elimine el texto de la línea que se ha copiado y modifique la línea para incluir la expresión del
    valor
    statval=".
  6. Guarde el archivo requestshared.xml.
  7. Verifique que los cambios se reflejan correctamente en las pantallas de interfaz de usuario relacionada con la solicitud (las pantallas Detalles de la solicitud, Aprobar solicitud y Solicitud de cumplimiento).
Ejemplo: Cómo agregar nuevos estados de aprobación
Para agregar los estados de aprobación 500, 700 y 900, todos ellos relacionados con la aprobación financiera, agregue las nuevas líneas de estos estados en las secciones request_header, request_item y request_item_approval_action del archivo requestshared.xml. A continuación aparecen más ejemplos en
negrita
.
Especifique el valor numérico y el texto en las secciones request_header y request_item. Especifique solo el valor numérico (sin el texto) en la sección request_item_approval_action.
<?xml version="1.0" encoding="UTF-8" ?> ... - <request_header> <!-- status values must be synchronized with the status list in request_item, request_item_approval_action and/or request_item_fulfillment_action --> <st_1>Pending</st_1> <st_2>Completed</st_2> ... <!-- 400 to 499 are reserved --> <st_400>Pending Approval</st_400> <!-- 500 to 599 can be used for custom pending approval status --> <st_500>Pending Financial Approval</st_500> <!-- 600 to 699 are reserved --> <st_600>Rejected</st_600> <!-- 700 to 799 can be used for custom rejected status --> <st_700>Rejected by Financial Approver</st_700> <!-- 800 to 899 are reserved --> <st_800>Approved</st_800> <st_801>Approval Not Needed</st_801> <!-- 900 to 990 can be used for custom approved status --> <st_900>Approved by Financial Approver</st_900> !-- 991 to 999 are reserved --> <st_999>Approval Done</st_999> ... </request_header> - <request_item> <!-- status values must be synchronized with the status list in request_header, request_item_approval_action and/or request_item_fulfillment_action --> <st_1>Pending</st_1> <st_2>Completed</st_2> ... <!-- 400 to 499 are reserved --> <st_400>Pending Approval</st_400> <!-- 500 to 599 can be used for custom pending approval status --> <st_500>Pending Financial Approval</st_500> <!-- 600 to 699 are reserved --> <st_600>Rejected</st_600> <!-- 700 to 799 can be used for custom rejected status --> <st_700>Rejected by Financial Approver</st_700> <!-- 800 to 899 are reserved --> <st_800>Approved</st_800> <st_801>Approval Not Needed</st_801> <!-- 900 to 990 can be used for custom approved status --> <st_900>Approved by Financial Approver</st_900> <!-- 991 to 999 are reserved --> <st_999>Approval Done</st_999> ... </request_item> - <request_item_approval_action> <!-- status values must be synchronized with the status list in request_header and request_item --> <!-- A "default" value for the attribute "current_status_value" indicates these statuses will be listed by default in the "item status" menu if no other custom statuses are defined --> <custom_menu current_status_value="default"> <!-- 400 to 499 are reserved --> <!-- 500 to 599 can be used for custom pending approval status --> <st_500 statval="500"/> <!-- 600 to 699 are reserved --> <!-- 700 to 799 can be used for custom rejected status --> <st_700 statval="700"/> <!-- 800 to 899 are reserved --> <st_800 statval="800">Approve</st_800> <!-- 900 to 999 can be used for custom approved status --> <st_900 statval="900"/> ...
Cómo ocultar estados de solicitud
La lista predeterminada de estados de solicitud puede incluir más opciones de las necesarias para ciertas categorías. Se pueden ocultar algunos de los valores de la categoría. Por lo tanto, los usuarios no podrán ver estas opciones en la interfaz de usuario cuando se tratan las solicitudes con acción pendiente.
Siga los pasos siguientes:
  1. Edite el archivo requestshared.xml para el idioma de su sistema mediante un editor de texto. Por ejemplo, para inglés, edite el archivo que se ubica en la carpeta USM_HOME\view\webapps\usm\locale\icusen\request.
  2. Edite la línea en las secciones <request_header> y <request_item> para los estados que desee ocultar. Escriba los caracteres de comentario antes y después de la expresión original.
  3. Oculte las líneas correspondientes de todas las demás secciones que lo utilizan, por ejemplo, la sección <request_item_approval> o <request_item_fulfillment>.
    Oculte las mismas líneas que son iguales en todas las secciones pertinentes del archivo. Esto es necesario para que el estado aparezca correctamente en la interfaz de usuario.
  4. Guarde el archivo requestshared.xml.
  5. Compruebe que los cambios realizados aparecen correctamente reflejados en las páginas siguientes relacionadas con la solicitud: Detalles de la solicitud, Aprobar solicitud y Solicitud de cumplimiento.
Ejemplo: Ocultar estados de solicitud
Para ocultar ciertos estados relacionados con el cumplimiento predeterminado, introduzca los caracteres de comentario antes y después de la expresión original. Ejemplo en
negrita
. Introduzca los caracteres de comentarios en las secciones request_header, request_item y request_item_fulfillment_action del archivo requestshared.xml.
En este ejemplo,
antes
de agregar los marcadores de comentario, los siguientes estados estarán visibles en las siguientes páginas relacionadas con la solicitud: Solicitado, Enviado, Recibido, Orden cancelada, En almacenamiento intermedio y Configurado.
Después
de agregar los marcadores de comentario, los siguientes estados estarán visibles en las páginas: Solicitado, Enviado y Configurado.
- <request_header> ... <st_1004>Ordered</st_1004> <st_1006>Shipped</st_1006> <!--<st_1007>Received</st_1007>--> <!--<st_1008>Order Cancelled</st_1008>--> <!--<st_1017>Staged</st_1017>--> <st_1019>Configured</st_1019> ... </request_header> - <request_item> ... <st_1004>Ordered</st_1004> <st_1006>Shipped</st_1006> <!--<st_1007>Received</st_1007>--> <!--<st_1008>Order Cancelled</st_1008>--> <!--<st_1017>Staged</st_1017>--> <st_1019>Configured</st_1019> ... </request_item> - <request_item_fulfillment_action> ... <custom_menu current_status_value="default"> ... <st_1004 statval="1004"/> <st_1006 statval="1006"/> <!--<st_1007 statval="1007"/>--> <!--<st_1008 statval="1008"/>--> <!--<st_1017 statval="1017"/>--> <st_1019 statval="1019"/> ... </shared>
Limitación de los cambios de estado disponibles para un elemento de solicitud
Se pueden limitar los cambios de estado disponibles para un elemento de solicitud en función de su estado actual. Por ejemplo, supongamos que cuando un elemento está aprobado (estado Aprobado), ya no desea que los usuarios puedan realizar ningún cambio en el estado
excepto
si es a un estado relacionado con el cumplimiento. Se puede configurar la lista desplegable Estado del elemento para mostrar
solo
las opciones relacionadas con el cumplimiento de los elementos cuyo estado es aprobado.
Siga los pasos siguientes:
  1. Edite el archivo requestshared.xml para el idioma de su sistema mediante un editor de texto. Por ejemplo, para inglés, edite el archivo que se ubica en la carpeta USM_HOME\view\webapps\usm\locale\icusen\request\requestshared.xml.
  2. Localice la sección del archivo donde desee restringir los cambios disponibles para uno o más valores de estado.
    Se pueden limitar los cambios de estado en cualquier sección
    excepto
    las secciones y .
  3. Decida qué estado desea limitar y los estados que va a permitir que se modifiquen.
    Aparecerá la lista de todos los valores de estado existentes en la siguiente línea:
    - <custom_menu current_status_value="default">
  4. Agregue y permita un estado de la solicitud en la lista, si es necesario. Los estados que desee permitir ya deben existir previamente.
  5. Localice la sección de menú personalizado. De forma predeterminada, esta sección contiene sangría y comentarios. Suprima las líneas de comentario de apertura y cierre de esta sección.
    - <!-- <custom_menu current_status_value="400"> <st_400 statval="400"/> <st_600 statval="600"/> </custom_menu> --> <custom_menu current_status_value="400"> <st_400 statval="400">/> <st_600 statval="600"/> </custom_menu> <custom_menu current_status_value="400"> <st_400 statval="400"/> <st_600 statval="600"/> <st_801 statval="801"/> </custom_menu>
  6. Verifique que el valor en la expresión current_status_value = "
    nnn
    " de la primera línea de esta sección coincida con el valor de estado que desee limitar.
    Por ejemplo, en el paso anterior, 400 corresponde al estado Aprobación pendiente. Por lo tanto, los valores de estado aparecen en las páginas relacionadas con la solicitud cuando el valor de estado es Aprobación pendiente. Si desea limitar un estado diferente, sustituya el valor actual con el nuevo valor.
  7. Verifique que el valor en la expresión current_status_value = "
    nnn
    " se ha definido en una de las líneas "<st_
    nnn
    statval=...", tal como se muestra para su Aprobación pendiente en el ejemplo anterior.
  8. Copie y pegue el estado o estados adicionales para los cuales desee permitir su modificación. Se puede copiar y pegar en la lista de valores de estado que aparece más arriba en la sección.
    Por ejemplo, en la sección <request_item_approval>, copie y pegue la nueva línea "<st_801..." de la sección custom_menu para su aprobación pendiente:
  9. Ahora el estado Aprobación no necesaria se agrega a los estados cuyos elementos del estado Aprobación pendiente pueden modificarse.
  10. Limite los cambios de estado de otro estado de la misma sección en el archivo requestshared.xml, si es necesario. Utilice las siguientes directrices:
    1. Copie el elemento custom_menu completo y los elementos hijo.
    2. Péguela después del elemento que se ha actualizado.
    3. Modifique el elemento recién copiado.
    4. Modifique el elemento custom_menu existente y los elementos hijo, si es necesario. Por ejemplo, en la sección <request_item_fulfillment>, supongamos que desea limitar los elementos en el estado Cumplimiento pendiente para que se cambien a Cumplimiento cancelado o Cumplido. En este caso, modifique el elemento custom_menu existente de la manera siguiente:
    <custom_menu current_status_value="1000"> <st_1000 statval="1000"/> <st_1999 statval="1999"/> <st_2000 statval="2000"/> </custom_menu>
  11. Guarde el archivo requestshared.xml.
  12. Verifique que los cambios se reflejan correctamente en las páginas de interfaz de usuario relacionada con la solicitud (páginas Detalles de la solicitud, Aprobar solicitud y Solicitud de cumplimiento).
Se han restringido los cambios de estado disponibles para un elemento de solicitud en función de su estado actual.