Pacote de Dados
O Connector possui a capacidade de configurar como e quando os dados serão buscados na API do Guiabolso. É possível definir novos eventos que agreguem dados buscados na API e definir diferentes níveis de cache de forma opcional. Tudo isso pode ser feito através do arquivo datapackages.yml
Crie um novo arquivo chamado datapackage.yml com as configurações abaixo e deixe-o na mesma pasta que o arquivo do Connector está salvo. O Connector já possui uma configuração padrão embutida mas o ideal é que você possa sobrescrevê-la através desse arquivo.
#Pacote de dados para agregação de eventosdataPackages: - publish: type: EVENT name: gbconnect:variables version: 1 sources: - statusKey: GBCONNECT.IDENTIFICATION.VARIABLES.STATUS eventName: gbconnect:identification:variables eventVersion: 1 - statusKey: GBCONNECT.CREDIT.VARIABLES.STATUS eventName: gbconnect:credit:variables eventVersion: 1 - statusKey: GBCONNECT.SEGMENTATION.VARIABLES.STATUS eventName: gbconnect:segmentation:variables eventVersion: 1 - statusKey: GBCONNECT.FINANCIAL.VARIABLES.STATUS eventName: gbconnect:financial:variables eventVersion: 1#Configuração de cache de dadosdataCaches: - eventName: gbconnect:variables eventVersion: '*' duration: 7 days cacheUsagePolicy: ALWAYS
Configuração | Descrição |
---|---|
cacheUsagePolicy | [NEVER, ONLY_ON_FAILURES, ALWAYS] |
cacheDuration | [day, days, month, months, minute, minutes, min, second, seconds, s] |
Eventos agregadores
A palavra-chave publish
define um evento agregador gbconnect:variables
. Esse evento será o resultado da execução de todos os eventos definidos dentro da palavra-chave sources
.
Isso é importante para que você não precise gerenciar cada requisição em separado, basta chamar o evento agregador publicado e o próprio Connector mescla o resultado de todos os outros para você.
Cache de Dados
No próprio arquivo datapackage.yml é possível também definir uma política de cache a ser aplicada para os eventos. O uso de cache de dados não é obrigatório mas pode servir de proteção contra possíveis instabilidades na plataforma e para minimizar custos.
A palavra-chage dataCaches
é usada para definir cache para os eventos. No nosso exemplo acima, definimos um cache de 7 dias para o evento gbconnect:variables
. O Connector só fará a requisição para um mesmo usuário se os 7 dias da primeira requisição já tiver passado.