SmartIQ2CM User Manual 3.1.0
  • 21 Oct 2022
  • 11 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

SmartIQ2CM User Manual 3.1.0

  • Dark
    Light
  • PDF

Article Summary

SEND TO CONTENT MANAGER (CM)

The connector allows you to place a Send to CM action within your Project.
From this Send to CM Action you can complete the following sections:

CREATE ELECTRONIC DOCUMENT IN CM

Once a document is generated with SmartIQ you can have this document automatically registered into Content Manager via the Send to CM Action.

With the connector, new fields are available for mapping. These include Alternative Container, Client, and a Blank Record field.

CREATE BLANK RECORDS IN CM

Where the term Blank Record is referred to this was designed with the idea of being able to create a Folder (or Container) when registering a document. Effectively giving you the ability to make a record in Content Manager that isn't an electronic document such as a folder/container or other record type you may choose to contain your generated documents in.

A reason you may be required to use a Blank Record is when generating a document through SmartIQ, you want to save to a specific folder within Content Manager that wasn't yet created. There is no requirement to create the folder first making it a two-step process.

UPDATE EXISTING RECORD METADATA IN CM

The connector will allow you to update the metadata (properties) of any record already existing in Content Manager.

UPDATE ELECTRONIC DOCUMENTS FOR EXISTING RECORDS IN CM

The connector will provide you with the ability to update an existing document in Content Manager. The update can be done by creating a new revision or by replacing the existing document.

CONTENT MANAGER/RM/TRIM

In version 9.0 Records Manager was renamed to Content Manager. HPE has also been acquired by Micro Focus. Please take this into consideration when referenced throughout the document as some references may still refer to HPERM or CM when running different versions. All settings still apply.

SETTING UP THE SEND TO CM ACTION

The following instructions outline how to utilise the Send to Trim Action within the SmartIQ Design application.

ADDING SEND TO CM ACTION TO PROJECTS

  1. Browse to the Manage page and select the Design Button in the top right corner of the window
    image.png

  2. Open a Project or a New Project with your SmartIQ Design Application
    image.png

  3. Select the Actions menu in the right pane of the Design interface to access your list of actions
    image.png

  4. Select and drag the Send to CM action into
    image.png

  5. Once added, the Action will appear under the Finish section, onto a Workflow Transition, or into a Run Action Button
    image.png

ADDING ACTION ATTRIBUTES

  1. Click on the Send to CM action to view the Action Properties pane
    image.png

  2. To start adding Inputs, click on the action input drop-down menu and select the required Content Manager input
    image.png

  3. Select the Input and define what answer Type you want to it be set to, to obtain the required information from the project
    image.png

image.png

  1. In this example, a Text Value will be used and set statically to 3463
    image.png

  2. Click on the Add button to add the Attribute to the list
    image.png

The result of which would look like the below
image.png

  1. The following table provides an explanation on each Action Attribute that can be used
