Utilización de la documentación de mensajes de validación

A fin de determinar qué validaciones se identifican como validaciones configurables que se pueden inhabilitar, las organizaciones pueden consultar la documentación de mensajes de validación que se proporciona en formato HTML como parte de los instaladores de desarrollo. Tras ejecutar el instalador de desarrollo, dicha documentación puede encontrarse en la carpeta ?Doc' de nivel superior de la base de código instalada. A la página de inicio de la documentación de mensajes de validación se accede seleccionando el archivo index.html situado en la carpeta ValidationMessages/html.

Puede visualizarse una lista de validaciones referenciadas por cada método de clase de fachada seleccionando el enlace “Índice A-Z de fachadas” en la página de inicio de la documentación, seleccionando un nombre de clase de fachada y, a continuación, seleccionando un método.

También puede visualizarse una lista de validaciones referenciadas por cada método de pantalla seleccionando el enlace “Índice A-Z de fachadas” en la página de inicio de la documentación, seleccionando un nombre de pantalla y, a continuación, seleccionando un método.

Para cada validación se proporciona la referencia de validación y el texto del mensaje de validación. Por ejemplo, para la validación utilizada para impedir que la fecha de inicio de un rol de participante en un caso sea posterior a la fecha de finalización de un caso, se visualiza la referencia de validación BPOCASEPARTICIPANTROLE.ERR_CASEPARTICIPANTROLE_XFV_FROM_DATE_CASEHEADER_END_DATE y el texto de mensaje de validación “La fecha de inicio del rol de participante en un caso no debe ser posterior a la fecha de finalización del caso - "%1d"”.

Para cada validación, la documentación también muestra si es configurable o no. Se han comprobado todas las validaciones configurables para que no afecten al proceso del sistema si no se ejecutan y una agencia las pueda inhabilitar. Si no se indica que una validación es configurable, la organización no puede inhabilitar la validación dentro de la aplicación de administración del sistema y debe generar un caso de soporte si se requiere que se pueda inhabilitar la validación.

Además, una sección de mensajes configurables lista todas las validaciones identificadas como validaciones configurables, incluidas las fachadas desde las que se hace referencia a las validaciones. Se accede a esta sección seleccionando el enlace “Índice A-Z de mensajes configurables” en la página de inicio de la documentación. La organización puede utilizar esta lista para determinar la referencia de validación exclusiva que se necesita para buscar e inhabilitar la validación como parte de la administración del sistema.

Por ejemplo, si la organización desea identificar las validaciones que existen y son configurables como parte del proceso de modificación del miembro de un caso, puede seleccionar la opción “Índice A-Z de pantallas” en la página de inicio de la documentación, especificar “modifyCaseMember” para filtrar la lista de pantallas, seleccionar la pantalla “Case_modifyCaseMemberFromList.uim”, seleccionar la referencia de fachada “Case.modifyCaseMember” y, a continuación, visualizar una lista de validaciones, incluyendo si cada validación es configurable o no.

Si la organización encuentra que la validación BPOCASEPARTICIPANTROLE.ERR_CASEPARTICIPANTROLE_XFV_FROM_DATE_CASEHEADER_FROM_DATE es configurable, puede realizar una referencia cruzada de la validación con la lista de validaciones configurables para identificar el ID de referencia exclusivo de la validación. Esto se lleva a cabo mediante los filtros Referencia de fachadas y Referencia de mensajes. Si se especifica el nombre de método “modifyCaseMember” en el filtro Referencia de fachadas y se especifica la referencia de validación BPOCASEPARTICIPANTROLE.ERR_CASEPARTICIPANTROLE_XFV_FROM_DATE_CASEHEADER_FROM_DATE en el filtro Referencia de mensajes, se visualiza una referencia exclusiva de validación bpocaseparticipantrole.err_caseparticipantrole_xfv_from_date_caseheader_from_date|a| para la validación.

Si se visualiza más de una referencia exclusiva de validación para una combinación específica de Referencia de fachada y Referencia de mensaje, la organización puede determinar la referencia exclusiva de validación a inhabilitar habilitando la visualización de la referencia exclusiva de validación dentro de la aplicación junto con el texto de mensaje de validación que se visualiza cuando se ejecuta el proceso de negocio que hará que se llame a la validación. En la mayoría de casos, esto hará que se visualice solo una referencia de validación, que es la que se debe inhabilitar. En el caso improbable de que se visualice más de una referencia de validación cuando se ejecuta el proceso de negocio, significa que la misma validación se realiza dos veces durante el mismo proceso de negocio y que deben inhabilitarse ambas.

Tenga en cuenta que todas las entradas de catálogo de mensajes a las que se hace referencia mediante un método se visualizan para cada método en la documentación de mensajes de validación; por tanto, es posible que también se visualicen otros tipos de mensaje, como los mensajes de infraestructura y los mensajes utilizados para registro, junto con los mensajes de validación. Además, para cada método la documentación también visualiza todos los mensajes a los que hace referencia cualquier método llamado por el método, y así, en algunos casos, se listan mensajes que no necesariamente han sido llamados por la pantalla que utiliza el método.

La sección siguiente proporciona más detalles sobre cómo habilitar la visualización del ID de referencia exclusivo de validación dentro de la aplicación.