Terminologieserver - Authoring - CreateCodeSystem
Aus Termserver-CTS2
(Unterschied zwischen Versionen)
(automatisch erstellt vom Webservice-Schnittstellen-Tool) |
(automatisch erstellt vom Webservice-Schnittstellen-Tool) |
||
Zeile 28: | Zeile 28: | ||
<td></td> <td id="cardinality_cell">1..1</td> | <td></td> <td id="cardinality_cell">1..1</td> | ||
<td>Name of codesystem. Each codesystem requires at least one version.</td> | <td>Name of codesystem. Each codesystem requires at least one version.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">2</td> | ||
+ | <td id="param_level2">codeSystemType</td> | ||
+ | <td>String</td> | ||
+ | <td>30</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Type of Code System (Taxonomy, Ontology). Possible values are available in domain table with id 6</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">2</td> | ||
+ | <td id="param_level2">currentVersionId</td> | ||
+ | <td>Long</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Version of the Code System</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Zeile 43: | Zeile 58: | ||
<td></td> <td id="cardinality_cell">0..1</td> | <td></td> <td id="cardinality_cell">0..1</td> | ||
<td>Id of an existing code system</td> | <td>Id of an existing code system</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">2</td> | ||
+ | <td id="param_level2">insertTimestamp</td> | ||
+ | <td>java.util.Date</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Timestamp, when the Code System was inserted</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Zeile 58: | Zeile 80: | ||
<td></td> <td id="cardinality_cell">1..1</td> | <td></td> <td id="cardinality_cell">1..1</td> | ||
<td>Version of a Code System</td> | <td>Version of a Code System</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">codeSystemId</td> | ||
+ | <td>Long</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td></td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Zeile 73: | Zeile 102: | ||
<td></td> <td id="cardinality_cell">0..1</td> | <td></td> <td id="cardinality_cell">0..1</td> | ||
<td>Point of time the Code System looses its validity.</td> | <td>Point of time the Code System looses its validity.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">insertTimestamp</td> | ||
+ | <td>java.util.Date</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Point of time when the Code System Version was inserted.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Zeile 105: | Zeile 141: | ||
<td id="cardinality_cell">0..1</td> | <td id="cardinality_cell">0..1</td> | ||
<td>Preferred language for this code system. Value comes from the ISO 639-1 ('de' for German, 'en' for English, ...)</td> | <td>Preferred language for this code system. Value comes from the ISO 639-1 ('de' for German, 'en' for English, ...)</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">previousVersionID</td> | ||
+ | <td>Long</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Refers to the prior version, if there are more than one.</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Zeile 127: | Zeile 170: | ||
<td></td> <td id="cardinality_cell">0..1</td> | <td></td> <td id="cardinality_cell">0..1</td> | ||
<td>Status of the current entry. Can be taken from a domain.</td> | <td>Status of the current entry. Can be taken from a domain.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">statusDate</td> | ||
+ | <td>java.util.Date</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Point of time of the last change of the status</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Zeile 143: | Zeile 193: | ||
<td>Validity range, Values from domain list "codesystem_validityrange". | <td>Validity range, Values from domain list "codesystem_validityrange". | ||
Standard: 1 (required), 2 (recomended), 3 (limited), 4 (optional)</td> | Standard: 1 (required), 2 (recomended), 3 (limited), 4 (optional)</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">versionId</td> | ||
+ | <td>Long</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td></td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
Zeile 162: | Zeile 219: | ||
<td></td> <td id="cardinality_cell">1..1</td> | <td></td> <td id="cardinality_cell">1..1</td> | ||
<td>Return information</td> | <td>Return information</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">2</td> | ||
+ | <td id="param_level2">count</td> | ||
+ | <td>Integer</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>number of results</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Zeile 191: | Zeile 255: | ||
<td></td> <td id="cardinality_cell">1..1</td> | <td></td> <td id="cardinality_cell">1..1</td> | ||
<td>Name of codesystem. Each codesystem requires at least one version.</td> | <td>Name of codesystem. Each codesystem requires at least one version.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">2</td> | ||
+ | <td id="param_level2">codeSystemType</td> | ||
+ | <td>String</td> | ||
+ | <td>30</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Type of Code System (Taxonomy, Ontology). Possible values are available in domain table with id 6</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Zeile 198: | Zeile 270: | ||
<td></td> <td id="cardinality_cell">1..1</td> | <td></td> <td id="cardinality_cell">1..1</td> | ||
<td>Version of the Code System</td> | <td>Version of the Code System</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">2</td> | ||
+ | <td id="param_level2">description</td> | ||
+ | <td>String</td> | ||
+ | <td>65535</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Narrative description of Code System</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
Zeile 205: | Zeile 285: | ||
<td></td> <td id="cardinality_cell">1..1</td> | <td></td> <td id="cardinality_cell">1..1</td> | ||
<td>Internal ID = Primary Key of Code System</td> | <td>Internal ID = Primary Key of Code System</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">2</td> | ||
+ | <td id="param_level2">insertTimestamp</td> | ||
+ | <td>java.util.Date</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Timestamp, when the Code System was inserted</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">2</td> | ||
+ | <td id="param_level2">name</td> | ||
+ | <td>String</td> | ||
+ | <td>100</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Name of the Code System. The precise name should be specified in the Code System Version.</td> | ||
</tr> | </tr> | ||
<tr id="row_object"> | <tr id="row_object"> | ||
Zeile 212: | Zeile 307: | ||
<td></td> <td id="cardinality_cell">1..1</td> | <td></td> <td id="cardinality_cell">1..1</td> | ||
<td>Version of a Code System</td> | <td>Version of a Code System</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">codeSystemId</td> | ||
+ | <td>Long</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td></td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">description</td> | ||
+ | <td>String</td> | ||
+ | <td>65535</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Description of the Code System</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">expirationDate</td> | ||
+ | <td>java.util.Date</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Point of time the Code System looses its validity.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">insertTimestamp</td> | ||
+ | <td>java.util.Date</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Point of time when the Code System Version was inserted.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">licenceHolder</td> | ||
+ | <td>String</td> | ||
+ | <td>65535</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Owner of the licence.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">name</td> | ||
+ | <td>String</td> | ||
+ | <td>100</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Complete Name of the Code System.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">oid</td> | ||
+ | <td>String</td> | ||
+ | <td>100</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Official OID</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">preferredLanguageCd</td> | ||
+ | <td>String</td> | ||
+ | <td>30</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Preferred language for this code system. Value comes from the ISO 639-1 ('de' for German, 'en' for English, ...)</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">previousVersionID</td> | ||
+ | <td>Long</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Refers to the prior version, if there are more than one.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">releaseDate</td> | ||
+ | <td>java.util.Date</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Point of time, when this version starts to be valid.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">source</td> | ||
+ | <td>String</td> | ||
+ | <td>65535</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Source of the Code System Version</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">status</td> | ||
+ | <td>Integer</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Status of the current entry. Can be taken from a domain.</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">statusDate</td> | ||
+ | <td>java.util.Date</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>Point of time of the last change of the status</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">underLicence</td> | ||
+ | <td>Boolean</td> | ||
+ | <td></td> <td id="cardinality_cell">-</td> | ||
+ | <td>true, if Code System is under license (Code System will be invisible for all users without proper license)</td> | ||
+ | </tr> | ||
+ | <tr id="gray"> | ||
+ | <td id="cardinality_cell">3</td> | ||
+ | <td id="param_level3">validityRange</td> | ||
+ | <td>String</td> | ||
+ | <td>30</td> | ||
+ | <td id="cardinality_cell">-</td> | ||
+ | <td>Validity range, Values from domain list "codesystem_validityrange". | ||
+ | Standard: 1 (required), 2 (recomended), 3 (limited), 4 (optional)</td> | ||
</tr> | </tr> | ||
<tr> | <tr> |
Version vom 30. September 2014, 12:19 Uhr
zurück zur Webservice-Übersicht
Inhaltsverzeichnis |
Beschreibung
Create a new code system including a new version. If the parameter codeSystemId is set and a code system with this id already exists, only a new version will be added instead.
Request/Response
Request
Level | Parameter | Typ | Länge | Kardinalität | Beschreibung |
---|---|---|---|---|---|
1 | loginToken | String | 1..1 | Login-Token that ensures the user is logged in. | |
1 | codeSystem | code_system | 1..1 | Name of codesystem. Each codesystem requires at least one version. | |
2 | codeSystemType | String | 30 | - | Type of Code System (Taxonomy, Ontology). Possible values are available in domain table with id 6 |
2 | currentVersionId | Long | - | Version of the Code System | |
2 | description | String | 65535 | 0..1 | Narrative description of Code System |
2 | id | Long | 0..1 | Id of an existing code system | |
2 | insertTimestamp | java.util.Date | - | Timestamp, when the Code System was inserted | |
2 | name | String | 100 | 0..1 | Name of the new code system. Optional, if code system with given id already exists. |
2 | codeSystemVersion | code_system_version | 1..1 | Version of a Code System | |
3 | codeSystemId | Long | - | ||
3 | description | String | 65535 | 0..1 | Description of the Code System |
3 | expirationDate | java.util.Date | 0..1 | Point of time the Code System looses its validity. | |
3 | insertTimestamp | java.util.Date | - | Point of time when the Code System Version was inserted. | |
3 | licenceHolder | String | 65535 | 0..1 | Owner of the licence. |
3 | name | String | 100 | 1..1 | Complete Name of the Code System. |
3 | oid | String | 100 | 0..1 | Official OID |
3 | preferredLanguageCd | String | 30 | 0..1 | Preferred language for this code system. Value comes from the ISO 639-1 ('de' for German, 'en' for English, ...) |
3 | previousVersionID | Long | - | Refers to the prior version, if there are more than one. | |
3 | releaseDate | java.util.Date | 0..1 | Point of time, when this version starts to be valid. | |
3 | source | String | 65535 | 0..1 | Source of the Code System Version |
3 | status | Integer | 0..1 | Status of the current entry. Can be taken from a domain. | |
3 | statusDate | java.util.Date | - | Point of time of the last change of the status | |
3 | underLicence | Boolean | 1..1 | true, if Code System is under license (Code System will be invisible for all users without proper license) | |
3 | validityRange | String | 30 | 1..1 | Validity range, Values from domain list "codesystem_validityrange". Standard: 1 (required), 2 (recomended), 3 (limited), 4 (optional) |
3 | versionId | Long | - |
Response
Level | Parameter | Typ | Länge | Kardinalität | Beschreibung |
---|---|---|---|---|---|
1 | returnInfos | ReturnType | 1..1 | Return information | |
2 | count | Integer | - | number of results | |
2 | message | String | 1..1 | an additional message | |
2 | overallErrorCategory | 1..1 | INFO, WARN, ERROR | ||
2 | status | 1..1 | OK, FAILURE | ||
1 | codeSystem | code_system | 1..1 | Name of codesystem. Each codesystem requires at least one version. | |
2 | codeSystemType | String | 30 | - | Type of Code System (Taxonomy, Ontology). Possible values are available in domain table with id 6 |
2 | currentVersionId | Long | 1..1 | Version of the Code System | |
2 | description | String | 65535 | - | Narrative description of Code System |
2 | id | Long | 1..1 | Internal ID = Primary Key of Code System | |
2 | insertTimestamp | java.util.Date | - | Timestamp, when the Code System was inserted | |
2 | name | String | 100 | - | Name of the Code System. The precise name should be specified in the Code System Version. |
2 | codeSystemVersion | code_system_version | 1..1 | Version of a Code System | |
3 | codeSystemId | Long | - | ||
3 | description | String | 65535 | - | Description of the Code System |
3 | expirationDate | java.util.Date | - | Point of time the Code System looses its validity. | |
3 | insertTimestamp | java.util.Date | - | Point of time when the Code System Version was inserted. | |
3 | licenceHolder | String | 65535 | - | Owner of the licence. |
3 | name | String | 100 | - | Complete Name of the Code System. |
3 | oid | String | 100 | - | Official OID |
3 | preferredLanguageCd | String | 30 | - | Preferred language for this code system. Value comes from the ISO 639-1 ('de' for German, 'en' for English, ...) |
3 | previousVersionID | Long | - | Refers to the prior version, if there are more than one. | |
3 | releaseDate | java.util.Date | - | Point of time, when this version starts to be valid. | |
3 | source | String | 65535 | - | Source of the Code System Version |
3 | status | Integer | - | Status of the current entry. Can be taken from a domain. | |
3 | statusDate | java.util.Date | - | Point of time of the last change of the status | |
3 | underLicence | Boolean | - | true, if Code System is under license (Code System will be invisible for all users without proper license) | |
3 | validityRange | String | 30 | - | Validity range, Values from domain list "codesystem_validityrange". Standard: 1 (required), 2 (recomended), 3 (limited), 4 (optional) |
3 | versionId | Long | 1..1 |
Beispiele
SOAP
Create code system
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:aut="http://authoring.ws.terminologie.fhdo.de/"> <soapenv:Header/> <soapenv:Body> <aut:CreateCodeSystem> <parameter> <codeSystem> <name>Test Codesystem 1</name> <codeSystemVersions> <name>Test Codesystem Version 1</name> </codeSystemVersions> </codeSystem> <loginToken>237b6ee6-a448-4b91-8210-a896bf50258a</loginToken> </parameter> </aut:CreateCodeSystem> </soapenv:Body> </soapenv:Envelope>