Implementación de SAP Asset Performance Management
Inicio de SAP Asset Performance Management
Aplicación de estrategias de activos en SAP Asset Performance Management
Evaluar y supervisar el estado de los activos en SAP Asset Performance Management
Aplicación de análisis en SAP Asset Performance Management

Implementación de la integración de IoT

Objective

After completing this lesson, you will be able to identificar los principios y procedimientos para configurar la integración con dispositivos IoT dentro del contexto de SAP Asset Performance Management

Integración con dispositivos IoT

Términos clave, utilizados en esta lección:

  1. Sincronización de IoT: el proceso de sincronización de datos entre SAP APM y los servicios de SAP IoT. 
  2. Gateway REST: protocolo utilizado para servicios web que permite la integración de datos IoT en SAP APM. 
  3. Datos de serie cronológica: datos recopilados en diferentes momentos, a menudo utilizados para el análisis de tendencias en contextos de IoT. 
  4. JWT (JSON Web Token): Un medio compacto y seguro de URL para representar las reclamaciones que se transferirán entre dos partes. 
  5. OAuth: Un estándar abierto para la delegación de acceso, comúnmente utilizado como una forma para que los usuarios otorguen a los sitios web o aplicaciones acceso a su información en otros sitios web, pero sin darles las contraseñas. 
  6. URL de asignación de modelo: el URL utilizado para asignar objetos técnicos a sus modelos correspondientes en el servicio IoT. 
  7. Payload: la parte de los datos transmitidos que es el mensaje real previsto. 
  8. URL de medición IoT: el punto final al que se envían las mediciones desde dispositivos IoT. 
  9. API (Application Programming Interface): Un conjunto de protocolos para construir e interactuar con aplicaciones de software. 
  10. Frecuencia de jobs de sincronización: hace referencia a la frecuencia con la que se produce la sincronización entre sistemas como SAP S/4HANA y SAP APM. 
  11. API de SAP IoT: interfaces de programación de aplicaciones proporcionadas por SAP para interactuar con datos y servicios de IoT. 

Escenario empresarial: Integración con dispositivos IoT

Jessica Martin

Para esta lección, Jessica Martin intentará adquirir las habilidades para aprovechar los datos de series cronológicas, como los datos de sensores, en SAP Asset Performance Management. Aprenderá cómo SAP Asset Performance Management se integra con SAP Internet of Things.

Resumen de la lección: Integración de IoT con APM

En esta lección, aprenderá a ingerir datos de IoT en SAP Asset Performance Management en un indicador local asignado a un objeto técnico, como un equipo. Como requisito previo, la integración entre ERP y SAP APM debe estar completa y algunos objetos técnicos se han cargado en el sistema.

Integración con dispositivos IoT

Resumen del panel de instrucciones con varias opciones de gestión y sus métricas asociadas. 'Explorar objetos técnicos' muestra un recuento de 2.41k, 'Grupos' tienen 9, 'Reglas' son 38 y 'Sincronizar objetos técnicos - IoT' también en 2.41k. En Gestión de evaluaciones, hay 14 plantillas de evaluación de riesgos y criticidad, 11 evaluaciones, 14 evaluaciones de estrategia para clases, 3 evaluaciones RCM y 13 elementos en el workbench de recomendaciones.

Inicie sesión en la solución SAP APM y vaya a la aplicación Explorar objetos técnicos.

Interfaz de SAP que detalla información sobre una 'Bomba de circulación de agua de refrigeración - APM'. Muestra categorías como Datos generales, Estructura, Datos de fabricante y Datos de ubicación, con campos para Tipo de objeto, Número de serie, Fabricante, Número de modelo y otros detalles del equipo relacionados. La interfaz forma parte de la función Explorar objetos técnicos dentro de la plataforma.

2. Seleccione cualquier objeto técnico que desee añadir un indicador local.

