Exploración de consultas y API de consultas

Objective

After completing this lesson, you will be able to cree consultas complejas en la base de datos de SAP Field Service Management Cloud utilizando CoreSQL y exporte los resultados de manera eficaz.

Introducción a consultas y API de consulta

Unidad 4: Temas clave

Varios conceptos clave son fundamentales para comprender estas lecciones a fin de aprovechar de forma eficaz las capacidades de SAP Field Service Management (FSM).

La primera lección se centra en las consultas que utilizan la base de datos de la empresa FSM. "CoreSQL" es el lenguaje utilizado para escribir estas consultas y se puede utilizar para generar sentencias SELECT complejas a partir de varias tablas en la base de datos en la nube de FSM.

"Grupo de políticas de usuario" controla el acceso a los datos dentro del sistema. Los datos de la base de datos de FSM Cloud se organizan en "Objetos de transferencia de datos" (DTO), que incluyen "Actividad", "Llamada de servicio" y "WorkTimeTask". Es esencial comprender las relaciones de los DTO y cómo se vinculan para servir a varias características del sistema.

La segunda lección subraya el "Dashboard de análisis", una función que presenta indicadores de rendimiento clave para facilitar el seguimiento.

El dashboard utiliza consultas prediseñadas que pueden representar visualmente los datos utilizando varios tipos de gráficos. También puede definir sus propias consultas para análisis más personalizados.

La lección tres aborda la gestión de informes de FSM, donde las "plantillas de informe" son clave en el diseño, la creación y la utilización de informes.

Estas plantillas, que incluyen elementos de diseño, estilo, archivos de traducción e imágenes, junto con datos de la base de datos de la empresa o móvil generan el informe final. La "Generación automática de informes" y la "Generación manual de informes" son dos métodos para crear estos informes.

En todas las lecciones, el uso de "CoreSQL" para la extracción de datos es prominente. La estructura de la base de datos y la disposición de DTO contribuyen significativamente a la creación de informes y análisis. Una comprensión de "consultas", "dashboard de análisis", "plantillas de informe" y "DTO" es fundamental para dominar estas lecciones.

Consultas

SAP Field Service Management ofrece a los usuarios habituales la opción de consultar la base de datos de la empresa FSM.

SAP Field Service Management ofrece a los usuarios habituales la opción de consultar la base de datos de la empresa FSM (siempre que se haya concedido acceso a los usuarios). Esta función está disponible en Análisis e informesConsultas. Con las consultas, puede hacer lo siguiente:

  • Obtener una lista de datos según una consulta
  • Grabar consultas para uso posterior
  • Compartir consultas con otros usuarios dentro de la misma empresa

Al establecer una consulta como favorita (menú Agregar a), aparece un corazón en la lista de consultas.

Las consultas se escriben en CoreSQL. Permite sentencias SELECT complejas en varias tablas en la base de datos en la nube de FSM.

Las consultas se escriben en CoreSQL. Este es el mismo idioma de consulta que se utiliza para la API de consulta FSM. Se deriva de PostgreSQL y se limita a las operaciones de LECTURA. Permite sentencias SELECT complejas en varias tablas en la base de datos en la nube de FSM. La salida resultante se puede exportar en formatos CSV o JSON.

El acceso a los datos se rige por la configuración del Grupo de políticas de administración.

