Principais termos, usados nesta lição:
- Sincronização IoT: o processo de sincronização de dados entre SAP APM e serviços SAP IoT.
- Gateway REST: um protocolo utilizado para Web Services que permite a integração de dados de IoT em SAP APM.
- Dados de série cronológica: dados coletados em diferentes momentos, geralmente usados para análise de tendência em contextos de IoT.
- JWT (JSON Web Token): Um meio compacto seguro de URL de representar reivindicações a serem transferidas entre duas partes.
- OAuth: Um padrão aberto para delegação de acesso, comumente usado como uma forma de os usuários concederem aos sites ou aplicativos acesso a suas informações em outros sites, mas sem lhes dar as senhas.
- URL de mapeamento de modelo: o URL utilizado para mapear objetos técnicos para os modelos correspondentes no serviço IoT.
- Payload: a parte dos dados transmitidos que é a mensagem real pretendida.
- URL de medição IoT: o ponto de acesso para o qual as medições de dispositivos IoT são enviadas.
- API (Application Programming Interface): um conjunto de protocolos para criação e interação com aplicativos de software.
- Frequência do job de sincronização: refere-se à frequência com que ocorre a sincronização entre sistemas como SAP S/4HANA e SAP APM.
- SAP IoT APIs: Interfaces de Programação de Aplicativos fornecidas pela SAP para interação com dados e serviços de IoT.
Cenário empresarial: integração com dispositivos IoT

Para esta lição, Jessica Martin procurará adquirir habilidades para aproveitar dados de série cronológica, como dados de sensores, no SAP Asset Performance Management. Ela aprenderá como o SAP Asset Performance Management se integra ao SAP Internet of Things.
Visão geral da lição: Integração de IoT com APM
Nesta lição, você aprenderá a ingerir dados de IoT no SAP Asset Performance Management para um indicador local atribuído a um objeto técnico, como um equipamento. Como pré-requisito, a integração entre o ERP e o SAP APM deve estar concluída e alguns objetos técnicos foram carregados no sistema.
Integração com dispositivos IoT

Efetue logon na solução SAP APM e vá para o aplicativo Explorar objetos técnicos.

2. Selecione qualquer objeto técnico que você queira adicionar a um indicador local.

Navegue para a guia Indicadores e selecione Criar.

Preencha os detalhes para o código local - considere que a característica, a posição e a categoria são obrigatórias.

O indicador local é agora criado.

Volte para a tela inicial e navegue para o app Administrar conectividade de objeto técnico no grupo Asset Health Monitoring.

Procure e selecione o equipamento para o qual você acabou de adicionar o indicador local e pressione Configurar. Comute o comutador Sincronização IoT. A seleção de gateway é importante se você utilizar os APIs de conectividade de dispositivo SAP IoT, pois isso determinará se o dispositivo está configurado para REST ou MQTT. Se estiver usando as APIs de série cronológica fornecidas pelo SAP APM, permaneça com o "Gateway REST" padrão.

Você pode ver que este código é replicado do "Ponto de medição" de origem em conjunto com o ID do ponto de medição como 93. Agora, o valor do indicador é 76.
Criação de um novo documento de medição no SAP S/4HANA
Vamos tentar modificar o valor em tempo real e ver se os dados fluem para APM em tempo real.
Vá para a transação IK11 do documento de medição e abra o ponto de medição 93


Assim que a configuração estiver concluída, selecione "Sincronizar com IoT", o que sincronizará o objeto técnico APM com SAP IoT. O status de sincronização será alterado de Em andamento para Êxito.
A série cronológica
Após o status Com êxito do objeto técnico na IU APM, os dados de série cronológica podem ser integrados no SAP APM por vários meios:
- Manualmente na ficha de registro Indicadores na página Objeto técnico
- Aproveitando as APIs do SAP APM ou SAP IoT
- Se o indicador não for local, mas sim um ponto de medição integrado do SAP S/4HANA, um documento de medição criaria automaticamente o valor da série cronológica por meio da interface do SAP Event Mesh discutida anteriormente.
Em seguida, veremos os dois primeiros métodos de integração de dados de séries temporais.

