CTS2-LE REST API: Read Entity Descriptions: Unterschied zwischen den Versionen

Aus CTS2-LE
Zur Navigation springen Zur Suche springen
K (→‎[non-public] Get top level concepts of default code system version with code system uri http://loinc.org)
K (→‎Example Structure for call /codesystem/_/version/_def/entity/11/children?codesystemuri=http://test/vs)
Zeile 336: Zeile 336:
  
  
−
===== Example Structure for call /codesystem/_/version/_def/entity/11/children?codesystemuri=http://test/vs =====
+
===== Example Responses =====
 +
====== Get children of concept with code 11 contained in default csv with csv uri http://test/vs  ======
 +
'''Path''': /codesystem/_/version/_def/entity/11/children?codesystemuri=http://test/vs
 
<code xml>
 
<code xml>
 
  <?xml version="1.0" encoding="UTF-8"?>
 
  <?xml version="1.0" encoding="UTF-8"?>
Zeile 388: Zeile 390:
 
</code>
 
</code>
  
 +
 +
====== [non-public] Get children of LOINC concept with code LP31625-4  ======
 +
'''Compete Path''': http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4/children?codesystemuri=http://loinc.org
 +
<code xml>
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
<EntityList xmlns="http://www.omg.org/spec/CTS2/1.1/Entity" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" complete="COMPLETE" numEntries="8">
 +
    <core:heading xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">
 +
        <core:resourceRoot>http://10.147.147.61:8080/WebCts2LE/rest/</core:resourceRoot>
 +
        <core:resourceURI>codesystem/_/version/_def/entity/LP31625-4/children</core:resourceURI>
 +
        <core:parameter arg="Accept">
 +
            <core:val>*/*</core:val>
 +
        </core:parameter>
 +
        <core:parameter arg="Accept-Language">
 +
            <core:val>de-DE,de;q=0.8,en-US;q=0.6,en;q=0.4</core:val>
 +
        </core:parameter>
 +
        <core:parameter arg="page">
 +
            <core:val>0</core:val>
 +
        </core:parameter>
 +
        <core:parameter arg="maxtoreturn">
 +
            <core:val>100</core:val>
 +
        </core:parameter>
 +
        <core:parameter arg="codesystemuri">
 +
            <core:val>http://loinc.org</core:val>
 +
        </core:parameter>
 +
        <core:accessDate>2016-08-31T11:54:39</core:accessDate>
 +
    </core:heading>
 +
    <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
 +
        <entry>
 +
            <classDescription about="urn:negros:oid#464e3874_3A15697b2c611_3A26bc">
 +
                <entityID>
 +
                    <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP16999-2</core:name>
 +
                </entityID>
 +
                <describingCodeSystemVersion>
 +
                    <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
 +
                </describingCodeSystemVersion>
 +
                <designation designationRole="PREFERRED">
 +
                    <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">House dust</core:value>
 +
                </designation>
 +
                <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
 +
                    <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
 +
                </parent>
 +
                <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP16999-2/children?codesystemuri=http://loinc.org</children>
 +
                <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
 +
            </classDescription>
 +
        </entry>
 +
    </entry>
 +
    <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
 +
        <entry>
 +
            <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A_2D192c">
 +
                <entityID>
 +
                    <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP30672-7</core:name>
 +
                </entityID>
 +
                <describingCodeSystemVersion>
 +
                    <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
 +
                </describingCodeSystemVersion>
 +
                <designation designationRole="PREFERRED">
 +
                    <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Molds and Other Microorganisms</core:value>
 +
                </designation>
 +
                <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
 +
                    <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
 +
                </parent>
 +
                <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP30672-7/children?codesystemuri=http://loinc.org</children>
 +
                <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
 +
            </classDescription>
 +
        </entry>
 +
    </entry>
 +
    <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
 +
        <entry>
 +
            <classDescription about="urn:negros:oid#464e3874_3A15697b2c611_3A_2Da3b">
 +
                <entityID>
 +
                    <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP30681-8</core:name>
 +
                </entityID>
 +
                <describingCodeSystemVersion>
 +
                    <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
 +
                </describingCodeSystemVersion>
 +
                <designation designationRole="PREFERRED">
 +
                    <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Miscellaneous allergens</core:value>
 +
                </designation>
 +
                <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
 +
                    <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
 +
                </parent>
 +
                <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP30681-8/children?codesystemuri=http://loinc.org</children>
 +
                <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
 +
            </classDescription>
 +
        </entry>
 +
    </entry>
 +
    <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
 +
        <entry>
 +
            <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A3d2">
 +
                <entityID>
 +
                    <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP30682-6</core:name>
 +
                </entityID>
 +
                <describingCodeSystemVersion>
 +
                    <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
 +
                </describingCodeSystemVersion>
 +
                <designation designationRole="PREFERRED">
 +
                    <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Drug allergens</core:value>
 +
                </designation>
 +
                <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
 +
                    <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
 +
                </parent>
 +
                <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP30682-6/children?codesystemuri=http://loinc.org</children>
 +
                <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
 +
            </classDescription>
 +
        </entry>
 +
    </entry>
 +
    <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
 +
        <entry>
 +
            <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A1e4a">
 +
                <entityID>
 +
                    <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP30689-1</core:name>
 +
                </entityID>
 +
                <describingCodeSystemVersion>
 +
                    <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
 +
                </describingCodeSystemVersion>
 +
                <designation designationRole="PREFERRED">
 +
                    <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Occupational allergens</core:value>
 +
                </designation>
 +
                <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
 +
                    <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
 +
                </parent>
 +
                <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP30689-1/children?codesystemuri=http://loinc.org</children>
 +
                <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
 +
            </classDescription>
 +
        </entry>
 +
    </entry>
 +
    <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
 +
        <entry>
 +
            <classDescription about="urn:negros:oid#464e3874_3A15697b2c611_3A751d">
 +
                <entityID>
 +
                    <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31627-0</core:name>
 +
                </entityID>
 +
                <describingCodeSystemVersion>
 +
                    <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
 +
                </describingCodeSystemVersion>
 +
                <designation designationRole="PREFERRED">
 +
                    <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Animal</core:value>
 +
                </designation>
 +
                <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
 +
                    <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
 +
                </parent>
 +
                <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31627-0/children?codesystemuri=http://loinc.org</children>
 +
                <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
 +
            </classDescription>
 +
        </entry>
 +
    </entry>
 +
    <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
 +
        <entry>
 +
            <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A567">
 +
                <entityID>
 +
                    <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31628-8</core:name>
 +
                </entityID>
 +
                <describingCodeSystemVersion>
 +
                    <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
 +
                </describingCodeSystemVersion>
 +
                <designation designationRole="PREFERRED">
 +
                    <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Plant</core:value>
 +
                </designation>
 +
                <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
 +
                    <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
 +
                </parent>
 +
                <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31628-8/children?codesystemuri=http://loinc.org</children>
 +
                <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
 +
            </classDescription>
 +
        </entry>
 +
    </entry>
 +
    <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
 +
        <entry>
 +
            <classDescription about="urn:negros:oid#464e3874_3A15697b18c63_3A5a6e">
 +
                <entityID>
 +
                    <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP32758-2</core:name>
 +
                </entityID>
 +
                <describingCodeSystemVersion>
 +
                    <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
 +
                </describingCodeSystemVersion>
 +
                <designation designationRole="PREFERRED">
 +
                    <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Others</core:value>
 +
                </designation>
 +
                <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
 +
                    <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
 +
                    <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
 +
                </parent>
 +
                <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP32758-2/children?codesystemuri=http://loinc.org</children>
 +
                <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
 +
            </classDescription>
 +
        </entry>
 +
    </entry>
 +
</EntityList>
 +
</code>
  
 
===== Exceptions =====
 
===== Exceptions =====

Version vom 31. August 2016, 11:56 Uhr

A general note: Response format and language may be controlled either by a Query Parameter: ?referencelanguage={language} or ?format={format} OR by the HTTP 'Accept' and 'Accept-Language' Header Parameters. Query OR Header parameters will both the accepted as valid, however, the Query parameters will ALWAYS take precedence over the Header parameters, if both are present. Currently, we only support application/xml as format. The language attribute will be ignored.

Root-URL: /WebCts2LE/rest/

Retrieve all top level concepts of a code system version

  • this service is a restricted version of the standard REST call with uri /codesystem/{codesystemid}/version/{codesystemversionid}/entities; it cannot be used to retrieve all entities of a code system version (csv) but only the top level concepts
  • Path: /codesystem/{codesystemid}/version/{codesystemversionid}/entities
  • Method: GET
  • Path Parameters:
codesytemid the Name of the Code System - will be ignored
codesystemversionid the Name (version ID) of the Code System Version, set to '_def' to request the default version
  • Query Parameters:
page the 0-based page number used for paging result sets. Default is 0.
maxtoreturn the maximum number of entries that may be present in a return Directory. If maxToReturn is not supplied, a block size of 100 is used.
codesystemuri the URI that references a code system, e.g. http://www.nlm.nih.gov/mesh14 for the MeSH vocabulary
filtercomponent the name or URI of the property or model element to be filtered. Properties are referenced by their predicate and model elements all have URI's that are established by this specification. This service supports the following filter components: 'toplevel' returns only the top level entities (entities that have no parents and are ranked first in a hierarchy). At the moment, this is the only filtercomponent value and it has to be present in any call.
  • returns: entity:EntityList; contains only the preferred term of each entity description and no alternative designation, definitions are not included
Example Responses
Get top level concepts of the default code system version with code system uri http://test/vs

Path: /codesystem/_/version/_def/entities?codesystemuri=http://test/vs&filtercomponent=toplevel 

<?xml version="1.0" encoding="UTF-8"?>
<EntityList xmlns="http://www.omg.org/spec/CTS2/1.1/Entity" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" complete="COMPLETE" numEntries="3">
   <core:heading xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">
       <core:resourceRoot>http://localhost:8080/WebCts2LE/rest/</core:resourceRoot>
       <core:resourceURI>codesystem/_/version/_def/entities</core:resourceURI>
       <core:parameter arg="filtercomponent">
           <core:val>toplevel</core:val>
       </core:parameter>
       <core:parameter arg="Accept">
           <core:val>*/*</core:val>
       </core:parameter>
       <core:parameter arg="Accept-Language">
           <core:val>de-DE,de;q=0.8,en-US;q=0.6,en;q=0.4</core:val>
       </core:parameter>
       <core:parameter arg="page">
           <core:val>0</core:val>
       </core:parameter>
       <core:parameter arg="maxtoreturn">
           <core:val>100</core:val>
       </core:parameter>
       <core:parameter arg="codesystemuri">
           <core:val>http://test/vs</core:val>
       </core:parameter>
       <core:accessDate>2016-07-05T13:05:22</core:accessDate>
   </core:heading>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fbf">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">3</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">code-system-88-4-11</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">3</core:value>
               </designation>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fc8">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">11</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">code-system-88-4-11</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">designation-1</core:value>
               </designation>
               <children>http://localhost:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/11/children?codesystemuri=http://test/vs</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fc1">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">2</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">code-system-88-4-11</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">designation-2</core:value>
               </designation>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
</EntityList>

[non-public] Get LOINC top level concepts

Complete Path: http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entities?codesystemuri=http://loinc.org&filtercomponent=toplevel 

<?xml version="1.0" encoding="UTF-8"?>
<EntityList complete="COMPLETE" numEntries="24" xmlns="http://www.omg.org/spec/CTS2/1.1/Entity" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <core:heading xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">
       <core:resourceRoot>http://10.147.147.61:8080/WebCts2LE/rest/</core:resourceRoot>
       <core:resourceURI>codesystem/_/version/_def/entities</core:resourceURI>
       <core:parameter arg="filtercomponent">
           <core:val>toplevel</core:val>
       </core:parameter>
       <core:parameter arg="Accept">
           <core:val>*/*</core:val>
       </core:parameter>
       <core:parameter arg="Accept-Language">
           <core:val>de-DE,de;q=0.8,en-US;q=0.6,en;q=0.4</core:val>
       </core:parameter>
       <core:parameter arg="page">
           <core:val>0</core:val>
       </core:parameter>
       <core:parameter arg="maxtoreturn">
           <core:val>100</core:val>
       </core:parameter>
       <core:parameter arg="codesystemuri">
           <core:val>http://loinc.org</core:val>
       </core:parameter>
       <core:accessDate>2016-08-31T11:38:24</core:accessDate>
   </core:heading>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:value>
               </designation>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription"/>
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A2ada">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP32995-0</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Skin tests</core:value>
               </designation>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP32995-0/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription"/>
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A_2D67bb">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP32743-4</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Specimen attributes</core:value>
               </designation>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP32743-4/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription"/>
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b32408_3A_2D3b55">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP32744-2</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Urinalysis</core:value>
               </designation>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP32744-2/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription"/>
           </classDescription>
       </entry>
   </entry>
</EntityList>

Exceptions
  • UnknownCodeSystemVersion if
    • the name of the code system (path parameter codesystemid) is not set to an underscore
    • the query parameter codesystemuri is not specified or is not an uri
    • there is no csv with the given uri and version id
  • unspecified exception if the query parameter filtercomponent is not set to toplevel

Retrieve an entity description from a specified code system version

  • EntityDescriptionReadService:read: retrieve an entity description from a specified code system version
    Please consider the instructions on how to identify a code system version!
  • Path: /codesystem/{codesystemid}/version/{codesystemversionid}/entity/{entityid}
  • Method: GET
  • Path Parameters:
codesytemid the Name of the Code System - will be ignored
codesystemversionid the Name (version ID) of the Code System Version, set to '_def' to request the default version
entityid the Scoped Entity Name of the EntityDescription Resource. This service implementation only accepts the name of the requested EntityDescription. There should not be a namespace identifier.
  • Query Parameters:
codesystemuri the URI that references a code system, e.g. http://www.nlm.nih.gov/mesh14 for the MeSH vocabulary
  • returns: entity:EntityDescriptionMsg; contains all designations for an entity description and definitions if given


Example Responses
Get concept with code c02 contained in default csv with csv uri example:anotherTerminology

Path: /codesystem/_/version/_def/entity/c02?codesystemuri=example:anotherTerminology 

<?xml version="1.0" encoding="UTF-8"?>
<EntityDescriptionMsg xmlns="http://www.omg.org/spec/CTS2/1.1/Entity" xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <core:heading xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">
       <core:resourceRoot>http://localhost:8080/WebCts2LE/rest/</core:resourceRoot>
       <core:resourceURI>codesystem/_/version/_def/entity/c02</core:resourceURI>
       <core:parameter arg="Accept">
           <core:val>*/*</core:val>
       </core:parameter>
       <core:parameter arg="Accept-Language">
           <core:val>de-DE,de;q=0.8,en-US;q=0.6,en;q=0.4</core:val>
       </core:parameter>
       <core:parameter arg="codesystemuri">
           <core:val>example:anotherTerminology</core:val>
       </core:parameter>
       <core:accessDate>2016-07-06T09:24:23</core:accessDate>
   </core:heading>
   <EntityDescription xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <classDescription about="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fa0">
           <entityID>
               <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
               <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">c02</core:name>
           </entityID>
           <describingCodeSystemVersion>
               <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">ExampleCS2016</core:version>
           </describingCodeSystemVersion>
           <designation designationRole="PREFERRED">
               <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">cPrefTerm</core:value>
               <core:language xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">en</core:language>
           </designation>
           <designation designationRole="ALTERNATIVE">
               <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">cSynonym_üöä</core:value>
               <core:language xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">en</core:language>
           </designation>
           <definition definitionRole="INFORMATIVE">
               <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">def for c</core:value>
           </definition>
           <targetOf>http://localhost:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/c02/targetof?codesystemuri=example:anotherTerminology</targetOf>
           <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
       </classDescription>
   </EntityDescription>
</EntityDescriptionMsg>


[non-public] Get LOINC concept with code LP31625-4

Complete Path: http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org 

<?xml version="1.0" encoding="UTF-8"?>
<EntityDescriptionMsg xmlns="http://www.omg.org/spec/CTS2/1.1/Entity" xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <core:heading xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">
       <core:resourceRoot>http://10.147.147.61:8080/WebCts2LE/rest/</core:resourceRoot>
       <core:resourceURI>codesystem/_/version/_def/entity/LP31625-4</core:resourceURI>
       <core:parameter arg="Accept">
           <core:val>*/*</core:val>
       </core:parameter>
       <core:parameter arg="Accept-Language">
           <core:val>de-DE,de;q=0.8,en-US;q=0.6,en;q=0.4</core:val>
       </core:parameter>
       <core:parameter arg="codesystemuri">
           <core:val>http://loinc.org</core:val>
       </core:parameter>
       <core:accessDate>2016-08-31T11:52:17</core:accessDate>
   </core:heading>
   <EntityDescription xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <classDescription about="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
           <entityID>
               <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
               <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
           </entityID>
           <describingCodeSystemVersion>
               <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
           </describingCodeSystemVersion>
           <designation designationRole="PREFERRED">
               <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:value>
               <core:language xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">en</core:language>
           </designation>
           <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4/children?codesystemuri=http://loinc.org</children>
           <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
       </classDescription>
   </EntityDescription>
</EntityDescriptionMsg>

Exceptions
  • UnknownCodeSystemVersion if
    • the name of the code system (path parameter codesystemid) is not set to an underscore
    • the query parameter codesystemuri is not specified or is not an uri
    • there is no csv with the given uri and version id
  • UnknownEntity if there is no entity in the referenced csv with the given entityid as ScopedEntityName:name

Retrieve a list of child entities

  • Resolve a list of child entities. EntityDescriptionQueryService:resolve: Return an EntityDirectory that contains the set of EntityReferences identified by directory.
    Please consider the instructions on how to identify a code system version!
  • Path: /codesystem/{codesystemid}/version/{codesystemversionid}/entity/{entityid}/children
  • Method: GET
  • Path Parameters:
codesytemid the Name of the Code System - will be ignored
codesystemversionid the Name (version ID) of the Code System Version, set to '_def' to request the default version
entityid the Scoped Entity Name of the EntityDescription Resource. This service implementation only accepts the name of the requested EntityDescription. There should not be a namespace identifier.
  • Query Parameters:
page the 0-based page number used for paging result sets. Default is 0.
maxtoreturn the maximum number of entries that may be present in a return Directory. If maxToReturn is not supplied, a block size of 100 is used.
codesystemuri the URI that references a code system, e.g. http://www.nlm.nih.gov/mesh14 for the MeSH vocabulary
  • returns: entity:EntityList


Example Responses
Get children of concept with code 11 contained in default csv with csv uri http://test/vs

Path: /codesystem/_/version/_def/entity/11/children?codesystemuri=http://test/vs 

<?xml version="1.0" encoding="UTF-8"?>
<EntityList xmlns="http://www.omg.org/spec/CTS2/1.1/Entity" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" complete="COMPLETE" numEntries="1">
   <core:heading xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">
       <core:resourceRoot>http://localhost:8080/WebCts2LE/rest/</core:resourceRoot>
       <core:resourceURI>codesystem/_/version/_def/entity/11/children</core:resourceURI>
       <core:parameter arg="Accept">
           <core:val>*/*</core:val>
       </core:parameter>
       <core:parameter arg="Accept-Language">
           <core:val>de-DE,de;q=0.8,en-US;q=0.6,en;q=0.4</core:val>
       </core:parameter>
       <core:parameter arg="page">
           <core:val>0</core:val>
       </core:parameter>
       <core:parameter arg="maxtoreturn">
           <core:val>100</core:val>
       </core:parameter>
       <core:parameter arg="codesystemuri">
           <core:val>http://test/vs</core:val>
       </core:parameter>
       <core:accessDate>2016-07-05T14:24:46</core:accessDate>
   </core:heading>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fc5">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">1.1</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">code-system-88-4-11</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">designation-11-b</core:value>
               </designation>
               <definition definitionRole="NORMATIVE">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">def1.1.b</core:value>
               </definition>
               <parent href="http://localhost:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/11?codesystemuri=http://test/vs" uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fc8">
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">11</core:name>
                   <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">designation-1</core:designation>
               </parent>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
</EntityList>


[non-public] Get children of LOINC concept with code LP31625-4

Compete Path: http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4/children?codesystemuri=http://loinc.org 

<?xml version="1.0" encoding="UTF-8"?>
<EntityList xmlns="http://www.omg.org/spec/CTS2/1.1/Entity" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" complete="COMPLETE" numEntries="8">
   <core:heading xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">
       <core:resourceRoot>http://10.147.147.61:8080/WebCts2LE/rest/</core:resourceRoot>
       <core:resourceURI>codesystem/_/version/_def/entity/LP31625-4/children</core:resourceURI>
       <core:parameter arg="Accept">
           <core:val>*/*</core:val>
       </core:parameter>
       <core:parameter arg="Accept-Language">
           <core:val>de-DE,de;q=0.8,en-US;q=0.6,en;q=0.4</core:val>
       </core:parameter>
       <core:parameter arg="page">
           <core:val>0</core:val>
       </core:parameter>
       <core:parameter arg="maxtoreturn">
           <core:val>100</core:val>
       </core:parameter>
       <core:parameter arg="codesystemuri">
           <core:val>http://loinc.org</core:val>
       </core:parameter>
       <core:accessDate>2016-08-31T11:54:39</core:accessDate>
   </core:heading>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b2c611_3A26bc">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP16999-2</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">House dust</core:value>
               </designation>
               <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
                   <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
               </parent>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP16999-2/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A_2D192c">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP30672-7</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Molds and Other Microorganisms</core:value>
               </designation>
               <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
                   <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
               </parent>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP30672-7/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b2c611_3A_2Da3b">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP30681-8</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Miscellaneous allergens</core:value>
               </designation>
               <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
                   <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
               </parent>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP30681-8/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A3d2">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP30682-6</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Drug allergens</core:value>
               </designation>
               <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
                   <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
               </parent>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP30682-6/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A1e4a">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP30689-1</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Occupational allergens</core:value>
               </designation>
               <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
                   <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
               </parent>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP30689-1/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b2c611_3A751d">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31627-0</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Animal</core:value>
               </designation>
               <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
                   <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
               </parent>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31627-0/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b297e8_3A567">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31628-8</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Plant</core:value>
               </designation>
               <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
                   <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
               </parent>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31628-8/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Entity">
       <entry>
           <classDescription about="urn:negros:oid#464e3874_3A15697b18c63_3A5a6e">
               <entityID>
                   <core:namespace xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">no-namespace</core:namespace>
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP32758-2</core:name>
               </entityID>
               <describingCodeSystemVersion>
                   <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Loinc2.44</core:version>
               </describingCodeSystemVersion>
               <designation designationRole="PREFERRED">
                   <core:value xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Others</core:value>
               </designation>
               <parent href="http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP31625-4?codesystemuri=http://loinc.org" uri="urn:negros:oid#464e3874_3A15697b2c611_3A4a80">
                   <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">LP31625-4</core:name>
                   <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">Allergy</core:designation>
               </parent>
               <children>http://10.147.147.61:8080/WebCts2LE/rest/codesystem/_/version/_def/entity/LP32758-2/children?codesystemuri=http://loinc.org</children>
               <entityType uri="http://fokus.fraunhofer.de/eHealth/cts2infoModel/signatures#ClassDescription" />
           </classDescription>
       </entry>
   </entry>
</EntityList>

Exceptions
  • UnknownCodeSystemVersion if
    • the name of the code system (path parameter codesystemid) is not set to an underscore
    • the query parameter codesystemuri is not specified or is not an uri
    • there is no csv with the given uri and version id
  • UnknownEntity if there is no entity in the referenced csv with the given entityid as ScopedEntityName:name

Retrieve associations in which a given entity is the subject

  • AssociationQueryService:resolve: Return a directory that summarizes the resolution of the supplied association directory URI.
  • Path: /codesystem/{codesystemid}/version/{codesystemversionid}/entity/{entityid}/subjectof
  • Method: GET
  • Path Parameters:
codesytemid the Name of the Code System - will be ignored
codesystemversionid the Name (version ID) of the Code System Version, set to '_def' to request the default version
  • Query Parameters:
page the 0-based page number used for paging result sets. Default is 0.
maxtoreturn the maximum number of entries that may be present in a return Directory. If maxToReturn is not supplied, a block size of 100 is used.
codesystemuri the URI that references a code system, e.g. http://www.nlm.nih.gov/mesh14 for the MeSH vocabulary
  • returns: association:AssociationList
Example Structure for call /codesystem/_/version/_def/entity/a02/subjectof?codesystemuri=example:anotherTerminology

<?xml version="1.0" encoding="UTF-8"?>
<AssociationList xmlns="http://www.omg.org/spec/CTS2/1.1/Association" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" complete="COMPLETE" numEntries="2">
   <core:heading xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">
       <core:resourceRoot>http://localhost:8080/WebCts2LE/rest/</core:resourceRoot>
       <core:resourceURI>codesystem/_/version/_def/entity/a02/subjectof</core:resourceURI>
       <core:parameter arg="Accept">
           <core:val>*/*</core:val>
       </core:parameter>
       <core:parameter arg="Accept-Language">
           <core:val>de-DE,de;q=0.8,en-US;q=0.6,en;q=0.4</core:val>
       </core:parameter>
       <core:parameter arg="page">
           <core:val>0</core:val>
       </core:parameter>
       <core:parameter arg="maxtoreturn">
           <core:val>100</core:val>
       </core:parameter>
       <core:parameter arg="codesystemuri">
           <core:val>example:anotherTerminology</core:val>
       </core:parameter>
       <core:accessDate>2016-07-05T14:32:05</core:accessDate>
   </core:heading>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Association">
       <subject uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fa8" />
       <predicate uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7f9c">
           <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">seeAlso</core:designation>
       </predicate>
       <target>
           <core:entity xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core" href="WebCts2LE/rest/codesystem/_/version/1.0/entity/b02?codesystemuri=example:anotherTerminology" uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fa4">
               <core:name>b02</core:name>
               <core:designation>bPrefTerm</core:designation>
           </core:entity>
       </target>
       <assertedBy>
           <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">ExampleCS2016</core:version>
       </assertedBy>
   </entry>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Association">
       <subject uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fa8" />
       <predicate uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7f9c">
           <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">seeAlso</core:designation>
       </predicate>
       <target>
           <core:entity xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core" href="WebCts2LE/rest/codesystem/_/version/1.0/entity/c02?codesystemuri=example:anotherTerminology" uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fa0">
               <core:name>c02</core:name>
               <core:designation>cPrefTerm</core:designation>
           </core:entity>
       </target>
       <assertedBy>
           <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">ExampleCS2016</core:version>
       </assertedBy>
   </entry>
</AssociationList>


Exceptions
  • UnknownCodeSystemVersion if
    • the name of the code system (path parameter codesystemid) is not set to an underscore
    • the query parameter codesystemuri is not specified or is not an uri
    • there is no csv with the given uri and version id
  • UnknownEntity if there is no entity in the referenced csv with the given entityid as ScopedEntityName:name

Retrieve associations in which a given entity is the target

  • A Directory of Associations that are the 'targetof' the given entity. 'targetof' means that the given entity must participate as the 'target' or 'object' of the association. This URL Path represents: a DirectoryURI that references a set of Associations. AssociationQueryService:resolve: Return a directory that summarizes the resolution of the supplied association directory URI.
  • Path: /codesystem/{codesystemid}/version/{codesystemversionid}/entity/{entityid}/targetof
  • Method: GET
  • Path Parameters:
codesytemid the Name of the Code System - will be ignored
codesystemversionid the Name (version ID) of the Code System Version, set to '_def' to request the default version
  • Query Parameters:
page the 0-based page number used for paging result sets. Default is 0.
maxtoreturn the maximum number of entries that may be present in a return Directory. If maxToReturn is not supplied, a block size of 100 is used.
codesystemuri the URI that references a code system, e.g. http://www.nlm.nih.gov/mesh14 for the MeSH vocabulary
  • returns: association:AssociationList
Example Structure for call /codesystem/_/version/_def/entity/b02/targetof?codesystemuri=example:anotherTerminology

<?xml version="1.0" encoding="UTF-8"?>
<AssociationList xmlns="http://www.omg.org/spec/CTS2/1.1/Association" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" complete="COMPLETE" numEntries="1">
   <core:heading xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">
       <core:resourceRoot>http://localhost:8080/WebCts2LE/rest/</core:resourceRoot>
       <core:resourceURI>codesystem/_/version/_def/entity/b02/targetof</core:resourceURI>
       <core:parameter arg="Accept">
           <core:val>*/*</core:val>
       </core:parameter>
       <core:parameter arg="Accept-Language">
           <core:val>de-DE,de;q=0.8,en-US;q=0.6,en;q=0.4</core:val>
       </core:parameter>
       <core:parameter arg="page">
           <core:val>0</core:val>
       </core:parameter>
       <core:parameter arg="maxtoreturn">
           <core:val>100</core:val>
       </core:parameter>
       <core:parameter arg="codesystemuri">
           <core:val>example:anotherTerminology</core:val>
       </core:parameter>
       <core:accessDate>2016-07-05T14:34:59</core:accessDate>
   </core:heading>
   <entry xmlns="http://www.omg.org/spec/CTS2/1.1/Association">
       <subject href="WebCts2LE/rest/codesystem/_/version/1.0/entity/a02?codesystemuri=example:anotherTerminology" uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fa8">
           <core:name xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">a02</core:name>
           <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">aPrefTerm</core:designation>
       </subject>
       <predicate uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7f9c">
           <core:designation xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">seeAlso</core:designation>
       </predicate>
       <target>
           <core:entity xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core" uri="urn:negros:oid#_2D4e7ea6c8_3A155baac06e0_3A_2D7fa4" />
       </target>
       <assertedBy>
           <core:version xmlns:core="http://www.omg.org/spec/CTS2/1.1/Core">ExampleCS2016</core:version>
       </assertedBy>
   </entry>
</AssociationList>


Exceptions
  • UnknownCodeSystemVersion if
    • the name of the code system (path parameter codesystemid) is not set to an underscore
    • the query parameter codesystemuri is not specified or is not an uri
    • there is no csv with the given uri and version id
  • UnknownEntity if there is no entity in the referenced csv with the given entityid as ScopedEntityName:name
Abgerufen von „https://websites.fraunhofer.de/CTS2-LE/index.php?title=CTS2-LE_REST_API:_Read_Entity_Descriptions&oldid=557“