Ver panel de instrumentos del gestor

Solución

En la sección siguiente se describen las API, las rutinas de usuario, los servicios y otros componentes.

La vista Panel de instrumentos del gestor se puede iniciar desde la página de inicio de la aplicación utilizando el icono de ojo. El panel de control del gestor proporciona el número total de órdenes, gráficos de estado de orden, gráficos de SLA, etc. Los aspectos técnicos de cumplimentación del panel de instrumentos son los siguientes:

Se llama a los mashups para cumplimentar los datos para cada portlet del panel de instrumentos. Se agregan varios mashups en una única llamada al servidor para invocar un servicio, que llena el gráfico SLA y el gráfico Estado de orden, mostrados el uno junto al otro. Basándose en los parámetros de entrada del mashup, el servicio consulta la base de datos para los pedidos de Enviar desde almacén o Recogida desde almacén y los estados de pedido solicitados.
Una tienda sólo puede manejar pedidos de Recogida en tienda o Enviar desde tienda . En estos casos, el permiso de recurso necesario se puede habilitar para que el grupo de usuarios de la tienda acceda al portlet adecuado. Dependiendo del permiso de recurso habilitado, el portlet correspondiente se visualiza con los gráficos de Estado de orden y SLA uno junto al otro en la versión de escritorio de la aplicación. Sin embargo en la versión móvil de la aplicación, se visualiza un enlace para conmutar entre los gráficos. El portlet está oculto en estos casos, ya que sería redundante con el portlet principal.

El archivo manager-dashboard.json existente en la carpeta <WAR>/ngstore/store/views/home/manager-dashboard/ contiene la configuración de la característica. El servicio utiliza este archivo para consultar la base de datos y devolver el número de órdenes correspondientes a un estado de orden o SLA determinado. El archivo de configuración JSON ayuda a agregar estados de envío y SLA para facilitar la visualización en la interfaz de usuario. Dado que es configurable, puede añadir o modificar los estados para que se ajusten a las necesidades de la empresa.

Tabla 1. Mashups y servicios
Mashup	Función
`mgrdb_getCommonCodeListForSLA`	Recupera la lista de códigos comunes correspondientes a los umbrales de tiempo para cada categoría SLA. Invoca la API `getCommonCodeList`.
`mgrdb_getDashboardPollingIntervalRuleDetails`	Este mashup llama a la API `getRuleDetails` y recupera el intervalo de renovación del panel de control configurado en Sterling Business Center.
`sfs_sla_getShipmentCountForGivenStatuses`	Recupera el número de envíos bajo cada categoría SLA en el archivo `manager-dashboard.json` para las órdenes Enviar desde almacén. Invoca el servicio `YCD_GetShipmentCountForStatusList`.
`sfs_orderstatus_getShipmentCountForGivenStatuses`	Recupera el número de envíos bajo cada categoría Estado de orden en el archivo `manager-dashboard.json` para las órdenes Enviar desde almacén. Invoca el servicio `YCD_GetShipmentCountForStatusList`.
`bopus_sla_getShipmentCountForGivenStatuses`	Recupera el número de envíos bajo cada categoría SLA en el archivo `manager-dashboard.json` para las órdenes Recogida desde almacén. Invoca el servicio `YCD_GetShipmentCountForStatusList`.
`bopus_orderstatus_getShipmentCountForGivenStatuses`	Recupera el número de envíos bajo cada categoría de estado de orden en el archivo `manager-dashboard.json` para las órdenes Recogida en tienda. Invoca el servicio `YCD_GetShipmentCountForStatusList`.

Se ejecuta la lógica siguiente para visualizar la información en el panel de instrumentos del gestor:

Cuando se inicia el panel de instrumentos del gestor, los mashups mgrdb_getCommonCodeListForSLA y mgrdb_getDashboardPollingIntervalRuleDetails se agregan y se invocan conjuntamente. Sólo se invoca una vez por sesión y bloquea la interfaz de usuario. Cualquier navegación posterior en el panel de instrumentos de gestor recoge la respuesta almacenada en memoria caché hasta que se renueve el navegador. Los datos que se recuperan para los umbrales de SLA los utilizan los mashups sfs_sla_getShipmentCountForGivenStatuses y bopus_sla_getShipmentCountForGivenStatuses para invocar el servicio YCD_GetShipmentCountForStatusList para obtener los datos relacionados con SLA.
El portlet Enviar desde almacén agrega e invoca sfs_sla_getShipmentCountForGivenStatuses y sfs_orderstatus_getShipmentCountForGivenStatuses. Simultáneamente, se invocan los mashups bopus_sla_getShipmentCountForGivenStatuses y bopus_orderstatus_getShipmentCountForGivenStatuses desde el portlet Recogida en almacén. Estas dos llamadas de mashup no bloquean la interfaz de usuario.
Siempre que el gestor de almacén elige conmutar entre el gráfico SLA y el gráfico Estado de orden, se invoca uno de los mashups adecuados.

Configuración JSON

El archivo manager-dashboard.json contiene configuración que el Panel de instrumentos de gestor utiliza. Contiene la configuración para los gráficos de estado de orden y SLA segregados en función de los métodos de cumplimentación de orden Recogida en almacén y Enviar desde almacén . Proporciona configuración con las siguientes finalidades:

