Physical Activity Implementation Guide
1.0.1 - STU Release 1 United States of America flag

Physical Activity Implementation Guide, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 1.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/physical-activity/ and changes regularly. See the Directory of published versions

CapabilityStatement: PA Service Provider (Light)

Official URL: http://hl7.org/fhir/us/physical-activity/CapabilityStatement/pa-service-provider-light Version: 1.0.1
Standards status: Trial-use Maturity Level: 2 Computable Name: PAServiceProviderLight

Describes the expected capabilities of a system used by a personal trainer, community fitness organization, or other entity that delivers services that help a patient to improve or maintain their level of physical activity. This set of capabilities is appropriate for service providers that CANNOT expose their own FHIR server and that rely on the Care Manager to store Tasks, reports and other resources.

Raw OpenAPI-Swagger Definition file | Download


General

Supported FHIR Version: 4.0.1
Imports other Capabilities:
Supported exchange formats: json, xml

Jump to:


REST client behavior

A 'light' Service Provider has less sophistication than a full Service Provider. They rely exclusively on the care manager to store the Tasks and any reports associated with referrals. Therefore, all interactions are handled as 'client' functionality.


Resource summary

Resource Search Read Read Version Instance History Resource History Create Update Delete Operations
CarePlan SHOULD MAY SHOULD
Condition SHALL MAY
DiagnosticReport SHALL
DocumentReference SHOULD SHOULD MAY
Goal SHALL MAY SHOULD SHOULD
Observation SHALL SHALL SHALL
Patient SHALL
Practitioner SHALL
PractitionerRole SHALL
Questionnaire SHALL
QuestionnaireResponse SHALL SHALL SHOULD
ServiceRequest SHALL
Subscription SHALL SHALL SHALL
Task SHALL SHALL SHALL


CarePlan

Supported Profile(s):

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  update SHOULD

Allows a service provider to make updates to a plan owned by a care manager.

  search-type SHOULD

Allows retrieval of care plans for a given patient.

  history-instance MAY

Allows seeing how a care plan has changed over time. This may be particularly important if multiple stakeholders have the ability to make adjustments to the plan. However, history is not widely supported.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known care plan records - and more specifically, retrieving more than one in a single call to check for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

category SHALL token

Allows retrieving only those plans related to physical activity.

date SHOULD date

Allows filtering plans based on the time frame they apply(ied) to.

lifecycle-status SHALL token

Allows filtering to only active or draft plans.

patient SHALL reference

Allows filtering to only those plans for a specific patient. Most systems will treat this as a mandatory search parameter, though systems MAY support cross-patient search, at least through bulk-data interfaces for payer or research use.



Condition

Supported Profile(s):

Behavior

Reference policy: literal

Interactions

Name Conformance Description
  search-type SHALL

Allows retrieval of conditions for a given patient.

  history-instance MAY

Allows seeing how a condition has changed over time.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known condition records - and more specifically, retrieving more than one in a single call to check for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

category SHALL token

Allows retrieving only those plans related to physical activity.

clinical-status SHOULD token

Allows filtering to only active conditions.

code SHOULD token

Allows retrieving specific patient conditions - e.g. all 'low physical activity' conditions.

patient SHALL reference

Allows filtering to only those plans for a specific patient. Most systems will treat this as a mandatory search parameter, though systems MAY support cross-patient search, at least through bulk-data interfaces for payer or research use.

verification-status SHOULD token

Allows excluding refuted or erroneous conditions.



DiagnosticReport

Supported Profile(s):

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  search-type SHALL

Allows searching for reports already submitted.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known reports - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

basedOn SHOULD reference

Allows filtering to reports created in fulfillement of a particular order or referral.

code SHOULD token

Allows filtering to specific types of reports.

date SHOULD date

Allows filtering reports based on the period the cover.

category SHALL token

Allows retrieving only those reports related to physical activity.

patient SHALL reference

Allows filtering to only those reports for a specific patient. Most systems will treat this as a mandatory search parameter, though systems MAY support cross-patient search, at least through bulk-data interfaces for payer or research use.

performer SHOULD reference

Allows filtering to only retrieve reports created by a specific performer.

status SHOULD token

Allows filtering to only retrieve active or completed reports.



DocumentReference

Supported Profile(s):

Behavior

Reference policy: literal