La interfaz SAP para una Bomba de circulación de agua de refrigeración - APM con una pestaña seleccionada para Indicadores. La pantalla indica que no hay indicadores disponibles para el objeto técnico actual y proporciona una opción para crear indicadores nuevos. La interfaz está diseñada para supervisar y gestionar el rendimiento del equipo técnico dentro del sistema.

Vaya a la pestaña Indicadores y seleccione Crear.

Un formulario en la interfaz SAP para crear un indicador local. Los campos que se deben rellenar incluyen Característica con una entrada de ejemplo de OPERATING_HOUR, Descripción, Posición, Categoría y varios parámetros de medición como unidad de medida, máximo, mínimo y valores de destino, junto con opciones para la selección de color y el tipo de indicador.

Rellene los detalles para el Indicador local . Tenga en cuenta que Característica, Posición y Categoría son obligatorios.

La interfaz de SAP muestra una sección para Bomba de circulación de agua de refrigeración - APM en Indicadores. Se ha creado un nuevo indicador llamado OPERATING_HOUR con la descripción Lectura(es) de contador de horas y se enumera en la interfaz, con un mensaje de confirmación Se ha creado el indicador en la parte inferior.

Se ha creado el indicador local.

Dashboard de interfaz de SAP con varias opciones de gestión de activos. Una sección, resaltada con una casilla roja, se titula Gestionar problemas de conectividad de objetos técnicos con un contador de 20 junto a un icono que representa la conectividad. Indica que hay 20 problemas que se deben gestionar dentro de esta categoría

Vuelva a la pantalla de inicio y vaya a la aplicación Gestionar conectividad de objetos técnicos en el grupo Supervisión de estado de activos.

Interfaz de SAP para gestionar la conectividad de objetos técnicos. Muestra una entrada individual para una Bomba de circulación de agua de refrigeración - APM con un estado que indica No configurado. La interfaz proporciona opciones de configuración, que muestran el número de indicadores, el estado de sincronización y la última hora de sincronización intentada para el objeto.

Busque y seleccione el equipo para el que acaba de añadir el indicador local y pulse Configurar. Conmute el conmutador IoT Sync. La selección de gateway es importante si se aprovechan las API de conectividad del dispositivo SAP IoT, ya que determinarán si el dispositivo está configurado para REST o MQTT. Si utiliza las API de serie cronológica proporcionadas por SAP APM, permanezca con el "gateway REST" predeterminado.

Ventana emergente Configuración en la interfaz SAP Gestionar conectividad de objetos técnicos. Se pide configurar un dispositivo IoT con un conmutador, indicando la capacidad de habilitar o deshabilitar la conexión. Hay un menú desplegable disponible para seleccionar la puerta de enlace, con el botón Confirmar para aplicar los cambios.

Puede ver que este indicador se replica desde la fuente "Punto de medición" junto con el ID del punto de medición como 93. Ahora el valor del indicador es 76.

Creación de un nuevo documento de medición en SAP S/4HANA

Intentemos modificar el valor en tiempo real y ver si los datos fluyen a APM en tiempo real.

Vaya a la transacción IK11 del documento de medición y abra el punto de medición 93. 

Interfaz de conectividad de SAP Gestionar objeto técnico que muestra una Bomba de circulación de agua de refrigeración - APM con un indicador en curso. El estado de sincronización es En curso, el último intento de sincronización fue el 12 de marzo de 2023, a las 10:32 PM, con Gateway REST seleccionado como gateway. Un mensaje en la parte inferior indica que se ha desencadenado la sincronización.
La interfaz de SAP para Gestionar conectividad de objetos técnicos muestra una Bomba de circulación de agua de refrigeración - APM con un estado que indica que el indicador 1 es Correcto. El último intento de sincronización se marca el 10 de marzo de 2023 a las 10:32 PM, y el gateway utilizado es Gateway REST.

