Como configurar a integração de consumos do ERP v10 para o Valuekeep?

Como configurar a integração de consumos do ERP v10 para o Valuekeep?


O Valuekeep está totalmente integrado com o ERP v10 para que possa usufruir das funcionalidades dos dois produtos. Esta integração é biderecional, ou seja, partilham dados e mantém a comunicação entre si. 
Para auxiliar na operação, estão disponíveis de base alguns exemplos de integração. 

De seguida, é explicada a configuração da integração dos documentos de consumo de material do ERP v10 para o Valuekeep. 

Pré requisitos da instalação

  1. Possuir a licença do Valuekeep para o add on Valuekeep Integrador e ERP v10;
  2. Adicionar o modulo VK.Int à licença do ERP v10.

Configurações no Cegid ERP v10

Para configurar os dados a integrar do ERP v10 para o Valuekeep, é necessário criar as listas no ERP v10. Se pretender integrar os documentos criados no ERP v10 para o Valuekeep, deve criar uma lista com os documentos e respetivos campos que pretende que sejam integrados.

Neste cenário, na pasta do integrador \VKPlugin\SAMPLES\V10LISTS\PRIMAVERA10_VALUEKEEP3 estão disponíveis duas queries para criar as duas listas necessárias. Antes de copiar as listas, deve criar os campos de utilizador (CDU) no ERP v10 e os atributos personalizados no Cegid Valuekeep.

Criar listas no ERP v10
V10_VK3_CONSUMPTIONS_1
  1. Esta lista permite obter todos os campos necessários para a criação de um consumo no Valuekeep e está disponível na pasta VKPlugin\SAMPLES\V10LISTS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_1.sql. 
  2. Todos os campos são mapeados no ficheiro Mapper representado na configuração por: MappingFile  = VKPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_1.json
V10_VK3_CONSUMPTIONS_3
  1. Esta lista permite obter os campos do tipo Dinheiro para atualizar no Valuekeep e está disponível na pasta VKPlugin\SAMPLES\V10LISTS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_3.sql
  2. Todos os campos são mapeados no ficheiro Mapper representado na configuração por: MappingFile = VKPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_3.json
Criar Campos de Utilizador

Nas tabelas cabecInternos e linhasInternos (tabelas onde está registada a informação dos documentos a integrar) deve criar os seguintes campos de utilizador:
CabecInternos
  1. CDU_SourceHash: configurado com o tipo Varchar (100) e visível a false;
  2. CDU_TargetHash: configurado com o tipo Varchar (100) e visível a false;
  3. CDU_IsSync: configurado com o tipo Bit (valor por defeito a false) e visível a false;
  4. CDU_Funcionario: configurado com o tipo Varchar (100) e visível a true para o preenchimento manual no ERP v10;
  5. CDU_OrdemTrabalho: configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10.
LinhasInternos
  1. CDU_IdLinhaVK: configurado com o tipo Varchar (100) e visível a false;
  2. CDU_Localizacao: configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10;
  3. CDU_Equipamento:  configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10;
  4. CDU_Ferramenta: configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10;
  5. CDU_Rota: configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10. É necessário indicar a Rota e o ativo da rota no documento interno;
  6. CDU_SourceHash: configurado com o tipo Varchar (100) e visível a false;
  7. CDU_TargetHash: configurado com o tipo Varchar (100) e visível a false;
  8. CDU_IsSync: configurado com o tipo Bit (valor por defeito a false) e visível a false.

Configurações no Valuekeep 

Após criar documentos de consumos, poderá alterá-los no ERP v10, dado que o integrador deteta a alteração da informação através dos campos descritos abaixo.
Para adicionar os campos, siga os seguintes passos:
  1. Garanta que os seguintes campos estão configurados na lista consumos da ordem de trabalho;
  2. Aceda a Trabalho | Explorar Custos | Consumos;
  3. Clique no botão Gerir Atributos Personalizados;
  4. Adicione os atributos relativos ao Consumo da Ordem de Trabalho:
    1. SourceHash: configurado com o tipo Texto e visível a false;
    2. TargetHash: configurado com o tipo Texto e visível a false;
    3. IsSync: configurado com o tipo Booleano e visível a false;
  5. Adicione os atributos relativo à linha do Consumo da Ordem de Trabalho:
    1. ERPIdCabec: corresponde ao ID do documento interno do ERP v10, que deve estar configurado com o tipo Texto e visível a false;
    2. ERPIdLinha: corresponde ao ID da linha do consumo do documento interno do ERP v10, que deve estar configurado com o tipo Texto e visível a false;
  6. Aceda a Oficinas e Funcionários | Funcionários | Mapear Funcionário;
  7. Crie um funcionário (por exemplo IMPORTER_0004) e no nome de utilizador (email do utilizador) insira o seguinte texto: application-user::valuekeep-importer.
  8. Clique em Guardar e Novo.
O funcionário definido no passo 7 será responsável pela integração. Assim, sempre for criado o documento interno no ERP v10, é necessário indicar esse funcionário no campos de utilizador do cabeçalho. Alternativamente, o nome do funcionário pode estar fixo no ficheiro de configuração V10_VK3_CONSUMPTIONS_1.json, como por exemplo: { "Field": "employee", "Handlers": { "Mapping": [  {  "Field": "Default" } ], "DefaultValue": "IMPORTER_0004", "IgnoreOnUpdate": true } } .   