Agrupación de diversos estados de envío en tres estados de visualización para cada representación visual.
Las etiquetas y los estilos que se aplican a la interfaz de usuario.

Tabla 2. Detalles de la configuración
Atributo	Descripción
`statusName`	Nombre del estado.
`combinedStatusArray`	Estados que se agrupan y se visualizan debajo de `statusName`
`ui_chartConfig`	Configuración que se utiliza en la interfaz de usuario para visualizar la etiquetas (`labelKey`) y CSS (`cssClass`). El gráfico en la interfaz de usuario utiliza `unitValueInnerPadding` y `radiusInnerPadding`.
`ui_chartId`	Debe corresponder al ID de DOM del gráfico. Se utiliza para establecer la configuración de JSON en el gráfico correcto.

La configuración de órdenes de agrupación en función del SLA presenta las siguientes diferencias

Tabla 3. Diferencias de configuración
Atributo	Descripción
`combinedStatusArray`	Contendrá la lista de descripciones (`shortDescription`) para los SLA configurados en Business Center. Deben permanecer igual y no pueden globalizarse.
`statusUIDefaults`	En el caso de que más de un SLA esté agrupado bajo `combinedStatusArray`, se adoptarán los iconos y estilos configurados para el estado mencionado en el archivo.
`cssClass`	No es necesario. Se obtiene automáticamente de `statusUIDefaults`.
`shipmentStatusToExclude`	Es el estado de envío que no debe incluirse mientras se calculan los números de SLA. De forma predeterminada, cambia a `"statusName":"complete"`.

Notas:

El recuento de envíos en los portlets incluye los envíos de orden de venta y de orden de transferencia.
Puede agrupar diferentes estados de envío debajo de las categorías complete, inProgress y notStarted. De forma predeterminada, esto se implementa para los pedidos de Recogida en tienda y Enviar desde tienda para la configuración de shipmentStatus . Sin embargo, no se recomienda agrupar diferentes categorías SLA bajo overdue, dueSoon y withinSLA.
Puede añadir o eliminar categorías de las configuraciones sla y shipmentStatus. Sin embargo, el número de categorías y sus nombres deben ser iguales en shipFromStore y pickupInStore.
Para las nuevas categorías añadidas bajo sla, debe definir la etiqueta, css e iconos correspondientes. De lo contrario se visualizan los detalles predeterminados.
Además, las categorías sla definidas en el archivo deben estar configuradas para la organización en Sterling Business Center. De lo contrario, no se muestran los gráficos y se visualiza un mensaje indicando que la configuración no es válida.

Los códigos de estado y los criterios de agrupación se describen en las tablas siguientes:

Tabla 4. Códigos de estado
Código de estado	Descripción
`1100.70.06.10`	Listo para selección interna
`1100.70.06.20`	Selección interna en curso
`1100.70.06.50`	Listo para embalaje
`1100.70.06.70`	Envío en proceso de embalaje
`1100.70.06.30`	Listo para cliente
`1400`	Envío efectuado
`1300`	Empaquetado

Tabla 5. Criterios de agrupación para Estado del pedido
Estado del pedido	Criterios de agrupación
No iniciado	Todos los pedidos en estado `Ready For Backroom Pick` .
En curso	Todos los pedidos en estado `Backroom Pick in Progress` Todos los pedidos de Enviar desde almacén en estado `Ready For Packing` Todos los pedidos de Enviar desde almacén en estado `Shipment Being Packed`
Completado	Todos los pedidos de Recogida en tienda en estado `Ready For Customer` . Todos los pedidos en estado `Shipment Shipped` . Todos los pedidos de Enviar desde almacén en estado `Packed` .

Tabla 6. Criterios de agrupación para SLA
Acuerdo de nivel de servicio	Criterios de agrupación
Vencido	El tiempo restante para la finalización del pedido es de 0 minutos o menos.
Vence pronto	El tiempo restante para la finalización del pedido es de 30 minutos o menos. Este grupo incluye órdenes de prioridad media y alta.
Dentro de SLA	El tiempo restante para la finalización del pedido es superior a 30 minutos.

Los criterios de agrupación que se mencionan aquí se basan en los datos de la implementación de referencia suministrados para la organización predeterminada. De forma similar, puede configurar los criterios de agrupación de SLA para su organización utilizando la configuración de Indicadores de nivel de servicio en Sterling Business Center.

Personalización de los iconos de SLA