Una vez completada la configuración, seleccione "Sincronizar con IoT", que sincronizará el objeto técnico de APM con SAP IoT. El estado de sincronización cambiará de En curso a Correcto

La serie cronológica

Después del estado Correcto del objeto técnico en la IU de APM, los datos de serie cronológica se pueden integrar en SAP APM a través de varios medios:

  1. Manualmente en la pestaña Indicadores de la página Objeto técnico
  2. Aprovechar las API de SAP APM o las API de SAP IoT
  3. Si el indicador no es local, sino un punto de medición integrado desde SAP S/4HANA, un documento de medición crearía automáticamente el valor de serie cronológica a través de la interfaz de SAP Event Mesh comentada anteriormente.

A continuación, veremos los dos primeros métodos de integración de datos de series cronológicas.

Interfaz de SAP para Explorar objetos técnicos que muestra los detalles de una Bomba de circulación de agua de refrigeración - APM. La pestaña Indicadores está abierta y muestra un indicador OPERATING_HOUR con la opción Crear y Añadir valor nuevo disponible. El indicador se ha creado correctamente y está listo para otra configuración o adición de valor.

Para ilustrar un valor manual, vuelva a la página Objeto técnico para este equipo. Seleccione el indicador y pulse Añadir valor nuevo.

Ventana de superposición en la interfaz de SAP titulada Añadir nuevo valor de indicador para Bomba de circulación de agua de refrigeración - APM. Contiene campos para introducir un nuevo valor y una fecha y hora. La interfaz está diseñada para que los usuarios actualicen y gestionen las lecturas de los indicadores para el equipo técnico.

Rellene la página y pulse Guardar. El indicador se actualizará con este valor.

La interfaz Explorar objetos técnicos de SAP muestra un indicador para OPERATING_HOUR con un nuevo valor añadido. La interfaz indica la actualización correcta del indicador con un valor y proporciona otras opciones, como editar, borrar y configurar para la 'Bomba de circulación de agua de refrigeración - APM.
Un gráfico en la interfaz Explorar objetos técnicos de SAP que muestra la tendencia de lectura del contador de horas para una Bomba de circulación de agua de refrigeración - APM. El gráfico de líneas horizontales indica un valor consistente a lo largo del tiempo, con una quick info que revela la lectura más reciente.

Después de un tiempo, el gráfico Supervisión de indicadores también se actualizará con este valor.

La entrada manual de series cronológicas es suficiente en muchos escenarios, especialmente cuando los datos se recopilan manualmente. Sin embargo, las series cronológicas son generadas con frecuencia por sensores y aquí queremos aprovechar una API para incorporar estos datos al sistema. Esto mostrará un ejemplo sobre cómo el uso de un cliente REST, como Postman, puede traer datos. Sin embargo, en un proyecto real, se puede utilizar una herramienta de integración, como SAP Plant Connectivity o SAP Data Intelligence.

Para utilizar la API de SAP APMs, necesitará dos cosas:

  1. La X-API-KEY que se puede obtener a pedido a través de un incidente con SAP. Esto se puede hacer creando un ticket en el componente APM-OPS-SERV con prioridad Media. Proporcione los siguientes detalles:
  2. Subdominio de subcuenta
  3. ID de subcuenta
  4. API de subcuenta
  5. ID de correo electrónico (para enviar la clave)
  6. La clave de servicio creada al crear una instancia de servicio en la subcuenta BTP. Las API están protegidas mediante oAuth 2.0 y el ID de cliente y el secreto de cliente están incluidos en la clave de servicio.

Nota: cada solicitud de API tendría que tener dos cabeceras:

  • X-API-KEY con la clave API como valor.
  • Autorización con <token> de portador como valor. El <token> se obtiene aprovechando el ID de cliente / secreto de cliente / y la URL de autorización de la clave de servicio.
