Conector OpenBOM

Conector OpenBOM

Integrar a Tulip com o OpenBOM usando o conector HTTP da Tulip

Introdução

O OpenBOM é uma tecnologia de gerenciamento de dados e colaboração em tempo real baseada em nuvem que permite gerenciar peças, catálogos, listas de materiais, estoques e pedidos de compra em redes de engenheiros, gerentes de cadeia de suprimentos e fabricantes contratados. O objetivo desse conector é integrar o OpenBOM com a Tulip usando os conectores HTTP da Tulip e fornecer a você um conector OpenBOM pronto para uso que possa ser importado para sua instância.

Objetivo

1. Destacaremos diferentes funções do conector HTTP que podem ser criadas por meio de chamadas HTTP para os endpoints do OpenBOM para obter informações sobre listas técnicas configuradas, catálogos mantidos e informações sobre listas técnicas de ordens de produção liberadas no OpenBOM.
2. Os aplicativos Tulip podem ser criados para personalizar instruções de trabalho para operadores no chão de fábrica que extraem informações sobre ordens de produção, destacando as peças necessárias para que os operadores montem produtos e concluam a ordem de produção no chão de fábrica. Aproveitando os catálogos no OpenBOMs, mostraremos como os gerentes de chão de fábrica podem manter um inventário em tempo real das diferentes peças necessárias para montar o produto no chão de fábrica.

Documento da API

As seguintes funções de conector destacadas neste documento aproveitaram os documentos de API do OpenBOM

Pré-requisitos

1. Crie uma conta no OpenBOM e configure o OpenBOM Catalogs & BOM para o produto a ser montado em seu chão de fábrica.
2. Você precisaria gerar uma chave de API que é usada nos conectores Tulip para fazer conexões com o OpenBOM.
3. Usando a autenticação básica (nome de usuário e senha), obtenha o token de acesso (explicado abaixo) que será passado como um cabeçalho de solicitação em todas as funções do conector.

Detalhes da conexão Tulip

As informações a seguir precisariam ser configuradas no conector HTTP da Tulip.

1. Em execução: host do conector de nuvem
2. Host: developer-api.openbom.com
3. Porta:443
4. TLS: Sim
5. Autenticação: No Auth
6. Cabeçalhos: x-openbom-appkey

Funções do conector

Obtenção de token de acesso

Objetivo

1. Obter o token de acesso que seria usado como um cabeçalho de solicitação em todas as funções subsequentes do conector.
2. O token de acesso expira a cada 24 horas. Depois de executar essa função de conector, o OpenBOM retorna o token de acesso que pode ser armazenado em uma variável Tulip que pode ser usada dinamicamente por todas as funções de conector subsequentes como um cabeçalho de solicitação.

Ponto de extremidade e cabeçalhos

1. Uma chamada POST para o ponto de extremidade: https://developer-api.openbom.com:443/login
2. Cabeçalho da solicitação: x-openbom-appkey
3. Corpo da solicitação: ContentType: JSON nome de usuário e senha como chaves

Extrator de saída necessário

1. Token de acesso - O token de acesso retornado seria usado em todas as funções do subconector.

Obtenção de uma lista de catálogos

Objetivo

1. Esse ponto de extremidade fornece uma lista de catálogos disponíveis no perfil OpenBOM do usuário.
2. A lista pode ser usada para extrair as IDs de catálogo que podem ser usadas para aproveitar catálogos específicos para obter o inventário atual de diferentes materiais e atualizar diferentes propriedades dentro do catálogo em tempo real.

Ponto de extremidade e cabeçalhos

1. Uma chamada GET para o endpoint: https://developer-api.openbom.com:443/catalogs
2. Cabeçalhos de solicitação: x-openbom-appkey, x-openbom-accesstoken

Entrada obrigatória

1. Token de acesso a ser passado por uma variável que é exigida como cabeçalho de solicitação para a chamada HTTP para o endpoint acima.

Extratores de saída obrigatórios

