7.2.12 Edit Remote Command dialog box

Use the Edit Remote Command dialog box to set the remote command that the plug-in will execute. To display the Edit Remote Command dialog box, in the Create Plug-in dialog box or in the Edit Plug-in dialog box, click the Edit button in the Remote Command section.

Figure 7-14 Edit Remote Command dialog box (when Script is selected for Execution Mode and Attachment is selected for Setting the Scripts)

This dialog box displays the following items:

Platform

Shows the OS on the target devices of the remote command.

Execution Mode radio button

Select the execution mode of the remote command.

• Script
  To select a script created by a user, select this option.
  
• Command
  To select a command stored on the operation-target device, select this option.
  
• Do not Submit
  Not to execute a remote command, select this option.
  

Command line text box

Enter a command line. The text box allows a maximum of 8,192 characters. The Command line text box is displayed when you select either Script or Command for the Execution Mode radio button.

Insert All Input Properties button

If you click this button, all input properties defined for the plug-in are input to the Command line text box in the format of ?dna_property-key-1? ?dna_property-key-2?…. The Insert All Input Properties button is displayed when you select Script or Command for the Execution Mode radio button.

Setting the Scripts radio button

Select how to set the script. The Setting the Scripts radio button is displayed when you select Script for the Execution Mode radio button.

• Attachment
  To attach a script, select this option.
  
• Direct Input
  To directly enter the script, select this option.
  

File

Shows the file name of the script to be attached.

If the script file has already been uploaded, you can download the file by clicking the file name. File is displayed when you select Attachment for the Setting the Scripts radio button.

Select button

If you click this button, a dialog box appears that is used to select a script file to be attached. Specify a script file with a name that has no more than 90 characters. (If you specify a zip file, the relative path to the script file in the zip file must have no more than 90 characters.) Also, the total number of characters entered in the ID, Vendor ID, and File Name text boxes must be no more than 123. (If you specify a zip file, the relative path to the script file in the zip file must be assumed as the file name. Then the total must be no more than 123 characters.)

The Select button is displayed when you select Attachment for the Setting the Scripts radio button.

File Name text box

Enter the file name of the script that you entered in the Script text box. The file name must have no more than 90 characters. Also, the total number of characters entered in the ID, Vendor ID, and File Name text boxes must be no more than 123. The script whose name you entered in the Script text box will be uploaded with the file name set in the File Name text box. The File Name text box is displayed when you select Direct Input for the Setting the Scripts radio button.

Script text box

Enter the name of a script you want to execute on the operation-target device. The text box allows a maximum of 5,000 characters. The script whose name you entered in the Script text box will be uploaded with the file name set in the File Name text box. The Script text box is displayed when you select Direct Input for the Setting the Scripts radio button.

Mapping Definition of Output Properties

This section lists the mapping definitions of output properties. If you click the column title of a display item, the data will be sorted in ascending or descending order.

Table 7-8 Items displayed in Mapping Definition of Output Properties (Edit Remote Command dialog box)

Display item	Description
Key	Displays the property key of each output property.
Name	Displays the name of each output property.
Description	Displays the description of each output property.
Output Filter	Displays the output filter for each output property.

Edit button

To edit the output filter for the selected output property, click this button. If you click this button, the Edit Output Filter dialog box appears.

Specify the Details

If you click this, the Execution Directory text box and a list of environment variables are displayed.

Execution Directory text box

Enter a directory on the operation-target device. The specified command or script will be executed, targeted to that directory. The text box allows a maximum of 256 characters.

Environment Variable

This section lists the environment variables required when a command or script is executed. If you click the column title of a display item, the data will be sorted in ascending or descending order.

Table 7-9 Items displayed in Environment Variable (Edit Remote Command dialog box)

Display item	Description
Name	Displays the name of each environment variable.
Value	Displays the variable set for each environment variable.

Add button

To create an environment variable, click this button. If you click this button, the Create Environment Variable dialog box appears.

Edit button

To edit the selected environment variable, click this button. If you click this button, the Create Environment Variable dialog box appears.

Remove button

To delete the selected environment variable, click this button. If you click this button, a confirmation dialog box appears. If you click the OK button, the environment variable is deleted.

OK button

Click this button to apply the changes are applied.

Cancel button

Click this button to close the Edit Remote Command dialog box.