Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Una libreria variabile ti permette di fornire un valore che varia a seconda dell'ambiente, invece di codificare rigidamente un valore corretto in un solo workspace. Ovunque Fabric accetti un riferimento variabile, risolve quel riferimento a un valore prima di utilizzarlo.
Quando Fabric non riesce a risolvere un riferimento, non sostituisce un valore. Invece riporta uno stato della risoluzione che indica quale parte del riferimento è fallita. Questo articolo spiega ogni stato e cosa fare al riguardo.
Come viene risolto un riferimento
La risoluzione di un riferimento avviene a fasi, e un guasto in qualsiasi fase ferma il resto. Fabric fa quanto segue:
- Legge il riferimento e verifica che sia ben formato.
- Trova la libreria di variabili con i nomi di riferimento e conferma che puoi leggerla.
- Trova il set di valori attivi della biblioteca.
- Trova la variabile all'interno di quell'insieme di valori.
- Controlla che il tipo di valore della variabile corrisponda a quello richiesto dal riferimento.
- Se il valore punta a un altro oggetto o a una connessione, risolve anche quei dettagli.
Lo stato che vedi ti dice quali di questi stadi hanno fallito, il che di solito è sufficiente per identificare la correzione senza dover ispezionare tutta la catena.
Errori di risoluzione dei riferimenti
Questi errori significano che il riferimento stesso, la libreria delle variabili o la variabile non sono stati risolti.
| Messaggio | Che cosa significa | Come risolverlo |
|---|---|---|
| Il formato di riferimento è invalido | Il riferimento non è formattato correttamente. | Correggi la sintassi di riferimento. |
| Manca il riferimento alla libreria delle variabili | Il riferimento non indica una libreria di variabili. | Fornisci una referenza completa che includa la biblioteca. |
| Il riferimento alla libreria variabile è ambiguo | Più di una libreria di variabili corrisponde al riferimento. | Rendi il riferimento più specifico così che corrisponda a una libreria. |
| La specifica del tipo non è consentita | Il riferimento specifica un tipo inline e quest’ultimo non lo supporta. | Rimuovi la specifica di tipo inline. |
| Libreria variabile non trovata | La biblioteca non esiste, o non hai il permesso di leggerla. | Controlla il riferimento e controlla il tuo accesso alla biblioteca. |
| La libreria delle variabili è corrotta | La libreria non può essere letta. | Questa non è in modalità self-service. Se continua, contatta il supporto tecnico. |
| Set di valori attivi non trovati | Il set di valori attivi configurato dalla libreria non esiste. | Imposta un insieme di valori attivi che esiste nella libreria. |
| La definizione della variabile è invalida | Una o più definizioni di variabili nella libreria sono invalide. | Correggi le definizioni delle variabili nella libreria. |
| L'override delle variabili è invalido | Uno o più valori di override sono invalidi. | Correggi i valori di override. |
| Variabile non trovata | La libreria è stata trovata, ma non ha alcuna variabile con quel nome. | Verifica il nome della variabile. Una variabile rinominata è una causa comune. |
| Incompatibilità del tipo di variabile | Il tipo di valore della variabile non è quello che il riferimento richiede. | Cambia il tipo richiesto o il valore della variabile. |
Se vedi un messaggio generico Impossibile risolvere il riferimento invece di uno di questi, l'errore non può essere attribuito a una fase specifica. Riprova, e se persiste, trattalo come un errore lato servizio piuttosto che come un problema con il riferimento.
Errori negli elementi di riferimento
Questi errori significano che il riferimento si è risolto in un valore, ma l'elemento o la connessione a cui punta il valore non è stato risolto. Il riferimento è corretto, quindi fissa il bersaglio invece che il riferimento.
| Messaggio | Che cosa significa | Come risolverlo |
|---|---|---|
| Oggetto di riferimento non trovato | L'elemento a cui il valore fa riferimento non esiste. | Conferma che l'elemento esista ancora e che il valore faccia riferimento a quello corretto. |
| Accesso all'oggetto di riferimento negato | L'oggetto esiste, ma non hai il permesso di lettura su di esso. | Richiedi accesso in lettura all'oggetto. |
| Connessione citata non trovata o accesso negato | La connessione non esiste, o non puoi leggerla. | Controlla la connessione e il tuo accesso ad esso. |
| Si è verificato un errore | L'oggetto citato non è stato risolto e la causa non è specifica. | Riprovare. Se persiste, consideralo un errore lato servizio. |
Considerazioni
Alcuni di questi vale la pena conoscerli prima di colpirli:
- In alcuni casi, gli errori di autorizzazione e gli oggetti mancanti vengono segnalati allo stesso modo. "Libreria variabile non trovata" e "Connessione di riferimento non trovata o accesso negato" coprono entrambi l'oggetto che non esiste e che tu non riesci a vederlo, perché Fabric non conferma l'esistenza di qualcosa che non puoi leggere. Controlla il tuo accesso prima di concludere che l'oggetto è sparito.
- Una referenza che si risolve per te potrebbe non risolversi per qualcun altro. La risoluzione dipende dai permessi di chi la attiva, quindi un riferimento che funziona durante l'authoring può fallire in seguito quando un'identità diversa esegue lo stesso lavoro.
- Rinominare una variabile rompe i riferimenti a essa. I riferimenti sono basati sul nome, quindi una ridenominazione si manifesta come Variabile non trovata anziché come un avviso durante la ridenominazione.