1. CatalogId - Pode ser usado para chamar catálogos específicos de interesse

Obtenção de uma lista de listas técnicas

Finalidade

1. Esse ponto de extremidade fornece uma lista de listas técnicas disponíveis no perfil OpenBOM do usuário.
2. A lista pode ser usada para extrair as IDs ou o nome das listas técnicas que podem ser usados para aproveitar listas técnicas específicas para obter informações sobre diferentes peças necessárias para concluir a montagem de uma unidade no chão de fábrica.

Ponto de extremidade e cabeçalhos

1. Uma chamada GET para o ponto de extremidade: https://developer-api.openbom.com:443/boms
2. Cabeçalhos de solicitação x-openbom-appkey, x-openbom-accesstoken

Entrada obrigatória

1. Token de acesso a ser passado por uma variável que é exigida como cabeçalho de solicitação para a chamada HTTP para o endpoint acima.

Extratores de saída obrigatórios

1. BOMId - Pode ser usado para chamar listas técnicas específicas de interesse
2. Name - Pode ser usado para fazer um POST para chamar uma lista técnica específica, passando a propriedade Name.

Obtenção de lista técnica de ordem de produção

Objetivo

1. Essa função extrai a lista técnica de ordem de produção quando a lista técnica específica para montagem de uma unidade é liberada para produção no OpenBOM.
2. Essa função de conector extrai detalhes importantes (Nome, BOMID, Número de unidades) sobre a ordem de produção que seriam passados dinamicamente para chamar uma ID de lista técnica específica que conterá todas as informações sobre o número total de peças necessárias para que o operador conclua toda a ordem de produção.

Ponto de extremidade e cabeçalhos

1. Uma chamada GET para o ponto de extremidade: https://developer-api.openbom.com:443/orderboms
2. Cabeçalhos de solicitação: x-openbom-appkey, x-openbom-accesstoken

Entrada obrigatória

1. Token de acesso a ser passado por uma variável que é necessária como cabeçalho de solicitação para a chamada HTTP para o ponto de extremidade acima.

Extratores de saída obrigatórios

1. Name - Pode ser usado para obter os detalhes de uma BOM de produção específica, passando o Name para o ponto de extremidade específico da BOM.
2. BOMID - Pode ser usado para obter todos os detalhes de uma BOM de produção específica, passando a ID para o ponto de extremidade específico da BOM.
3. numUnits - Essa propriedade pode ser usada para indicar o número de unidades a serem produzidas no chão de fábrica para uma única ordem de produção.

Obtenção de lista técnica específica

Objetivo

1. Essa função obtém as propriedades de todos os diferentes materiais incluídos em uma lista técnica específica para montar uma unidade.
2. As linhas retornadas pelo OpenBOM podem ser analisadas no Tulip, que é usado para exibir a quantidade de diferentes matérias-primas necessárias para concluir a ordem de produção, além de todas as outras propriedades da lista técnica retornadas pelo OpenBOM, dependendo de como a lista técnica está configurada.

Ponto de extremidade e cabeçalhos

1. Uma chamada GET para o ponto de extremidade: https: //developer-api.openbom.com:443/bom/{bomid}
2. Cabeçalho de solicitação: x-openbom-appkey, x-openbom-accesstoken
3. Parâmetro de URL: {bomid} - Isso será passado como uma entrada.

Entradas necessárias

1. Token de acesso a ser passado por uma variável que é necessária como cabeçalho de solicitação para a chamada HTTP para o ponto de extremidade acima.
2. BOMID - Para obter as informações sobre a lista técnica específica de interesse.

Saídas necessárias

1. Linhas retornadas pelo OpenBOM para uma lista técnica específica que inclui as propriedades de diferentes materiais que fazem parte da lista técnica
2. Os usuários podem analisar detalhes específicos retornados pelo OpenBOM com base no caso de uso.

Obtenção de lista técnica específica por nome

Objetivo

