Misc elements in the Process Designer tool enhance capabilities of the Datawatch Automator.
The table below specifies functionality of the Misc group elements.
Element files (to both the file system and to FTP-compliant and WebDAV-compliant servers using http)
Writing to the Windows Event Log
Name – name of the graphic element.
Acceptable distribution actions:
Log – allows you to create an event written to WindowsApplication Event Log.
Email – allows you to email files to another user Move – allows you to move files to another location, either to the file system using drive letter or UNC naming, or to FTP and HTTP locations
Copy – allows you to copy files to another location, either to the file system using drive letter or UNC naming, or to FTP and HTTP locations
Delete – allows you to delete all files specified by the distribution
RSS – allows you to "pull" information as opposed to the
"push" model of Email
Email By Key – allows you to set the recipients of the E-mail, based on key. This option available only for the Summary Export element.
Detailed information on distribution settings is specified in the Distribution Settings table below. Designer scripts is the Process Designer Scripting APIsection.
Name – name of the graphic element.
Script field – displays the current script.
If the scripts has errors, all the errors are displayed below the Script field.
All namespaces and references, which specified in the Global Scripts of Automator Standard Processes, are imported in scripts of Automator Visual Processes.
There is no limit to what you can do with the scripting function of Datawatch Visual Process Designer Scripting API. The entire Microsoft .NET Framework is available for use.
You can use Visual Studio.NET to help create your scripts, or you can obtain the free Microsoft .NET Framework SDK.
Element
Name Description Properties and Comments
Note that while you can compile and test your scripts with the Visual Process Script, you must ensure that you are not using message boxes or other functions that interact with the UI when you are running the scripts as part of a process.
Credentials
Use it to specify the HTTP and/or FTP login credentials for input, model, export files from a FTP site or a SharePoint repository.
Name – name of the graphic element.
HTTP Credentials – specifies a name in the User name field and password in the Password field.
Note: To use the current windows login, select the corresponding check box.
FTP Credentials – specifies a name in the User name field and password in the Password field.
Timer
When configuring a process, one of the settings you can specify is a process retries setting.
This setting allows a process workflow to be retried if it fails for some reason, such as due to a process prerequisite not being met.
When specifying a process retries setting, you may specify the interval for the retry in hours and minutes, as well as the number of retries to attempt.
Name – name of the graphic element.
Retry at most – the maximum number of times that you want Automator to retry the process workflow.
Retry every – the desired retry interval in hours, minutes or seconds.
Distribution Settings
The table below specifies distribution actions.
Distribution
Action Description Procedure and Comments
Log
Allows you to create an event written to WindowsApplication Event Log.
This can be useful when using system management systems such as BMC Patrol, Tivoli, or Openview to tie in Datawatch
Type: Select the type from the drop-down list.
Event ID: Enter the event ID.
Message: Type the message in the text field.
Note: You may use the naming macros to provide a message for the log distribution. To do this, click the Insert Macro icon and select the naming macros from the
drop-Distribution
Action Description Procedure and Comments
Automator operations with your
overall systems. down list.
Email Allows you to email files to another user
Emailing procedure:
1. Specify the recipients' email addresses in the corresponding boxes: From, To, Cc, Bcc. To select recipients from the contacts list, click the Contacts icon.
2. Type the message subject in the Subject box.
Note: You may use the naming macros to provide a subject line for an email distribution. To do this, click the Insert Macro icon and select the naming macros from the drop-down list.
3. Type the message in the Message box.
4. Select the Attach files check box to attach a file for the distribution.
5. Select the Zip check box to archive the attached files.
The Zip Options appear.
6. Under Zip Options provide the following information:
Specify the Compression level from the following:
None, Medium, Maximum.
Select the Store directory path check box if necessary.
Select the Password check box to set the password.
7. Select the Attach links check box to attach a link to file.
Note: Please specify the Admin Host and Port information in the System Settings.
8. Select the One file per mail check box to attach only one file per mail.
9. Select the email Priority from the following: Low, Normal, High.
Move Allows you to move files to
another location, either to the file Moving procedure:
Distribution
Action Description Procedure and Comments
system using drive letter or UNC naming, or to FTP and HTTP locations.
1. In the Destination box, specify the destination folder.
You can either enter the destination folder path in the box or select the folder in the Browse section.
Click on Browse to expand the Browse section.
From the Named Paths list, select the appropriate named path.
Select the folder from the list displayed in the Named Path Content box.
Click Apply to add the folder.
2. In the Rename as box, specify a new file name if you want to change the file name.
Note: You may use the naming macros to name the moved files and destination folder. To do this, click the Insert Macro icon ( ) and select the naming macros from the drop-down list.
3. Select the Change extension to check box to change file's extension. Specify new extension in the enabled text box below.
4. Select the Zip check box, if you want to archive the file.
The Zip Options settings appear.
Note: The Zip check box is disabled if Change extension to check box selected.
Under Zip Options, provide the following information:
Select the Compression level from the following:
None, Medium, Maximum.
Select the Store directory path check box, if you want to store directory path.
Select the Set password check box to set the password.
5. Select the Overwrite check box to overwrite the existing file.
Copy Allows you to copy files to Copying procedure is similar to moving procedure (see
Distribution
Action Description Procedure and Comments
another location, either to the file system using drive letter or UNC naming, or to FTP and HTTP locations.
above).
Delete Allows you to delete all files specified by the distribution.
RSS
Allows you to "pull" information as opposed to the "push" model of Email.
RSS (Really Simple Syndication) is a widely used format for publishing information.
The RSS file must reside on a web server and be accessible to users who can read the RSS feed using one of the many free and commercial RSS news readers available on the market, for example, RSSBandit.
1. In the Feed box, specify the RSS file. You can either enter the destination folder path in the box or select the folder in the Browse section.
Click on Browse to expand the Browse section.
From the Named Paths list, select the appropriate named path.
Select the folder from the list displayed in the Named Path Content box.
Click Apply to add the folder.
2. Select the Create if not found check box if you want to create the file if the specified file is not found.
3. In the Title box, enter the item title.
4. In the Item description box, enter the item description.
Note: You may use the naming macros to provide a title and description for an RSS distribution. To do this, click the Insert Macro icon naming macros.zoom80 and select the naming macros from the drop-down list.
5. In the Link box, enter the name of link to the file.
6. Expand the Channel section to provide the channel parameters:
Title: Enter channel title.
Channel Description: Provide channel description.
Link: Enter the name of the link to the file.
Note: If you leave the Title, Channel Description, and Link fields blank the default values will be automatically assigned.
Distribution
Action Description Procedure and Comments
Max Items: Specify the maximum number of items.
Unlimited: Select this check box if you want to set the unlimited number of items.
Email By Key
Allows you to set the recipients of the E-mail, based on key. This option available only for the Summary Export element.
1. From: Type the address or click the Contacts icon to choose a sender.
2. To: Type the address or click the Contacts icon to choose a sender.
Note: When typing multiple addresses, separate them with semicolon.
3. Recipients: Allows you to set the recipients of the e-mail, based on key.
4. Subject: The subject line for the message. You can use the adjacent arrow icon to insert a naming macro.
5. Type the message in the Message box.
6. Select the Attach files check box to attach a file for the distribution.
7. Select the Zip check box to archive the attached files.
The Zip Options appear.
8. Under Zip Options provide the following information:
Specify the Compression level from the following:
None, Medium, Maximum.
Select the Store directory path check box if necessary.
Select the Password check box to set the password.
9. Select the One file per mail check box to attach only one file per mail.
10. Select the email Priority from the following: Low, Normal, High.