Implementation Guide for Portuguese Use Cases

PractitionerRole PT PS

Tree view

PractitionerRole	I		PractitionerRole	There are no (further) constraints on this element Element id PractitionerRole Short description Roles/organizations the practitioner is associated with Definition A specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time. Data type PractitionerRole Constraints dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources `contained.contained.empty()` dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()` dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource `contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference \| %resource.descendants().as(canonical) \| %resource.descendants().as(uri) \| %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()` dom-6: A resource should have narrative for robust management text.`div`.exists() dom-5: If a resource is contained in another resource, it SHALL NOT have a security label `contained.meta.security.empty()` Mappings rim: Entity. Role, or Act v2: PRD (as one example) rim: Role servd: ServiceSiteProvider w5: administrative.individual
id	Σ	1..1	id	There are no (further) constraints on this element Element id PractitionerRole.id Short description Logical id of this artifact Definition The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. Comments The only time that a resource does not have an id is when it is being submitted to the server using a create operation. Data type id
meta	Σ	0..1	Meta PT Core	There are no (further) constraints on this element Element id PractitionerRole.meta Short description Metadata about the resource Definition The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource. Data type Meta PT Core Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a rim: N/A
implicitRules	Σ ?!	0..1	uri	There are no (further) constraints on this element Element id PractitionerRole.implicitRules Short description A set of rules under which this content was created Definition A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc. Comments Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc. Data type uri Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a
language		0..1	codeBinding	There are no (further) constraints on this element Element id PractitionerRole.language Short description Language of the resource content Definition The base language in which the resource is written. Comments Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute). Data type code Binding IETF language tag Common Languages (preferred) Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a
text		0..1	Narrative	There are no (further) constraints on this element Element id PractitionerRole.text Short description Text summary of the resource, for human interpretation Alternate names narrative, html, xhtml, display Definition A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety. Comments Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later. Data type Narrative Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a rim: N/A rim: Act.text?
contained	I	0..*	Resource	There are no (further) constraints on this element Element id PractitionerRole.contained Short description Contained, inline Resources Alternate names inline resources, anonymous resources, contained resources Definition These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope. Comments This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels. Data type Resource Constraints dom-r4b: Containing new R4B resources within R4 resources may cause interoperability issues if instances are shared with R4 systems ($this is Citation or $this is Evidence or $this is EvidenceReport or $this is EvidenceVariable or $this is MedicinalProductDefinition or $this is PackagedProductDefinition or $this is AdministrableProductDefinition or $this is Ingredient or $this is ClinicalUseDefinition or $this is RegulatedAuthorization or $this is SubstanceDefinition or $this is SubscriptionStatus or $this is SubscriptionTopic) implies (%resource is Citation or %resource is Evidence or %resource is EvidenceReport or %resource is EvidenceVariable or %resource is MedicinalProductDefinition or %resource is PackagedProductDefinition or %resource is AdministrableProductDefinition or %resource is Ingredient or %resource is ClinicalUseDefinition or %resource is RegulatedAuthorization or %resource is SubstanceDefinition or %resource is SubscriptionStatus or %resource is SubscriptionTopic) Mappings rim: Entity. Role, or Act rim: N/A
extension	I	0..0	Extension	There are no (further) constraints on this element Element id PractitionerRole.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
modifierExtension	?! I	0..*	Extension	There are no (further) constraints on this element Element id PractitionerRole.modifierExtension Short description Extensions that cannot be ignored Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). Requirements Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
identifier	Σ	0..0	Extension Identifier PT Core	There are no (further) constraints on this element Element id PractitionerRole.identifier Short description An identifier intended for computation Definition Número de identificação local Identificadores da função do profissional na entidade local. A estrutura do identificador tem de respeitar as regras identificadas seguidamente. Número da identificação central Identificadores da função do profissional no provedor nacional de profissionais. A estrutura do identificador tem de respeitar as regras identificadas seguidamente. Requirements Often, specific identities are assigned for the agent. Data type Extension Identifier PT Core Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a v2: CX / EI (occasionally, more often EI maps to a resource id or a URL) rim: II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT] servd: Identifier w5: FiveWs.identifier v2: PRD-7 (or XCN.1) rim: .id servd: ./Identifiers
active	Σ	0..0	boolean	There are no (further) constraints on this element Element id PractitionerRole.active Short description Whether this practitioner role record is in active use Definition Indica se a função está ativa ou inativa Requirements Need to be able to mark a practitioner role record as not to be used because it was created in error, or otherwise no longer in active use. Comments If this value is false, you may refer to the period to see when the role was in active use. If there is no period specified, no inference can be made about when it was active. Meaning when missing This resource is generally assumed to be active if no value is provided for the active element Data type boolean Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a w5: FiveWs.status v2: STF-7 rim: .statusCode
period	Σ I	0..0	Period PT Core	There are no (further) constraints on this element Element id PractitionerRole.period Short description Time range defined by start and end date/time Alternate names Period Definition Período durante o qual o profissional é autorizado a desempenhar a função Requirements Even after the agencies is revoked, the fact that it existed must still be recorded. Comments A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration. Data type Period PT Core Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)` Mappings rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] w5: FiveWs.done[x] v2: PRD-8/9 / PRA-5.4 rim: .performance[@typeCode <= 'PPRF'].ActDefinitionOrEvent.effectiveTime servd: (ServD maps Practitioners and Organizations via another entity, so this concept is not available)
practitioner	Σ I	1..1	Reference(Practitioner PT PS)	Element id PractitionerRole.practitioner Short description Practitioner that is able to provide the defined services for the organization Definition Identifica o profissional que desempenha as funções descritas neste recurso Comments References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository. Data type Reference(Practitioner PT PS) Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids')) or (reference='#' and %rootResource!=%resource)` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) rim: .player
organization	Σ I	0..0	Reference(Organization PT Core)	There are no (further) constraints on this element Element id PractitionerRole.organization Short description Organization where the roles are available Definition Identifica a entidade onde as funções são desempenhadas Comments References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository. Data type Reference(Organization PT Core) Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids')) or (reference='#' and %rootResource!=%resource)` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) rim: .scoper
code	Σ	1..*	CodeableConcept PT CoreBinding	There are no (further) constraints on this element Element id PractitionerRole.code Short description Concept - reference to a terminology or just text Definition Funções que está autorizado a desempenhar na entidade empregadora Requirements Need to know what authority the practitioner has - what can they do? Comments Value Set Name: HealthcareProfessionalRole Data type CodeableConcept PT Core Binding The role a person plays representing an organization. https://www.ctc.min-saude.pt/catalogos/categorias-profissionais-de-saude (required) Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: PRD-1 / STF-18 / PRA-3 / PRT-4 / ROL-3 / ORC-12 / OBR-16 / PV1-7 / PV1-8 / PV1-9 / PV1-17 rim: .code servd: (ServD maps Practitioners and Organizations via another entity, so this concept is not available)
specialty	Σ	0..0	CodeableConceptBinding	There are no (further) constraints on this element Element id PractitionerRole.specialty Short description Specific specialty of the practitioner Definition Specific specialty of the practitioner. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data type CodeableConcept Sliced: Unordered, Open, by id(Value) Binding Specific specialty associated with the agency. Practice Setting Code Value Set (preferred) Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: PRA-5 rim: .player.HealthCareProvider[@classCode = 'PROV'].code servd: ./Specialty
location	Σ I	0..0	Reference(Location PT Core)	There are no (further) constraints on this element Element id PractitionerRole.location Short description The location(s) at which this practitioner provides care Definition Local onde o profissional presta os cuidados Comments References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository. Data type Reference(Location PT Core) Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids')) or (reference='#' and %rootResource!=%resource)` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) w5: FiveWs.where[x] rim: .performance.ActDefinitionOrEvent.ServiceDeliveryLocation[@classCode = 'SDLOC'] servd: (ServD maps Practitioners and Organizations via another entity, so this concept is not available)<br/> However these are accessed via the Site.ServiceSite.ServiceSiteProvider record. (The Site has the location)
healthcareService	I	0..0	Reference(Healthcare Service PT Core)	There are no (further) constraints on this element Element id PractitionerRole.healthcareService Short description The list of healthcare services that this worker provides for this role's Organization/Location(s) Definition Indica os serviços de saúde ou categoria de serviços prestados de uma entidade numa determinada localização. Comments References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository. Data type Reference(Healthcare Service PT Core) Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids')) or (reference='#' and %rootResource!=%resource)` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) v2: EDU-2 / AFF-3 rim: .player.QualifiedEntity[@classCode = 'QUAL'].code
telecom	Σ I	0..0	ContactPoint PT Core	There are no (further) constraints on this element Element id PractitionerRole.telecom Short description Details of a Technology mediated contact point (phone, fax, email, etc.) Definition Informações detalhadas dos contactos Requirements Often practitioners have a dedicated line for each location (or service) that they work at, and need to be able to define separate contact details for each of these. Data type ContactPoint PT Core Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` cpt-2: A system is required if a value is provided. `value.empty() or system.exists()` Mappings rim: n/a v2: XTN rim: TEL servd: ContactPoint rim: .telecom
availableTime		0..0	BackboneElement	There are no (further) constraints on this element Element id PractitionerRole.availableTime Short description Times the Service Site is available Definition Dias da semana e horas de disponibilidade do serviço Comments More detailed availability information may be provided in associated Schedule/Slot resources. Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a rim: .effectiveTime
notAvailable		0..0	BackboneElement	There are no (further) constraints on this element Element id PractitionerRole.notAvailable Short description Not available during this time due to provided reason Definition Indica a indisponibilidade do serviço para um determinado período e pelo motivo indicado Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a rim: .effectiveTime
availabilityExceptions		0..0	string	There are no (further) constraints on this element Element id PractitionerRole.availabilityExceptions Short description Description of availability exceptions Definition Exceções de disponibilidade Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` Mappings rim: n/a rim: .effectiveTime
endpoint	I	0..0	Reference(Endpoint)	There are no (further) constraints on this element Element id PractitionerRole.endpoint Short description Technical endpoints providing access to services operated for the practitioner with this role Definition Pontos que fornecem acesso aos serviços Requirements Organizations have multiple systems that provide various services and ,ay also be different for practitioners too. So the endpoint satisfies the need to be able to define the technical connection details for how to connect to them, and for what purpose. Comments References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository. Data type Reference(Endpoint) Constraints ele-1: All FHIR elements must have a @value or children unless an empty Parameters resource `hasValue() or (children().count() > id.count()) or $this is Parameters` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids')) or (reference='#' and %rootResource!=%resource)` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)

Binding

Path	Strength	ValueSet	Comment
PractitionerRole.code	required	https://www.ctc.min-saude.pt/catalogos/categorias-profissionais-de-saude	Value Set Name: HealthcareProfessionalRole

Path

Strength

ValueSet

Comment

PractitionerRole.code

required

https://www.ctc.min-saude.pt/catalogos/categorias-profissionais-de-saude

Value Set Name: HealthcareProfessionalRole

Para mais informações sobre a utilização do elemento system consultar Systems.

Identifiers Type

Estes Identificadores devem ser utilizados no elemento

identifier.type.coding[*]

Regras de implementação

Para além das constraints identificadas pelo FHIR para este recurso devem ser consideradas as constraints que identificamos na tabela infra.

Voltar ao início