WebApi - Sincronização do Hashing de um Pipeline

WebApi - Sincronização do Hashing de um Pipeline

O Valuekeep Integrator adopta um controlo de versionamento baseado num sistema de hashing. Cada pipeline, possui um controlo de versionamento, ou seja, possui uma chave de hashing que permite identificar se o subset de informação (hashset) ainda não foi objeto de integração ou se eventualmente sofreu alguma alteração nos seus dados, requerendo para o efeito nova integração. Esta técnica de hashing aplica-se a um segmento de informação (hashset), isto é, permite identificar quais os atributos que compõem a chave de hashing (ignorando, deste modo, pedidos de integração quando a entidade sofre alteração em atributos que não constam na composição da chave).

Este método permite sincronizar o hash de um pipeline, isto é, sincronizar o hashing dos registos que foram sincronizados com sucesso, evitando posteriores sincronizações, caso não se tenha registado alteração nos atributos de hashing.

O método utilizado para o efeito é: POST /api/mytenant/myorganization/integration/pipelines/synchash


Exemplo (Json) para a sincronização do hasing de um pipeline.

  1. {
        "BaseEntity": "BusinessCore.Brands",
        "ValueSourceHash": "VALUEKEEP",
        "FieldSourceHash": "User_SourceHash",
        "FieldTargetHash": "User_TargetHash",
        "FieldIsSync": "User_IsSync"    
    }

Descrição dos atributos disponíveis no pedido:
  • BaseEntity: identifica a entidade base (tabela principal);
  • ValueSourceHash: identifica o valor da chave hash no sistema origem;
  • FieldSourceHash: identifica o atributo SourceHash, quando  ignorado, o sistema assume: User_SourceHash;
  • FieldTargetHash: identifica o atributo TargetHash, quando ignorado, o sistema assume: User_TargetHash. Este atributo será usado para reservar o valor sincronizado;
  • FieldSyncHash: identifica o atributo IsSync, quando ignorado, o sistema assume: User_IsSync. Este atributo será usado para controlar se o registo será ou não objeto de sincronização (os registos são classificados para sincronização quando o valor do atributo FieldSourceHash difere do valor do atributo FieldTargetHash).

Quando este método é executado com sucesso devolve um HttpStatusCode.OK.


    • Related Articles

    • WebApi - Cálculo do Hashing de um Pipeline

      O Valuekeep Integration adopta um controlo de versionamento baseado num sistema de hashing. Cada pipeline, possui um controlo de versionamento, ou seja, possui uma chave de hashing que permite identificar se o subset de informação (hashset) ainda não ...

    • WebApi - Monitorização da Pipeline

      O Valuekeep Integrator, conceptualmente, possibilita a monitorização da execução de todos os pipelines. Esta funcionalidade, permite ao implementador / integrador controlar a execução dos fluxos de integração e inclusive identificar situações ...

    • WebAPI - Como obter o registo da webapi?

      No momento em que é realizada a subscrição no Valuekeep CMMS o subscriber recebe um email com as credenciais da subscrição, compostas por client_Id e um Cliente_Secret. Estas credencias devem ser guardadas, caso contrário não será possível utilizar a ...

    • Como customizar as Tags de uma Pipeline para o Url do pedido

      No Valuekeep temos pedidos "POST" devivados de chaves, exemplificando a seguir: O método a utilizar para a criação de um registo de follow-up numa Ordem de Trabalho é: POST ...

    • WebAPI - Criação de um equipamento

      Este método permite, de forma simplificada, criar um equipamento. O método a utilizar para a criação de um equipamento é:   POST url/api/mytenant/myorganization/assetmanagementcore/equipmentItems   Exemplo de Json para criação de um equipamento: ...