Interactions

Name Conformance Description
  create SHOULD

Allows adding additional images/documents for later retrieval.

  update MAY

Allows replacing an existing image/document with a newer version.

  search-type SHOULD

Allows searching for appropriate an appropriate image/document to reference.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known document reference records - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

contenttype SHOULD token

Allows filtering for only PDFs, images, etc.

category SHOULD token

Allows filtering for only records tied to a particular category (e.g. physical-activity).

description SHOULD string

Allows filtering based on words found in the description - i.e. with a 'contains' search.



Goal

Supported Profile(s):

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  update SHOULD

Allows patients or service providers to modify a goal - for example shifting target values or dates, updating the status, etc. Allowing patients, care-givers, and service providers to help maintain goals is a key aspect of a patient-centered care plan. However, not all care manager systems (or their organizations) yet have the technical mechanisms or policies in place to support this.

  create SHOULD

Allows patients or service providers to add additional physical activity related goals. As with updates, this is a key part of a patient-centered care plan, but not all systems or organizations will be able to do this.

  search-type SHALL

Allows retrieval of goals for a given patient.

  history-instance MAY

Allows seeing how goals have changed over time. This may be particularly important if multiple stakeholders have the ability to make adjustments to goals. However, history is not widely supported.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known goal records - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

category SHOULD token

Allows retrieving only those goals related to physical activity.

lifecycle-status SHOULD token

Allows filtering to only active, completed or other goal statuses.

patient SHALL reference

Allows filtering to only those goals for a specific patient. Most systems will treat this as a mandatory search parameter, though systems MAY support cross-patient search, at least through bulk-data interfaces for payer or research use.

target-date SHOULD date

Allows filtering goals based on when they're to be achieved.



Observation

Supported Profile(s):

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  update SHALL

Allows correction of or adding comments to previously recorded observations.

  create SHALL

Allows other systems to record physical-activity related observations.

  search-type SHALL

Allows retrieval of observations for a given patient.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known observation records - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

category SHALL token

Allows retrieving only those observations related to physical activity. As well, many clinical systems will require searches to specify a category so the server knows which part of the database to search as different types of observations are stored in different areas.

code SHALL token

Allows filtering to only retrieve a specific type of physical activity vital sign or supporting observation.

date SHALL date

Allows filtering to only retrieve a observations from a particular time period.

patient SHALL reference

Allows filtering to only those observations for a specific patient. Most systems will treat this as a mandatory search parameter, though systems MAY support cross-patient search, at least through bulk-data interfaces for payer or research use.

status SHALL token

Allows excluding entered-in-error or non-final observations.

value-quantity SHOULD quantity

Allows retrieval of only those observations that fall in a particular range. Particularly useful for cross-patient queries.



Patient

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  search-type SHALL

Allows searching of the patients.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known reports - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

birthdate MAY date

Allows filtering of individuals based on their date of birth.

family MAY string

Allows filtering of individuals based on their family name.

gender MAY token

Allows filtering of individuals based on their gender.

given MAY string

Allows filtering of individuals based on their given name.

identifier SHALL token

Enables filtering of patients based on their unique identifiers.

name SHALL string

Enables filtering of patients based on their full name.



Practitioner

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  search-type SHALL

Allows searching of the practitioners.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known reports - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

identifier SHOULD token

Enables filtering of practitioners based on their unique identifiers.

name SHOULD string

Enables filtering of practitioners based on their full name.



PractitionerRole

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  search-type SHALL

Allows searching of the practitioner roles.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known reports - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

specialty SHOULD token

Allows filtering of practitioner specialty.

practitioner SHOULD reference

Enables filtering of practitioner roles based on the associated practitioner.



Questionnaire

Supported Profile(s):

Behavior

Reference policy: literal

Interactions

Name Conformance Description
  search-type SHALL

Allows retrieval of questionnaires to be completed.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known questionnaire records - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

url SHALL uri

Allows retrieving a referenced Questionnaire.

version SHOULD token

Allows retrieving a specific version of a referenced questionnaire.

context-type-value SHOULD composite

Allows filtering for Questionnaires that are phyical activity-related.

identifier SHOULD token

Allows retrieving Questionnaires with a known identifier.

publisher SHOULD string

Allows retrieving Questionnaires based on who is responsible for having defined the form.

