DSTU2 STU 3 Candidate
This page is part of the FHIR Specification (v1.0.2: DSTU 2). The current version which supercedes this version is

This page is part of the FHIR Specification (v1.4.0: STU 3 Ballot 3). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . For a full list of available versions, see the Directory of published versions . Page versions: . Page versions: R5 R4B R4 R3 R2

Operation-resource-meta.xml Raw XML (

Raw XML ( canonical form canonical form ) Operation Definition )

Operation Definition

<OperationDefinition xmlns="http://hl7.org/fhir">
  <id value="Resource-meta"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <h2>Access a list of profiles, tags, and security labels</h2>
      <p>OPERATION: Access a list of profiles, tags, and security labels</p>
      <div>
        <p>This operation retrieves a summary of the profiles, tags, and security labels for the
           given scope; e.g. for each scope:
          <br/>
        </p>

        <ul>

          <li>system-wide: a list of all profiles, tags and security labels in use by the system</li>

          <li>resource-type level: A list of all profiles, tags, and security labels for the resource
             type</li>

          <li>individual resource level: A list of all profiles, tags, and security labels for the current
             version of the resource.  Also, as a special case, this operation (and other meta operations)
             can be performed on a historical version of a resource)</li>

        </ul>

      </div>
      <p>URL: [base]/$meta</p>
      <p>URL: [base]/Resource/$meta</p>
      <p>URL: [base]/Resource/[id]/$meta</p>
      <p>Parameters</p>
      <table class="grid">
        <tr>
          <td>
            <b>Use</b>
          </td>
          <td>
            <b>Name</b>
          </td>
          <td>
            <b>Cardinality</b>
          </td>
          <td>
            <b>Type</b>
          </td>
          <td>
            <b>Binding</b>
          </td>
          <td>
            <b>Documentation</b>
          </td>
        </tr>
        <tr>
          <td>OUT</td>
          <td>return</td>
          <td>1..1</td>
          <td>Meta</td>
          <td/>
          <td>
            <div>
              <p>The meta returned by the operation</p>

            </div>
          </td>
        </tr>
      </table>
      <div>
        <p>At the system and type levels, the $meta operation is used to get a summary of all the
           labels that are in use across the system. The principle use for this operation is to support
           search e.g. what tags can be searched for. At these levels, the meta will not contain
           versionId, lastUpdated etc. Systems are not obligated to implement the operation at this
           level (and should return a 4xx error if they don't). At the resource and historical entry
           level, the $meta operation returns the same meta as would be returned by accessing the
           resource directly. This can be used to allow a system to get access to the meta-information
           for the resource without accessing the resource itself, e.g. for security reasons</p>

      </div>
    </div>
  </text>
  <url value="http://hl7.org/fhir/OperationDefinition/Resource-meta"/>
  <name value="Access a list of profiles, tags, and security labels"/>
  <status value="draft"/>
  <kind value="operation"/>
  <date value="2016-03-31T08:01:25+11:00"/>
  <publisher value="HL7 (FHIR Project)"/>
  <contact>
    <telecom>
      <system value="other"/>
      <value value="http://hl7.org/fhir"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="fhir@lists.hl7.org"/>
    </telecom>
  </contact>
  

  <description value="This operation retrieves a summary of the profiles, tags, and security labels for the
   given scope; e.g. for each scope:    * system-wide: a list of all profiles, tags and security
   labels in use by the system  * resource-type level: A list of all profiles, tags, and
   security labels for the resource type  * individual resource level: A list of all profiles,
   tags, and security labels for the current version of the resource.  Also, as a special
   case, this operation (and other meta operations) can be performed on a historical version
   of a resource)"/>
  <code value="meta"/>
  At the system and type levels, the $meta operation is used to get a summary of all the

  <comment value="At the system and type levels, the $meta operation is used to get a summary of all the
   labels that are in use across the system. The principle use for this operation is to support
   search e.g. what tags can be searched for. At these levels, the meta will not contain
   versionId, lastUpdated etc. Systems are not obligated to implement the operation at this
   level (and should return a 4xx error if they don't). At the resource and historical entry
   level, the $meta operation returns the same meta as would be returned by accessing the
   resource directly. This can be used to allow a system to get access to the meta-information
   for the resource without accessing the resource itself, e.g. for security reasons"/>
  <system value="true"/>
  <type value="Resource"/>
  <instance value="true"/>
  <parameter>
    <name value="return"/>
    <use value="out"/>
    <min value="1"/>
    <max value="1"/>
    <documentation value="The meta returned by the operation"/>
    <type value="Meta"/>
  </parameter>


</

OperationDefinition

>

Usage
note:
every
effort
has
been
made
to
ensure
that
the
examples
are
correct
and
useful,
but
they
are
not
a
normative
part
of
the
specification.
©
HL7.org
2011+.
FHIR
DSTU2
(v1.0.2-7202)
generated
on
Sat,
Oct
24,
2015
07:43+1100.
Links:

Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.