¿Cómo configurar la integración de consumos desde ERP v10 a Valuekeep?

¿Cómo configurar la integración de consumos desde ERP v10 a Valuekeep?

Valuekeep está totalmente integrado con ERP v10 para que pueda aprovechar las funcionalidades de ambos productos. Esta integración es bidireccional, es decir, comparten datos y mantienen comunicación entre sí. 

Para ayudarle en la operación, tiene a su disposición algunos ejemplos básicos de integración. 

 

A continuación, se explica la configuración de la integración de los documentos de consumo de material desde ERP v10 a Valuekeep. 

Requisitos previos para la instalación

  1. Disponer de una licencia Valuekeep para el complemento Valuekeep Integrator y ERP v10;
  2. Añadir el módulo VK.Int a la licencia ERP v10.

Configuraciones en Cegid ERP v10

Para configurar los datos a integrar desde ERP v10 en Valuekeep, es necesario crear las listas en ERP v10. Si desea integrar los documentos creados en ERP v10 en Valuekeep, debe crear una lista de los documentos y sus campos correspondientes que desea integrar.

 

En este escenario, en la carpeta del integrador \VKPlugin\SAMPLES\V10LISTS\PRIMAVERA10_VALUEKEEP3 hay dos consultas disponibles para crear las dos listas necesarias. Antes de copiar las listas, debe crear los campos de usuario (CDU) en ERP v10 y los atributos personalizados en Cegid Valuekeep.

 

Crear listas en ERP v10

V10_VK3_CONSUMPTIONS_1

  1. Esta lista proporciona todos los campos necesarios para crear un consumo en Valuekeep y está disponible en la carpetaVKPlugin\SAMPLES\V10LISTS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_1.sql. 
  2. Todos los campos se mapean en el archivo Mapper representado en la configuración por: MappingFile  = VKPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_1.json

V10_VK3_CONSUMPTIONS_3

  1. Esta lista proporciona los campos del tipo Dinero para actualizar en Valuekeep y está disponible en la carpetaVKPlugin\SAMPLES\V10LISTS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_3.sql
  2. Todos los campos se mapean en el archivo Mapper representado en la configuración por: MappingFile = VKPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_3.json

Crear Campos de Usuario

 

En las tablas cabecInternos y linhasInternos (tablas donde está registrada la información de los documentos a integrar) debe crear los siguientes campos de usuario:

CabecInternos

  1. CDU_SourceHash: configurado con el tipo Varchar (100) y visible la false;
  2. CDU_TargetHash: configurado con el tipo Varchar (100) y visible la false;
  3. CDU_IsSync: configurado con el tipo Bit (valor por defecto la false) y visible la false;
  4. CDU_Funcionario: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10;
  5. CDU_OrdemTrabalho: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10.

LinhasInternos

  1. CDU_IdLinhaVK: configurado con el tipo Varchar (100) y visible la false;
  2. CDU_Localizacao: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10;
  3. CDU_Equipamento:  configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10;
  4. CDU_Ferramenta: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10;
  5. CDU_Rota: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10. Es necesario especificar la Ruta y el activo de la ruta en el documento interno;
  6. CDU_SourceHash: configurado con el tipo Varchar (100) y visible la false;
  7. CDU_TargetHash: configurado con el tipo Varchar (100) y visible la false;
  8. CDU_IsSync: configurado con el tipo Bit (valor por defecto la false) y visible la flase.

 

Configuraciones en Valuekeep 

Una vez creados los documentos de consumos, puede modificarlos en ERP v10, puesto que el integrador detecta la modificación de la información a través de los campos que se describen a continuación.

Para añadir los campos, siga estos pasos:

  1. Asegúrese de que los siguientes campos están configurados en la lista de consumos de la orden de trabajo;
  2. Acceda a Trabajo | Explorar Costes | Consumos;
  3. Haga clic en el botón Gestionar Atributos Personalizados;
  4. Añada los atributos relativos al Consumo de la Orden de Trabajo:
    1. SourceHash: configurado con el tipo Texto y visible la false;
    2. TargetHash: configurado con el tipo  Texto y visible la false;
    3. IsSync: configurado con el tipo Booleano y visible la false;
  5. Añada los atributos relativos a la línea del Consumo de la Orden de Trabajo:
    1. ERPIdCabec: corresponde al ID del documento interno de ERP v10, que debe estar configurado con el tipo Texto y visible la false;
    2. ERPIdLinha: corresponde al ID de la línea del consumo del documento interno de ERP v10, que debe estar configurado con el tipo Texto y visible la false;
  6. Acceda a Talleres y Trabajadores | Trabajadores | Mapear Trabajador;
  7. Cree un trabajador (por ejemplo, IMPORTER_0004) y en el nombre de usuario (correo electrónico del usuario) introduzca el siguiente texto: application-user::valuekeep-importer.
  8. Haga clic en Guardar y Nuevo.

El trabajador definido en el paso 7 se encargará de la integración. Así, cada vez que se cree el documento interno en ERP v10, es necesario especificar ese trabajador en los campos de usuario del encabezado. Como alternativa, el nombre del trabajador puede fijarse en el archivo de configuración V10_VK3_CONSUMPTIONS_1.json, por ejemplo: { "Field": "employee", "Handlers": { "Mapping": [  {  "Field": "Default" } ], "DefaultValue": "IMPORTER_0004", "IgnoreOnUpdate": true } } .   

Configuraciones en Valuekeep Integrador 

Una vez realizadas las configuraciones necesarias en ERP v10 y Valuekeep, debe realizar las siguientes configuraciones en el integrador:

Paso 1: Configurar Pipelines

  1. Acceda a la carpeta donde está instalado el integrador y, a continuación, a la carpeta VKPlugin\SAMPLES\CONFIGS;
  2. Abra el archivo VK3_V10_Integration.config;
  3. Copie las pipelines V10_VK3_CONSUMPTIONS_1, V10_VK3_CONSUMPTIONS_2 y V10_VK3_CONSUMPTIONS_3 en el archivo Integration.config en el siguiente orden:
    1. V10_VK3_CONSUMPTIONS_1: contiene la información del encabezado;
    2. VK3_V10_CONSUMPTIONS_2: contiene la información de los detalles;
    3. V10_VK3_CONSUMPTIONS_3: contiene la información información para actualizar los precios.

Las tres pipelines de este ejemplo deben ejecutarse en la secuencia mostrada:

        <Handler Id="h1"  Order="1" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_1"/>

        <Handler Id="h2"  Order="2" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_2"/>

        <Handler Id="h3"  Order="3" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_3"/>   

...    

Y a continuación, los demás pipelines de los documentos internos.

 

Si existen más pipelines relativas a documentos internos, deben ejecutarse todas en el mismo Handler por secuencia, por ejemplo:

 <Pipeline Id="VK3_V10_REPORTS" Scheduler="Default" Active="false" >

      <Handlers>

        <Handler Id="h1"  Order="1" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=VK3_V10_LABORS"/>

        <Handler Id="h2"  Order="2" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_SYNC_MO_INFO"/>

        

        <Handler Id="h3"  Order="3" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=VK3_V10_MISC_COSTS"/>

        <Handler Id="h4"  Order="4" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_SYNC_OC_INFO"/>

        

        <Handler Id="h5"  Order="5" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_1"/>

        <Handler Id="h6"  Order="6" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_2"/>

        <Handler Id="h7"  Order="7" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_3"/>        

        

        <Handler Id="h8"  Order="8" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=VK3_V10_REQUISITIONS"/>

      </Handlers>

    </Pipeline>

 

Paso 2: Configurar Mappers

Debe copiar los archivos sample distribuidos en las siguientes carpetas:

  1.  VKPlugin\SAMPLES\MAPPERS\PRIMAVERA10_VALUEKEEP3 
    1. Copie los archivos V10_VK3_CONSUMPTIONS_1.json yV10_VK3_CONSUMPTIONS_3.json;
    2. Pegue los archivos en la carpeta VKPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP;
    3. Modifique el tipo de documento al utilizado en el ERP.
  2. VKPlugin\SAMPLES\MAPPERS\VALUEKEEP3_PRIMAVERA10
    1. Copie el archivo V10_VK3_CONSUMPTIONS_2.json;
    2. Pegue el archivo en la carpetaVKPlugin\SAMPLES\MAPPERS\VALUEKEEP3_PRIMAVERA10.

Paso 3: Configurar Hashsets

Debe copiar los archivos sample distribuidos en las siguientes carpetas:

  1.  VKPlugin\SAMPLES\HASHSETS\PRIMAVERA10_VALUEKEEP3 
    1. Copie los archivos V10_VK3_CONSUMPTIONS_1.json y V10_VK3_CONSUMPTIONS_3.json;
    2. Pegue los archivos en la carpeta VKPlugin\HASHSETS\PRIMAVERA10_VALUEKEEP
  2. VKPlugin\SAMPLES\HASHSETS\VALUEKEEP3_PRIMAVERA10
    1. Copie el archivo V10_VK3_CONSUMPTIONS_2.json;
    2. Pegue el archivo en la carpetaVKPlugin\SAMPLES\HASHSETS\VALUEKEEP3_PRIMAVERA10.


Los campos que se muestran pueden derivar del tipo de necesidades que se vayan a sincronizar.

      <Handler Id="h1"  Order="1" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_1"/>

      Sincroniza el documento interno con Valuekeep.

      <Handler Id="h2"  Order="2" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_2"/>

      Actualiza el campo Mapper con ERP v10(CDU_IdLinhaVK)

      <Handler Id="h3"  Order="3" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_3"/>   

      Actualiza los costes relativos al documento previamente sincronizado.


    • Related Articles

    • ¿Cómo configurar el Valuekeep Integrator?

      La instalación del Valuekeep Integrator puede realizarse a través de las siguientes opciones: · Portal (link): descargar el instalador del add-on Valuekeep Integrator disponible e instalar; · PRIMAVERA Deployment Center: esta opción solo está ...
    • ¿Cómo descargar el plugin de ERP Primavera V10?

      La instalación del plugin PRIMAVERA V10 – Valuekeep Integratior es realizada a través del PRIMAVERA Deployment Center. Esta opción solo está disponible para clientes que han subscripto el módulo VK.INT – Valuekeep Integrator (ver PRIMAVERA Licensing) ...
    • ¿Cómo obtener el registro de consumos a través de OData?

      Es posible realizar solicitudes Odata en todas las Entidades. En las solicitudes Odata hay que prestar atención a la siguiente sintaxis: $select: expresión que determina qué campos de la solicitud se incluyen en el resultado; $filter: expresión ...
    • ¿Cuál es la arquitectura del Valuekeep-Integrator?

      El plugin VALUEKEEP V3 – Valuekeep Integrator ofrece en su carpeta de instalación: <Install Path>\VKPlugin\SAMPLES\CONFIGS, una solución de integración (VK3_V10_Integration.config) que podrá ser reutilizada como ejemplo base y que podrá ser ...
    • ¿Cómo configurar los Mappers?

      Para optimizar procesos de integración, el plugin ofrece un conjunto de mappers (archivos json) que pueden ser usados en la implementación de servicios de integración. El procedimiento de transformación de datos es definido en la configuración del ...