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 |