ACTIONDESCRIPTION
Access Control: Contribute ContentsUse a list of location unique identifiers separated by a comma to add these locations to the "Contribute Contents" access control of the records being created by the action.
Example: 1000,1001
NOTE: Setting the value to 0 will overwrite the default record access of the record type and set the access control as open to everyone.
Access Control: Contribute Contents Overwrite [True/False]Set value to "True" if you want to overwrite any default list of locations on the "Contribute Contents" access control with the list of locations provided to the "Access Control: Contribute Contents" input.
Access Control: DestroyUse a list of location unique identifiers separated by a comma to add these locations to the "Destroy" access control of the records being created by the action
Example: 1000,1001
NOTE: Setting the value to 0 will overwrite the default record access of the record type and set the access control as open to everyone.
Access Control: Destroy Overwrite [True/False]Set value to "True" if you want to overwrite any default list of Locations on the "Destroy" access control with the list of locations provided to the "Access Control: Destroy" input.
Access Control: Modify Record AccessUse a list of location unique identifiers separated by a comma to add these locations to the "Modify Record Access" access control of the records being created by the action.
Example: 1000,1001
NOTE: Setting the value to 0 will overwrite the default record access of the record type and set the access control as open to everyone.
Access Control: Modify Record Access Overwrite [True/False]Set value to "True" if you want to overwrite any default list of locations on the "Modify Record Access" access control with the list of locations provided to the "Access Control: Modify Record Access" input.
Access Control: Update DocumentUse a list of location unique identifiers separated by a comma to add these locations to the "Update Document" access control of the records being created by the action
Example: 1000,1001
NOTE: Setting the value to 0 will overwrite the default record access of the record type and set the access control as open to everyone.
Access Control: Update Document Overwrite [True/False]Set value to “True” if you want to overwrite any default list of locations on the “Update Document” access control with the list of locations provided to the “Access Control: Update Document” input.
Access Control: Update Record MetadataUse a list of location unique identifiers separated by a comma to add these locations to the "Contribute Contents" access control of the records being created by the action.
Example: 1000,1001
NOTE: Setting the value to 0 will overwrite the default record access of the record type and set the access control as open to everyone.
Access Control: Update Record Metadata Overwrite [True/False]Set value to “True” if you want to overwrite any default list of locations on the “Update Record Metadata” access control with the list of locations provided to the “Access Control: Update Record Metadata” input.
Access Control: View DocumentUse a list of location unique identifiers separated by a comma to add these locations to the "View Document" access control of the records being created by the action.
Example: 1000,1001
Please note that setting the value to 0 will overwrite the default record access of the record type and set the access control as open to everyone.
Access Control: View Document Overwrite [True/False]Set value to “True” if you want to overwrite any default list of locations on the "Contribute Contents" access control with the list of locations provided to the “Access Control: View Document” input.
Access Control: View MetadataUse a list of location unique identifiers separated by a comma to add these locations to the "View Metadata" access control of the records being created by the action.
Example: 1000,1001
Please note that setting the value to 0 will overwrite the default record access of the record type and set the access control as open to everyone.
Access Control: View Metadata Overwrite [True/False]Set value to “True” if you want to overwrite any default list of locations on the “View Metadata” access control with the list of locations provided to the “Access Control: View Metadata” input.
Additional Contact [Contact Type=Location URI]Contact type (case-sensitive): Addressee, Author, Bcc, Cc, Client, Custom 1- 10, Other, Representative ‘=’ Comma-separated Location URIs e.g. Cc=123,234,345
AddresseeThe comma-separated location URIs of the Addressee(s) of the record e.g. 123,234,345
Alternative ContainerThe record number of the alternative container that the record will be alternatively contained within
AssigneeThe URI of the location of the assignee on the record
Attach ActionThe URI of the action. Must be used in conjunction with “Attach Action – Default Assignee”.
Attach Action – Default AssigneeThe URI of the default assignee location for the action being attached to the record. Must be used in conjunction with “Attach Action”.
Attach WorkflowThe URI of the workflow template to instantiate
AuthorThe comma-separated location URIs of the author(s) on the record e.g. 123,234,345
Blank Record [True/False]Set to True to create a blank Record without any electronic document attachments. No documents will be generated in this case.
ClassificationThe URI of the classification of the record e.g. 7666
ClientThe comma-separated location URIs of the client(s) on the record 123,234,345
ContainerThe record number of the container that the record will reside within
CreatorThe URI of the creator location
ConvertToPDFSet to “True” if the attached document is to be converted to a PDF document.
Database IDThe 2 alphanumeric characters of the dataset to connect to.
NOTE: This will override the default connector settings
Date ClosedThe date the record was closed
Date DueThe date the record is due
External IDAllows the insertion of data into the External ID field on records
Finalize Record [True/False]Set to "True" to finalize record upon creation
HomeThe URI of the location of the home on the record
NotesThe notes that will be applied to the record
OwnerThe URI of the owner location on the record
PasswordThe password of the user account that connects to the Content Manager dataset
NOTE: This will override the default connector settings.
Previous Part URIThe URI of the record to create a new part for. This attribute can be used in conjunction with the “Title” attribute to set the title of the newly created part. No documents will be generated in this case.
Record NumberAllows you to define the record number that will be used when creating the record. Used were record type numbering patterns utilise manually generated numbers.
Record TypeThe record type of the new record.
NOTE: This will override the default connector settings
Related ToThe URI that this record will be related to
Retention ScheduleThe URI of the retention schedule that is to be applied to the record
Security CaveatThe URI of the security caveat that is to be applied to the record. This input supports multiple Caveats by using a comma separator.
Example: 20,45
Security Caveat Overwrite [True/False]Set value to “True” if you want to overwrite any default or existing security caveats with the list defined in the “Security Caveat” input
Security LevelThe name of the security level of the record.
NOTE: This will override the default connector settings
Software Stamp (Notes)This is the text that gets appended to the user stamp that automatically gets added to the notes field of the record being generated. By default, this is set to ‘via SmartIQ’.
TitleThe title of the record. If no value is defined, the title will be set to the document file name
Update Via UriThe URI of the record to update
Update Via Record NumberThe record number of the record to update.
Update [True/False]Set to True to update an existing record. This is a prerequisite for the ‘Update As Revision’ and ‘Update Record Details’ attributes when set to "True"
Update As Revision [True/False]Setting to “True” will create a new revision of the document. Setting to “False” will replace the current revision of the document.
Update Record Details [True/False]Set to "True" to update metadata on an existing record
User Defined Field [name=value]Set a user defined field or fields (additional field) of a record
For location values add the URI of the location.
E.g. Responsible Person=1234
UsernameThe user account that will deliver the documents to Content Manager. This location will also appear as the creator for all documents generated via SmartIQ**
E.g. smartiq, domain\smartiq
Workgroup Server NameName of the workgroup server to connect to.
NOTE: This will override the default connector settings
Workgroup Server PortThe workgroup server port number. By default, this is 1137.
NOTE: This will override the default connector settings
* Indicates a mandatory field. These can also be defined in the connector settings

ADDING THE RECORD NUMBER TO A DOCUMENT

To insert the Record Number into the body of the Document created by SmartIQ:

  1. Open the Document template in Design view
  2. Place the following tag anywhere in the document where the Record Number is to be inserted
    {{rm_record_number}}
  3. Save and close the template document

USING THE CONVERT TO PDF ACTION INPUT

In order to insert the Record Number into PDF Documents you will need to ensure the following:

  1. The outputted document from SmartIQ is not in PDF format (Example: Output as a Word Document)
  2. The ConvertToPDF is set to true
    This is because the connector needs to receive the document in an editable format before converting it to PDF
    If you supply the outputting document as a PDF, it will only create the metadata and you will receive a failed notification in Management.

ADDING THE RECORD NUMBER OR URI TO AN ACTION

The Record Number or URI of a Document can be returned within another Action in the same Project.
For example, to display the Record Number on the last page of the generation process, follow the steps below:

  1. Add the Display Message action
    image.png

  2. In the Properties Pane of the Display Message Action, under Attribute select Message, then click on the arrow on the right of the Fixed Value box
    image.png

  3. In the Question Set, expand the Send to CM to show the Action outputs, then click on Record Number
    image.png

  4. You should see the [Action Name.Record Number] inserted into the Text Value field.
    image.png

  5. Click on Add, then save the Project

The same steps can be followed to return the URI within an action.


Was this article helpful?