Data Model Libraries
    Preparing search index...

    Subscription Class

    The subscription resource describes a particular client's request to be notified about a SubscriptionTopic.

    FHIR Specification

    • Short: Notification about a SubscriptionTopic
    • Definition: The subscription resource describes a particular client's request to be notified about a SubscriptionTopic.
    • FHIR Version: 5.0.0

    Hierarchy (View Summary)

    Implements

    Index

    Constructors

    Properties

    Methods

    parse getIdentifier setIdentifier addIdentifier hasIdentifier getNameElement setNameElement hasNameElement getName setName hasName getStatusEnumType setStatusEnumType hasStatusEnumType getStatusElement setStatusElement hasStatusElement getStatus setStatus hasStatus getTopicElement setTopicElement hasTopicElement getTopic setTopic hasTopic getContact setContact addContact hasContact getEndElement setEndElement hasEndElement getEnd setEnd hasEnd getManagingEntity setManagingEntity hasManagingEntity getReasonElement setReasonElement hasReasonElement getReason setReason hasReason getFilterBy setFilterBy addFilterBy hasFilterBy getChannelType setChannelType hasChannelType getEndpointElement setEndpointElement hasEndpointElement getEndpoint setEndpoint hasEndpoint getParameter setParameter addParameter hasParameter getHeartbeatPeriodElement setHeartbeatPeriodElement hasHeartbeatPeriodElement getHeartbeatPeriod setHeartbeatPeriod hasHeartbeatPeriod getTimeoutElement setTimeoutElement hasTimeoutElement getTimeout setTimeout hasTimeout getContentTypeElement setContentTypeElement hasContentTypeElement getContentType setContentType hasContentType getContentEnumType setContentEnumType hasContentEnumType getContentElement setContentElement hasContentElement getContent setContent hasContent getMaxCountElement setMaxCountElement hasMaxCountElement getMaxCount setMaxCount hasMaxCount fhirType isEmpty isRequiredFieldsEmpty copy toJSON getText setText hasText getContained setContained addContained hasContained getExtension setExtension hasExtension getExtensionByUrl addExtension removeExtension getModifierExtension setModifierExtension hasModifierExtension getModifierExtensionByUrl addModifierExtension removeModifierExtension resourceType getIdElement setIdElement hasIdElement getId setId hasId getMeta setMeta hasMeta getImplicitRulesElement setImplicitRulesElement hasImplicitRulesElement getImplicitRules setImplicitRules hasImplicitRules getLanguageElement setLanguageElement hasLanguageElement getLanguage setLanguage hasLanguage isResource isDataType isComplexDataType isPrimitive isBooleanPrimitive isStringPrimitive isNumberPrimitive isBigIntPrimitive isDateTimePrimitive copyValues initIdentifier initContact initFilterBy initParameter

    Constructors

    Properties

    identifier?: Identifier[]

    Subscription.identifier Element

    FHIR Specification

    • Short: Additional identifiers (business identifier)
    • Definition: A formal identifier that is used to identify this code system when it is represented in other formats, or referenced in a specification, model, design or an instance.
    • FHIR Type: Identifier
    • Cardinality: 0..*
    • isModifier: false
    • isSummary: true
    name?: StringType

    FHIR Specification

    • Short: Human readable name for this subscription
    • Definition: A natural language name identifying the subscription.
    • FHIR Type: string
    • Cardinality: 0..1
    • isModifier: false
    • isSummary: true
    subscriptionStatusEnum: SubscriptionStatusEnum

    FHIR CodeSystem: SubscriptionStatus

    status: null | EnumCodeType

    Subscription.status Element

    FHIR Specification

    • Short: requested | active | error | off | entered-in-error
    • Definition: The status of the subscription, which marks the server state for managing the subscription.
    • Comment: A client can only submit subscription resources in the requested or off state. Only the server can move a subscription from requested to active, and then to error. Either the server or the client can turn a subscription off. This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.
    • FHIR Type: code
    • Cardinality: 1..1
    • isModifier: true
    • isModifierReason: This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
    • isSummary: true

    CodeSystem Enumeration: SubscriptionStatusEnum

    topic: null | CanonicalType

    Subscription.topic Element

    FHIR Specification

    • Short: Reference to the subscription topic being subscribed to
    • Definition: The reference to the subscription topic to be notified about.
    • FHIR Type: canonical
    • Cardinality: 1..1
    • isModifier: false
    • isSummary: true
    contact?: ContactPoint[]

    Subscription.contact Element

    FHIR Specification

    • Short: Contact details for source (e.g. troubleshooting)
    • Definition: Contact details for a human to contact about the subscription. The primary use of this for system administrator troubleshooting.
    • FHIR Type: ContactPoint
    • Cardinality: 0..*
    • isModifier: false
    • isSummary: true

    Subscription.end Element

    FHIR Specification

    • Short: When to automatically delete the subscription
    • Definition: The time for the server to turn the subscription off.
    • Comment: The server is permitted to deviate from this time but should observe it.
    • FHIR Type: instant
    • Cardinality: 0..1
    • isModifier: false
    • isSummary: true
    managingEntity?: Reference

    Subscription.managingEntity Element

    FHIR Specification

    reason?: StringType

    Subscription.reason Element

    FHIR Specification

    • Short: Description of why this subscription was created
    • Definition: A description of why this subscription is defined.
    • FHIR Type: string
    • Cardinality: 0..1
    • isModifier: false
    • isSummary: true

    Subscription.filterBy Element

    FHIR Specification

    • Short: Criteria for narrowing the subscription topic stream
    • Definition: The filter properties to be applied to narrow the subscription topic stream. When multiple filters are applied, evaluates to true if all the conditions applicable to that resource are met; otherwise it returns false (i.e., logical AND).
    • FHIR Type: BackboneElement
    • Cardinality: 0..*
    • isModifier: false
    • isSummary: true
    channelType: null | Coding

    Subscription.channelType Element

    FHIR Specification

    • Short: Channel type for notifications
    • Definition: The type of channel to send notifications on.
    • FHIR Type: Coding
    • Cardinality: 1..1
    • isModifier: false
    • isSummary: true
    endpoint?: UrlType

    Subscription.endpoint Element

    FHIR Specification

    • Short: Where the channel points to
    • Definition: The url that describes the actual end-point to send notifications to.
    • Comment: For rest-hook the end-point must be an http: or https: URL; for websockets, ws: or wss:; for email, a mailto: url; and for message the endpoint can be in any form of url the server understands (usually, http/s: or mllp:). The URI is allowed to be relative; in which case, it is relative to the server end-point (since there may be more than one, clients should avoid using relative URIs).
    • FHIR Type: url
    • Cardinality: 0..1
    • isModifier: false
    • isSummary: true

    Subscription.parameter Element

    FHIR Specification

    • Short: Channel type
    • Definition: Channel-dependent information to send as part of the notification (e.g., HTTP Headers).
    • Comment: Exactly what these mean depend on the channel type. They can convey additional information to the server or recipient and/or meet security requirements; for example, support of multiple headers in the outgoing notifications for rest-hook type subscriptions. Note that names are not required to be unique, but channel definitions can impose restrictions.
    • FHIR Type: BackboneElement
    • Cardinality: 0..*
    • isModifier: false
    • isSummary: false
    heartbeatPeriod?: UnsignedIntType

    Subscription.heartbeatPeriod Element

    FHIR Specification

    • Short: Interval in seconds to send 'heartbeat' notification
    • Definition: If present, a 'heartbeat' notification (keep-alive) is sent via this channel with an interval period equal to this elements integer value in seconds. If not present, a heartbeat notification is not sent.
    • FHIR Type: unsignedInt
    • Cardinality: 0..1
    • isModifier: false
    • isSummary: true
    timeout?: UnsignedIntType

    Subscription.timeout Element

    FHIR Specification

    • Short: Timeout in seconds to attempt notification delivery
    • Definition: If present, the maximum amount of time a server will allow before failing a notification attempt.
    • FHIR Type: unsignedInt
    • Cardinality: 0..1
    • isModifier: false
    • isSummary: true
    contentType?: CodeType

    Subscription.contentType Element

    FHIR Specification

    • Short: MIME type to send, or omit for no payload
    • Definition: The MIME type to send the payload in - e.g., application/fhir+xml or application/fhir+json. Note that: * clients may request notifications in a specific FHIR version by using the FHIR Version Parameter - e.g., application/fhir+json; fhirVersion=4.0. * additional MIME types can be allowed by channels - e.g., text/plain and text/html are defined by the Email channel.
    • FHIR Type: code
    • Cardinality: 0..1
    • isModifier: false
    • isSummary: true
    subscriptionPayloadContentEnum: SubscriptionPayloadContentEnum

    FHIR CodeSystem: SubscriptionPayloadContent

    content?: EnumCodeType

    Subscription.content Element

    FHIR Specification

    • Short: empty | id-only | full-resource
    • Definition: How much of the resource content to deliver in the notification payload. The choices are an empty payload, only the resource id, or the full resource content.
    • Comment: Sending the payload has obvious security implications. The server is responsible for ensuring that the content is appropriately secured.
    • FHIR Type: code
    • Cardinality: 0..1
    • isModifier: false
    • isSummary: true

    CodeSystem Enumeration: SubscriptionPayloadContentEnum

    maxCount?: PositiveIntType

    Subscription.maxCount Element

    FHIR Specification

    • Short: Maximum number of events that can be combined in a single notification
    • Definition: If present, the maximum number of events that will be included in a notification bundle. Note that this is not a strict limit on the number of entries in a bundle, as dependent resources can be included.
    • FHIR Type: positiveInt
    • Cardinality: 0..1
    • isModifier: false
    • isSummary: true

    Methods

    • Parse the provided Subscription JSON to instantiate the Subscription data model.

      Parameters

      • sourceJson: Value

        JSON representing FHIR Subscription

      • OptionaloptSourceField: string

        Optional data source field (e.g. <complexTypeName>.<complexTypeFieldName>); defaults to Subscription

      Returns undefined | Subscription

      Subscription data model or undefined for Subscription

      JsonError if the provided JSON is not a valid JSON object

    • Assigns the provided ManagingEntity object value to the managingEntity property.

      Parameters

      • value: undefined | Reference

        the managingEntity object value

      Returns this

      this

      @ReferenceTargets('Subscription.managingEntity', ['CareTeam','HealthcareService','Organization','RelatedPerson','Patient','Practitioner','PractitionerRole',])

      InvalidTypeError for invalid data type or reference value

    • Assigns the provided value to the text property.

      Parameters

      Returns this

      this

    • Returns boolean

      true if the text property exists and has a value; false otherwise

    • Assigns the provided Resource array value to the contained property.

      Parameters

      • value: undefined | IResource[]

        the contained array value

      Returns this

      this

    • Returns boolean

      true if the contained property exists and has a value; false otherwise

    • Assigns the provided array of Extension values to the extension property.

      Parameters

      • extension: undefined | IExtension[]

        array of Extensions

      Returns this

      this

    • Determines if the extension property exists.

      Parameters

      • Optionalurl: string

        the url that identifies a specific Extension

      Returns boolean

      true if an Extension has the provided url; false otherwise

      If the url is provided, determines if an Extension having the provided url exists. If the url is not provided, determines if the extension property exists and has any values.

      AssertionError for invalid url

    • Adds the provided Extension to the extension property array.

      Parameters

      • extension: undefined | IExtension

        the Extension value to add to the extension property array

      Returns this

      this

    • Removes the Extension having the provided url from the extension property array.

      Parameters

      • url: string

        the url that identifies a specific Extension to remove

      Returns void

      AssertionError for invalid url

    • Determines if the modifierExtension property exists.

      Parameters

      • Optionalurl: string

        the url that identifies a specific Extension

      Returns boolean

      true if an Extension has the provided url

      If the url is provided, determines if an Extension having the provided url exists. If the url is not provided, determines if the modifierExtension property exists and has any values.

      AssertionError for invalid url

    • Assigns the provided PrimitiveType value to the id property.

      Parameters

      • element: undefined | IdType

        the id value

      Returns this

      this

    • Returns undefined | string

      the id property value as a primitive value

    • Assigns the provided primitive value to the id property.

      Parameters

      • value: undefined | string

        the id value

      Returns this

      this

      PrimitiveTypeError for invalid primitive types

    • Returns boolean

      true if the id property exists and has a value; false otherwise

    • Assigns the provided value to the meta property.

      Parameters

      • value: undefined | Meta

        the meta value

      Returns this

      this

    • Returns boolean

      true if the meta property exists and has a value; false otherwise

    • Assigns the provided primitive value to the implicitRules property.

      Parameters

      • value: undefined | string

        the implicitRules value

      Returns this

      this

      PrimitiveTypeError for invalid primitive types

    • Returns undefined | string

      the language property value as a primitive value

    • Assigns the provided primitive value to the language property.

      Parameters

      • value: undefined | string

        the language value

      Returns this

      this

      PrimitiveTypeError for invalid primitive types

    • Returns boolean

      true if the language property exists and has a value; false otherwise

    • Returns boolean

      true if the instance is a FHIR complex or primitive datatype; false otherwise