Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-28184

Clarify agent.type vs agent.role

    XMLWordPrintableJSON

    Details

    • Type: Change Request
    • Status: Resolved - change required (View Workflow)
    • Priority: Medium
    • Resolution: Persuasive
    • Specification:
      FHIR Core (FHIR)
    • Raised in Version:
      R5
    • Work Group:
      Security
    • Related Artifact(s):
      Provenance
    • Resolution Description:
      Hide
      Provenance.agent.type
      Element Id Provenance.agent.type
      Definition The primary act of participation of the agent with respect to the activity.
      Cardinality 0..1
      Terminology Binding ParticipationRoleType (Extensible)
      Type CodeableConcept
      Requirements Functional roles reflect functional aspects of relationships between entities. Functional roles are bound to the realization/performance of acts, where actions might be concatenated to an activity or even to a process.
      This element will hold the functional role that the agent played in the activity that is the focus of this Provenance. Where an agent played multiple functional roles, they will be listed as multiple .agent elements representing each functional participation.
      Note: The .type of author could be .role of primary author. Note there are overlapping codes to be used in specific circumstances. See ISO 21298:2018 - Health Informatics - Functional and structural roles+, and ISO 22600-2:2014 - Health Informatics - Privilege Management and Access Control - Part 2: formal models+.
      Summary true
      Comments For example: assembler, author, doctor, nurse, clerk, prescriber, signer, investigator, etc.
      Provenance.agent.role
      Element Id Provenance.agent.role
      Definition The functional or structural roles of the agent indicating the agent's competency. The security role enabling the agent with respect to the activity.
      Cardinality 0..*
      Terminology Binding SecurityRoleType (Example)
      Type CodeableConcept
      Requirements Note: The .type of author could be .role of primary author. Note there are overlapping codes to be used in specific circumstances.
      Structural roles reflect the structural aspects of relationships between entities. Structural roles describe prerequisites, feasibilities, or competences for acts. Functional roles reflect functional aspects of relationships between entities. Functional roles are bound to the realization/performance of acts, where actions might be concatenated to an activity or even to a process.

      See ISO 21298:2018 - Health Informatics - Functional and structural roles+, and ISO 22600-2:2014 - Health Informatics - Privilege Management and Access Control - Part 2: formal models.+
       |

      Comments For example: PRIMAUTH, REVIEWER, VERF, etc.Chief-of-Radiology, Nurse, Physician, Medical-Student, etc 
      Show
      Provenance.agent.type Element Id Provenance.agent.type Definition The primary act of participation of the agent with respect to the activity. Cardinality 0..1 Terminology Binding ParticipationRoleType  ( Extensible ) Type CodeableConcept Requirements Functional roles reflect functional aspects of relationships between entities. Functional roles are bound to the realization/performance of acts, where actions might be concatenated to an activity or even to a process. This element will hold the functional role that the agent played in the activity that is the focus of this Provenance. Where an agent played multiple functional roles, they will be listed as multiple .agent elements representing each functional participation. Note: The .type of author could be .role of primary author. Note there are overlapping codes to be used in specific circumstances. See ISO 21298:2018 - Health Informatics - Functional and structural roles+ , and ISO 22600-2:2014 - Health Informatics - Privilege Management and Access Control - Part 2: formal models +. Summary true Comments For example: assembler, author, doctor, nurse, clerk,   prescriber, signer, investigator, etc. Provenance.agent.role Element Id Provenance.agent.role Definition The functional or structural roles of the agent indicating the agent's competency. The security role enabling the agent with respect to the activity. Cardinality 0..* Terminology Binding SecurityRoleType  ( Example ) Type CodeableConcept Requirements Note: The .type of author could be .role of primary author. Note there are overlapping codes to be used in specific circumstances. Structural roles reflect the structural aspects of relationships between entities. Structural roles describe prerequisites, feasibilities, or competences for acts. Functional roles reflect functional aspects of relationships between entities. Functional roles are bound to the realization/performance of acts, where actions might be concatenated to an activity or even to a process. See ISO 21298:2018 - Health Informatics - Functional and structural roles+ , and ISO 22600-2:2014 - Health Informatics - Privilege Management and Access Control - Part 2: formal models. +  | Comments For example: PRIMAUTH, REVIEWER, VERF, etc. Chief-of-Radiology, Nurse, Physician, Medical-Student, etc  
    • Resolution Vote:
      Kathleen Connor / Alexander Mense: 6-0-0
    • Change Category:
      Clarification
    • Change Impact:
      Non-substantive
    • Applied for Version:
      R5

      Description

      type should be clearly the functional role that is used with respect to the activity. Other functional roles are not relevant. the .role should be structural roles only, not including functional role. Thus need better separation of the valueSets between these two. Not clear where we have a valueSet of structural roles, might need to invent an example valueSet showing examples of structural roles.

      Provenance.agent.type
      Element Id Provenance.agent.type
      Definition The primary act of participation of the agent with respect to the activity.
      Cardinality 0..1
      Terminology Binding ParticipationRoleType (Extensible)
      Type CodeableConcept
      Requirements Note: The .type of author could be .role of primary author. Note there are overlapping codes to be used in specific circumstances. See ISO 21298:2018 - Health Informatics - Functional and structural roles.
      Summary true
      Comments For example: assembler, author, doctor, nurse, clerk, etc.
      Provenance.agent.role
      Element Id Provenance.agent.role
      Definition The functional or structural roles of the agent indicating the agent's competency. The security role enabling the agent with respect to the activity.
      Cardinality 0..*
      Terminology Binding SecurityRoleType (Example)
      Type CodeableConcept
      Requirements Note: The .type of author could be .role of primary author. Note there are overlapping codes to be used in specific circumstances. See ISO 21298:2018 - Health Informatics - Functional and structural roles.
      Comments For example: PRIMAUTH, REVIEWER, VERF, etc.

        Attachments

          Activity

            People

            Assignee:
            john_moehrke John Moehrke
            Reporter:
            john_moehrke John Moehrke
            Watchers:
            1 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:
              Vote Date: