R4 Draft for Comment

This page is part of the FHIR Specification (v3.2.0: R4 Ballot 1). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

Operation-structuredefinition-generate.xml

FHIR Infrastructure Work GroupMaturity Level: N/ABallot Status: InformativeCompartments: Not linked to any defined compartments

Raw XML (canonical form)

Jump past Narrative

Operation Definition

<OperationDefinition xmlns="http://hl7.org/fhir">
  <id value="StructureDefinition-generate"/> 
  <text> 
    <status value="generated"/> 
    <div xmlns="http://www.w3.org/1999/xhtml">
      <h2> Generate Snapshot</h2> 
      <p> OPERATION: Generate Snapshot</p> 
      <p> The official URL for this operation definition is: </p> 
      <pre> http://hl7.org/fhir/OperationDefinition/StructureDefinition-generate</pre> 
      <div> 
        <p> Generates a 
          <a href="structuredefinition.html">StructureDefinition</a>  instance  with  a snapshot, based on a differential in a specified 
          <a href="structuredefinition.html">StructureDefinition</a> .   If the operation is not called at the instance level, either 
          <em> definition</em>  or 
          <em> url</em>  'in' parameters must be provided. If more than one is specified, servers may raise an
           error or may resolve with the parameter of their choice. If called at the instance level,
           these parameters will be ignored.
        </p> 

      </div> 
      <p> URL: [base]/StructureDefinition/$generate</p> 
      <p> URL: [base]/StructureDefinition/[id]/$generate</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> IN</td> 
          <td> definition</td> 
          <td> 0..1</td> 
          <td> StructureDefinition</td> 
          <td/>  
          <td> 
            <div> 
              <p> The 
                <a href="structuredefinition.html">StructureDefinition</a>  is provided directly as part of the request. Servers may choose not to accept profiles
                 in this fashion
              </p> 

            </div> 
          </td> 
        </tr> 
        <tr> 
          <td> IN</td> 
          <td> url</td> 
          <td> 0..1</td> 
          <td> string</td> 
          <td/>  
          <td> 
            <div> 
              <p> The profile's canonical URL (i.e. 'StructureDefinition.url'). The server must know the
                 structure definition, or be able to retrieve it from other known repositories.</p> 

            </div> 
          </td> 
        </tr> 
        <tr> 
          <td> OUT</td> 
          <td> return</td> 
          <td> 1..1</td> 
          <td> StructureDefinition</td> 
          <td/>  
          <td> 
            <div> 
              <p> The structure definition with a snapshot</p> 

            </div> 
          </td> 
        </tr> 
      </table> 
      <div/>  
    </div> 
  </text> 
  <url value="http://hl7.org/fhir/OperationDefinition/StructureDefinition-generate"/> 
  <name value="Generate Snapshot"/> 
  <status value="draft"/> 
  <kind value="operation"/> 
  <date value="2017-12-20T15:52:34+11:00"/> 
  <publisher value="HL7 (FHIR Project)"/> 
  <contact> 
    <telecom> 
      <system value="url"/> 
      <value value="http://hl7.org/fhir"/> 
    </telecom> 
    <telecom> 
      <system value="email"/> 
      <value value="fhir@lists.hl7.org"/> 
    </telecom> 
  </contact> 
  <description value="Generates a [StructureDefinition](structuredefinition.html) instance  with  a snapshot,
   based on a differential in a specified [StructureDefinition](structuredefinition.html).
     If the operation is not called at the instance level, either *definition* or *url* 'in'
   parameters must be provided. If more than one is specified, servers may raise an error
   or may resolve with the parameter of their choice. If called at the instance level, these
   parameters will be ignored."/> 
  <code value="generate"/> 
  <resource value="StructureDefinition"/> 
  <system value="false"/> 
  <type value="true"/> 
  <instance value="true"/> 
  <parameter> 
    <name value="definition"/> 
    <use value="in"/> 
    <min value="0"/> 
    <max value="1"/> 
    <documentation value="The [StructureDefinition](structuredefinition.html) is provided directly as part of the
     request. Servers may choose not to accept profiles in this fashion"/> 
    <type value="StructureDefinition"/> 
    <searchType value="token"/> 
  </parameter> 
  <parameter> 
    <name value="url"/> 
    <use value="in"/> 
    <min value="0"/> 
    <max value="1"/> 
    <documentation value="The profile's canonical URL (i.e. 'StructureDefinition.url'). The server must know the
     structure definition, or be able to retrieve it from other known repositories."/> 
    <type value="string"/> 
    <searchType value="token"/> 
  </parameter> 
  <parameter> 
    <name value="return"/> 
    <use value="out"/> 
    <min value="1"/> 
    <max value="1"/> 
    <documentation value="The structure definition with a snapshot"/> 
    <type value="StructureDefinition"/> 
  </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.