Clase Java de Cita de Muestra

La Interface de Clase Java de Cita a la que se hace referencia en la configuración de características del sistema externo es responsable de la interacción con el motor de mensajes de salida en tiempo real de XAI para comunicarse con el sistema externo para obtener una lógica de cita.

El producto base proporciona una clase java por defecto (llamada com.splwg.wfmi.workforce.DefaultWFMSystem) para integración de citas que se puede usar si proporciona la lógica que la implementación necesita.

Nota:

Oracle Utilities Mobile Workforce Management. Consulte la documentación sobre integración para obtener información acerca de la clase java proporcionada para integración con Oracle Utilities Mobile Workforce Management.

La clase java por defecto proporcionada con el producto base realiza lo siguiente:

  • Extrae información de actividad de campo adicional no proporcionada por el servicio de página de cita
  • Convierte los datos en el servicio de página y la información de actividad de campo en un documento XML
  • Invoca al motor de mensajes salientes en tiempo real.

Las respuestas recibidas desde el motor se encuentran en la forma de un documento XML. La clase de java transforma la información en un formato reconocido por el modelo de datos de página y lo envía nuevamente a la salida de usuario.

Nota:

El CILOAPTP.xml que se encuentra en el directorio xmlMetaInfo describe la estructura base del XML de solicitud de Mostrar Cita, Registrar Cita y Cancelar Cita. La actividad de campo seleccionada para registrarse o cancelarse posee un elemento faExtraInfo adicional. El elemento faExtraInfo sigue la estructura describa por CILOEFIP.xml.

Las siguientes secciones describen con más detalle la lógica proporcionada por la interface de clase java de cita de producto base de muestra.

Obtener Citas Disponibles

Para obtener las citas disponibles, la salida de usuario pasa el tipo de ubicación intermedia de descarga de notificación que hace referencia al indicador de condición Obtener Cita Disponible. Todos los datos disponibles en el servicio de página se pasan al motor como un documento XML que incluye cualquier campo de búsqueda definido por el usuario.

La salida de usuario espera una respuesta a este mensaje para devolver una recopilación de los registros que se desplegarán en la grilla de citas disponibles en la página de cita, incluido cualquier campo de resultados definido por el usuario. Cualquier error recibido se comunica al usuario.

Nota:

Traslación de Mensaje. Cualquier mensaje de error recibido desde el sistema externo se traslada desde un mensaje externo a un mensaje de error de sistema correspondiente usando la información de mensaje en la configuración de características del sistema externo.

Parte Superior de la Página

Registrar Cita

Una vez que el usuario confirmó la cita deseada con el cliente, el usuario intenta registrarla. La clase java de integración de cita genérica proporcionada con el sistema envía un mensaje que registra las citas en tiempo real. La salida de usuario pasa el tipo de ubicación intermedia de descarga de notificación que hace referencia al indicador de condición Registro de Citas.

Nota:

Una actividad de campo a la vez. La salida de usuario de muestra proporcionada por el sistema solo soporta el registro de citas de una actividad de campo a la vez. Como resultado, si desea usar la salida de usuario de muestra, los sistemas externos se deben configurar con la opción Permitir Reservas Múltiples definida en N. Si la organización deseara soportar el registro de citas para múltiples actividades de campo de una vez, puede crear su propia salida de usuario para proporcionar esta capacidad.

La salida de usuario de muestra proporcionada con el producto espera una respuesta positiva o negativa a este mensaje.

  • Si se recibe una respuesta positiva, la salida de usuario espera que se le pase un número de reserva y una indicación de si la cita fue o no forzada. Éste completa la recopilación de características de actividad de campo con estos valores usando Tipo de Característica de Reserva y Tipo de Característica Forzada de Cita definidos como opciones en la configuración de características del sistema externo.
  • Si se recibe una respuesta negativa, se despliega un mensaje de error al usuario.
Nota:

Traslación de Mensaje. Cualquier mensaje de error recibido desde el sistema externo se traslada desde un mensaje externo a un mensaje de error de sistema correspondiente usando la información de mensaje en la configuración de características del sistema externo.

