I comandi Generali utilizzati negli script CA DMM sono i seguenti:
Sposta il flusso del controllo alla fine del ciclo più prossimo ed esegue la prima istruzione che segue il loop. È diverso da un return, che mantiene tutti i cicli e l'ambito della funzione. È utile solo all'interno di un loop.
function Foo()
{
while (true)
{
while (z < 5)
{
...
if (x == false)
{
break; // jumps to line following while (z < 5) {}
}
if (y == true)
{
return 5; // returns from Foo() immediately
}
}
if (x == false)
{
break; // jumps to line following while (true) {}
}
}
...
return 1; // returns from Foo() immediately
Converte una stringa binaria in una stringa ASCII. Dispone di un parametro necessario, ossia la stringa contenente i dati binari da convertire. Il secondo parametro è facoltativo e binario. Se il valore booleano è vero, il risultato della conversione è una stringa UNICODE. Tuttavia, se il valore booleano è falso, il risultato della conversione è una stringa ASCII.
La stringa binaria
Il valore booleano
ConvertBinaryToString(<valore>,[booleano]);
var result = ConvertBinaryToString("000FFFDCB709E")
Converte una stringa ASCII in una stringa binaria. dispone di un parametro necessario, ossia la stringa ASCII da convertire. Il secondo parametro è facoltativo. Se questo è vero, il risultato della conversione è una stringa binaria UNICODE.
La stringa ASCII
Il valore booleano
ConvertStringToBinary(<valore>,[booleano]);
var result = ConvertStringToBinary("convert this string to binary")
Specifica l'applicazione associata allo script. È consentito associare una sola applicazione a uno script. Sul computer di origine è chiamata dalla funzione di rilevamento. Sul computer di destinazione può essere chiamata da qualsiasi punto per risolvere il percorso dell'applicazione. L'interprete risolve la parola chiave APPLICATIONPATH, che non è valida e non dovrebbe essere utilizzata prima dell'esecuzione di questa chiamata. Lo script dovrebbe chiamare Detect nella funzione di rilevamento per evitare un'elaborazione non necessaria.
I parametri per Detect sono il nome del file eseguibile e un valore facoltativo della chiave di registro. Entrambi i parametri sono valori di stringa. Il parametro del percorso del valore di registro è il percorso completo per il valore del registro che contiene il percorso per il file eseguibile. Se il valore del registro è il parametro predefinito, il percorso dovrebbe terminare con il nome della chiave e una barra (vedere l'esempio sottostante). Nella funzione di rilevamento, lo script deve controllare il valore restituito di Detect per stabilire se continuare l'elaborazione dello script o interrompere lo script.
Il nome del file eseguibile (valore stringa)
Il percorso del registro (valore stringa)
Detect ( <Executable name>, [Registry path] );
if( Detect( "MyApp.exe", "HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\MyApp.exe\\" ) == false)
{
return;
}
if (Detect ( <executable Name>) == false)
return;
Esegue un file eseguibile o dll. Se il comando Execute non riesce a trovare il file eseguibile o il file dll per effettuare la chiamata, la funzione restituisce il risultato Falso.
Il primo parametro è costituito dal percorso del file da eseguire. Se il percorso individua un file dll, la funzione API deve essere indicata subito dopo la doppia ripetizione di due punti. Il formato della chiamata dll è PATH::APIFunctionName. Il comando Execute per i file dll esegue solo la ricerca di chiamate in due tipi di funzioni:
int FunctionName();
int FunctionName( const char * );
Se la chiamata accetta argomenti di righe di comando, specificare gli argomenti o immettere una stringa vuota.
Un valore booleano che indica se lo script rimarrà in attesa del completamento di un file eseguibile. Questo parametro viene ignorato in caso di chiamate dll.
/*executes notepad with the following file, myfile.txt and waits for the process to end.*/ Execute( "c:\\windows\\notepad.exe", "myfile.txt", true ); /*executes notepad without parameters and waiting.*/ Execute( "c:\\windows\\notepad.exe" ); /* makes a call into the dll with parameters*/ Execute( "c\\windows\\Somelib.dll::CheckNetwork", "000d1");
Permette di uscire da uno script. Se questa parola chiave è seguita da un valore, questo è scritto nei registri di debug e degli errori. Le parentesi sono facoltative.
Exit ("Exiting because MS Word does not exist on machine.");
Espande tutte le variabili di ambiente in una determinata stringa e restituisce il risultato.
La stringa che contiene le variabili di ambiente.
ExpandString(<string>);
var result = ExpandString("%WinDir%")
Restituisce dati relativi al motore in base all'ID del comando. Durante la migrazione viene restituito l'errore se viene trasmesso l'ID del comando errato. Il comando può essere utilizzato per entrambe le attività (memorizzazione e applicazione) della migrazione.
Nota: il comando non può essere utilizzato con le versioni precedenti del prodotto. Se si prova a utilizzarlo in una versione precedente, verrà visualizzato un messaggio di errore di sintassi.
ID comando (ad esempio, GET_CUR_SEL) per ottenere il nome del nodo attualmente selezionato (impostazioni delle applicazioni o di sistema) per la migrazione.
GetEngineData(<ID comando>);
var strNewPath = GetEngineData(GET_CUR_SEL)
Restituisce il nuovo percorso del file associato al nuovo computer. Tale comando può anche accettare percorsi con delimitatori diversi dal comune carattere \\.
Il vecchio percorso del file (valore di stringa)
Il delimitatore del percorso (valore di stringa)
GetMappedPath( <old File path>, [<path delimiter>] );
newPath = GetMappedPath("c:\\old path\\file.txt");
/* newPath will equal the new file path.*/
oldPath = "c:_old path_file.txt";
newPath = GetMappedPath( oldPath, "_" );
/* newPath will equal the new file path with the delimiter*/
/* for example newPath could equal e:_new path_file.txt*/
Restituisce la piattaforma del computer. I valori di ritorno sono: WIN2000, WINXP, WINVI, o WIN7 (consultare l'elenco delle definizioni ). Accetta un solo parametro che indica se considerare la piattaforma installata sul computer di origine o su quello di destinazione. Questo parametro è facoltativo ed è costituito da un valore booleano. Il valore predefinito è Falso e indica la destinazione; Vero indica il computer corrente.
Nota: il parametro booleano può essere utilizzato solo durante le funzioni Generale e Applica. Se usato in altro modo, provoca un errore di sintassi o di runtime.
Il computer (valore booleano)
GetPlatform( [Boolean] );
if (GetPlatform(DESTINATION) == WINXP)
ApplyWinXPWord();
Viene effettuata una query nel sistema operativo per stabilire se si tratta di Windows 2000, Windows XP, Windows Vista o Windows 7. Il parametro è facoltativo. Se impostato su Vero, CA DMM utilizza il sistema operativo del computer di origine, altrimenti utilizza quello del computer di destinazione. Il suo valore predefinito è Falso.
Nota: il parametro può essere impostato solo su Vero durante le funzioni Generale ed Applica. Il parametro causa un errore di sintassi o di runtime se viene utilizzato in una funzione di archiviazione.
Il computer (valore booleano)
Value = IsLikeNT([Boolean]);
IsLikeNT(SOURCE);
Associa un percorso a un altro per la durata di uno script. Questa associazione dei percorsi può essere eseguita per tutte le operazioni di applicazione che seguono la parola chiave MapPath nello script corrente. Tale parola chiave ha come effetto la sostituzione di tutti i percorsi in cui il <vecchio percorso> coincide con il <nuovo percorso> nelle operazioni ApplyDirectory, ApplyFile e ApplyMappedValue.
Il vecchio percorso (valore di stringa)
Il nuovo percorso (valore di stringa)
MapPath(<old path>, <new path>);
MapPath("c:\\winword\\data", "c:\\winword\\Application Data");
Visualizza un messaggio all'utente. Questo comando accetta un solo parametro, costituito da un valore di stringa. Le parentesi sono facoltative.
Il testo del messaggio (valore di stringa)
Message ( <string> );
Message ("help!");
Crea un'opzione visualizzabile nella pagina delle impostazioni. Associa, inoltre, le funzioni di archiviazione e applicazione dell'opzione. Se l'utente sceglie un'opzione, vengono attivate dall'interprete anche le funzioni ad essa associate. L'istruzione di visualizzazione può specificare una gerarchia usando il carattere (/). Per esempio, l'opzione Microsoft Word\\Barra degli strumenti mostra Microsoft Word in una riga, mentre Barra degli strumenti compare con un rientro nella riga successiva nella struttura di visualizzazione delle opzioni.
Il percorso dell'opzione (valore di stringa)
Il nome della funzione di archiviazione (valore di stringa)
Il nome della funzione di applicazione (valore di stringa)
Consultare l'esempio Creazione di strutture di impostazioni localizzate.
Opzione( <percorso opzione>, [Archivia nome funzione], [Applica nome funzione], [Convalida nome funzione], [PercorsoIndipendenteLingua]);
Option ( "Microsoft Word\\Toolbar");
Option( "MicrosoftWord\\Toolbar\\Tooltips", "StoreTooltips", "ApplyTooltips", "msword\\toolbar\\tooltips");
Se la voce è selezionata dall'utente, le funzioni di archiviazione e applicazione sono richiamate dall'interprete. Se un'opzione è selezionata dall'utente, sono richiamate anche le funzioni principali dell'opzione.
Stampa un messaggio nel registro delle attività o in quello di debug. Le parentesi sono facoltative. Questo comando accetta un solo parametro, costituito da un valore di stringa. Per informazioni sul secondo parametro facoltativo, vedere Livelli di stampa. Se non risulta specificato alcun livello di stampa, il parametro predefinito è GENERALE.
string (valore di stringa)
print (<string>);
Stampa (Avviso: il file win.ini verrà sovrascritto);
Stampa una stringa nel registro delle eccezioni. Il registro delle eccezioni viene usato per visualizzare elementi che CA DMM non è riuscito a trasferire o per i quali non è stato possibile inoltrare le istruzioni di migrazione. Per esempio, lo script di Netscape Communicator stampa istruzioni dettagliate che descrivono le procedure di aggiornamento nel registro delle eccezioni. Lo script di MS Word stampa le impostazioni che non è stato possibile aggiornare. Il comando PrintException può essere usato solo in ApplyFunction. Per informazioni sul secondo parametro facoltativo, consultare Livelli di stampa. Se non risulta specificato alcun livello di stampa, il parametro predefinito è GENERALE.
string (valore di stringa)
PrintException (<string>);
PrintException ("Please remove the file c:\\windows\\netscapecommunication.ttt");
Recupera un valore della chiave di registro dal computer di origine o da quello di destinazione. Può accettare tre parametri: il percorso della chiave, il nome del valore e un booleano. I primi due parametri sono obbligatori e sono valori di stringa. Il terzo parametro è facoltativo. Se il terzo parametro è Vero, CA DMM effettua la ricerca sul computer di origine, altrimenti su quello di destinazione. Il suo valore predefinito è Falso. Il comando restituisce Falso se non è stato possibile recuperare il valore.
Nota: il terzo parametro booleano può essere utilizzato solo durante le funzioni Generale e Applica. Se usato in altro modo, provoca un errore di sintassi o di runtime.
Il percorso della chiave (valore di stringa)
Il nome del valore (valore stringa)
Il computer (valore booleano)
Value = RetrieveValue(<Key Path>, <Value Name>, [Boolean]);
RetrieveValue( "HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", SOURCE);
RetrieveValue( "HKCU\\Software\\Microsoft\\Office\\8.0\\Common\", "Tooltips", DESTINATION);
Indica a CA DMM di visualizzare la finestra di dialogo Riavvio richiesto al termine di una migrazione. Utilizzare questa funzione per gli script che richiedono un riavvio per completare la migrazione. L'unico valore necessario è un valore booleano che indica se lo script richiede un riavvio.
(valore booleano)
RestartRequired(<Boolean>);
RestartRequired(true);
|
Copyright © 2014 CA.
Tutti i diritti riservati.
|
|