Términos clave, utilizados en esta lección:
- Sincronización de IoT: el proceso de sincronización de datos entre SAP APM y los servicios de SAP IoT.
- Gateway REST: protocolo utilizado para servicios web que permite la integración de datos IoT en SAP APM.
- Datos de serie cronológica: datos recopilados en diferentes momentos, a menudo utilizados para el análisis de tendencias en contextos de IoT.
- JWT (JSON Web Token): Un medio compacto y seguro de URL para representar las reclamaciones que se transferirán entre dos partes.
- 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.
- URL de asignación de modelo: el URL utilizado para asignar objetos técnicos a sus modelos correspondientes en el servicio IoT.
- Payload: la parte de los datos transmitidos que es el mensaje real previsto.
- URL de medición IoT: el punto final al que se envían las mediciones desde dispositivos IoT.
- API (Application Programming Interface): Un conjunto de protocolos para construir e interactuar con aplicaciones de software.
- 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.
- 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

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

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

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

Vaya a la pestaña Indicadores y seleccione Crear.

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

Se ha creado el indicador local.

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.

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.

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.


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:
- Manualmente en la pestaña Indicadores de la página Objeto técnico
- Aprovechar las API de SAP APM o las API de SAP IoT
- 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.

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.

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


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:
- 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:
- Subdominio de subcuenta
- ID de subcuenta
- API de subcuenta
- ID de correo electrónico (para enviar la clave)
- 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.

![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. 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.](https://learning.sap.com/service/media/topic/ce6e529e-eab3-4fe6-98f6-460225344dea_es-ES/IAM160_2402_es-ES_media/IAM160_2402_es-ES_images/IAM160_2402_U2L5_027.png)
Para crear correctamente datos de serie cronológica mediante las API de SAP APM, debemos aprovechar dos API.
- API de indicador para obtener los ID internos del indicador.
- API de serie cronológica para crear los valores de serie cronológica.

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'

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:
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:
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".


Vídeos de demostración
Recursos adicionales

API de estado de activos en SAP Business Accelerator Hub
https://api.sap.com/package/SAPAssetPerformanceManagementAssetHealth/overview

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