Accès en programmation au fichier d'options DMM

Manuel de référence › Fichiers de commandes et d'encapsulation › Accès en programmation au fichier d'options DMM

Accès en programmation au fichier d'options DMM

Vous pouvez accéder à un fichier d'options DMM et modifier les options par programme.

DNAXMLAccess.dll est fichier DLL ATL COM qui prend en charge l'interface IDispatch. Un composant peut ainsi être appelé directement à partir d'un programme Visual Basic ou de tout langage de script prenant en charge les contrôles ActiveX. Quelques exemples de fonctions membre utilisées pour accéder aux fichiers DNA sont présentés ci-après :

Ouverture du fichier indiqué par bstrFile pour y accéder. Ce fichier doit être un fichier d'options DMM valide sous la forme d'un fichier DNAOptions.xml.
```
HRESULT SetFile([in] BSTR bstrFile);
```
Ajout ou remplacement de l'option de chaîne de caractères indiquée par bstrOption par la valeur bstrValue.
```
HRESULT SetStringOption([in] BSTR bstrOption, [in] BSTR bstrValue);
```

Extraction de l'option de chaîne de caractères indiquée par bstrOption.

HRESULT GetStringOption([in] BSTR bstrOption, [out, retval] BSTR* bstrValue);

Ajout ou remplacement de l'option booléenne indiquée par bstrOption par la valeur fValue.

HRESULT SetBoolOption([in] BSTR bstrOption, [in] VARIANT_BOOL fValue); [out, retval] VARIANT_BOOL* fValue);

Extraction de l'option booléenne indiquée par bstrOption.
```
HRESULT GetBoolOption([in] BSTR bstrOption,
```
Ajout ou remplacement de l'option entier indiquée par bstrOption par la valeur lValue.
```
HRESULT SetIntOption([in] BSTR bstrOption, [in] LONG lValue);
```

Extraction de l'option entier indiquée par bstrOption.

HRESULT GetIntOption([in] BSTR bstrOption, [out, retval] LONG* lValue);

Exemple de Visual Basic :

Pour accéder au fichier d'options DMM en utilisant Visual Basic (pseudo-code) :

REM Create the CPM object for accessing 
Options file
DIM XMLAccess As CNAXMLAccessor
Set XMLAccess = New DNAXMLAccessor

REM Set the file to use for subsequent
XML calls, use the file path you copied above.
XMLAccess.SetFile
"c:\SomeFile\Path\To\MigrationSpecific\
XMLFile.xml"

REM Set any options that need to be customized for this migration
REM BOOL, INT, and STRING options are set like this:
XMLAccess.SetBoolOption "Network log

Pour accéder au fichier d'options DMM lorsque la ligne de commande excède la limite fixée à 255 caractères :
```
XMLAccess.SetStringOption "command line",
"/D" "c:\MyDNAFile.DNA" "/T"
"C:\MyTemplateFile.dtf"" /M /X"
```

Pour utiliser des appels Get* vers les fichiers d'options pour extraire des données après la migration :

REM Get any options that need to be retrieved after this migration
REM BOOL, INT, and STRING options are retrieved like this:
Dim StringVal As String
DIM BoolVal as Boolean
Dim IntVal As Integer
BoolVal = XMLAccessGetBool-Option("Network log enabled?')
StringVal = XMLAccess.GetStringOption("Network log level")