Quem é responsável pela informação entre sistemas?

Defina a fonte de referência para cada registo

Ligar duas ferramentas não esclarece qual a informação que deve prevalecer. Um registo de cliente pode incluir dados de faturação, preferências de serviço e um estado contratual mantidos por pessoas diferentes em sistemas distintos.

Identifique a fonte de referência para cada campo ou acontecimento de negócio tratado pela integração. Defina o identificador que permite reconhecer a mesma entidade nos vários sistemas. Um nome ou endereço de email pode não ser suficiente quando os registos mudam ou já existem duplicados.

Registe o que deve acontecer quando as fontes divergem. A resposta pode ser uma atualização autorizada, uma tarefa de reconciliação ou uma decisão do responsável pelo processo. A ligação entre sistemas deve respeitar uma regra definida, sem a inventar.

Especifique o que é transferido, quando e em que sentido

Descreva o acontecimento que inicia o processo, os dados incluídos, o destino e o resultado esperado. Indique se a execução responde a um evento, segue um horário ou depende de um pedido de uma pessoa.

Numa ligação bidirecional, defina como distinguir as atualizações das alterações geradas pela própria integração. Caso contrário, uma correção pode circular entre sistemas sem um responsável claro. Considere a ordem dos acontecimentos e a forma de detetar uma atualização desatualizada.

Os acessos fazem parte da solução. Identifique a organização titular de cada conta, as permissões necessárias e o processo para renovar ou retirar esse acesso.

Responsável de negócio

Define o significado da informação e decide como resolver os conflitos.

Responsável pelo sistema

Gere a origem ou o destino, os respetivos acessos e as alterações que podem afetar a integração.

Responsável pela implementação

Mantém a ligação, a monitorização e as instruções de recuperação acordadas.

Distinga uma tentativa de atualização de um resultado confirmado

Um pedido de rede pode falhar antes de chegar ao sistema, durante o processamento ou depois de a alteração ter sido efetuada, mas antes de a resposta chegar à origem. Uma mensagem de erro num dos lados não explica tudo o que aconteceu no outro.

Defina como a integração reconhece uma atualização aceite e como pode encontrar o resultado mais tarde. A solução pode usar identificadores do destino, identificadores de pedido estáveis, registos de eventos e reconciliação. O mecanismo adequado depende das interfaces disponíveis.

Uma integração que repete um pedido precisa de proteção contra efeitos duplicados. É necessário implementar e testar essa proteção para a operação em causa; a existência de um botão para tentar novamente não a garante.

Torne o trabalho por resolver visível à pessoa certa

A vista operacional deve distinguir o trabalho em espera, as conclusões confirmadas e os assuntos que precisam de atenção. Inclua contexto suficiente para identificar a origem, o destino e a operação, sem expor informação sensível desnecessária.

Acorde quem recebe o problema, a resposta esperada e como a empresa pode continuar enquanto aguarda a resolução. Certo trabalho pode esperar em segurança. Outro exige uma alternativa manual, com o registo do que aconteceu fora da integração.

Monitorizar e prestar suporte são responsabilidades diferentes. Um aviso de falha só é útil se alguém souber o que deve verificar e quais as ações que pode executar.

Entregue uma ligação que possa ser mantida

A passagem para operação deve descrever o mapeamento de dados, as dependências de acesso, as regras de atualização, a confirmação, as limitações conhecidas e a recuperação. Entregue ao cliente a informação operacional e os acordos de responsabilidade definidos no âmbito.

Os testes devem incluir atualizações normais, alterações de permissões, eventos duplicados e falhas de ligação. Quando um fornecedor muda a API ou a empresa altera o processo, identifique as verificações que é preciso repetir.

O resultado prático é uma integração com um funcionamento compreensível: os dados que trata, as alterações que pode efetuar e as pessoas responsáveis quando os sistemas não coincidem.