1. Esta função obtém as propriedades de todos os diferentes materiais incluídos em uma lista técnica específica para montar uma unidade, passando o Nome da lista técnica no lugar de um ID.
2. As linhas retornadas pelo OpenBOM podem ser analisadas no Tulip, que é usado para exibir a quantidade de diferentes matérias-primas necessárias para concluir a ordem de produção, além de todas as outras propriedades da lista técnica retornadas pelo OpenBOM, dependendo de como a lista técnica está configurada.

Ponto de extremidade e cabeçalhos

1. Uma chamada POST para o ponto de extremidade: https://developer-api.openbom.com:443/boms/byparams
2. Cabeçalho da solicitação x-openbom-appkey, x-openbom-accesstoken
3. Corpo da solicitação Content-Type:JSON , nome como a chave passada no JSON

Entradas obrigatórias

1. Token de acesso
2. BOM NAME - Passado como o valor para a chave "name" no corpo da solicitação.

Saídas obrigatórias

1. Linhas retornadas pelo OpenBOM para uma lista técnica específica que inclui as propriedades de diferentes materiais que fazem parte da lista técnica
2. Os usuários podem analisar detalhes específicos retornados pelo OpenBOM com base no caso de uso.

Obtenção de catálogo específico

Finalidade

1. Além de várias outras propriedades predefinidas ou personalizadas, o Catalogs no OpenBOM mantém o inventário das peças em mãos que podem ser usadas para exibir/atualizar o inventário em tempo real no Tulip
2. Essa função é usada para obter informações sobre todas as propriedades disponíveis no OpenBOMs Catalogs.

Ponto de extremidade e cabeçalhos

1. Uma chamada GET para o endpoint: https://developer-api.openbom.com:443/bom/{bomid}
2. Cabeçalho da solicitação x-openbom-appkey, x-openbom-accesstoken
3. Parâmetro de URL: {catid} - Será passado como uma entrada.

Entrada obrigatória

1. Token de acesso
2. CATID: Para obter as informações sobre a lista técnica específica de interesse.

Saída obrigatória

1. Dependendo do caso de uso, os usuários podem extrair diferentes propriedades de catálogo retornadas pelo OpenBOM, sendo a Quantity On Hand uma propriedade que pode ser usada para gerenciar o inventário no Tulip e atualizá-lo em tempo real.

Atualização das propriedades do catálogo

Objetivo

1. O Catalog no OpenBOM mantém o inventário das peças em mãos que podem ser usadas para exibir/atualizar o inventário em tempo real dessas peças nos aplicativos Tulip em execução no chão de fábrica.
2. Essa função é usada para atualizar as propriedades do Catalog em tempo real, sendo a Quantity On Hand um exemplo que destaca o inventário de materiais que estão sendo usados para montar o produto no chão de fábrica. Como os materiais estão sendo consumidos em tempo real, podemos aproveitar essa função para atualizar a Quantidade em tempo real à medida que o operador prossegue com a montagem de uma unidade usando o aplicativo de instruções de trabalho no Tulip.

Ponto de extremidade e cabeçalhos

1. Uma chamada POST para o endpoint: https: //developer-api.openbom.com:443/catalog/{catid}/propertyvalue
2. Cabeçalho da solicitação x-openbom-appkey, x-openbom-accesstoken
3. Tipo de conteúdo do corpo da solicitação : JSON
4. São necessárias 4 chaves para serem passadas em um JSON -partNumberPropertyName, partNumber, propertyName, propertyValue

Entrada obrigatória

1. Token de acesso
2. CATID: Parâmetro de URL
3. PartNumberPropertyName: Valor da chave passada no corpo da solicitação
4. PartNumber: Valor da chave passada no corpo da solicitação
5. PropertyName: Valor da chave passada no corpo da solicitação
6. PropertyValue: Valor da chave passada no corpo da solicitação

O OpenBOM retorna um status de 200 com uma resposta bem-sucedida de "Property Updated".

Vídeo

Um pequeno vídeo que explica como você pode usar o OpenBOM com um aplicativo Tulip.