Fouten bij het oplossen van variabeleverwijzingen

Met een variabelebibliotheek kun je een waarde geven die per omgeving verschilt, in plaats van een waarde die in één werkruimte correct is te hardcoderen. Waar Fabric een variabele referentie accepteert, lost het die verwijzing op naar een waarde voordat het deze gebruikt.

Wanneer Fabric een referentie niet kan oplossen, vervangt het geen waarde. In plaats daarvan geeft het een resolutiestatus aan die aangeeft welk deel van de referentie is mislukt. Dit artikel legt elke status uit en wat je ermee kunt doen.

Hoe een verwijzing wordt opgelost

Het oplossen van een referentie gebeurt in fasen, en een storing in een willekeurig stadium stopt de rest. Fabric doet het volgende:

  1. Leest de referentie en controleert of deze correct gevormd is.
  2. Vindt de variabelenbibliotheek, de referentienamen en bevestigt dat je het kunt lezen.
  3. Vindt de actieve waardeset van de bibliotheek.
  4. Vindt de variabele binnen die waardeset.
  5. Controleert of het waardetype van de variabele overeenkomt met het type dat de referentie vraagt.
  6. Als de waarde naar een ander item of een verbinding wijst, lost dat die details ook op.

De status die je ziet vertelt je welke van die fasen faalde, wat meestal voldoende is om de oplossing te identificeren zonder de hele keten te inspecteren.

Fouten bij referentieresolutie

Deze fouten betekenen dat de referentie zelf, de variabelenbibliotheek of de variabele niet kon worden opgelost.

Bericht Wat betekent het? Het probleem oplossen
Referentieformaat is ongeldig De referentie is niet correct opgemaakt. Corrigeer de referentiesyntaxis.
Verwijzing naar de variabelenbibliotheek ontbreekt De referentie noemt geen variabelenbibliotheek. Geef een volledige referentie die de bibliotheek bevat.
De verwijzing naar de variabelenbibliotheek is dubbelzinnig Meer dan één variabelenbibliotheek komt overeen met de referentie. Maak de referentie specifieker zodat deze overeenkomt met één bibliotheek.
Typespecificatie is niet toegestaan De referentie specificeert een type inline, en deze referentie ondersteunt dat niet. Verwijder de inline-typespecificatie.
Variabele bibliotheek niet gevonden De bibliotheek bestaat niet, of je hebt geen toestemming om het te lezen. Controleer de referentie en controleer je toegang tot de bibliotheek.
Variabelenbibliotheek is beschadigd De bibliotheek kan niet worden gelezen. Deze is niet voor zelfbediening. Neem contact op met de ondersteuning als dit aanhoudt.
Actieve waardeset niet gevonden De geconfigureerde actieve waardeset van de bibliotheek bestaat niet. Stel een actieve waardeset in die in de bibliotheek aanwezig is.
De variabelendefinitie is ongeldig Een of meer variabelendefinities in de bibliotheek zijn ongeldig. Corrigeer de variabelendefinities in de bibliotheek.
Variabele override-optie is ongeldig Een of meer override-waarden zijn ongeldig. Corrigeer de override-waarden.
Variabele is niet gevonden De bibliotheek heeft opgelost, maar er is geen variabele met die naam. Controleer de variabelenaam. Een hernoemde variabele is een veelvoorkomende oorzaak.
Typemismatch van variabele Het waardetype van de variabele is niet het type waar de referentie om vraagt. Verander ofwel het gevraagde type of de waarde van de variabele.

Als je een generiek 'Kon niet oplossen'-referentiebericht ziet in plaats van een van deze, kan de mislukking niet aan een specifieke fase worden toegeschreven. Probeer het opnieuw, en als het blijft bestaan, behandel het dan als een service-side fout in plaats van een probleem met de referentie.

Gerefereerde itemfouten

Deze fouten betekenen dat de referentie naar een waarde verwees, maar dat het item of de verbinding waarnaar de waarde wijst niet kon worden gevonden. De referentie is correct, dus bepaal het doel in plaats van de referentie.

Bericht Wat betekent het? Het probleem oplossen
Referentie item niet gevonden Het item waar de waarde op wijst bestaat niet. Bevestig dat het item nog steeds bestaat en dat de waarde op het juiste object wijst.
Toegang tot het gerefereerde item geweigerd Het item bestaat, maar je hebt er geen leestoestemming voor. Verzoek om leestoegang tot het item.
Referentieverbinding niet gevonden of toegang geweigerd De verbinding bestaat niet, of je kunt het niet lezen. Controleer de verbinding en je toegang ertoe.
Er is iets misgegaan Het genoemde punt kon niet worden opgelost en de oorzaak is niet specifiek. Probeer het opnieuw. Als het blijft bestaan, behandel het dan als een service-side fout.

Overwegingen

Een paar hiervan zijn het waard om te weten voordat je eraan begint:

  • Autorisatiefouten en ontbrekende objecten worden in sommige gevallen op dezelfde manier gerapporteerd. "Variabele bibliotheek niet gevonden" en "Referentieverbinding niet gevonden of toegang geweigerd" dekken beide het object dat niet bestaat en dat jij het niet kunt zien, omdat Fabric het bestaan van iets dat je niet kunt lezen niet bevestigt. Controleer je toegang voordat je concludeert dat het object verdwenen is.
  • Een referentie die voor jou oplost, hoeft niet voor iemand anders te werken. De resolutie hangt af van de rechten van degene die het activeert, dus een referentie die werkt tijdens het authoren kan later falen wanneer een andere identiteit hetzelfde werk draait.
  • Het hernoemen van een variabele breekt de verwijzingen ernaar. Verwijzingen zijn bij naam, dus een naamswijziging verschijnt als Variabele niet gevonden in plaats van als waarschuwing bij het hernoemen.