status SHOULD token

Allows filtering to only retrieve active questionnaires.

subject-type SHOULD token

Allows retrieving Questionnaires that are intended to provide information about patients - as opposed to practitioners, organizations, etc.

title SHOULD string

Allows searching for forms by name.



QuestionnaireResponse

Supported Profile(s):

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  update SHOULD

Allows correction of or continued editing of a previously recorded questionnaire response.

  create SHALL

Allows other systems to record questionnaire responses.

  search-type SHALL

Allows retrieval of completed or in-progresss questionnaire responses.

Search

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known questionnaire response records - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

author SHALL reference

Allows filtering responses previously created by a particular individual.

authored SHOULD date

Allows filtering responses based on when they were completed.

patient SHALL reference

Allows filtering to only those responses for a specific patient. Most systems will treat this as a mandatory search parameter, though systems MAY support cross-patient search, at least through bulk-data interfaces for payer or research use.

questionnaire SHALL reference

Allows retrieving a referenced Questionnaire.

status SHOULD token

Allows filtering to only retrieve completed questionnaire responses.



ServiceRequest

Supported Profile(s):

Behavior

Reference policy: literal

Interactions

Name Conformance Description
  search-type SHALL

Allows searching for orders or referrals for a particular patient or for updates to previously retrieved orders.

Search

Supported Includes: ServiceRequest:patient, ServiceRequest:requester

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known service request records - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

authored SHOULD date

Allows filtering orders based on when they were created.

category SHALL token

Allows retrieving only those referrals related to physical activity.

code SHALL token

Allows retrieving only orders for particular types of interventions.

patient SHALL reference

Allows filtering to only those orders for a specific patient. Most systems will treat this as a mandatory search parameter, though systems MAY support cross-patient search, at least through bulk-data interfaces for payer or research use.

performer SHOULD reference

Allows filtering to only retrieve orders targeted to a specific performer.

requester SHOULD reference

Allows filtering to only retrieve orders solicited by a specific provider.

status SHOULD token

Allows filtering to only retrieve active or completed orders.



Subscription

Supported Profile(s):

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  create SHALL

Allows establishing a new subscription.

  update SHALL

Allows revising an existing subscription - to cancel it or change the email address or SMS number.

  search-type SHALL

Allows retrieval of existing subscriptions prior to update.

Search

Parameter Conformance Type Definition & Chaining
topic SHOULD uri

Allows filtering for just subscriptions for Task monitoring.

_id SHALL token

Allows retrieving known subscription records.

url SHALL uri

Allows filtering only for subscriptions that notify a specific endpoint. Substituting for the 'owner' search parameter, which doesn't exist in R4.



Task

Supported Profile(s):

Behavior

Versioning support: versioned-update

Reference policy: literal

Interactions

Name Conformance Description
  create SHALL

Allows a service provider to create a patient-assigned Task.

  update SHALL

Allows existing tasks to be updated - to change their status and/or to attach 'outputs' resulting from the Task.

  search-type SHALL

Allows retrieval of existing tasks to check for changes or prior to making updates. This will typically be prompted by a subscription notification.

Search

Supported Includes: Task:focus, Task:output, Task:patient, ServiceRequest:requester

Parameter Conformance Type Definition & Chaining
_id SHALL token

Allows retrieving known task records - and more specifically, retrieving more than one in a single call to poll for updates.

_lastUpdated SHOULD date

Allows filtering for only records that have changed since last query.

code SHALL token

Allows filtering for 'fulfill' tasks as opposed to others. Some systems may require code to be included as a filter criteria as different Task codes may correspond to different internal database tables.

owner SHALL reference

Allows filtering only for tasks that are assigned to a particular owner (or alternatively, tasks that have not yet been assigned).

patient SHALL reference

Allows filtering to only those tasks for a specific patient. Most systems will treat this as a mandatory search parameter, though systems MAY support cross-patient search, at least through bulk-data interfaces for payer or research use.

requester SHALL reference

Allows filtering to only retrieve tasks initiated by a specific provider.

status SHALL token

Allows filtering to only retrieve active or completed orders.

focus SHALL reference

Allows retrieving the task(s) seeking fulfillment of a particular ServiceRequest.

output SHOULD reference

Allows for the 'output' of a Task to be included when retrieving a Task.