Los datos de la base de datos de FSM Cloud se estructuran en tablas, una para cada tipo de objeto. Estas tablas se denominan Objetos de transferencia de datos (DTO')

Los datos de la base de datos de FSM Cloud se estructuran en tablas, una para cada tipo de objeto. Los tipos de objeto o tablas se denominan Objetos de transferencia de datos o DTO. Algunos ejemplos de DTO son Actividad, Llamada de servicio y WorkTimeTask. Cada DTO consta de un número de campos de datos diferentes, y cada DTO puede tener muchos registros de datos individuales. En total, hay cientos de estos DTO.

Los DTO no solo se designan por su nombre, sino también por su número de versión. Los números de versión aumentan gradualmente con el tiempo, a medida que cambia la definición de cada tabla. Esto puede suceder, por ejemplo, cuando se añade un nuevo campo a una tabla.

La imagen anterior es un diagrama simplificado de varios objetos de transferencia de datos importantes. El diagrama no está completo, pero muestra varias entidades de uso común y sus relaciones.

Nota

Este diagrama también puede ser útil para las unidades que cubren las reglas empresariales y los datos maestros para recuperar información relativa a los objetos de transferencia de datos principales.

Es importante comprender cómo se relacionan las diferentes DTO entre sí: qué DTO se pueden vincular en primer lugar y si pueden tener un enlace. Si las tablas están vinculadas, es importante comprender la naturaleza de estas relaciones, por ejemplo:

  • Cada llamada de servicio (SC) se asigna exactamente a un tipo de llamada de servicio
  • Muchas llamadas de servicio pueden hacer referencia a un tipo de llamada de servicio
  • Cualquier actividad individual se asigna exactamente a una llamada de servicio, pero solo se puede vincular a 1 o 0 asignaciones de servicio a la vez

Si bien no es posible proporcionar un resumen completo de todos los DTO y sus relaciones aquí, el uso de consultas FSM puede ayudarle a explorar y comprender el modelo de datos.

La mayoría de los datos, pero no todos, forman parte de la base de datos de la empresa FSM. Algunos datos se almacenan en microservicios, a los que no se puede acceder mediante Query API / CoreSQL. En su lugar, estos microservicios tienen sus propias API dedicadas.

El núcleo de la lógica y los datos en Field Service Management se conoce como el "monolito". El monolito incluye la base de datos FSM Cloud de su empresa FSM. Sin embargo, no todos los datos forman parte de la base de datos de la empresa FSM: el desarrollo de productos de gestión de servicios de campo está implementando cada vez más microservicios porque esto hace que el desarrollo de software sea más ágil. Estos microservicios operan fuera del monolito y suelen tener sus propias bases de datos fuera de la base de datos principal de la empresa, además de tener API específicas dedicadas. Por lo tanto, los datos de microservicios (por ejemplo, detalles de nivel de organización) deben recuperarse mediante la API dedicada correspondiente, en lugar de utilizar la API de consulta o la API de datos.

Junto a la función Consultas en el módulo Análisis e informes, hay una funcionalidad similar disponible para los administradores dentro de la consola de administración de una empresa FSM. Allí, está disponible en la pestaña API de consulta. Los clientes fuera de FSM también pueden leer la fecha utilizando la API de consulta de FSM.

Las consultas CoreSQL también son componentes importantes de las plantillas de informes y las reglas empresariales. Comprender la API de consulta es una habilidad invaluable para depurar y configurar integraciones.

CoreQL admite muchas pero no todas las sentencias SQL para leer datos.

CoreQL admite muchas pero no todas las sentencias SQL para leer datos. Para obtener una guía completa de las declaraciones admitidas, consulte la documentación de ayuda.

Al utilizar Consultas en la IU del usuario final o en el módulo Admin, la versión DTO tiene por defecto la última versión. Sin embargo, en las reglas empresariales es obligatorio especificar la versión DTO deseada.

Al escribir una consulta, es obligatorio utilizar un alias cuando se hace referencia a un DTO. En la siguiente consulta, por ejemplo, nos referimos a la actividad DTO con el alias "act": SELECT act FROM Activity act

A continuación se muestran algunas consultas de ejemplo:

  • Obteniendo todos los campos de todas las asignaciones de servicio:

    SELECT sa FROM ServiceAssignment sa

  • Obtener el código y los campos de asunto de las últimas 10 actividades:

    SELECT act.code, act.subject FROM Activity act ORDER BY act.createDateTime DESC LIMIT 10

  • seleccionando Datos de llamada de servicio y socio de negocios para Llamadas de servicio con prioridad alta, uniendo las 2 tablas:

    SELECT bp.code, bp.name, sc.code, sc.subject FROM ServiceCall sc LEFT JOIN BusinessPartner bp ON bp.id = sc.businessPartner WHERE sc.priority = 'HIGH'

En la consola de administración, en Query API, puede ejecutar consultas escritas en CoreSQL y ver los resultados en pantalla.

La API de consulta en el módulo Admin utilizará la última versión del DTO de forma predeterminada. Si desea utilizar una versión DTO específica, puede seleccionar la opción de configuración que le permitirá declarar una versión específica de un objeto de datos admitido. También puede seleccionar si desea mostrar los cronomarcadores como fechas y horas o como cronomarcadores Unix. Para simular lo que vería un usuario específico, puede especificar algunos en Ejecutar como.

Para aumentar la facilidad de uso, el sistema sugiere comandos, tablas y nombres de campo relevantes a medida que escribe. Puede marcar sus consultas para grabarlas para su uso posterior. Las consultas más recientes están visibles en el botón Historial