The formal definitions for the elements in the agent resource. Also available as an XML file.
Agent |
Definition | A person who represents an organization, and is authorized to perform actions on its behalf |
Control | 1..1 |
Requirements | Need to track doctors, staff, locums etc for both healthcare providers, funders, etc. |
RIM Mapping | Role |
v2 Mapping | PRD (as one example) |
Agent.person |
Definition | The person who acts as the agent |
Control | 0..1 |
Type | Resource(Person) |
Must Understand | true |
Requirements | Need to be able to track the person who represents the organisation separately |
v2 Mapping | PRD-2 |
Agent.organization |
Definition | The organisation that is being represented |
Control | 0..1 |
Type | Resource(Organization) |
Must Understand | true |
Requirements | Need to be able to track the represented organisation separately |
v2 Mapping | PRD-10 (-> 14) |
Agent.role |
Definition | The way in which the person represents the organisation - what role do they have? |
Control | 0..* |
Type | CodeableConcept from AgentRole |
Must Understand | true |
Requirements | Need to know what authority the agent has - what can they do? |
Comments | A person may have more than one role. At least one role is required - why have an agent who isn't actually an agent? |
v2 Mapping | PRD-1 |
Agent.specialty |
Definition | Represents a specific specialty within the healthcare facility under which the agent acts |
Control | 0..* |
Type | CodeableConcept from AgentSpecialty |
Agent.period |
Definition | The time period during which the agent was/is authorised to represent the organisation. |
Control | 0..1 |
Type | Period |
Requirements | Agencies are often for a limited period of time, and can be revoked. Even after the agencies is revoked, the fact that it existed must still be recorded |
v2 Mapping | PRD-8/9 |
Agent.identifier |
Definition | An identifier that applies to this person in this role |
Control | 0..* |
Type | HumanId |
Must Understand | true |
Requirements | Often, specific identifies are assigned for the agent |
Comments | The identifier changes when a new/different person steps into the same role |
v2 Mapping | PRD-7 |
Agent.address |
Definition | A postal address for this person playing this role |
Control | 0..* |
Type | Address |
Comments | i.e. the address is not their personal address. For many agents, this is the same as their work address |
v2 Mapping | PRD-3 |
To Do | What about place? (PRD-4) |
Agent.contact |
Definition | A contact detail address for this person playing this role |
Control | 0..* |
Type | Contact |
Comments | i.e. the contact is not their personal contact. For many agents, this is the same as their work contacts. Note that a person may choose to use a personal mobile phone (for instance) for their contact in a given role - in this case, the contact detail will be repeated in the agent resource |
v2 Mapping | PRD-5 |
Agent.extension |
Definition | See Extensions |
Control | 0..* |
Type | Extension |
Agent.text |
Definition | Text summary of resource (for human interpretation) |
Control | 1..1 |
Type | Narrative |