Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Une bibliothèque de variables vous permet de fournir une valeur qui diffère selon l’environnement, au lieu de coder en dur une valeur correcte dans un seul espace de travail. Partout où Fabric accepte une référence de variable, il résout cette référence à une valeur avant de l’utiliser.
Quand Fabric ne peut pas résoudre une référence, il ne remplace pas une valeur. À la place, il indique un statut de résolution précisant quelle partie de la référence a échoué. Cet article explique chaque statut et ce qu’il faut faire à ce sujet.
Résolution d’une référence
La résolution d’une référence se fait par étapes, et une défaillance à n’importe quel stade arrête le reste. Fabric fait ce qui suit :
- Il lit la référence et vérifie qu’elle est bien formulée.
- Recherche la bibliothèque de variables désignée par les noms de référence et confirme que vous pouvez la lire.
- Trouve l’ensemble de valeurs actives de la bibliothèque.
- Trouve la variable à l’intérieur de cet ensemble de valeurs.
- Vérifie que le type de valeur de la variable correspond au type demandé par la référence.
- Si la valeur pointe vers un autre objet ou une connexion, cela résout aussi ces détails.
Le statut que vous voyez vous indique laquelle de ces étapes a échoué, ce qui suffit généralement à identifier la correction sans inspecter toute la chaîne.
Erreurs de résolution de référence
Ces erreurs signifient que la référence elle-même, la bibliothèque de variables ou la variable n’ont pas pu être résolues.
| Message | Ce que cela signifie | Comment le corriger |
|---|---|---|
| Le format de référence est invalide | La référence n’est pas correctement formatée. | Corrigez la syntaxe de référence. |
| La référence à la bibliothèque de variables est manquante | La référence ne nomme pas de bibliothèque de variables. | Fournissez une référence complète incluant la bibliothèque. |
| La référence à la bibliothèque de variables est ambiguë | Plus d’une bibliothèque de variables correspond à la référence. | Rendez la référence plus précise pour qu’elle corresponde à une bibliothèque. |
| La spécification de type n’est pas autorisée | La référence spécifie un type en ligne, et cette référence ne le prend pas en charge. | Supprimez la spécification de type intégrée. |
| Bibliothèque de variables non trouvée | La bibliothèque n’existe pas, ou vous n’avez pas la permission de la lire. | Vérifie la référence et ton accès à la bibliothèque. |
| La bibliothèque de variables est corrompue | La bibliothèque ne peut pas être lue. | Celui-ci n’est pas en libre-service. Contactez le support s’il persiste. |
| Ensemble de valeurs actives non trouvé | L’ensemble de valeurs actives configuré par la bibliothèque n’existe pas. | Définissez un ensemble de valeurs actives qui existe dans la bibliothèque. |
| La définition de la variable est invalide | Une ou plusieurs définitions de variables dans la bibliothèque sont invalides. | Corrigez les définitions des variables dans la bibliothèque. |
| La redéfinition de variable est invalide | Une ou plusieurs valeurs de dérogation sont invalides. | Corrigez les valeurs de dérogation. |
| Variable introuvable | La bibliothèque a bien été résolue, mais elle n’a pas de variable de ce nom. | Vérifiez le nom de la variable. Une variable renommée est une cause fréquente. |
| Incompatibilité de type de variable | Le type de valeur de la variable n’est pas celui demandé par la référence. | Changez soit le type demandé, soit la valeur de la variable. |
Si, au lieu de l’un de ceux-ci, vous voyez un message générique Impossible de résoudre la référence, c’est que l’échec n’a pas pu être attribué à une étape précise. Réessayez, et si cela persiste, considérez-le comme une erreur côté service plutôt que comme un problème avec la référence.
Erreurs d’éléments référencés
Ces erreurs signifient que la référence a été résolue en une valeur, mais que l’élément ou la connexion vers laquelle la valeur pointe n’a pas pu être résolu. La référence est correcte, donc fixez la cible plutôt que la référence.
| Message | Ce que cela signifie | Comment le corriger |
|---|---|---|
| Article référencé non trouvé | L’objet où la valeur est indiquée n’existe pas. | Vérifiez que l’élément existe toujours et que la valeur pointe vers le bon. |
| Accès à l’élément référencé refusé | L’objet existe, mais vous n’avez pas la permission de lecture dessus. | Demande d’accès en lecture à l’article. |
| Connexion référencée non trouvée ou accès refusé | La connexion n’existe pas, ou tu ne peux pas la lire. | Vérifie la connexion et ton accès à celle-ci. |
| Une erreur s’est produite | L’élément mentionné n’a pas pu être résolu, et la cause n’est pas précise. | Réessayez. Si cela persiste, considérez-le comme une erreur côté service. |
Considerations
Il vaut la peine d’en connaître quelques-uns avant d’y être confronté :
- Les erreurs d’autorisation et les objets manquants sont signalés de la même manière dans certains cas. « Bibliothèque de variables non trouvée » et « Connexion référencée non trouvée ou accès refusé » couvrent tous deux l'absence d'objet et le fait que vous ne puissiez pas le voir, car Fabric ne confirme pas l'existence de quelque chose que vous ne pouvez pas lire. Vérifiez votre accès avant de conclure que l’objet a disparu.
- Une référence qui se résout pour vous ne se résout pas forcément pour quelqu’un d’autre. La résolution dépend des autorisations de la personne qui la déclenche, donc une référence qui fonctionne pendant l’authoring peut échouer plus tard lorsqu’une identité différente exécute le même travail.
- Renommer une variable casse les références à celle-ci. Les références se font par nom, donc un renommage se traduit par Variable non trouvée plutôt que par un avertissement au moment du renommage.