Configurações no Valuekeep Integrador 

Após efetuar as configurações necessárias no ERP v10 e no Valuekeep, deve efetuar as seguintes configurações no integrador:
Passo 1: Configurar Pipelines
  1. Aceda à pasta onde está instalado o integrador e, de seguida, à pasta VKPlugin\SAMPLES\CONFIGS;
  2. Abra o ficheiro VK3_V10_Integration.config;
  3. Copie as pipelines V10_VK3_CONSUMPTIONS_1, V10_VK3_CONSUMPTIONS_2 e V10_VK3_CONSUMPTIONS_3 para o ficheiro Integration.config pela seguinte ordem:
    1. V10_VK3_CONSUMPTIONS_1: contém a informação do cabeçalho;
    2. VK3_V10_CONSUMPTIONS_2: contém a informação dos detalhes;
    3. V10_VK3_CONSUMPTIONS_3: contém a informação para atualização dos preços.
As três pipelines neste exemplo devem ser executadas na sequência apresentada:
        <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"/>   
...    
E, de seguida, as restantes pipelines referentes aos documentos internos.

Se existirem mais pipelines referentes aos documentos internos, devem ser todas executadas no mesmo Handler por sequência, por exemplo:
 <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>


Passo 2: Configurar Mappers
Deve copiar os ficheiros sample distribuídos nas seguintes pastas:
  1.  VKPlugin\SAMPLES\MAPPERS\PRIMAVERA10_VALUEKEEP3 
    1. Copie os ficheiros V10_VK3_CONSUMPTIONS_1.json e V10_VK3_CONSUMPTIONS_3.json;
    2. Cole os ficheiros na pasta VKPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP;
    3. Altere o tipo de documento para o utilizado no ERP.
  2. VKPlugin\SAMPLES\MAPPERS\VALUEKEEP3_PRIMAVERA10
    1. Copie o ficheiro V10_VK3_CONSUMPTIONS_2.json;
    2. Cole o ficheiro na pasta VKPlugin\SAMPLES\MAPPERS\VALUEKEEP3_PRIMAVERA10.
Passo 3: Configurar Hashsets
Deve copiar os ficheiros sample distribuídos nas seguintes pastas:
  1.  VKPlugin\SAMPLES\HASHSETS\PRIMAVERA10_VALUEKEEP3 
    1. Copie os ficheiros V10_VK3_CONSUMPTIONS_1.json e V10_VK3_CONSUMPTIONS_3.json;
    2. Cole os ficheiros na pasta VKPlugin\HASHSETS\PRIMAVERA10_VALUEKEEP
  2. VKPlugin\SAMPLES\HASHSETS\VALUEKEEP3_PRIMAVERA10
    1. Copie o ficheiro V10_VK3_CONSUMPTIONS_2.json;
    2. Cole o ficheiro na pasta VKPlugin\SAMPLES\HASHSETS\VALUEKEEP3_PRIMAVERA10.
Os campos apresentados podem derivar do tipo de necessidades a sincronizar.
      <Handler Id="h1"  Order="1" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_1"/>
      Sincroniza o documento interno para o Valuekeep.
      <Handler Id="h2"  Order="2" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_2"/>
      Atualiza o campo Mapper para o ERP v10(CDU_IdLinhaVK)
      <Handler Id="h3"  Order="3" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_3"/>   
      Atualiza os custos referentes ao documento anteriormente sincronizado.


    • Related Articles

    • Como configurar o Valuekeep Integrator?

      A instalação do Valuekeep Integrator poderá ser realizada através das seguintes opções: · Portal (link): efectuar download do setup do addon Valuekeep Integrator disponível e proceder à respectiva instalação; · PRIMAVERA Deployment Center: esta opção ...

    • Como configurar os Schedulers?

      A frequência de execução de um pipeline é definida através do scheduler expresso na configuração do pipeline. O catálogo de Schedulers presente na solução disponível como exemplo base, poderá ser customizado com a inclusão de novos itens, com recurso ...

    • Como obter o registo de consumos por OData?

      É possível realizar pedidos OData em todas as entidades. Nos pedidos OData, é necessário ter atenção à seguinte sintaxe: $select: expressão que determina quais os campos do pedido que são incluídos no resultado; $filter: expressão utilizada para ...

    • O que é o Valuekeep Integrator?

      O Valuekeep Integrator preconiza um modelo conceptual de integração de dados e consequente lógica funcional entre sistemas. Como solução de integração entre sistemas, o Valuekeep Integrator reúne um conjunto de características que se consideram ...

    • Como fazer download do plugin ERP Primavera V10?

      ​ A instalação do plugin PRIMAVERA V10 –  Valuekeep Integration é realizada através do PRIMAVERA Deployment Center.  ​ Esta opção apenas está disponível para clientes que subscreveram o módulo VK.INT – Valuekeep Integrator (ver PRIMAVERA ...