É provável que ouças falar de “fluxos” de vez em quando no mundo das ligações de software, mas o que significa realmente? Simplificando, tem a ver com a movimentação de informações de um sistema para outro. Como é que o APIcenter utiliza fluxos? E como é que um fluxo funciona exatamente? Vamos dar uma vista de olhos aos detalhes dos fluxos e à forma como funcionam neste sistema.
Fluxos? O que é que isso significa realmente no contexto das ligações de software?
Os fluxos referem-se aos grupos de dados/informação que são transferidos de um sistema para outro. Mas como é que um fluxo deste tipo funciona realmente?
Como é que um fluxo funciona no APIcenter?
Imagina que um fluxo é uma série de tarefas concluídas uma após a outra, como os passos de uma receita. Este processo é utilizado para mover informação de um sistema (chamemos-lhe sistema A) para outro sistema (chamemos-lhe sistema B).
Para isso, precisamos de uma chave digital fornecida pelo pacote de software, chamada chave API, para aceder aos sistemas. Esta chave determina quais os dados que nos são permitidos receber, dependendo dos direitos atribuídos à chave API.
Vejamos agora um exemplo simples de como funciona com um fluxo de produtos:
Recupera os dados:
- Começamos por obter uma lista de produtos do Sistema A.
- A partir desta lista, seleccionamos 10 itens com os quais queremos trabalhar, e depois começa o verdadeiro trabalho.
- Primeiro, extrai todas as informações detalhadas sobre cada produto.
- Em seguida, consulta diferentes locais para recolher todas as informações necessárias para completar os detalhes do produto.
- Neste momento, temos todos os dados em bruto de que necessitamos para um produto do sistema A (o sistema de origem).
- Aplicamos alguns filtros para limpar os dados.
- De seguida, envia os dados para o nosso “Core”.
Núcleo do APIcenter:
- No núcleo, pegamos nos dados em bruto e transformamo-los num formato que o nosso sistema compreende (chamamos a isto o nosso modelo de dados).
- Ajustamos os dados com base num conjunto de regras ou mapeamentos.
- Se faltarem informações, acrescentá-las-emos.
- Prepara tudo no nosso modelo de dados para o sistema B.
Transmissão de dados:
- Quando os dados estiverem prontos no nosso modelo de dados, enviamo-los para o sistema B (o sistema de destino).
- Ajustamos os dados novamente, mas desta vez para corresponder ao que o Sistema B espera.
- Organizamos as tarefas de uma forma que faz sentido para as necessidades específicas do Sistema B.
Este processo é efectuado a cada 5 minutos e recupera 10 itens por defeito.
Também é possível escolher webhooks ou RabbitMQ para determinados fluxos. Estes métodos enviam-nos actualizações instantâneas quando algo é alterado no sistema A, permitindo que as alterações sejam detectadas mais rapidamente.
Que dados de um fluxo podem ser actualizados?
O site APIcenter lista globalmente o que pode ser atualizado para cada ligação. Claro que depende do sistema e do que obtemos na chave da API. Se os dados estiverem dentro do fluxo, serão quase sempre suportados. Também há mais informações por fluxo nos detalhes.
O APIcenter utiliza quatro fluxos padrão: Encomendas, Produtos, Stocks e Clientes. Se necessitar de um fluxo que não suportamos atualmente, também é possívelconstruí-lo.
Como é que determinas quais os fluxos necessários para o teu processo de trabalho específico?
É importante notar que um fluxo segue sempre apenas um sentido numa ligação. Isto deve-se ao facto de a ligação só poder ver as actualizações. A ativação de ambos os fluxos pode levar a uma repetição desnecessária, uma espécie de “loop infinito”.
Por isso, é essencial prestar atenção a este aspeto para evitar que a ligação processe continuamente as mesmas actualizações. Existem também setas no sítio que indicam em que sentido é possível encaminhar dados. Quando estão visíveis 2 setas, podes sempre selecionar uma das duas.
Se quiseres atualizar as informações sobre os produtos a partir de um sistema, só precisas do “fluxo de produtos”.
Lê o blogue aqui para obteres mais informações sobre como definir os fluxos do teu processo de trabalho no APIcenter.
Definições, tabelas, mapeamento de dados e pontos finais
Podes definir a tua ligação a nível micro.
No APIcenter, podes fazê-lo por fluxo. Por fluxo, tens definições onde, por exemplo, podes indicar se queres atualizar as imagens ou não.
Além disso, tens as Tabelas, que te permitem configurar os teus atributos ao nível do campo, por exemplo.
Além disso, o APIcenter tem um mapeamento de dados, onde podes mapear campos específicos.
Em Pontos de extremidade, podes ver quais os pontos de extremidade que utilizamos para recuperar ou enviar dados. Estes pontos finais são personalizáveis, mas recomendamos que não o faças, uma vez que isso pode interferir com a forma como as nossas integrações funcionam.
Conclusão
Em suma, os fluxos são simplesmente mensageiros digitais que transportam informações de um sistema informático para outro. Dentro do centro API, seguem uma espécie de roteiro para mover os dados do sistema A para o sistema B.
Escolher o fluxo certo para o teu processo de trabalho é como selecionar os pratos certos para uma refeição perfeita. E tal como podes ajustar os ingredientes na cozinha, no APIcenter podes afinar o acoplamento, como o mapeamento de dados e os pontos finais, para que tudo se ajuste exatamente ao que precisas. Compreender os fluxos é, na verdade, como a chave para um processo de trabalho digital sem problemas!