Guida di MicroStation CONNECT Edition

Direttive di flusso e direttive delle variabili

Le direttive di flusso controllano il modo in cui il prodotto elabora i file di configurazione. Le direttive di flusso iniziano sempre con %. Sono disponibili le seguenti direttive di flusso:

Direttiva di flusso Sintassi Descrizione
%include %include<filespec> Include uno o più file di configurazione prima di passare alla riga successiva all'interno di questo file di configurazione. <filespec> può specificare un singolo file o comprendere caratteri jolly per includere più file. <filespec> può contenere una variabile di configurazione. Ad esempio:

%include $(_USTN_WORKSPACECFG)

%include<filespec> level <levelspec> La direttiva %include può includere un livello di variabili di configurazione al quale vengono applicate le assegnazioni nel file incluso (finché non viene incontrata un'altra direttiva di livello). Ad esempio:

%include $(_USTN_ROLECFG) level Role

%if %if <expression> Se <expression> risulta vera, continuare alla riga successiva, altrimenti passare direttamente all'istruzione corrispondente %else, %elif o %endif. Consultare Operatori per la sintassi di <expression>. Ad esempio:

%if $(PHASE)=="Final"

%ifdef %ifdef<cfgvar> Se <cfgvar> è definita, continuare alla riga successiva, altrimenti passare direttamente all'istruzione corrispondente %else, %elif, o %endif. Ad esempio:

%ifdef _USTN_ROLECFG

%ifndef %ifndef<cfgvar> Se <cfgvar> non è definita, continuare alla riga successiva, altrimenti passare direttamente all'istruzione corrispondente %else, %elif, o %endif. Ad esempio:

%ifndef MS_DEF

%else %else Un'istruzione %if, %ifdef o %ifndef che risulta falsa, continua sulla riga che segue un'istruzione %else corrispondente, se presente.
%elif %elif <expression> Un'istruzione %if, %ifdef, o %ifndef che risulta falsa continua calcolando <expression> in corrispondenza della prima istruzione %elif corrispondente; quindi, continua ad elaborare alla riga seguente se l'espressione risulta vera, oppure passa direttamente all'istruzione successiva %elif, %else, o %endif Ad esempio:

%elif defined (MS_RFDIR)

%endif %endif L'istruzione indica la fine del blocco di condizioni di un'istruzione %if, %ifdef o %ifndef.
%echo %echo<message> Mostra i contenuti di <message> nella finestra di testo di MicroStation e continua l'elaborazione. Ad esempio:

%echo $(MS_DEF)

%error %error<message> Interrompe l'elaborazione, segnalando i contenuti di <message> come errore. Ad esempio:

%error unexpected value

Direttive delle variabili

Sono supportate le seguenti direttive delle variabili:

Direttiva della variabile Sintassi Definizione
%lock %lock<cfgvar> Blocca la variabile di configurazione Variabile di configurazione<cfgvar> per evitare che sia modificata.
%undef %undef<cfgvar> Ignora il valore della Variabile di configurazione e la imposta su non definita.
%level %level<newLevel> Specifica il livello in corrispondenza del quale le seguenti definizioni della Variabile di configurazione devono essere applicate. L'argomento <newlevel> deve essere uno dei seguenti:
  • Sistema
  • Applicazione
  • Organizzazione
  • WorkSpace
  • WorkSet
  • Ruolo
  • Utente
Nota: Gli argomenti precedenti non fanno distinzione tra maiuscole e minuscole