ManageRecordCollection Parameters and Valid Execution Modes
The valid execution mode for ManageRecordCollection is SYNCHR.
The parameters of ManageRecordCollection are as follows:
Name | Semantics | Type | Valid Values | Multi-plicity |
---|---|---|---|---|
Direction: In | ||||
AsynProcessIndicator (Optional) | See Common Parameters. | |||
BundlingOption (Optional) | This parameter indicates if records should be converted to record hierarchies. If set to true, the output record collection will have hierarchies of the record based on specified relationships. When record hierarchies are being created, a repository should be specified as input and would be used as root repository.
If bundlingOption is set to false, no hierarchies are created. This is typically used when you need to create a record collection of all records in the input document or event so that this record collection can be processed by other workflow activities. Note that if input document is not specified, a repository can be specified as input so that the resulting record collection will contain records belonging to specified repository only. |
boolean | True
False |
0..1 |
IncludeDraftRecords (Optional) | See Common Parameters. | |||
InDocument (Optional) | See Common Parameters. | |||
InRecordList (Optional) | See
Common Parameters.
Input RecordList. If none is specified, all records associated with the event are considered. This parameter is required only if SetRecordListReadOnly is true. |
recordlist | Existing RecordList. | 0..1 |
MasterCatalog (Optional) | When both MasterCatalog and Indoc are specified as input to ManageRecordCollection, the catalog specified in the MasterCatalog parameter is used for bundling.
This parameter allows you to limit the record collection to a specific repository, if BundlingOption=false.
|
string | 0..1 | |
PerspectiveName (Optional) | See CreateWorkItem Parameters and Valid Execution Modes. | |||
RecordPerAsyncCall (Optional) | See Common Parameters. | |||
RelationshipName#
(Optional) |
See Common Parameters. | |||
setRecordListReadOnly (Optional) | A boolean to determine whether the activity should take the incoming record list object and set it to be read-only. | boolean | True
False (default) |
1 |
VersionOption (Optional) | See Common Parameters. | |||
Direction: Out | ||||
OutRecordList | See Common Parameters. | |||
RecordsProcessed (Optional) | Number of records added to the newly created record list. | long | ||
BundlesCreated
(applicable since version 7.1) |
Number of bundles created using the specified relationship name. | long |
The following table describes how the activities process input records and valid input combinations.
Bundling | InDoc | Repository | Relation Name | Behavior |
---|---|---|---|---|
True | N/A | N/A | N | The following message is shown: None of the specified relationships are valid or none specified. |
Y | N | Y | Bundles for specified relation name and relationships are not validated. | |
Y | Y | Y | Repository is used to validate relationships. | |
N | N | Y | All records associated with the event are processed. Relationships are not validated. This is the slowest execution mode. | |
N | Y | Y | All records associated with the event are processed. Relationships are validated. Processing happens in two passes. The first pass attempts to create bundles for a specified repository. The second pass processes only those records from other repositories which are not already associated with the roots identified so far.
First, all records associated with the specified repository are processed. Next, all remaining records are processed if they are not already part of bundle created in the first pass. |
|
False | Y | N/A | N/A | Relationships specified are ignored. Repository name specified is ignored. |
N | Y | N/A | Relationship name is ignored.
All records associated with the event are added to output record collection if they belong to the specified repository. |
|
N | N | N/A | Relationship name is ignored.
All records associated with event are added to output record collection. |