Falhas de resolução de referência variável

Uma biblioteca de variáveis permite que você forneça um valor que difere de acordo com o ambiente, em vez de codificar um valor correto em apenas um espaço de trabalho. Sempre que o Fabric aceita uma referência de variável, ele resolve essa referência para um valor antes de usá-la.

Quando o Fabric não consegue resolver uma referência, ele não substitui um valor. Em vez disso, ele reporta um status de resolução que diz qual parte da referência falhou. Este artigo explica cada status e o que fazer a respeito.

Como uma referência é resolvida

A resolução de uma referência ocorre em etapas, e uma falha em qualquer etapa interrompe o restante. A Fabric faz o seguinte:

  1. Lê a referência e verifica se está bem formada.
  2. Localiza a biblioteca de variáveis pelos nomes de referência e confirma que ela pode ser lida.
  3. Encontra o conjunto de valores ativos da biblioteca.
  4. Encontra a variável dentro desse conjunto de valores.
  5. Verifica se o tipo de valor da variável corresponde ao tipo que a referência solicita.
  6. Se o valor aponta para outro item ou uma conexão, também resolve esses detalhes.

O status que você vê indica qual dessas etapas falhou, o que geralmente é suficiente para identificar a correção sem precisar inspecionar toda a cadeia.

Erros de resolução de referência

Esses erros significam que a própria referência, a biblioteca de variáveis ou a variável não puderam ser resolvidos.

Message O que significa Como corrigir
O formato da referência é inválido A referência não está formatada corretamente. Corrija a sintaxe da referência.
A referência da biblioteca de variáveis está ausente A referência não nomeia uma biblioteca de variáveis. Forneça uma referência completa que inclua a biblioteca.
A referência da biblioteca de variáveis é ambígua Mais de uma biblioteca de variáveis corresponde à referência. Deixe a referência mais específica para que combine com uma biblioteca.
Especificação de tipo não é permitida A referência especifica um tipo inline, e essa referência não suporta isso. Remova a especificação do tipo inline.
Biblioteca de variáveis não encontrada A biblioteca não existe, ou você não tem permissão para ler. Verifique a referência e seu acesso à biblioteca.
A biblioteca de variáveis está corrompida A biblioteca não pode ser lida. Este não é de autoatendimento. Entre em contato com o suporte se continuar.
Conjunto de valores ativos não encontrado O conjunto de valores ativos configurado da biblioteca não existe. Defina um conjunto de valores ativos que exista na biblioteca.
A definição de variável é inválida Uma ou mais definições de variáveis na biblioteca são inválidas. Corrija as definições de variáveis na biblioteca.
A substituição de variáveis é inválida Um ou mais valores de override são inválidos. Corrija os valores substituídos.
Variável não encontrada A biblioteca foi localizada, mas não possui nenhuma variável com esse nome. Verifique o nome da variável. Uma variável renomeada é uma causa comum.
Incompatibilidade de tipo de variável O tipo de valor da variável não é o tipo que a referência pede. Mude o tipo solicitado ou o valor da variável.

Se você vir uma mensagem genérica Não foi possível resolver a referência em vez de uma dessas, não foi possível atribuir a falha a uma etapa específica. Retente, e, se persistir, trate como um erro do lado do serviço, e não como um problema na referência.

Erros de itens referenciados

Esses erros significam que a referência foi resolvida para um valor, mas o item ou conexão para a qual o valor aponta não pôde ser resolvido. A referência está correta, então fixe o alvo em vez da referência.

Message O que significa Como corrigir
Item referenciado não encontrado O item em que o valor aponta não existe. Confirme que o item ainda existe, e que o valor aponta para o item correto.
Acesso ao item referenciado negado O item existe, mas você não tem permissão de leitura para ele. Solicite acesso de leitura ao item.
Conexão referenciada não encontrada ou acesso negado A conexão não existe, ou você não consegue lê-la. Verifique a conexão e seu acesso a ela.
Ocorreu um erro. O item mencionado não pôde ser resolvido, e a causa não é específica. Tente novamente. Se persistir, considere isso um erro no serviço.

Considerações

Vale a pena conhecer alguns deles antes de se deparar com eles:

  • Falhas de permissão e objetos ausentes são reportados da mesma forma em alguns casos. "Biblioteca de variáveis não encontrada" e "Conexão referenciada não encontrada ou acesso negado" cobrem o facto de o objeto não existir e você não conseguir vê-lo, porque o Fabric não confirma a existência de algo que você não consegue ler. Verifique seu acesso antes de concluir que o objeto desapareceu.
  • Uma referência que resolve para você pode não resolver para outra pessoa. A resolução depende das permissões de quem a aciona; assim, uma referência que funciona durante a fase de criação pode falhar mais tarde quando outra identidade executa o mesmo trabalho.
  • Renomear uma variável quebra as referências a ela. As referências são por nome, então uma renomeação se manifesta como Variável não encontrada, em vez de como um aviso no momento da renomeação.

Conteúdo relacionado

  • Última atualização em