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
El atributo Procesado por Builder es un atributo de entidad desarrollado para determinar algunas configuraciones de elementos durante la integración de Promob x ERP. A continuación demostraremos cómo se debe crear este atributo en la biblioteca de Promob y cómo funciona este atributo en cada tipo de integración con ERP.
Cómo crear el atributo en las bibliotecas de Promob
El atributo debe ser creado dentro de atributos de entidad, para hacer esto dentro de Promob Catalog haga clic en registro, luego haga clic en sistemas y seleccione la opción atributos.
Luego, en la ventana de atributos, acceda a la opción Atributos - entity.attributes, que debe ser creada dentro de la carpeta Entidad con la siguiente configuración:
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 será 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
Objetivo
Busca definir os padrões de valores inseridos nos dados de cliente que sairão no XML de integração
Funcionalidade
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.
Ficando da seguinte maneira:
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 XML de integración
IDCATEGORY
El atributo IDCATEGORY se utiliza para identificar el identificador de la categoría a la que pertenece el elemento.
A continuación se muestra un ejemplo de XML con el atributo IDCATEGORY aplicado al artículo:
UNIT
El atributo UNIT se utiliza para identificar el tipo de unidad de medida de la cantidad del artículo. A continuación se muestra un ejemplo de XML con el atributo UNIT aplicado al artículo:
REDEFINITION
El atributo REDEFINITION se utiliza para identificar el margen redefinido en la biblioteca en los elementos con redefinición de márgenes.
A continuación se muestra un ejemplo de XML con el atributo REDEFINITION aplicado al elemento:
REPETITION
El atributo REPETITION se utiliza para identificar la repetición de un elemento concreto en el entorno.
Para las bibliotecas con Builder, este valor es siempre 1.
A continuación se muestra un ejemplo de XML con el atributo REPETITION aplicado al elemento:
IDPRICEPROVIDER
El atributo IDPRICEPROVIDER se utiliza para identificar el identificador del proveedor de precios, normalmente no tiene valor cuando sólo hay un proveedor, en este caso Price.
A continuación se muestra un ejemplo de XML con el atributo IDPRICEPROVIDER aplicado al artículo:
PRICE
El atributo PRICE se utiliza para buscar precios en línea utilizando la referencia contenida en el atributo (normalmente se presenta mediante la referencia COMPLETE).
A continuación se muestra un ejemplo de XML con el atributo PRICE aplicado al artículo:
Etiquetas disponibles a partir de la versión 1.60.20.4 del Builder:
FILECREATION
Introduzca la fecha y hora en que se generó el archivo.
ASSISTANCEORDER
Informar si se trata de un proyecto de Asistencia Técnica.