These parameters are specifically for importing files into CA DataMinder. Use them to associate CA DataMinder users with imported files and to determine how file capture dates are set. For Import Policy operations, you can also specify which user policy is applied to the imported files.
Note: Do not confuse these ImpFile.* parameters with the File.* file handling parameters, which cover such areas as the location of the source files to be imported, and whether to search subfolders for target files.
No default value. This parameter identifies which user policy is applies to imported files. It is mandatory when importing files as part of an Import Policy operation. The syntax is:
ImpFile.PolicyParticipant=<email address>, Yes or No
This parameter must be set to an email address followed by Yes or No. You must include a comma before the Yes or No option. This address must match an address associated with a CA DataMinder user (as listed in the User Properties dialog in the Administration console).
This parameter is only used when importing files as part of an Import Policy operation. For example, you may want to apply policy to imported files in order to categorize or apply smart tags to important business documents. When the policy engine processes an imported file, it maps the specified email address to a CA DataMinder user account and applies that user’s policy.
The Yes or No option determines whether this ‘policy user account’ is added to the list of event participants (in this case, the users associated with imported file). If set to:
The specified account is added to the list of event participants. Choose this option if you want to apply a specific user’s policy to the imported file and associate that same user with the resulting file event.
The specified account is not added to the list of event participants. You typically may choose this option if the ‘policy user account’ is not a real person, but simply an account that you use to apply a specific set of policy triggers. For example, you may have a Compliance user account with a customized user policy designed to enforce a specific set of regulations.
If you do not specify Yes or No, you do not need a comma and ImpFile.PolicyParticipant defaults to Yes.
No default value. Use this parameter to identify any CA DataMinder user associated with, or linked to, imported files. The syntax is:
ImpFile.AssociatedParticipant=<email address>
Typically, this user will be the author of the file. For example, if importing files from a specific user’s workstation or from their share on a file server, you can use this parameter to associate those files with that user.
The parameter must be set to an email address that matches an address associated with a CA DataMinder user account (as listed in the User Properties dialog in the Administration console). A single Event Import operation can only include a single instance of this parameter. For example, to associate all imported files with Spencer Rimmel, add this line to the import configuration file:
ImpFile.AssociatedParticipant=srimmel@unipraxis.com
If no associated participant is specified
All imported files are automatically associated with the machine hosting the source folder (only if the source folder is hosted locally—see the note below). Specifically, an address matching the machine’s domain name in Active Directory is associated with each imported file event and stored in the CMS database. This machine ‘address’ takes the form /cn=<computer name>/cn=computers. For example:
/cn=UX-MILAN-W2K3/cn=computers
This means that even if this parameter, ImpFile.AssociatedParticipant, is not used, each imported file is still associated with a ‘host machine’ address. In this situation (based on the example above), to ensure that files imported from host machine UX-MILAN-W2K3 can be retrieved during an iConsole event search, you would need to add the above machine address to the list of addresses specified for an appropriate CA DataMinder user account. You add new addresses in the User Properties dialog in the Administration console.
Note: If the import source folder is on a network mapped drive or a UNC path, a host machine address is not created and the resulting file event is not associated with a machine address.
Note: For further details about mapping file events to CA DataMinder users, see the ‘Event Participants’ technical note, available from CA Support.
Defaults to Yes. This parameter specifies how the capture date assigned to imported files is determined. The syntax is:
ImpFile.EventDateFromFile=Yes or No
If set to:
The timestamp reflects the time and date when the file was last modified.
The timestamp reflects the time of import.
Defaults to No. Use this parameter to explicitly flag imported file events as being captured by the Network Boundary Agent (NBA). This enables you to search directly for NBA events in the iConsole or Data Management console. The syntax is:
ImpFile.SourceIsNBA=Yes or No
If this parameter is set to:
All imported files in the current job are flagged as NBA file events.
When you search for file events in the iConsole or Data Management console, NBA file events are identified in the Event Type column by icons and described as ' A file moving over the network'.
Imported files are not differentiated by import or capture source. When you search for file events, all file events (including those captured by the File Scanning Agent or imported from Windows machines) are represented in the Event Type column by icons and described simply as 'File'.
Copyright © 2014 CA.
All rights reserved.
|
|