XML
Cómo se construye el Hash de Integración
Valores Predeterminados de Datos de Clientes
Valores campo Observación de Promob en el XML de Integración
Integración PromobERP – Integración DefaultERP - ETIQUETA Información Adicional
Procesado por Builder
El atributo Procesado por Builder es un atributo de entidad desarrollado para determinar algunas configuraciones del ítem durante la integración Promob x ERP, a continuación se mostrará cómo debe crearse 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 crearse dentro de atributos de entidad, para ello dentro de Promob Catalog haga clic en registro, luego haga clic en sistemas y seleccione la opción atributos.
Después, en la ventana de atributos acceda a la opción de atributos > entidad.atributos, debe crearse dentro de la carpeta entidad con la siguiente configuración:
ID = PROCESSED_BY_BUILDER
Nombre = Proceso del Builder
Tipo = Verdadero/Falso
Valor predeterminado = Falso
Y en los Check Box deben marcarse las siguientes opciones:
Editable
Propiedad avanzada
Guardar junto al Proyecto
Funcionamiento dentro de la integración con ERP Promob
Para la integración con el ERP Promob el atributo PROCESSED_BY_BUILDER define el valor de la etiqueta Builder en el nodo Ítem del XML.
Cuando el valor del atributo aplicado en la pieza PROCESSED_BY_BUILDER=Verdadero la etiqueta recibe Builder=S y si el valor es PROCESSED_BY_BUILDER= Falso se envía el valor Builder=N, conforme la imagen a continuación:
Con el valor Builder =S el ERP importa el ítem considerando que toda la ingeniería del ítem está contemplada en el XML.
Si el nodo Builder=N y el ítem posee el nodo Tipo_Producto= F (fabricado) el ERP busca en el configurador de producto del ERP la ingeniería del ítem indicado.
Funcionamiento dentro de la integración con ERP Focco
Cuando se aplica el valor del atributo Processed_by_Builder = Verdadero en una pieza, este ítem será generado en el XML de integración con Focco, conforme el ejemplo a continuación:
Por lo tanto, si se aplica el valor del atributo Processed_by_Builder=”Falso” en una pieza, este ítem no será generado en el XML de integración con Focco, conforme el ejemplo a continuación:
Situaciones que deben observarse
Situación 1: Cuando se aplica el atributo Processed_by_Builder=Verdadero en un ítem padre, luego se aplica el atributo nuevamente en un ítem hijo con el valor Processed_by_Builder=Falso y este ítem posee hijos con el atributo con valor Processed_by_Builder=Verdadero, los hijos no serán enviados al XML.
Si es necesario que estos ítems (hijos) sean enviados al XML, el atributo con valor Processed_by_Builder=”Falso” deberá ser cambiado a Processed_by_Builder=Verdadero y se debe crear una Característica de integración focco, llamada “Fantasma” y aplicada en el ítem padre.
Ejemplo
Mostrando en la práctica la situación correcta descrita arriba:
Ruta del ítem de la biblioteca en Promob Catalog
Disponible a partir de las versiones:
Plugin Builder 1.11.26 o superior.
Plugin Builder Budget 1.11.24 o superior.
Plugin ERP Promob 1.11.10 o superior.
Plugin ERP Promob Start 1.11.9 o superior.
Plugin ERP Focco 1.11.11 o superior.
Objetivo
Busca identificar en el XML de integración la ruta de la biblioteca de un ítem.
Funcionalidad
Al generar el archivo de integración, se generará la etiqueta “CAMINHOITEMCATALOG”, que indicará la ruta del ítem en la biblioteca.
Ejemplos
XML Integración ERP
XML Integración Focco
OBSERVACIÓN: En el integrador Focco, esta función solo funcionará si está habilitada la función “Mostrar información personalizada de Promob”.
Cambio en el mapeo de los XLS de Integración
Disponible a partir de las versiones:
Plugin Builder 1.11.26.0
Promob 5.38.9
Mejoras
1. Los archivos XLS que antes se cargaban desde la Biblioteca, ahora se cargan desde la carpeta local.
Es decir, la generación de los archivos XLS que anteriormente se hacía dentro de la Biblioteca, en la carpeta System
“C\...\Promob Studio Start Labs \System\Budget\Layouts\Listing”
Pasa a hacerse en la carpeta local
“C:\...\ ProgramData\Procad\Promob Studio Start Labs\Budget\Layouts\Listing”;
Ejemplo:
Lo que ocurría anteriormente en el siguiente directorio:
“C:\...\ Promob Studio Start Labs\Biblioteca\System\Budget\Layouts\Listing\Fabrica.xsl”
Ahora pasa a cargarse en:
“C:\ProgramData\Procad\Promob Studio Start Labs\Budget\Layouts\Listing\Fabrica.xsl”
2. BuilderSteps
El archivo BuilderSteps.steps, que anteriormente se encontraba en el directorio:
“Biblioteca del Cliente\System\budget\Steps”
Pasó a cargarse dinámicamente, sin depender del archivo, es decir, si el archivo existe en este directorio, el mismo es ignorado por Builder.
2.1. Archivos budget de los Integradores
Los siguientes archivos:
MCMBudget.budget;
FoccoBudget.budget;
WPSBudget.budget;
PromobERPStartBudget.budget.
Que anteriormente se encontraban en “C:\...\Biblioteca del Cliente\System\budget” pasaron a cargarse directamente de las dlls de los respectivos plugins de integración, de esta forma, ya no es necesario que estén en este directorio para ser cargados.
Información para generación de hash de integración
El Hash de integración es un valor calculado a partir de diversas informaciones de una pieza. Para calcular este valor se toman en cuenta las siguientes informaciones:
Altura;
Ancho;
Profundidad;
Referencia (Completa);
Cantidad;
Atributos de la entidad (BASE DE DATOS);
Id del Material;
Dirección del material;
Punto 3D del Shape
Operaciones de la pieza;
Estructuras de la pieza;
IMPORTANTE: Si el ítem tiene agregados, se generará un nuevo hash teniendo en cuenta los agregados.
Creación del atributo ID_MÓDULO
Disponible a partir de las versiones:
Plugin Builder Budget 1.11.23 o superior.
Plugin ERP Promob 1.11.9 o superior.
Plugin ERP Promob Start 1.11.8 o superior.
Objetivo
Busca identificar en el XML de integración cuál es el módulo padre de una entidad.
Funcionalidad
En el XML de integración ERP y ERP Start, se añadió el atributo ID_MODULO que tiene la función de informar el ID_PROMOB de la pieza que lo compone.
OBSERVACIÓN: Si el módulo no tiene padre, este no tendrá el atributo ID_MODULO.
Ejemplo:
En la imagen anterior hay dos módulos en el ambiente, con los ID_PROMOB “131” y “63”.
En el XML de los hijos de estos módulos, por ejemplo ID=”com_cos_tra_tra”, tendrá el atributo ID_MODULO con el valor del padre, que en este caso es ID_MODULO=”63”.
ETIQUETA Builder
La etiqueta Builder dentro del XML de integración con el ERP Promob funciona de dos maneras:
Al insertar cualquier operación en la pestaña builder de un ítem con geometría automáticamente en el momento de la generación de los archivos XML la ETIQUETA Builder saldrá con el valor igual a "S".
Funcionamiento dentro de la integración con ERP Promob
Al insertar el atributo PROCESSED_BY_BUILDER también se define el valor de la etiqueta Builder en el nodo Ítem del XML. Cuando el valor del atributo aplicado en la pieza PROCESSED_BY_BUILDER=Verdadero la etiqueta recibe Builder=“S” y si el valor es PROCESSED_BY_BUILDER=”Falso” se envía el valor Builder=“N”, conforme la imagen a continuación:
Con el valor Builder=“S” el ERP importa el ítem considerando que toda la ingeniería del ítem está contemplada en el XML. Si el nodo Builder=“N” y el ítem posee el nodo Tipo_Producto=“F” (fabricado) el ERP busca en el configurador de producto del ERP la ingeniería del ítem indicado.
Valores predeterminados en datos de clientes para salir en el XML de Integración
Disponible a partir de la versión:
Plugin ERP Promob – 1.12.5.0 o superior
Plugin ERP Promob Start – 1.12.4.0 o superior
Busca definir los valores predeterminados insertados en los datos de cliente que saldrán en el XML de integración.
Para que salga en el XML de integración (ERP y ERP_Start) la información de datos de los clientes, los predeterminados son (valor de la etiqueta name en el html):
1. Información de la tienda
Todos estos campos llenados se presentarán en el nodo Datos_Cliente en el campo TIENDA del archivo XML de integración.
2. Información del cliente
Todos estos campos llenados se presentarán en el nodo Datos_Cliente en el campo CLIENTE_TIENDA del archivo XML de integración.
En la pantalla se muestra como a continuación:
Valores campo Observación de Promob en el XML de Integración
Disponible a partir de la versión:
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 de la versión 1.60.0.21 del Builder, al llenar el campo Observación dentro de Promob, el valor informado se muestra en el XML de integración. Conforme los ejemplos a continuación:
Atributos del XML de Integración
IDCATEGORY
El atributo IDCATEGORY, se utiliza para identificar el identificador de la categoría a la que pertenece el ítem.
A continuación, un ejemplo de XML con atributo IDCATEGORY aplicado al ítem:
UNIT
El atributo UNIT, se utiliza para identificar el tipo de unidad de medida en que se encuentra la cantidad del ítem. A continuación, un ejemplo de XML con atributo UNIT aplicado al ítem:
REDEFINITION
El atributo REDEFINITION, se utiliza para identificar en ítems con redefinición de margen el margen redefinido en la biblioteca.
A continuación, un ejemplo de XML con atributo REDEFINITION aplicado al ítem:
REPETITION
El atributo REPETITION, se utiliza para identificar la repetición de un determinado ítem en el ambiente. Para bibliotecas con Builder, este valor es siempre 1.
A continuación, un ejemplo de XML con atributo REPETITION aplicado al ítem:
IDPRICEPROVIDER
El atributo IDPRICEPROVIDER, se utiliza para identificar el identificador del proveedor de precios, normalmente no posee valor cuando hay un único proveedor, en este caso el Price.
A continuación, un ejemplo de XML con atributo IDPRICEPROVIDER aplicado al ítem:
PRICE
El atributo PRICE, se utiliza para la búsqueda de precios en línea a través de la referencia contenida en el atributo (normalmente se presenta por la referencia COMPLETE).
A continuación, un ejemplo de XML con atributo PRICE aplicado al ítem:
Etiquetas disponibles a partir de la versión Builder 1.60.20.4:
FILECREATION
Informa la fecha y hora en que el archivo fue generado.
ASSISTANCEORDER
Informa si es un proyecto de Asistencia Técnica.