Previous | Table of Contents | Next
Attributes
Attribute
Value
Identifying Attributes
Name
agentRole
Label
Agent Role
Defined by
Government of Canada Records Management Metadata Standard - agentRole
Element URI
[To be actioned by Treasury Board of Canada, Secretariat before publication]
Definitional Attributes
Definition
A category that identifies the function or responsibility of a particular individual at the time an action was taken on a record or file.
Purpose
To identify the records management role played by a particular individual at the time an action was taken on a record or file for evidentiary requirements.
To provide consistency, through the use of assigned values, in the description of the broad records management roles and responsibilities that are carried out across the Government of Canada.
Rationale
"Techniques to ensure capture of records may include…d) systems which profile or template the actions undertaken in doing business, which…4) identify who has accessed a record…" ISO International Standard 15489-1, s. 9.3
"Managing the use of records encompasses a) identifying the records system user permissions associated with individuals and their positions within the organization…" ISO Technical Report 15489-2, s. 4.3.8
"At the point of record capture, metadata should include metadata about agents associated with records and their management. Ensuring metadata about agents that are captured, enables contextual information about agents involved in record creation and management to be documented… Agent metadata at the point of record capture should
a) identify the agents involved in records creation,
b) identify the agents involved in records management processes and their authorisation…
c) identify the agents authorized to access records." ISO Technical Specification 23081-1, s. 9.4.1
"The role of agents changes over time. Records systems need to capture these changes. This contextual information is necessary for understanding records." ISO Technical Specification 23081-1, s. 9.4.2
Value Domain
Enumerated strings of text representing roles.
Datatype Name
String
Constraint
Applicable at record level and file level.
Obligation
Mandatory at record level; mandatory at file level.
Relational Attributes
Encoding Scheme
Institution-specific scheme
References
-
Linkages
Agent Individual Identifier; Agent Individual Name
Conditions of Application - Record
Format
Text, based on encoding scheme.
Modifiable
Pre Record Declared Locked
Post Record Declared Locked
No
No
Occurrence
Not repeatable
Conditions of Application - File
Format
Text, based on encoding scheme.
Modifiable
No
Occurrence
Not repeatable
Comments and Guidance
a) Explanation of Definition/Usage
This element relates to the role that an agent played when they performed an action on a record or file. Agent Role relates to records management only. It is one of the elements that constitute a management and event history log.
Agent Role is not related to the element Agent Position Title, which identifies the position the agent holds within the organization.
Agent Role will be repeated in the log file for each action that is taken, but since only one action can take place at one single point in time, it is deemed as "Not repeatable".
b) Best Practices
The list of available records management roles will be determined by business rules and will be institution specific.
Since this element is used for audit purposes, the value cannot be modified.
If an institution uses a Human Resources Information System such as PeopleSoft this system should be the authoritative source for all agent data; however this data must be reliably maintained over time to be useful. Agent data must be retrievable as a "snapshot" for any given date and time in order to prove in what capacity the agent was acting when performing an action on a record or file. Links to databases that are dynamic in nature and retain only current information about an agent do not satisfy the requirements of a management and event history log for the record or file. Therefore, best practice may dictate that the information about the agent be brought inside the EDRMS and possibly stored within an agent database.
It is up to the institution to determine how to implement the management and event history log. Each time an agent performs an action on a record or file, all information about the agent may be written to the log of the record or file, or alternatively, only one element (e.g. Agent Individual Identifier or Agent Individual Name) may be written to the log of the record or file yet permit linkage to the separate agent database containing other information about the agent.
In order to minimize storage concerns of writing to each record or file all information about the agent, recommended best practice is to maintain a table within the EDRMS that records information about each agent and the elements that relate to them. This table will be maintained as a type of agent database, with new entries made for each change of the agent's information. In this way, a "snapshot" of an agent's status can always be retrieved for evidentiary purposes. This agent database would then be linked to the management and event history log of the record or file through the common element Agent Individual Identifier or Agent Individual Name, i.e. as long as Agent Individual Identifier or Agent Individual Name is written to the management and event history log of the record or file, information about the agent can be retrieved from the agent database.
In the above scenario, when moving records and files out of the institution, the information about the agent must be moved also in order to properly maintain the integrity of the management and event history log of the records and files.
c) Obligation
This element is mandatory for evidentiary purposes. It is important to know the role that an agent played when they performed an action on a record or file since the role adds context to the action performed.
d) Default Values/Auto-populate
This element is used as a log entry only and is not part of a record or file profile; therefore, all values for this element will be auto-populated by the EDRMS.
e) Linkages
This element is linked only to Agent Individual Identifier and Agent Individual Name. Through those elements, it is linked to all other agent elements and all event elements in order to constitute a management and event history log.
f) Examples