Cockpit de SAP BTP que muestra la sección Espacio: apm - Instancias de servicio. Enumera una única instancia de servicio llamada apm-001 para el servicio SAP Asset Performance Management con el plan estándar y el estado Creado, lo que indica una configuración de instancia correcta.
Configuración de cabecera de solicitud API con varias claves y valores. Cabe destacar que hay dos campos resaltados: X-Auth-Key con su valor redactado por seguridad y Autorización con un valor Bearer [token], también redactado. Estas cabeceras son críticas para garantizar una comunicación API segura.

Para crear correctamente datos de serie cronológica mediante las API de SAP APM, debemos aprovechar dos API.

  1. API de indicador para obtener los ID internos del indicador.
  2. API de serie cronológica para crear los valores de serie cronológica.
Detalle de credencial de formato JSON con varias URL de punto de acceso de servicio para una API. Se resalta uno de los puntos finales de servicio para IndicatorService, que indica la URL específica para acceder a este servicio dentro de la estructura de la API.

Para obtener la definición del indicador, realice una solicitud al servicio de indicadores. Aproveche la URL de servicio de "indicadores" que se encuentra en la clave de servicio APM. También puede añadir un string de filtro oData para reducir el conjunto de muestras al objeto técnico que necesita. Una llamada de ejemplo tendría el siguiente aspecto:

https://api-apm.prod.apimanagement.us10.hana.ondemand.com/IndicatorService/v1/Indicators?$filter=technialObject_number eq '217100092'

Interfaz de prueba de API con un cuerpo de respuesta en formato JSON visualizado. Incluye una matriz de objetos que detalla la información de TechnicalIndicator con varios atributos como uuid, value, valueId, creationTime y otros. Algunos atributos contienen datos específicos, mientras que otros son nulos, lo que refleja una estructura típica de una respuesta de una llamada API REST.

Creación de datos de serie cronológica

A continuación, utilizamos la API de serie cronológica, junto con los datos recuperados de la API de indicadores para crear datos de serie cronológica. Aquí aprovechamos una API POST para el servicio de serie cronológica, donde el payload es el siguiente:

Code Snippet
123456789101112131415
{ "SSID": "", "technicalObjectType": "", "technicalObjectNumber": "\", "categoryName": "" "positionID": "", "values": [ { "characteristicsInternalId": "\", "value": "", "time": "2024-03-01T16:00:00.0000000Z" } ] }

Tenga en cuenta que todos los campos, con la excepción de los campos "valor" y "hora", se obtienen del resultado de la API de indicador. Un ejemplo de payload completo tendría el siguiente aspecto:

Code Snippet
123456789101112131415
{ "SSID": "S4HCLNT100", "technicalObjectType": "EQUI", "technicalObjectNumber": "217100092", "categoryName": "M", "positionID": "24aa638b97194cb8b9d0cf4c2a46eb95", "values": [ { "characteristicsInternalId": "53", "value": "45", "time": "2024-03-01T16:00:00.0000000Z" } ] }

Si tiene éxito, debería recibir una respuesta "201 Creado".

Interfaz de credenciales de API que muestra datos JSON con varios puntos finales de servicio. El punto de acceso timeseries-service está resaltado, proporcionando la URL para acceder a los datos de serie cronológica dentro de la API. En la parte inferior, hay un objeto 'html5-apps-repo' que contiene un 'app-host-id', que indica además datos estructurados para la configuración y conectividad de API.
Respuesta de API en formato JSON visualizada en una herramienta de prueba de API. Muestra una matriz de mediciones con sus respectivos 'TechnicalEquipmentNumber', 'CharacteristicInternalId', 'valueId' y 'value'. Las entradas de datos tienen cronomarcadores que indican cuándo se registró cada medición.

Vídeos de demostración

Recursos adicionales

Portátil mostrando la interfaz de SAP Asset Performance Management en su pantalla. La sección Estado del activo está abierta y muestra una sección Acerca de con los detalles de la versión y el paquete de soporte, una sección Documentos con entradas para utilizar la clave de servicio y el resumen de problemas, y una sección Etiquetas empresariales relacionada con Asset Performance Management.

Obtención de X-API-KEY

API de estado de activos en SAP Business Accelerator Hub

https://api.sap.com/package/SAPAssetPerformanceManagementAssetHealth/overview

Reflexión personal

Piense en un momento en el que tuvo que aprender una nueva tecnología o proceso que estaba fuera de su experiencia habitual, como integrar dispositivos de IoT con SAP Asset Performance Management. ¿Cómo manejó la curva de aprendizaje y qué estrategias lo ayudaron a comprender los conceptos y procedimientos?

Respuesta de experto

Respuesta experta a la pregunta de reflexión personal:  

Abordar la nueva tecnología, como la integración de IoT con SAP APM, es como aprender a nadar. Comienza en el extremo poco profundo de lo que hacen los dispositivos IoT y cómo se comunican entre sí mediante API. Es como ponerse cómodo en el agua antes de intentar nadar. 

A continuación, profundice en detalles y aprenda cómo estos dispositivos se conectan con SAP APM. Es como nadar laps practicando los trazos hasta que se sientan naturales. Y al igual que los nadadores a menudo aprenden mejor con un entrenador o un equipo, encontré que trabajar a través de desafíos con colegas o compartir mis conocimientos hizo que el aprendizaje fuera un palo. 

Por lo tanto, cuando hablamos de configurar IoT en SAP APM, desde sincronizar equipos hasta enviar datos, es un proceso en el que cada paso se basa en el último. Mis experiencias pasadas me recuerdan que lo llevaré paso a paso, pedir ayuda cuando la necesite y compartir lo que aprendo en el camino. Se trata de ser paciente y persistente, y así es como las piezas caen en su lugar. 

Conclusión

Objetivo: Domine el proceso de integración de datos de IoT para objetos técnicos dentro de SAP Asset Performance Management (APM), garantizando que los datos del equipo de SAP S/4HANA se sincronicen de forma efectiva.

Puntos clave:

  1. Preparación:
    1. Confirme que el equipo de SAP S/4HANA está sincronizado con SAP APM.
    2. Acceda a la "Aplicación de objeto técnico Explorador" dentro de SAP APM.
  2. Sincronización de objetos técnicos:
    1. Localice el objeto técnico sincronizado de SAP S/4HANA.
    2. Verifique la frecuencia de tareas de sincronización para asegurarse de que el objeto aparezca en APM.
  3. Creación de indicadores y sincronización IoT:
    1. Generar nuevos indicadores locales para un objeto técnico.
    2. Utilice la función "Sincronizar objetos técnicos - IoT" para enlazar objetos técnicos con SAP IoT.
  4. Configuración de la ingesta de datos de IoT:
    1. Validar estado de sincronización correcto para el objeto técnico y los indicadores.
    2. Utilice la función "Añadir valor nuevo" para introducir datos de serie cronológica para indicadores de equipo.
  5. Interacción de API de SAP IoT:
    1. Recuperar tokens JWT mediante URL de autenticación APM.
    2. Utilice URLs de asignación de modelos para obtener IDs de asignación para objetos técnicos.
    3. Contabilizar datos de series cronológicas en indicadores mediante la API de medición de IoT.
  6. Verificación de la integración de datos:
    1. Después de contabilizar los datos, verifique la IU de APM para asegurarse de que los valores del indicador reflejen las nuevas entradas.
    2. Confirme la reflexión de datos en SAP APM para garantizar la integración de datos de punta a punta.

Resultados: los participantes obtendrán la capacidad de integrar y validar datos de IoT dentro de SAP APM, lo que permitirá mejorar la supervisión y el análisis del rendimiento de los objetos técnicos. Esto garantiza que los datos del equipo permanezcan actualizados, proporcionando una visión integral del estado y el rendimiento de los activos.