XML
Como é montado o Hash de Integração
Valores Padrões de Dados de Clientes
Valores campo Observação do Promob no XML de Integração
Integração PromobERP – Integração DefaultERP - TAG Additional Information
Processed By Builder
O atributo Processed by Builder é um atributo de entidade desenvolvido para determinar algumas configurações do item durante a integração Promob x ERP, abaixo será demostrado como deve ser criado esse atributo na biblioteca do Promob e como funciona esse atributo em cada tipo de integração com ERP.
Como criar o atributo nas bibliotecas do Promob
O atributo deve ser criado dentro de atributos de entidade, para isso dentro do Promob Catalog clic em cadastro, em seguida clic em sistemas e selecione a opção atributos.
Após, na janela de atributos acesse opção de atributos > entidade.atributes, deve ser criado dentro da pasta entidade com a seguinte configuração:
ID = PROCESSED_BY_BUILDER
Nome = Processo do Builder
Tipo = Verdadeiro/Falso
Valor padrão = Falso
E nos Check Box devem ser marcadas as seguintes opções:
Editável
Propriedade avançada
Salvar junto ao Projeto
Funcionamento dentro da integração com ERP Promob
Para a integração com o ERP Promob o atributo PROCESSED_BY_BUILDER define o valor da tag Builder no nodo Item do XML.
Quando o valor do atributo aplicado na peça PROCESSED_BY_BUILDER=Verdadeiro a tag recebe Builder=S e se o valor for PROCESSED_BY_BUILDER= Falso é enviado o valor Builder=N, conforme a imagem abaixo:
Com o valor Builder =S o ERP importa o item considerando que toda a engenharia do item está contemplada no XML.
Já se o nodo Builder=N e o item possuir o nodo Tipo_Produto= F (fabricado) o ERP busca no configurador de produto do ERP a engenharia do item indicado.
Funcionamento dentro da integração com ERP Focco
Quando aplicado o valor do atributo Processed_by_Builder = Verdadeiro em uma peça, esse item será gerado no XML de integração com o Focco, conforme o exemplo abaixo:
Logo se aplicado o valor do atributo Processed_by_Builder=”Falso” em uma peça, esse item não será gerado no XML de integração com o Focco, conforme o exemplo abaixo:
Situações que devem ser observadas
Situação 1: Quando for aplicado o atributo Processed_by_Builder=Verdadeiro em um item pai, após for aplicado o atributo novamente em um item filho com o valor Processed_by_Builder=Falso e esse item possuir filhos com o atributo com valor Processed_by_Builder=Verdadeiro, os filhos não serão enviados para o XML.
Sendo necessário que estes itens (filhos) sejam enviados para o XML, o atributo com valor Processed_by_Builder=”Falso” deverá ser alterado para Processed_by_Builder=Verdadeiro e que seja criado uma Característica de integração focco, chamada de “Fantasma” e aplicada no item pai.
Exemplo
Mostrando na prática a situação correta descrita acima:
Caminho do item da biblioteca no Promob Catalog
Disponível a partir das versões:
Plugin Builder 1.11.26 ou superior.
Plugin Builder Budget 1.11.24 ou superior.
Plugin ERP Promob 1.11.10 ou superior.
Plugin ERP Promob Start 1.11.9 ou superior.
Plugin ERP Focco 1.11.11 ou superior.
Objetivo
Busca identificar no XML de integração o caminho da biblioteca de um item.
Funcionalidade
Ao gerar o arquivo de integração, será gerado a tag “CAMINHOITEMCATALOG”, que indicará o caminho do item na biblioteca.
Exemplos
XML Integração ERP
XML Integração Focco
OBSERVAÇÃO: No integrador Focco, esta função só funcionará caso estiver habilitado a função “Exibir informações personalizadas do Promob”.
Mudança no mapeamento dos XLS de Integração
Disponível a partir das versões:
Plugin Builder 1.11.26.0
Promob 5.38.9
Melhorias
1. Os arquivos XLS que antes eram carregados a partir da Biblioteca, agora são carregados a partir da pasta local.
Ou seja, a geração dos arquivos XLS que anteriormente era feita dentro da Biblioteca, na pasta System
“C\...\Promob Studio Start Labs \System\Budget\Layouts\Listing”
Passa a ser feita na pasta local
“C:\...\ ProgramData\Procad\Promob Studio Start Labs\Budget\Layouts\Listing”;
Exemplo:
O que acontecia anteriormente no seguinte diretório:
“C:\...\ Promob Studio Start Labs\Biblioteca\System\Budget\Layouts\Listing\Fabrica.xsl”
Agora passa a ser carregado para:
“C:\ProgramData\Procad\Promob Studio Start Labs\Budget\Layouts\Listing\Fabrica.xsl”
2. BuilderSteps
O arquivo BuilderSteps.steps, que anteriormente encontrava-se no diretório:
“Biblioteca do Cliente\System\budget\Steps”
Passou a ser carregado dinamicamente, sem depender do arquivo, ou seja, caso o arquivo exista neste diretório, o mesmo é ignorado pelo Builder.
2.1. Arquivos budget dos Integradores
Os seguintes arquivos:
MCMBudget.budget;
FoccoBudget.budget;
WPSBudget.budget;
PromobERPStartBudget.budget.
Que anteriormente encontravam-se em “C:\...\Biblioteca do Cliente\System\budget” passaram a ser carregados direto das dlls dos respectivos plugins de integração, desta forma, não é mais necessário que estejam neste diretório para serem carregados.
Informações para geração de hash de integração
O Hash de integração é um valor calculado a partir de diversas informações de uma peça. Para calcular esse valor são levadas em conta as seguintes informações:
Altura;
Largura;
Profundidade;
Referencia (Complete);
Quantidade;
Atributos da entidade (BANCO_DADOS);
Id do Material;
Direção do material;
Ponto 3D do Shape
Operações da peça;
Structures da peça;
IMPORTANTE: Caso o item tiver agregados, será gerado um novo hash levando em conta os agregados.
Criação do atributo ID_MÓDULO
Disponível a partir das versões:
Plugin Builder Budget 1.11.23 ou superior.
Plugin ERP Promob 1.11.9 ou superior.
Plugin ERP Promob Start 1.11.8 ou superior.
Objetivo
Busca identificar no XML de integração qual o módulo pai de uma entidade.
Funcionalidade
No XML de integração ERP e ERP Start, foi adicionado o atributo ID_MODULO que possui a funcionalidade de informar o ID_PROMOB da peça que o compõem.
OBSERVAÇÃO: Caso o módulo não tiver pai, esse não terá o atributo ID_MODULO.
Exemplo:
Na imagem acima existem dois módulos no ambiente, sendo eles com os ID_PROMOB “131” e “63”.
No XML dos filhos desses módulos, por exemplo ID=”com_cos_tra_tra”, terá o atributo ID_MODULO com o valor do pai, que nesse caso é ID_MODULO=”63”.
TAG Builder
A Tag Builder dentro do XML de integração com o ERP Promob funciona de duas maneiras:
Ao inserir qualquer operação na aba builder de um item com geometria automaticamente no momento da geração dos arquivos de XML a TAG Builder sairá com o valor igual a "S".
Funcionamento dentro da integração com ERP Promob
Ao inserir o atributo PROCESSED_BY_BUILDER também é definido o valor da tag Builder no nodo Item do XML. Quando o valor do atributo aplicado na peça PROCESSED_BY_BUILDER=Verdadeiro a tag recebe Builder=“S” e se o valor for PROCESSED_BY_BUILDER=”Falso” é enviado o valor Builder=“N”, conforme a imagem abaixo:
Com o valor Builder=“S” o ERP importa o item considerando que toda a engenharia do item está contemplada no XML. Já se o nodo Builder=“N” e o item possuir o nodo Tipo_Produto=“F” (fabricado) o ERP busca no configurador de produto do ERP a engenharia do item indicado.
Padrões de valores em dados dos clientes para saírem no XML de Integração
Disponível a partir da versão:
Plugin ERP Promob – 1.12.5.0 ou superior
Plugin ERP Promob Start – 1.12.4.0 ou superior
Busca definir os padrões de valores inseridos nos dados de cliente que sairão no XML de integração.
Para que saia no XML de integração (ERP e ERP_Start) as informações de dados dos clientes, os padrões são (valor da tag name no html):
1. Informações da loja
Todos esses campos preenchidos serão apresentados no nodo Dados_Cliente no campo LOJA do arquivo XML de integração.
2. Informações do cliente
Todos esses campos preenchidos serão apresentados no nodo Dados_Cliente no campo CLIENTE_LOJA do arquivo XML de integração.
Na tela é exibida conforme abaixo:
Valores campo Observação do Promob no XML de Integração
Disponível a partir da versão:
Plugin Builder: 1.60.0.21
Plugin ERP Standard: 1.60.0.8
Plugin ERP Promob: 1.60.0.10
Plugin ERP Promob Start: 1.60.0.11
A partir da versão 1.60.0.21 do Builder, ao preencher o campo Observação dentro do Promob, o valor informado é exibido no XML de integração. Conforme exemplos abaixo:
Atributos do XML de Integração
IDCATEGORY
O atributo IDCATEGORY, é utilizado para identificar o identificador da categoria ao qual o item pertence.
Abaixo, um exemplo de XML com atributo IDCATEGORY aplicado ao item:
UNIT
O atributo UNIT, é utilizado para identificar o tipo de unidade de medida se encontra a quantidade do item. Abaixo, um exemplo de XML com atributo UNIT aplicado ao item:
REDEFINITION
O atributo REDEFINITION, é utilizado para identificar em itens com redefinição de margem a margem redefinida na biblioteca.
Abaixo, um exemplo de XML com atributo REDEFINITION aplicado ao item:
REPETITION
O atributo REPETITION, é utilizado para identificar a repetição de um determinado item no ambiente. Para bibliotecas com Builder, esse valor é sempre 1.
Abaixo, um exemplo de XML com atributo REPETITION aplicado ao item:
IDPRICEPROVIDER
O atributo IDPRICEPROVIDER, é utilizado para identificar o identificador do provedor de preços, normalmente não possui valor quando há um único provedor, nesse caso o Price.
Abaixo, um exemplo de XML com atributo IDPRICEPROVIDER aplicado ao item:
PRICE
O atributo PRICE, é utilizado para busca dos preços online através da referência contida no atributo (normalmente é apresentada pela referência COMPLETE).
Abaixo, um exemplo de XML com atributo PRICE aplicado ao item:
Tags disponíveis a partir da versão Builder 1.60.20.4:
FILECREATION
Informa a data e a hora que o arquivo foi gerado.
ASSISTANCEORDER
Informa se é um projeto de Assistência Técnica.
Roteiro Produtivo
O roteiro de produto orienta a execução do processo produtivo por meio da exibição sequencial das operações que devem ser realizadas.
A partir da versão 1.60.51.0 do Builder, o XML do roteiro de produto passa a apresentar duas novas tags para identificação dos preços:
UNIT_PRICE: informa o preço unitário de cada item, considerando a quantidade indicada na tag QUANTIDADE.
TOTAL_PRICE: informa o preço total da operação, obtido pela multiplicação da QUANTIDADE pelo UNIT_PRICE.
Exemplo:
QUANTIDADE: 2.06
UNIT_PRICE: 1.68
TOTAL_PRICE: 3.46
O cálculo é realizado da seguinte forma:
QUANTIDADE x UNIT_PRICE = TOTAL_PRICE
2.06 x 1.68 = 3.46