Para ilustrar um valor manual, retorne à página Objeto técnico para este equipamento. Selecione o indicador e pressione Adicionar novo valor.

Preencha a página e clique em Salvar. Em seguida, o indicador será atualizado com este valor.


Após algum tempo, o gráfico de Monitorização de indicadores também será atualizado com este valor.
A entrada manual de série cronológica é suficiente em muitos cenários, especialmente quando os dados são coletados manualmente. No entanto, séries temporais são frequentemente geradas por sensores e aqui queremos aproveitar uma API para trazer esses dados para o sistema. Isso mostrará um exemplo de como o uso de um cliente REST, como o Postman, pode trazer dados. No entanto, em um projeto real, uma ferramenta de integração, como o SAP Plant Connectivity ou o SAP Data Intelligence, pode ser usada.
Para utilizar SAP APMs API, você precisará de duas coisas:
- O X-API-KEY que pode ser obtido mediante solicitação por meio de um incidente com a SAP. Isso pode ser feito criando um ticket no componente APM-OPS-SERV com prioridade Média. Forneça os seguintes detalhes:
- Subdomínio de subconta
- ID da subconta
- API de subconta
- ID do e-mail (para enviar a chave)
- A chave de serviço criada ao criar uma instância de serviço na subconta BTP. As APIs são protegidas via oAuth 2.0 e o ID do cliente e a chave secreta do cliente estão contidos na chave de serviço.
Nota - Cada solicitação de API precisaria ter dois cabeçalhos:
- X-API-KEY com a chave API como valor.
- Autorização com portador <token> como valor. O <token> é chamado aproveitando o ID do cliente/chave secreta do cliente/e o URL de autorização da chave de serviço.

