Vínculo Automatizado

O Vínculo Automatizado consulta uma fonte externa para associar workspaces aos seus centros de custo na Onicloud.

Esse processo reduz o trabalho manual e mantém os vínculos de acordo com os dados fornecidos pela integração.

Antes de começar

Tenha disponíveis:

uma organização cadastrada na empresa ativa;
o endereço da fonte que fornece os vínculos;
a forma de autenticação, quando necessária;
os campos que identificam o workspace e o centro de custo;
as regras de filtro e paginação da fonte, quando existirem.

Segurança

Utilize credenciais exclusivas e com o menor privilégio possível. Não compartilhe senhas, tokens ou outros dados sensíveis em chamados e capturas de tela.

Como funciona

O processo é executado diariamente, por padrão às 2h no horário de São Paulo. Esse horário pode variar conforme o ambiente.

Durante a execução, a plataforma:

consulta as configurações ativas;
autentica-se na fonte externa, quando necessário;
obtém e filtra os dados de vínculo;
identifica o workspace e o centro de custo de cada item;
cria o centro de custo quando ele ainda não existe;
associa os workspaces que ainda estão sem centro de custo;
registra o resultado do processamento.

Uma falha em uma configuração não impede que as demais sejam processadas.

Configuração da fonte

Cada configuração pertence a uma organização e deve possuir pelo menos uma fonte de dados.

Informe:

o endereço e o método de consulta da fonte;
a autenticação, quando exigida;
a localização dos itens na resposta;
os campos de centro de custo e workspace;
os filtros e a paginação, quando necessários.

Quando houver mais de uma fonte, elas serão consultadas na ordem cadastrada e seus resultados serão reunidos.

Mapeamento dos dados

Informação	Obrigatória	Utilização
Centro de custo	Sim	Código utilizado para localizar ou criar o centro de custo.
Nome do centro de custo	Não	Nome utilizado quando um novo centro precisa ser criado.
Workspace	Sim	Identificador do workspace na nuvem.
Nome do workspace	Não	Informação descritiva retornada pela fonte.

Nome do centro de custo

Se a fonte puder retornar um centro de custo que ainda não existe, informe também o nome. Sem ele, a criação do centro poderá falhar.

Filtros e paginação

Os filtros permitem considerar somente os registros relevantes. Quando houver mais de um filtro, o item deverá atender a todos eles.

A paginação deve ser configurada quando a fonte divide o resultado em várias páginas. O processo continuará as consultas até que não exista uma próxima página.

Aplicação dos vínculos

O processo preserva os vínculos existentes:

workspaces não encontrados na organização são ignorados;
workspaces que já possuem centro de custo não são alterados;
vínculos repetidos na mesma execução são considerados apenas uma vez;
centros de custo inexistentes são criados antes do vínculo, desde que os dados necessários estejam disponíveis.

Atenção!

O Vínculo Automatizado não move um workspace que já esteja associado a outro centro de custo. Para fazer essa alteração, utilize a edição disponível na plataforma.

Acompanhamento

Cada configuração gera um registro com o resultado da execução. É possível identificar quantos vínculos foram criados, quantos itens foram ignorados e se houve alguma falha.

Os problemas mais comuns são:

falha na autenticação da fonte;
indisponibilidade ou erro na consulta;
campos não encontrados na resposta;
erro ao criar o centro de custo ou aplicar o vínculo.

Uma execução pode apresentar falha depois de concluir parte dos vínculos. Nesse caso, os vínculos realizados antes do erro são mantidos.