Si el motor de mensajes no se puede comunicar con el sistema externo, éste entrega una indicación a la salida de usuario. La salida de usuario continúa de la siguiente forma:

  • Si el sistema externo indica que Permitir Citas Manuales está definido en falso, se despliega un error al usuario.
  • Si se permiten las citas manuales, la salida de usuario emite una advertencia al usuario que pregunta si el mensaje se debe registrar y enviar cuando se establezca nuevamente la comunicación. Si el usuario acepta, la salida de usuario invoca la clase Java al solicitarle que publique un mensaje casi en tiempo real.
    • La salida de usuario calcula una ID de mensaje de salida única para el sistema externo. La Id de mensaje se calcula usando una secuencia de base de datos cuyo nombre se hace referencia en la opción Nombre de Secuencia de Base de Datos de ID de Mensaje en la configuración de características del sistema externo. Esta Id de mensaje se pasa al motor de mensajes en tiempo real para completarse como un ingreso de contexto de ubicación intermedia de descarga de notificación para soportar una respuesta asincrónica al mensaje.
    • La salida de usuario pasa el tipo de ubicación intermedia de descarga de notificación que hace referencia al indicador de condición Registro de Citas: Próximo a Tiempo Real. La Id de actividad de campo también se pasa al motor de mensajes en tiempo real para ser publicados en un ingreso de contexto de ubicación intermedia de descarga de notificación. El sistema espera que la respuesta a este mensaje cree un registro de ubicación intermedia de carga XAI y que este registro actualice las características de la actividad de campo con la información de reserva y de cita forzada (si se aplica). Consulte Mensajes de Ubicación Intermedia de Descarga de Notificación Próximo a Tiempo Real para obtener más información sobre las respuestas a los mensajes próximos a tiempo real y ubicación intermedia de carga XAI.
    • Si la configuración del sistema externo indica que se permiten citas forzadas, el mensaje se envía al sistema externo con el juego de indicaciones forzadas. Si el sistema externo no permite citas forzadas, es posible que esta cita manual sea rechazada por el sistema externo.

Si no se recibe error, la página de cita continúa con la acción de "cambio". Se crea un período de cita para la hora de la cita seleccionada si aún no existe una y el período de cita se enlaza a la actividad de campo.

Nota:

El período de cita se crea y se enlaza a la actividad de campo, incluso si se envía el mensaje al sistema externo en tiempo casi real y no se ha recibido confirmación. Esto se realiza a fin de registrar la cita solicitada en nuestro sistema para atender las situaciones cuando el cliente desea cambiar o cancelar la cita antes de recibir confirmación del sistema externo.

Parte Superior de la Página

Anular Cita

Si el cliente desea cancelar la cita, el usuario navega a la página de cita. La clase java de integración de cita genérica proporcionada con el sistema envía un mensaje para cancelar una cita en tiempo real. La salida de usuario pasa el tipo de ubicación intermedia de descarga de notificación que hace referencia al indicador de condición Cancelación de Cita. La salida de usuario espera una respuesta positiva o negativa a este mensaje.

  • Si se recibe una respuesta positiva, la página de cita continúa con la acción de cambio. (Ver a continuación).
  • Si se recibe una respuesta negativa, se despliega un mensaje de error al usuario.
Nota:

Traslación de Mensaje. Cualquier mensaje de error recibido desde el sistema externo se traslada desde un mensaje externo a un mensaje de error de sistema correspondiente usando la información de mensaje en la configuración de características del sistema externo.

Si el motor de mensajes no se puede comunicar con el sistema externo, éste entrega una indicación a la salida de usuario. La salida de usuario continúa de la siguiente forma:

  • Si el sistema externo indica que Permitir Anulación de Cita Manual está definido en falso, se despliega un error al usuario.
  • Si se permiten las citas manuales, la salida de usuario emite una advertencia al usuario que pregunta si el mensaje se debe registrar y enviar cuando se establezca nuevamente la comunicación. Si el usuario acepta, la salida de usuario invoca la clase java solicitándole que publique un mensaje de próximo a tiempo real.
    • La salida de usuario calcula una ID de mensaje de salida única para el sistema externo. La Id de mensaje se calcula usando una secuencia de base de datos cuyo nombre se hace referencia en la opción externa Nombre de Secuencia de Base de Datos de ID de Mensaje en la tabla de sistema externo. Esta Id de mensaje se pasa al motor de mensajes en tiempo real para completarse como un ingreso de contexto de ubicación intermedia de descarga de notificación para soportar una respuesta asincrónica al mensaje.
    • La salida de usuario transmite el tipo de ubicación intermedia de descarga de notificación que hace referencia al indicador de condición Anulación de Cita: Próximo a Tiempo Real. La Id de actividad de campo también se pasa al motor de mensajes en tiempo real para ser publicados en un ingreso de contexto de ubicación intermedia de descarga de notificación. Una respuesta a este mensaje será una confirmación. No se esperan otras actualizaciones a los datos de la actividad de campo.

Si no se recibe error, la página de cita continúa con la acción de "cambio". El período de cita se desenlaza de la actividad de campo y si no hay otras actividades de campo enlazadas a este período de cita, el período de cita se suprime. Además, las características de actividad de campo para el número de reserva y citas forzadas se mueven desde la actividad de campo.

Nota:

Las actualizaciones anteriores se realizan, incluso si el mensaje se envía en tiempo casi real y no se ha recibido respuesta. Esto se realiza para cancelar la cita en el sistema a fin de atender las situaciones en que el cliente desee volver a registrar la cita antes de recibir la confirmación del sistema externo.