![Configuração de cabeçalho de solicitação de API com várias chaves e valores. Notavelmente, existem dois campos destacados: 'X-Auth-Key' com o seu valor ocultado para segurança, e 'Authorization' com um valor 'Bearer [token]', também ocultado. Esses cabeçalhos são críticos para garantir uma comunicação API segura. Configuração de cabeçalho de solicitação de API com várias chaves e valores. Notavelmente, existem dois campos destacados: 'X-Auth-Key' com o seu valor ocultado para segurança, e 'Authorization' com um valor 'Bearer [token]', também ocultado. Esses cabeçalhos são críticos para garantir uma comunicação API segura.](https://learning.sap.com/service/media/topic/ce6e529e-eab3-4fe6-98f6-460225344dea_pt-BR/IAM160_2402_pt-BR_media/IAM160_2402_pt-BR_images/IAM160_2402_U2L5_027.png)
Para criar com êxito dados de série cronológica por meio das APIs do SAP APM, precisamos aproveitar duas APIs.
- API de indicador para chamar os IDs internos do indicador.
- A API de série cronológica para criar os valores de série cronológica.

Para chamar a definição do indicador, faça uma solicitação ao serviço do indicador. Aproveitar o URL de serviço "indicadores" encontrado na chave de serviço APM. Você também pode adicionar uma cadeia de filtro oData para reduzir o conjunto de amostra ao objeto técnico necessário. Uma chamada de exemplo teria o seguinte aspecto:
https://api-apm.prod.apimanagement.us10.hana.ondemand.com/IndicatorService/v1/Indicators?$filter=technicalObject_number eq '217100092'

Criar dados de série cronológica
Em seguida, usamos a API de série cronológica, juntamente com os dados recuperados da API de indicadores para criar dados de série cronológica. Aqui, estamos aproveitando uma API POST para o serviço de série cronológica, em que o payload é o seguinte:
123456789101112131415{
"SSID": "",
"technicalObjectType": "",
"technicalObjectNumber": "\",
"categoryName": ""
"positionID": "",
"values": [
{
"characteristicsInternalId": "\",
"value": "",
"time": "2024-03-01T16:00:00.0000000Z"
}
]
}
Considere que todos os campos, com exceção dos campos 'value' e 'time', são obtidos a partir do resultado do API de indicador. Um exemplo completo de payload teria o seguinte aspecto:
123456789101112131415{
"SSID": "S4HCLNT100",
"technicalObjectType": "EQUI",
"technicalObjectNumber": "217100092",
"categoryName": "M",
"positionID": "24aa638b97194cb8b9d0cf4c2a46eb95",
"values": [
{
"characteristicsInternalId": "53",
"value": "45",
"time": "2024-03-01T16:00:00.0000000Z"
}
]
}
Se tiver êxito, você deve receber uma resposta "201 Criado".


Vídeos de demonstração
Recursos adicionais

APIs de estado de ativos no SAP Business Accelerator Hub
https://api.sap.com/package/SAPAssetPerformanceManagementAssetHealth/overview

Pense em um momento em que você teve que aprender uma nova tecnologia ou processo que estava fora de sua experiência habitual, muito como a integração de dispositivos IoT com o SAP Asset Performance Management. Como você lidou com a curva de aprendizado e quais estratégias ajudaram você a compreender os conceitos e procedimentos?

Resposta do especialista à reflexão pessoal Pergunta:
Enfrentar novas tecnologias, como a integração da IoT com o SAP APM, é um pouco parecido com aprender a nadar. Você começa no fim raso obtendo a pendência do que os dispositivos IoT fazem e como eles conversam uns com os outros usando APIs. É como ficar confortável na água antes de tentar nadar.
Em seguida, você analisa detalhes, aprendendo como esses dispositivos se conectam com o SAP APM. É como nadar voltas praticando os golpes até que se sintam naturais. E assim como os nadadores muitas vezes aprendem melhor com um treinador ou uma equipe, eu descobri que trabalhar através de desafios com os colegas ou compartilhar meu conhecimento fez a bengala de aprendizagem.
Assim, quando falamos em configurar IoT no SAP APM, desde a sincronização do equipamento até o envio de dados, é um processo em que cada etapa se baseia no último. Minhas experiências passadas me lembram de dar um passo a passo, pedir ajuda quando preciso e compartilhar o que aprendo ao longo do caminho. É sobre ser paciente e persistente, e é assim que as peças caem no lugar.
Conclusão
Objetivo: Domine o processo de integração de dados de IoT para objetos técnicos no SAP Asset Performance Management (APM), garantindo que os dados de equipamento do SAP S/4HANA sejam efetivamente sincronizados.
Principais pontos:
- Preparação:
- Confirme se o equipamento do SAP S/4HANA está sincronizado com o SAP APM.
- Acesse a 'Aplicação de objeto técnico do Explorer' em SAP APM.
- Sincronização de objeto técnico:
- Localize o objeto técnico sincronizado do SAP S/4HANA.
- Verifique a frequência do trabalho de sincronização para garantir que o objeto apareça no APM.
- Criação de indicador e sincronização IoT:
- Gerar novos indicadores locais para um objeto técnico.
- Utilize a função 'Sincronizar objetos técnicos - IoT' para ligar objetos técnicos a SAP IoT.
- Configuração da ingestão de dados de IoT:
- Validar status de sincronização com êxito para o objeto técnico e indicadores.
- Utilize a funcionalidade 'Adicionar novo valor' para inserir dados de série cronológica para indicadores de equipamento.
- SAP IoT API Interaction:
- Recuperar tokens JWT utilizando URLs de autenticação APM.
- Utilize URLs de mapeamento de modelo para obter IDs de mapeamento para objetos técnicos.
- Lançar dados de série cronológica em indicadores por meio da API de medição IoT.
- Verificação da integração de dados:
- Após lançar dados, verifique a IU APM para garantir que os valores do indicador refletem as novas entradas.
- Confirme a reflexão de dados no SAP APM para garantir a integração de dados de ponta a ponta.
Resultados: os participantes ganharão a capacidade de integrar e validar dados de IoT no SAP APM, permitindo monitoramento aprimorado e análise de desempenho para objetos técnicos. Isso garante que os dados do equipamento permaneçam atualizados, fornecendo uma visão abrangente da integridade e do desempenho dos ativos.