Awarie zmiennych odniesień rozdzielczych

Biblioteka zmiennych pozwala podać wartość różniącą się w zależności od środowiska, zamiast kodować na stałe wartość poprawną tylko w jednym workspace. W każdym miejscu, w którym Fabric akceptuje odwołanie do zmiennej, przekształca je w wartość, zanim go użyje.

Gdy Fabric nie może rozwiązywać referencji, nie zastępuje wartości. Zamiast tego raportuje status rozdzielczości, który pokazuje, która część odniesienia zawiodła. Ten artykuł wyjaśnia każdy status i co z nim zrobić.

Jak jest rozwiązywana referencja

Rozwiązywanie referencji odbywa się etapami, a błąd na dowolnym etapie powoduje zatrzymanie dalszych etapów. Fabric robi następujące funkcje:

  1. Czyta referencję i sprawdza, czy jest dobrze sformułowana.
  2. Znajduje bibliotekę zmiennych, którą nazywa referencja, i potwierdza, że możesz ją odczytać.
  3. Znajduje aktywny zbiór wartości biblioteki.
  4. Znajduje zmienną w obrębie tego zbioru wartości.
  5. Sprawdza, czy typ wartości zmiennej odpowiada typowi wymaganemu przez referencję.
  6. Jeśli wartość wskazuje na inny przedmiot lub połączenie, te szczegóły również się rozwiązują.

Status, który widzisz, pokazuje, który z tych etapów zawiódł, co zwykle wystarcza, by zidentyfikować naprawę bez sprawdzania całego łańcucha.

Błędy rozdzielczości referencyjnej

Te błędy oznaczają, że sama referencja, biblioteka zmiennych czy zmienna nie mogły zostać rozwiązane.

Komunikat Co to znaczy Jak rozwiązać problem
Format referencyjny jest nieprawidłowy Referencja nie jest poprawnie sformatowana. Popraw składnię referencyjną.
Brakuje odniesień do biblioteki zmiennych Referencja nie nazywa biblioteki zmiennych. Dostarcz pełne źródło obejmujące bibliotekę.
Odniesienia do biblioteki zmiennych są niejednoznaczne Więcej niż jedna biblioteka zmiennych odpowiada referencji. Zrób odniesienie bardziej precyzyjne, aby pasowało do jednej biblioteki.
Specyfikacja typu nie jest dozwolona Referencja określa typ w linii, a ta referencja tego nie obsługuje. Usuń specyfikację typu inline.
Nie znaleziono biblioteki zmiennych Biblioteka nie istnieje albo nie masz pozwolenia, by ją przeczytać. Sprawdź źródło i sprawdź dostęp do biblioteki.
Biblioteka zmiennych jest uszkodzona Biblioteki nie da się czytać. To nie jest samoobsługowe. Skontaktuj się z pomocą techniczną, jeśli problem się utrzyma.
Zbiór wartości aktywnych nie znaleziono Skonfigurowany zestaw aktywnych wartości w bibliotece nie istnieje. Ustaw aktywny zbiór wartości istniejący w bibliotece.
Definicja zmiennej jest nieprawidłowa Definicje jednej lub więcej zmiennych w bibliotece są nieprawidłowe. Popraw definicje zmiennych w bibliotece.
Nadpisanie zmiennych jest nieprawidłowe Co najmniej jedna z wartości zastępujących jest nieprawidłowa. Popraw wartości zastępowania.
Nie można odnaleźć zmiennej Biblioteka została rozwiązana, ale nie ma zmiennej o tej nazwie. Zweryfikowaj nazwę zmiennej. Zmienna, której nazwę zmieniono, jest częstą przyczyną.
Niedopasowanie typu zmiennych Typ wartości zmiennej nie jest tym, o który prosi referencja. Zmień albo żądany typ, albo wartość zmiennej.

Jeśli zobaczysz ogólny komunikat "Nie udało się rozwiązać odwołania " zamiast jednego z tych, nie można przypisać awarii konkretnemu etapowi. Spróbuj ponownie, a jeśli problem się utrzymuje, traktuj to jako błąd po stronie usługi, a nie jako problem z referencją.

Błędy elementów referencyjnych

Te błędy oznaczają, że odniesienie zostało przypisane do wartości, ale nie udało się odnaleźć elementu lub połączenia, na które ta wartość wskazuje. Odniesienie jest poprawne, więc określ cel, a nie referencję.

Komunikat Co to znaczy Jak rozwiązać problem
Przedmiot referencyjny nie znaleziony Przedmiot, na który wskazuje wartość (value), nie istnieje. Potwierdź, że przedmiot nadal istnieje i że wartość wskazuje na właściwy przedmiot.
Odmówiono dostępu do przedmiotu referencyjnego Przedmiot istnieje, ale nie masz na niego zgody na odczyt. Poproś o dostęp do odczytu elementu.
Powiązanie referencyjne nie znaleziono lub dostęp odrzucony Połączenie nie istnieje albo nie możesz go odczytać. Sprawdź połączenie i swój dostęp do niego.
Coś poszło nie tak Wspomnianego elementu nie udało się rozwiązać, a przyczyna nie jest precyzyjna. Ponów próbę. Jeśli problem się utrzymuje, potraktuj to jako błąd po stronie usługi.

Zagadnienia do rozważenia

Kilka z nich warto znać zanim się na nie trafisz:

  • Błędy uprawnień i brakujące obiekty są w niektórych przypadkach zgłaszane w ten sam sposób. Zarówno komunikat „Nie znaleziono biblioteki zmiennych”, jak i „Nie znaleziono połączenia, do którego się odwołano, lub odmówiono dostępu” oznaczają zarówno, że obiekt nie istnieje, jak i że nie masz uprawnień, aby go zobaczyć, ponieważ Fabric nie potwierdza istnienia czegoś, do czego nie masz dostępu. Sprawdź swój dostęp, zanim uznasz, że obiekt zniknął.
  • Referencja, która rozwiąże się u Ciebie, może nie rozwiązać się u kogoś innego. Rozstrzyganie zależy od uprawnień osoby, która je uruchamia, więc odwołanie, które działa na etapie tworzenia, może później przestać działać, gdy to samo zadanie uruchomi inna tożsamość.
  • Przemianowanie zmiennej psuje odniesienia do niej. Odwołania są rozpoznawane po nazwie, więc po zmianie nazwy pojawia się komunikat Variable not found, a nie ostrzeżenie w momencie zmiany nazwy.