Executando integração personalizada

Objective

After completing this lesson, you will be able to utilizar a API de consulta para acessar efetivamente dados armazenados no SAP Field Service Management Cloud a partir de sistemas externos.

APIs de Field Service Management

Imagem mostrando várias APIs para o SAP Field Service Management

O SAP Field Service Management expõe várias APIs (Application Programming Interfaces) que oferecem várias formas de acessar os dados e as funcionalidades do Field Service Management a partir de sistemas externos. Essas APIs são usadas pelo próprio Field Service Management ou podem ser aproveitadas para suportar integrações e aprimoramentos personalizados.

As APIs FSM fornecidas incluem o seguinte:

  • API de consulta: para consultar dados armazenados no SAP Field Service Management Cloud.
  • API de dados: fornece acesso total aos dados armazenados no SAP Field Service Management Cloud.
  • API em massa: uma extensão da API de dados v4 usada para criar/atualizar e excluir recursos em massa.
  • API de serviço: para criar, atualizar e processar chamadas de serviço e atividades no FSM.
  • API de relatório: fornece recursos de relatório expostos como um conjunto de serviços da Web, com base em um mecanismo Jasper Reports.
  • Melhor API de técnico correspondente: para encontrar automaticamente o melhor técnico correspondente para uma atividade.
  • API de reserva de ocupação de portões: para ajudar a encontrar técnicos e horários de compromisso adequados para atividades.
  • API de reotimização: para reprogramar de forma assíncrona os trabalhos atribuídos de maneira autônoma e otimizada.
  • Crowd Partner API: para convidar subcontratados para se juntarem à plataforma SAP Field Service Management Crowd.
  • Crowd Technician API: para criar e gerenciar os técnicos do Crowd que aceitam atribuições e concluem o trabalho como parte da plataforma SAP Field Service Management Crowd.
  • Crowd Partner Dispatching API: para fazer solicitações de um aplicativo de terceiros para o SAP Field Service Management, para gerenciar atividades atribuídas a um parceiro Crowd.
  • API de acesso: para permitir que os aplicativos obtenham acesso limitado ao SAP Field Service Management.
  • API de usuário: para criar e gerenciar registros de usuários e direitos de acesso do usuário para aplicativos SAP Field Service Management.
  • API SCIM: baseada no System for Cross-domain Identity Management (SCIM), que é um padrão aberto para automatizar a troca de dados do usuário entre diferentes domínios de identidade de usuário.

Todas as APIs FSM utilizam o protocolo HTTP e aplicam o paradigma Representational State Transfer (REST). Uma compreensão básica desses conceitos é necessária para usá-los.

Para consumir as APIs, é recomendável usar uma ferramenta especializada que forneça assistência para testes de API, como Postman ou Insomnia. Como alternativa, uma ferramenta de linha de comando pode ser usada.

Todas as interações são baseadas em solicitações enviadas do sistema client que são depois processadas pelo sistema do servidor (neste caso, FSM). Após o processamento da solicitação, o servidor envia uma resposta com o resultado, por exemplo, o conteúdo do recurso que foi consultado.

As solicitações e respostas contêm recursos que são trocados entre o servidor e o cliente. Um recurso é uma informação que representa uma entidade no contexto da API específica. O cliente pode consultar um recurso no servidor, mas também enviar recursos para criá-los ou atualizá-los no lado do servidor. Em ambos os casos, o servidor incluirá os recursos processados em sua resposta.

A chave para interagir adequadamente com as APIs do FSM Cloud está na composição de solicitações HTTP válidas que podem ser processadas pela API específica. A estrutura de uma requisição HTTP consiste em três partes distintas:

  • Linha de solicitação
  • Campos de cabeçalho
  • Corpo da mensagem

Embora o corpo da mensagem seja específico de cada API, os campos de linha e de cabeçalho da solicitação compartilham várias características comuns na maioria das APIs FSM.

Pergunta do desafio

Desafie-se: Colocando seu conhecimento à prova

Nesta lição, você terá a oportunidade de aplicar os conceitos e conhecimentos adquiridos ao longo da unidade. Projetamos uma Pergunta do Desafio envolvente que colocará suas habilidades de pensamento crítico em ação. Reserve um momento para refletir sobre o que aprendeu e use esse entendimento para criar sua própria solução única para a pergunta em questão.

Para aproveitar ao máximo este exercício, recomendamos que você escreva sua resposta em um pedaço de papel separado. Isso ajudará você a organizar seus pensamentos e medir seu progresso de aprendizagem. Assim que você tiver concluído sua resposta, compare-a com a resposta de especialista fornecida. Isso lhe dará insights valiosos sobre como você entendeu bem o material e onde você pode precisar concentrar sua atenção para um crescimento maior.

