Registry - Create Value

Declaration

<AMREGISTRY ACTIVITY="write_value" KEY="text" VALUE="text" 
VALUEDATA="text" TYPE="text (options)" />

Description: Sets the specified name/value pair on the specified registry key.

WARNING: Incorrectly editing the registry may severely damage your system. Before making changes to the registry, you should back up any valued data on your computer.

Practical Usage

Used to write a value and optional data to the registry. Necessary keys will be automatically created.

General Parameters

Property

Type

Required

Default

Markup

Description

Value type

Text (options)

Yes

string

  1. TYPE="string"

  2. TYPE="dword"

The registry data type to create. The available options are:

  • String (default) - Create a STRING value, whichconsists of plain readable text. All data types ending with SZ are STRING values.All STRING values are indicated by an AB icon.

  • Dword- Create a DWORD value, which consists of binary data. System policy settings, device drivers, and services use DWORD values the most.

Registry key

Text

Yes

(Empty)

  1. PDFDOCUMENTFROM="new_file"

  2. PDFDOCUMENTFROM="existing_file"

The registry key (folder) in which to set the new value. Click the folder icon to open a standard registry viewer that you can use to navigate to the desired registry key.

Value name

Text

Yes

(Empty)

SOURCE="C:\PDFFileName.pdf"

The name of the registry value to create.

NOTE: When you add a registry value to a registry key, the new registry value name and data type are saved with default data.

Value data

Text

Yes

(Empty)

NEWPDF="C:\PDFFileName.pdf"

The registry value data to write. The Registry key and Value name must be specified along with this value for proper functionality.

Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.

Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)

On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)

Examples

The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: Write "theData" to value "temp" in key "HKEY_LOCAL_MACHINE\SOFTWARE\Network Automation\AutoMate 10\TaskService" as a String.

<AMREGISTRY ACTIVITY="write_value" KEY="HKEY_LOCAL_MACHINE\SOFTWARE\
Network Automation\AutoMate 10\TaskService" VALUE="temp" VALUEDATA="theData" />