O Orien tem a capacidade de puxar do SAP dados de uma instância do SAP através de APIs. Atualmente, Orien pode receber cargas úteis do JSON de:
- Locais funcionais de SAP
- Equipamento SAP
- Material SAP
- Centros de trabalho SAP
- Pontos de medição SAP
- Documentos de medição SAP
- Manutenção planejada finalizada SAP
Abaixo terá um guia de como visualizar e usar os dados do SAP no Orien. A Integração SAP ao Orien necessita de uma chave de Serviço Próprio do Orien API válida, não expirada para passar da estrutura de cargas úteis JSON. Para mais detalhes, verique os documentos de API para Orien em Documentação API Self-Service.
Para mais informações sobre rotas de API Orien e funcionalidades, verifique os documentos de Swagger para Orien aqui: Documentação Swagger.
Esse processo irá utilizar Hierarquia externa do Orien e funcionalidades. Para ajuda usando a Hierarquia externa, use este artigo: Hierarquia Externa.
Se você ainda tem perguntas sobre o processo ou deseja saber mais como inicializar dados SAP no Orien, entre em contato com o suporte em: support@orien.zendesk.com
Configuração Ponto Final SAP
Ponto final do SAP pode ser configurado para cada base de dados e é configurada pelo TI Orien e precisa ser feito antes desse passo. Para qualquer dúvida ou ajuda, por favor contato o suporte Orien em: support@orien.zendesk.com. Para visualizar Configuração de ponto final SAP, selecione o módulo de Configuração SAP no nível da base de dados.
Quando selecionado, você será capaz de configurar Ponto final para os dados/base de dados daquele cliente específico. As propriedades e valores para cada para cada uma das configurações desses pontos finais estão listadas abaixo.
Quando um ponto final (endpoint) SAP é selecionado, várias propriedades podem ser atribuídas para configurar o ponto (ex: limte de página, critérios, descrição AA, tipo URL, Ponto final de integração) e o tipo de planta (ex: planta de material, planta de planejamento, planta de manutenção) são requeridas para cada configuração de ponto final.
Rotas de SAP API
Para as rotas abaixo, você precisará anexar o URL base de sua instância do Orien e anexar o código da empresa atribuído a sua instância. Expanda as rotas para visualizar uma carga útil de amostra. Um exemplo será: Lorem.orien.app/api/ss/v1/integration-change/sap-functional-location/. Essas rotas receberão cargas JSON do seguintes dados:
Ordem de Inicializações
As inicializações devem ser feita sem um processo geral, pois alguns dos objetos técnicos possuem pré-requisitos ( ex: Equipamento est´aalocado a um FLOC). Recomendamos inicializações serem feitas na seguinte ordem:
- Local funcional SAP
- Equipamento SAP
- Material SAP
- Centro de trabalho SAP
- Pontos de medição SAP
- Manutenção programada finalizada SAP
Referência de Objetos SAP
A referência de objetos SAP serve para especificar o dado que é recebido pelo SAP. Isso é util quando o dado SAP é usado para múltiplas base de dados. Cada um desses objetos usam o campo de Código como um parâmetro com um campo de descrição opcional. A tabela abaixo é um exemplo de quais valores são esperados.
| ERROR MESSAGE | DESCRIPTION | RESOLUTION |
|---|---|---|
| Catalogue Profile | {Catalogue Profile Name} | |
| Construction Type | 000000000020009999 | |
| Functional Location Category | Technical system - standard | W |
| Object Type | DIST | |
| Planner Group | A99 | |
| Plant | Plant Name | {Plant Code} |
Incluso a Ref de objetos SAP estão os Centros de trabalho SAP. Centros de trabalho tem opção de criar, editar, e deletar nessa guia.
| WORK CENTRE FIELD | SAMPLE VALUE | |
|---|---|---|
| Description (STEXT) | Mechanic | |
| Plant (WERKS) | A999 | |
| Category (VERWE) | AAA | |
| USAGE (PLANV) | 001 | |
| Control Key (STEUS) | PMAA | |
| Indicator Control Key is Referenced (STEUS_REF) | ||
| Capacity Category (KAPART) | ||
| Capacity Planner Group (PLANR) | PM | |
| Base Unit of Measurement | H | |
| Capacity utilisation (NGRAD) | 100 | |
| Cost Center (KOSTL) | 0400690139 | |
| Cost Per Unit/Rate | ||
| Currency Key | ||
| System Status | ||
| Code(ARBPL) | AA1AA111 | |
| Notes | ||
Registro de Sincronização de Dados
Através do processo de inicialização, as acções chave do processo serão registradas e disponíveis no módulo de Sincronização de dados. O módulo irá mostrar o histórico de processos completos na base de dados selecionada. Abaixo está um exemplo da tela de Sincronização de dados que possui vários processos passados.
Quando ‘’Visualizar mensagens’’ é selecionado, o processo foi separado em todas as mensagens de sua sessão. Isso ajuda a identificar qual estágio está a sincronização de dados ou se acorreu alguem erro. Abaixo está um exemplo de mensagens que são recebidas por um processo de Pontos de medição SAP finalizado:
Agendadores Delta
Para receber Deltas (atualizações) do SAP para dados existentes dentro de uma hierarquia externa, o agendador precisará ser configurado para cada base de dados e cada tipo de integração (FLOC, Equipamento, Material etc). Para o guia de como configurar agendadores, revise este artigo: Orien Programador.
Quanto estiver criando um agendador para puxar Deltas para o Orien, esses são os campos requeridos:
| PROPERTY | TYPE | SOURCE |
|---|---|---|
| Description | String | Manual Input |
| Type | Collection | Static Orien Field - Must use 'Apply Integration Changes' |
| Schedule Interval (days) | Integer | Manual Input |
| Hour of the Day (0 to 23) | Integer | Manual Input |
| Disabled | Boolean | Manual Input |
| Next Due date | Date | Manual Input |
| Integration Type | Collection | Static Orien Field |
| Integration Server | Collection | Static Orien Field |
| Plant | Collection | User-defined Ref Object in SAP Config |
| API Key | String | Manual Input |
Junto aos Agendadores Delta, um agendador de verificação de tempo limite de integração deve ser aplicado a cada banco de dados integrado e executado pelo menos uma vez por semana.
Nota
Deltas deve ser executados diariamente. Dados Delta só são armazenados no sistema por 7 dias.
Uma vez que os Agendadores estão configurados, parecerá com isso: