Narrative Reference - SubstanceAdministration

back to homepage

Approval Status

  • Approval Status: Approved
  • Example Task Force: 6/1/2017
  • SDWG: 7/6/2017

C-CDA 2.1 Example:

  • Applies to all C-CDA/CDA templates with this entry type

Reference to full CDA sample:

  • This sample will not validate

Validation location

  • Not applicable


  • This example demonstrates how to link the section narrative (section.text) to the coded information (entry) below. The example includes several comments and does not conform to any specific C-CDA/CDA template. The principles agreed to in this sample should be present in all other examples.


  • Brett Marquard, (GitHub: brettmarquard) (original design courtesy of George Cole)


  • narrative, narrative-entry, linking text




Example: download example view on GitHub

	<!-- The following section is fictitious - it exists solely for the purpose of showing examples of text/reference and originalText/reference from discrete entry children. As such, many elements are omitted and replaced by ... comments. The text and content in the discrete entry elements does not use actual clinical content, but instead relies on filler text commonly used in publishing and graphic design. -->
		<!--  ... -->
			<!-- The text in this section is created strictly to illustrate how discrete entry child elements make references into the human readable text.  -->
			<!-- this table is used for a simple sunstanceAdministration; the ID values are meant to be unique across the whole document -->
					<tr ID="simpleSubstanceAdministrationFullTextReference1">
								<content ID="substanceAdministrationProductCodeTextReference1">Lorem ipsum dolor sit amet, consectetuer adipiscing elit.</content>
								<content ID="substanceAdministrationFreeTextSIGReference1"> Aenean commodo ligula eget dolor. Aenean massa.</content>
								<!-- ... -->
							<!-- ... -->
							<!-- ... -->
		<!-- This illustrates a simple substanceAdministration. In C-CDA this is used for both Immunization and Medication Activity -->
			<substanceAdministration classCode="SBADM" moodCode="EVN">
				<!-- ... -->
				<!-- Could include code element, although rarely used in substanceAdministration -->
				<!-- the entire text of the substanceAdministration
									Example, of a medication: 0.3 ML Enoxaparin Sodium 100 MG/ML Prefilled Syringe 100 MG injected DAILY AS DIRECTED. Site: Upper abdomen Quantity: 100 Refills: 5001 Administer one syringe daily for 7 days. Call for signs of bleeding. Ordered: 1-Jan-2013 Primari, Phillip Start: 14-Jul-2014 End: 14-Jul-2014 Reaction: Hives (Moderate), Abdominal pain (Severe), Vomiting (Severe) Indication: DVT Generic substitution allowed. Comment: Patient is having difficulty paying co-pays for this medication
					<reference value="#simpleSubstanceAdministrationFullTextReference1"/>
					<manufacturedProduct classCode="MANU">
						<!-- ... -->
							<code code="89012" codeSystem="" displayName="lorem ipsum dolor sit amet">
									<!-- notice this reference is just to a piece of the entire substanceAdministration text, and that the reference text is different than the code @displayName -->
									<reference value="#substanceAdministrationProductCodeTextReference1"/>
							<name>lorem ipsum</name>
				<!-- ... -->
				<!-- because of the importance of the following entryRelationship, we show actual templateId content for the Medication Free Text SIG and recommend viewing this as a SHOULD -->
				<entryRelationship typeCode="COMP">
					<substanceAdministration classCode="SBADM" moodCode="INT">
						<templateId root="2.16.840.1.113883."/>
						<code code="76662-6" codeSystem="2.16.840.1.113883.6.1"/>
							<reference value="#substanceAdministrationFreeTextSIGReference1"/>
								<manufacturedLabeledDrug nullFlavor="NA"/>
				<!-- ... -->
  1. C-CDA Example Search Help

    C-CDA Example Search Results
    This screen displays the results of executing the example search criteria against the existing examples recorded in the example database.

  2. Search Criteria Panel

    This panel allow you to further refine your queries and narrow the results

  3. Text Search Words

    Use this field to enter words related to your search. These words can appear in the title, the comments or as part of a special list of keywords associated with the example. The search words should be entered with spaces separating the items.

  4. Filter by example status

    By selecting the various statuses, the search results can be limited to only the example that are set to the selected status(es). By removing all status selections, the filtering is removed and examples from all statuses will be returned (based on any other filtering).

  5. Select only ONC Certified examples

    These are samples referenced in a government rule or certification companion guide.

  6. Execute the search based on the criteria entered (or retrieve all examples if no criteria specified).

  7. The number of results that match the query parameters can be found here.

  8. Use this link to jump back to the initial page of the application (that lists the sections).

  9. This columns list the names of the examples that match the criteria (and the comment for each example).

  10. This columns lists the area in the C-CDA specification (the specification is broken into distinct topics for the various exchangeable documents, the common header, and the sections that occur within the exchangeable documents) that the example demonstrates.

  11. This columns lists the state of the example in the example verification and approval process.

  12. You can select to download the examples directly or navigate to page with the full detailed description of the example.

  13. Tour Complete

    Return to the C-CDA Example Search Results page.