Previous | Table of Contents | Next
Attributes
Attribute
Value
Identifying Attributes
Name
agentInstitutionalEntity
Label
Agent Institutional Entity
Defined by
Government of Canada Records Management Metadata Standard - agentInstitutionalEntity
Element URI
[To be actioned by Treasury Board of Canada, Secretariat before publication]
Definitional Attributes
Definition
The formal name of the work group, unit of work, business unit, etc. of the individual who performed an action on a record or file at the time the action was taken.
Purpose
To provide further refinement of institutional information about the agent for evidentiary requirements.
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 names of institutional entities.
Datatype Name
String
Constraint
Applicable at record level and file level.
Obligation
Optional at record level; optional 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 is used to define further the organization to which an agent belongs. It is one of the elements that constitute a management and event history log.
It is not to be confused with the element Trustee Institutional Entity which specifies the name of the institutional entity of the steward of the record. Trustee Institutional Entity is not used within a management and event history log.
This element 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 value for this element should be able to be extended to whatever level deemed appropriate. - Branch-Division-Section. This level should be determined through institution-specific business rules. Acronyms and codes should not be used when describing the business unit of the agent. In developing an institution-specific encoding scheme, institutions may wish to consult internal organization charts or GEDS and expand as required.
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 deemed optional. While an institution may have legal status, the workgroup does not.
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