Lembre-se, esta é uma oportunidade para aplicar sua compreensão de uma forma prática, por isso não hesite em pensar criativamente e explorar diferentes abordagens. Sua participação ativa nesta lição reforçará seu aprendizado e o preparará para o sucesso no mundo real.

Cenário:

Você é o líder de TI de uma empresa de produção que utiliza sistemas da SAP para suas operações. Recentemente, sua empresa implementou o SAP Field Service Management (FSM) para gerenciamento aprimorado de operações de serviço. Sua tarefa é garantir uma integração sem problemas entre o FSM e seus sistemas de back-end SAP e não SAP existentes.

  1. Escreva um plano sobre como abordar a integração do SAP ECC, SAP S/4HANA (Cloud e On-premise) e do SAP CX Service Cloud com o FSM usando plataformas de integração adequadas.

  2. Determine quais objetos de dados mestre e transacionais seriam mais relevantes para a sua organização replicar no processo de integração.

  3. Descreva como você usaria o conector de nuvem do FSM para integração. Quais são seus componentes e como funcionam?

  4. Explicar o fluxo de dados transacionais por meio do conector FSM e sua configuração.

  5. Descreva sua abordagem para resolver quaisquer erros durante o processo de integração.

Resposta do consultor especialista

  1. Para abordar a integração de vários sistemas da SAP, usaria o conector de nuvem FSM fornecido pela proxy para integrações SAP ECC e SAP S/4HANA. Para o CX Service Cloud, usaria o SAP Cloud Integration (anteriormente CPI).

  2. Os objetos de dados mestre relevantes para integração podem incluir parceiros de negócios, produtos, estoque do produto e empregados. Os dados transacionais podem incluir ordens de serviço, itens de serviço e os esforços, despesas e materiais correspondentes relacionados a cada chamado de serviço.

  3. O FSM Cloud Connector desempenharia um papel vital nessa integração. Seus três componentes, o Business Integrator (um add-on ABAP que fornece os componentes técnicos e a lógica de processo necessários), o Message Broker (executado em um servidor Windows e fornecendo tratamento e conversão de dados entre o Business Integrator e o Transporter) e o Transporter (protegendo o envio de dados entre a SAP e o FSM Cloud HTTPS), seriam configurados e gerenciados para garantir uma transferência de dados sem problemas.

  4. O fluxo padrão de dados transacionais começaria com a replicação de uma ordem de serviço da SAP para o FSM, que inclui atividades e componentes relacionados. A atividade programada e liberada permite o registro de esforços, despesas e consumo de material não planejado no aplicativo móvel offline pelo técnico. A confirmação final de trabalho concluído, esforços de tempo e movimento de mercadorias é criada após a aprovação do diário T&M.

  5. A resolução de erros durante a integração envolveria o monitoramento da seção Erros do conector FSM no portal do administrador. Ele ajuda a identificar problemas ao enviar objetos para terceiros configurados no conector FSM. Em caso de erro, o botão Repetir permite reenviar os dados.

Recapitulação da lição

Nesta lição, nos concentramos em compreender os cenários e procedimentos de integração entre o SAP Field Service Management (FSM) e vários sistemas back-end, o que é crucial para garantir uma comunicação perfeita e uma transferência de dados eficiente.

Os destaques da unidade incluem o seguinte:

  1. Compreensão de diferentes tecnologias de integração: discutimos como diferentes plataformas de integração são usadas dependendo do sistema back-end. Eles incluem FSM Cloud Connector by SAP Partner Proaxia, SAP Integration Suite e SAP B1 Cloud Connector.

  2. Integração de dados mestre e transacionais: explicamos os tipos de dados que essas integrações abrangem, como dados mestre (parceiros de negócios, produtos, estoque) e dados de transação (ordens de serviço, itens, materiais reservados).

  3. FSM Cloud Connector: discutimos o funcionamento do conector de nuvem FSM e suas três partes principais: o integrador de negócios, o corretor de mensagens e o transportador.

  4. Integração com o SAP S/4HANA: Isso abordou como o FSM se integra ao SAP S/4HANA (Cloud e On-Premise) e a replicação de dados entre os dois sistemas.

  5. Integração de dados mestre (MDI): explicamos como a MDI fornece uma representação padronizada e consistente de dados mestre em uma estrutura híbrida, com base no SAP One Domain Model.

  6. Cobertura de integrações padrão: falamos sobre integrações padrão disponíveis com o SAP Commerce Cloud, o SAP Analytics Cloud e o SAP Asset Central.

  7. Uso do conector FSM: a lição discutiu como o conector FSM suporta o fluxo de dados transacionais e a configuração do conector para corresponder aos requisitos empresariais.