Configure los indicadores de nivel de servicio para la prioridad de SLA utilizando Sterling Business Center. Para obtener más información, consulte Configurar indicadores de nivel de servicio.
La vía de acceso y la extensión de las imágenes de SLA se truncan y el nombre de la imagen se utiliza como el nombre de clase CSS para definir el color de los iconos de prioridad de SLA. Por ejemplo, en la vía de acceso wsc/resources/css/icons/images/timeLeftOverdue.png, timeLeftOverdue se convierte en el nombre de clase CSS y el color del icono se puede definir como: .timeLeftOverdue{color:#DD1D32!important;fill:#DD1D32!important}
Para definir formas para los iconos de SLA, consulte el procedimiento del tema Sustituir los iconos de font existentes . Sin embargo, mientras sigue el procedimiento, debe modificar el código de acuerdo con los iconos que desea sustituir. Por ejemplo, para el icono timeLeftOverdue , puede tener el código como .app-icon-timeLeftOverdue{...}.

Entorno local para la configuración de SLA: Cuando conmute el entorno local BD, asegúrese de los cambios siguientes:

Asegúrese de que la configuración SLA en el archivo manager-dashboard.json está en el entorno local BD.
Asegúrese de que los campos combinedStatusArray y statusUIDefaults coinciden.
De forma predeterminada, los campos contienen entradas para el entorno local BD en inglés, que es el entorno local base. Si el entorno local BD base está en cualquier otro idioma, las siguientes entradas debe cambiarse a los literales del entorno local base en el archivo manager-dashboard.json:
```
Time Left Overdue
Time Left High Priority
Time Left Medium Priority
Time Left Low Priority
```

Consideraciones:

Los gráficos Estado de orden y los gráficos SLA solamente se generan para órdenes de venta.
Para calcular el número de pedidos en estado Not Started y In Progress , se tienen en cuenta los pedidos del día actual y los pedidos pendientes del día anterior.
Para calcular el número de pedidos en estado Completed , se tienen en cuenta los pedidos completados que pertenecen a la fecha actual o a una fecha futura.
12:00AM y 11:59PM se consideran como el inicio y el final de un día respectivamente.
Los datos del panel de control se actualizan automáticamente cada 5 minutos de forma predeterminada y el intervalo de tiempo se puede configurar en Sterling Business Center.

Importante: Un pedido puede tener varios envíos o varios pedidos pueden estar en un único envío. Básicamente, los mashups utilizados en esta característica sólo recuperan envíos. Sin embargo, utilizando los envíos devueltos por las mashups, la aplicación proporciona información en términos de los detalles de la orden correspondiente para la comodidad de los usuarios finales.

Visualización de envíos

En cualquiera de los portlets Enviar desde almacén o Recogida desde almacén , cuando el usuario pulsa un icono de leyenda o una región en el gráfico Estado de orden o SLA, se llama a una combinación de mashups que a su vez invoca un servicio.

Tabla 7. Mashups y sus funciones
Mashups	Función
`shipmentList_getShipmentListByStatus_sla`	Recupera la lista de envíos para el método de entrega necesario para SLA. Invoca la API `getShipmentList`.
`shipmentList_getShipmentListByStatus_orderstatus`	Recupera la lista de envíos para el método de entrega necesario para el Estado de orden. Invoca la API `getShipmentList`.
`sla_getShipmentCountForGivenStatuses`	Recupera el número de envíos bajo cada categoría SLA definida en el archivo `manager-dashboard.json` para las órdenes Enviar desde almacén o Recogida en almacén. Invoca el servicio `YCD_GetShipmentCountForStatusList`.
`orderstatus_getShipmentCountForGivenStatuses`	Recupera el número de envíos bajo cada categoría de estado de orden en el archivo `manager-dashboard.json` para las órdenes Enviar desde almacén o Recogida en almacén. Invoca el servicio `YCD_GetShipmentCountForStatusList`.

En función de si el usuario ha pulsado el gráfico SLA o el gráfico Estado de orden, la página de lista de envíos se carga y se agregan e invocan dos mashups de la siguiente manera:

Si se pulsa el gráfico SLA, los mashups shipmentList_getShipmentListByStatus_sla y sla_getShipmentCountForGivenStatuses se agregan y se invocan.
Si se pulsa el gráfico Estado de orden, los mashups shipmentList_getShipmentListByStatus_orderstatus y orderstatus_getShipmentCountForGivenStatuses se agregan y se invocan.

Un mashup proporciona la lista de envíos y el otro proporciona el número total de envíos, visualizado como un número en las fichas de cada categoría.

La navegación entre las fichas correspondientes a las categorías de estado o SLA invoca el mashup adecuado basándose en si el usuario llegó a la página de la lista de envíos desde el gráfico SLA o el gráfico Estado de orden.

Nota: La lista de envíos visualizados en diferentes separadores para Prioridad de SLA o Estado de orden incluye los envíos de orden de venta y de orden de transferencia.

Detalles específicos de dispositivo

El panel de instrumentos de gestor se puede visualizar tanto en la versión de escritorio como móvil de la aplicación.

Implementación

En la sección siguiente se describen las reglas que debe configurar.

Un usuario de tienda debe tener los permisos de recurso Recogida de panel de control de gestor en portlet de tienda y Envío de panel de control de gestor desde portlet de tienda . Para obtener información sobre la administración de permisos de grupos de usuarios, consulte la sección Administración de permisos de grupos de usuarios.
Configure correctamente los indicadores de nivel de servicio. Para obtener más información, consulte Configurar indicadores de nivel de servicio
El panel de control del gestor se renueva en función del intervalo de sondeo configurado en Sterling Business Center. Para obtener más información, consulte Configuración del intervalo de sondeo.