NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0
Wiki Markup
{scrollbar:icons=false}
h1. {
Scrollbar
iconsfalse
page-info

...

:title}
{section}
{column:width=75%}
{panel:title=Contents of this Page}
{toc:minLevel=2}
{panel}
{column}
{column}
{align:right}{include:Menu LexEVS 6.0 CTS2 to Include}{align}
Section
Column
width75%
Panel
titleContents of this Page
Table of Contents
minLevel2
Column
Wiki Markup

Introduction

LexEVS CTS2 Concept Domain Authoring API provides capability to author Concept Domain, maintain the binding between Concept Domain and the Value Sets and also the ability to create a Code System that can hold the Concept Domains.

Here are the authoring functions that can be performed on concept domain:

  • Create - This function provides capability to create:
    • New Code System to hold concept domains
    • New Concept Domain
    • Add new property to Concept Domain
    • Concept Domain to Value Set binding
  • Edit - This function provides capability to update:
    • Property of a Concept Domain
  • Remove - This function provides capability to remove:
    • Concept Domain
    • Property of a Concept Domain
    • Concept Domain to Value Set binding
  • Versionable Change - This function provides capability to modify versionable attributes of Concept Domain like Status, Effective Date, Expiration Date, isActive and Owner:
    • Concept Domain Status
    • Activate Concept Domain
    • De-Activate Concept Domain

Interface

{column}
{section}

h2. Introduction
LexEVS CTS2 Concept Domain Authoring API provides capability to author Concept Domain, maintain the binding between Concept Domain and the Value Sets and also the ability to create a Code System that can hold the Concept Domains. 

Here are the authoring functions that can be performed on concept domain: 

* *Create* - This function provides capability to create:
** New Code System to hold concept domains
** New Concept Domain
** Add new property to Concept Domain
** Concept Domain to Value Set binding
* *Edit* - This function provides capability to update:
** Property of a Concept Domain
* *Remove* - This function provides capability to remove:
** Concept Domain
** Property of a Concept Domain
** Concept Domain to Value Set binding
* *Versionable Change* - This function provides capability to modify versionable attributes of Concept Domain like Status, Effective Date, Expiration Date, isActive and Owner:
** Concept Domain Status
** Activate Concept Domain
** De-Activate Concept Domain

h2. Interface
*org.lexevs.cts2.author.ConceptDomainAuthoringOperation* is the main interface for all the authoring operations against Concept Domain. This interface can be accessed using main LexEVSCTS2 interface, like:

...



{code
}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthOp = new org.lexevs.cts2.LexEvsCTS2Impl().getAuthoringOperation().getConceptDomainAuthoringOperation();

Revision Information

...


{code}

h2. Revision Information
All the authoring functions described here requires information about the author and revision/version id to be assigned to entities for each of these operations. These is done passing object *org.lexevs.cts2.core.update.RevisionInfo*. RevisionInfo object has following attributes:

...



* *java.lang.String changeAgent* - (Optional) The source that participated in this particular change.

...


* *java.lang.String changeInstruction* - (Optional) A human or machine readable set of instructions on how to apply this change.

...


* *java.lang.String revisionId* - (*Mandatory*) The unique identifier of this revision.

...


* *java.lang.Long editOrder* - (Optional) The relative order that this revision is to be applied if in a systemRelease.

...


* *java.util.Date revisionDate* - (Optional) The end date for which this version is operative (considered commited).

...


* *java.lang.String description* -  (Optional) The description of the resource/change.

...


* *java.lang.String systemReleaseURI* - (Optional) The official URI of this release

...



h2. Authoring Functions

...


Following sections contains detailed functions provided by ConceptDomainAuthoringOperation interface.

h3.

...

 Create Operations

...


Create Operation provides capability to create a Code System to hold Concept Domains, Concept Domain, Property and binding between Concept Domain and Value Sets. For every entry that gets created, a unique revision(version) identifier will be assigned to that entry. This helps in retrieving snapshots of an entry based on its revision(version) identifier. This unique id can be passed in using the RevisionInfo object described above.

...

createConceptDomainCodeSystem

This function provides capability to create a new Code System to contain a set of Concept Domains. The Code System is created by defining the set of meta-data properties that describe it. At this point there is no concept domain added.

...



h4. createConceptDomainCodeSystem
This function provides capability to create a new Code System to contain a set of Concept Domains. The Code System is created by defining the set of meta-data properties that describe it. At this point there is no concept domain added.

{{createConceptDomainCodeSystem(RevisionInfo revision, String codeSystemName, String codeSystemURI, String formalName, String defaultLanguage, long approxNumConcepts, String representsVersion, List<String> localNameList, List<org.LexGrid.commonTypes.Source> sourceList, Text copyright, Mappings mappings)

...

}}

|| *Description:

...

* | Creates new code system to hold concept

...

Input:

 domains. |
|| *Input:* | * *_org.lexevs.cts2.core.update.RevisionInfo revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...


* *_java.lang.String codingSchemeName_* - (*Mandatory*) Concept Domain Code System Name.

...


* *_java.lang.String codingSchemeURI_* - (*Mandatory*) Concept Domain Code System URI.

...


* *_java.lang.String formalName_* - (Optional) Formal name of a Concept Domain Code System.

...


* *_java.lang.String defaultLanguage_* - (Optional) Default language of Concept Domain Code System.

...


* *_long approxNumConcepts_* - (Optional) Approximate number of concept domains this Concept Domain Code System may contain.

...


* *_java.lang.String representsVersion_* - (*Mandatory*) Initial version of the Concept Domain Code System.

...


* *_java.util.List<java.lang.String> localNameList_* - (Optional) Any local name(s)/reference(s) for this Concept Domain Code System used within the Code System.

...


* *_java.util.List<org.LexGrid.commonTypes.Source> sourceList_* - (Optional) Source(s) of this Concept Domain Code System.

...


* *_org.LexGrid.commonTypes.Text copyright_* - (Optional) Information about rights held in and over the Concept Domain Code System. Typically, copyright information includes a statement about various property rights associated with the Concept Domain Code System, including intellectual property rights.

...


* *_org.LexGrid.naming.Mappings mappings_* - (*Mandatory*) A list of all of the local identifiers and defining URI's that are used in the Concept Domain Code System.

...

 |
|| *Output:

...

* | *_org.LexGrid.codingSchemes.CodingScheme_* - Created Concept Domain Code

...

Exception:

 System |
|| *Exception:* | *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
RevisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 3:_ Populate new concept domain code system meta data:

...


{code

...

}
String codingSchemeURI = "urn:oid:11.11.22.999";
String representsVersion = "1.0";

String codingSchemeName = "Concept Domain Coding Scheme";
String formalName = "CTS 2 API Created Concept Domain Code System";
String defaultLanguage = "en";
Long approxNumConcepts = new Long(1);
List<String> localNameList = Arrays.asList();

org.LexGrid.commonTypes.Source source = new org.LexGrid.commonTypes.Source();
source.setContent("source");
List<org.LexGrid.commonTypes.Source> sourceList = Arrays.asList(source);

Text copyright = new Text();
org.LexGrid.naming.Mappings mappings = new org.LexGrid.naming.Mappings();

org.LexGrid.naming.SupportedLanguage supportedLang = new org.LexGrid.naming.SupportedLanguage();

supportedLang.setLocalId("en");_
supportedLang.setUri("URI_for_lang_en");_

mappings.addSupportedLanguage(supportedLang)

...

;
{code}
* _Step 4:_ call create method to create the concept domain code system:

...


{code

...

}
CodingScheme codeScheme = cdAuthorOp.createConceptDomainCodeSystem(revInfo, codingSchemeName, codingSchemeURI, formalName, defaultLanguage, approxNumConcepts, representsVersion, localNameList, sourceList, copyright, mappings);

...

createConceptDomain

This function creates a concept domain to be included in a Code System. The new concept domain is defined by the set of meta-data properties that describe it.

createConceptDomain(String conceptDomainId, String conceptDomainName, String namespace, RevisionInfo revisionInfo, String description, String status, boolean isActive, Properties properties, String codeSystemNameOrURI, String codeSystemVersion)

...

Description:

...

Creates new concept domain in a code system.

...

Input:

...


{code} |

h4. createConceptDomain
This function creates a concept domain to be included in a Code System. The new concept domain is defined by the set of meta-data properties that describe it.

{{createConceptDomain(String conceptDomainId, String conceptDomainName, String namespace, RevisionInfo revisionInfo, String description, String status, boolean isActive, Properties properties, String codeSystemNameOrURI, String codeSystemVersion)}}

|| *Description:* | Creates new concept domain in a code system. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) ID of a new concept domain.
* *_java.lang.String conceptDomainName_* - (*Mandatory*) Name of a new concept domain.
* *_java.lang.String namespace_* - (*Mandatory*) Namespace of a new concept domain.
* *_org.lexevs.cts2.core.update.RevisionInfo revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...


* *_java.lang.String description_* - (*Mandatory*) Description of a new concept domain.

...


* *_java.lang.String status_* - (Optional) Status of new Concept Domain.

...


* *_boolean isActive_* - (Optional) Status of new Concept Domain.

...


* *_org.LexGrid.commonTypes.Properties_* - (Optional) List of properties for the new Concept Domain.

...


* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Name or URI of a Code System that will hold this new Concept Domain.

...


* *_java.lang.String codeSystemVersion_* - (*Mandatory*) Version of a Code System that will hold this new Concept Domain.

...

 |
|| *Output:

...

* |  *_java.lang.String_* - concept domain id if created

...

Exception:

 successfully |
|| *Exception:* | *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
RevisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 3:_ Populate a properties to be added:

...


{code

...

}
Property prop = new Property();
prop.setPropertyId("propertyId1");
prop.setPropertyName("propertyName");
prop.setIsActive(false);
prop.setLanguage("en");
prop.setOwner("owner");
prop.setPropertyType(PropertyTypes.PROPERTY.name());
Text text = new Text();
text.setContent("content");
text.setDataType("Text datatype");
prop.setValue(text);

Properties props = new Properties();

props.addProperty(prop);

...


{code}
* _Step 3:_ call create concept domain method by passing code system version and concept domain information:

...


{code

...

}
String conceptDomainId = cdAuthOp.createConceptDomain("CD00A", "Automobiles-CD", "Automobiles", revInfo, "Concept Domain for automobiles", "pending", false, props, "Automobile", "1.0"

...

addConceptDomainProperty

This function provides capability to add a new property to a concept domain.

addConceptDomainProperty(String conceptDomainId, String namespace, Property newProperty, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)

...

Description:

...

Add new property for a concept domain.

...

Input:

,);
{code} |


h4. addConceptDomainProperty
This function provides capability to add a new property to a concept domain. 

{{addConceptDomainProperty(String conceptDomainId, String namespace, Property newProperty, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)}}

|| *Description:* | Add new property for a concept domain. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) Identifier of a Concept Domain to which a new property will be added.

...


* *_java.lang.String namespace_* - (*Mandatory*) Namespace of a Concept Domain to which a new property will be added.

...


* *_org.LexGrid.commonTypes.Property newProperty_* - (*Mandatory*) New property that will be added to the concept domain.

...


* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Name or URI of a Code System that contains the concept domain.

...


* *_java.lang.String codeSystemVersion_* - (*Mandatory*) Version of a Code System that contains the concept domain.

...


* *_org.lexevs.cts2.core.update.RevisionInfo revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* | *_boolean_* - True; if addition of new property was

...

Exception:

 success |
|| *Exception:* | *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
RevisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 3:_ Populate a property to be added:

...


{code

...

}
Property prop = new Property();
prop.setPropertyId("propertyId1");
prop.setPropertyName("propertyName");
prop.setIsActive(false);
prop.setLanguage("en");
prop.setOwner("owner");
prop.setPropertyType(PropertyTypes.PROPERTY.name());
Text text = new Text();
text.setContent("content");
text.setDataType("Text datatype");
prop.setValue(text);

...

{code}
* _Step 4:_ call add property method by passing the code system information, concept domain information and a new property:

...


{code

...

}
boolean added = cdAuthOp.addNewConceptDomainProperty("CD00A", "Automobiles-CD", prop, "Automobiles", "1

...

addConceptDomainToValueSetBinding

This function provides capability to create a value set to concept domain binding.

addConceptDomainToValueSetBinding(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, URI valueSetURI, RevisionInfo revisionInfo)

...

Description:

...

Create a value set to concept domain binding.

...

Input:

...

.0", revInfo);
{code} |

h4. addConceptDomainToValueSetBinding
This function provides capability to create a value set to concept domain binding.

{{addConceptDomainToValueSetBinding(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, URI valueSetURI, RevisionInfo revisionInfo)}}

|| *Description:* | Create a value set to concept domain binding. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) Identifier of a Concept Domain.
* *_java.lang.String namespace_* - (*Mandatory*) Namespace of a Concept Domain.
* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Name or URI of a Code System that contains the concept domain.
* *_java.lang.String codeSystemVersion_* - (*Mandatory*) Version of a Code System that contains the concept domain.
* *_java.net.URI valueSetURI_* - (*Mandatory*) URI of a value set that will be binded to the concept domain.
* *_org.lexevs.cts2.core.update.RevisionInfo

...

 revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* |  *_boolean_* - True; if binding was

...

Exception:

 success |
|| *Exception:* |  *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation(

...

);
{code}
* _Step 2:_ Populate RevisionInfo object:
{code}
RevisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 3:_ call add binding method by passing the code system information, concept domain information and value set uri:

...


{code

...

}
boolean added = cdAuthOp.addConceptDomainToValueSetBinding("CD00A", "Automobiles-CD", "Automobiles", "1.0", "some_value_set_uri", revInfo);

...

Edit Operations

...


{code} |


h3. Edit Operations
The edit operation provides the capability to modify properties of a concept domain. For every entry that gets modified, a unique revision(version) identifier will be assigned to that entry. This helps in retrieving snapshots of an entry based on its revision(version) identifier. This unique id can be passed in using the RevisionInfo object described above.

h4.

...

 updateConceptDomainProperty

...


This function provides capability to modify existing property of a concept domain.

...

 

{{updateConceptDomainProperty(String conceptDomainId, String namespace, Property changedProperty, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)

...

}}

|| *Description:

...

* | Modifies existing property of a concept domain.

...

Input:

 |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) Identifier of a Concept Domain that contains the property.

...


* *_java.lang.String namespace_* - (*Mandatory*) Namespace of a concept domain that contains the property.

...


* *_org.LexGrid.commonTypes.Property property_* - (*Mandatory*) Modified property.

...


* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Name or URI of a Code System that contains the concept domain.

...


* *_java.lang.String codeSystemVersion_* - (*Mandatory*) Version of a Code System that contains the concept domain.

...


* *_org.lexevs.cts2.core.update.RevisionInfo revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* | *_boolean_* - True; if update was

...

Exception:

 success |
| *Exception:* | *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
RevisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 3:_ Populate a modified property. Just modified isActive to 'true' and language to 'eng' in property 'propertyId1':

...


{code

...

}
Property prop = new Property();
prop.setPropertyId("propertyId1");
prop.setPropertyName("propertyName");
prop.setIsActive(true);
prop.setLanguage("eng");

...


{code}
* _Step 4:_ call update property method by passing the code system , concept domain information and the modified property:

...


{code

...

}
boolean updated = cdAuthOp.updateConceptDomainProperty("CD0001", "Automobiles-CD", prop, "Automobiles", "1.0", revInfo);

...

Remove Operations

Remove operation provides capability to remove concept domain, its property and its binding to value set.

removeConceptDomain

This function provides capability to remove a concept domain.

removeConceptDomain(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)

...

Description:

...

Removes a concept domain from code system.

...

Input:

...


{code} |


h3. Remove Operations
Remove operation provides capability to remove concept domain, its property and its binding to value set.

h4. removeConceptDomain
This function provides capability to remove a concept domain. 

{{removeConceptDomain(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)}}

|| *Description:* | Removes a concept domain from code system. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) Identifier of a Concept Domain to be removed.
* *_java.lang.String namespace_* - (*Mandatory*) Namespace of a Concept Domain to be removed.
* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Name or URI of a Code System that contains the concept domain to be removed.
* *_java.lang.String codeSystemVersion_* - (*Mandatory*) Version of a Code System that contains the concept domain to be removed.
* *_org.lexevs.cts2.core.update.RevisionInfo

...

 revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* |  *_boolean_* - True; if remove was

...

Exception:

 success |
|| *Exception:* |  *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation(

...

);
{code}
* _Step 2:_ Populate RevisionInfo object:
{code}
RevisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 3:_ call remove concept domain method by passing the code system and concept domain information:

...


{code

...

}
boolean removed = cdAuthOp.deleteConcept("CD0001", "Automobiles-CD", "urn:oid:11.11.0.99", "1.0", revInfo);

...

removeConceptDomainProperty

This function provides capability to remove property of a concept domain.

removeConceptDomainProperty(String conceptDomainId, String namespace, Property property, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)

...

Description:

...

Removes a property of a concept domain.

...

Input:

{code} |


h4. removeConceptDomainProperty
This function provides capability to remove property of a concept domain. 

{{removeConceptDomainProperty(String conceptDomainId, String namespace, Property property, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)}}

|| *Description:* | Removes a property of a concept domain. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) Concept Domain identifier that contains the property.

...


* *_java.lang.String namespace_* - (*Mandatory*) Namespace of a concept domain that contains the property.

...


* *_org.LexGrid.commonType.Property property_* - (*Mandatory*) Property that needs to be removed.

...


* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Code System URI/name that contains the concept domain.

...


* *_java.lang.String representsVersion_* - (*Mandatory*) Version of the Code System that contains the concept domain.

...


* *_org.lexevs.cts2.core.update.RevisionInfo revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* |  *_boolean_* - True; if remove was

...

Exception:

 success |
|| *Exception:* |  *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
RevisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 3:_ Populate property that needs to be removed:

...


{code

...

}
Property propertyToRemove = new Property();
propertyToRemove.setPropertyId("p1");

...


{code}
* _Step 4:_ Call remove property method by passing the code system, concept domain and property information:

...


{code

...

}
boolean removed = cdAuthOp.removeConceptDomainProperty("CD0001", "Automobiles-CD", propertyToRemove, "urn:oid:11.11.0.99", "1.0", revInfo);

...

removeConceptDomainToValueSetBinding

This function provides capability to remove value set to concept domain binding.

removeConceptDomainToValueSetBinding(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, URI valueSetURI, RevisionInfo revisionInfo)

...

Description:

...

Removes value set to concept domain binding.

...

Input:


{code} |


h4. removeConceptDomainToValueSetBinding
This function provides capability to remove value set to concept domain binding. 

{{removeConceptDomainToValueSetBinding(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, URI valueSetURI, RevisionInfo revisionInfo)}}

|| *Description:* | Removes value set to concept domain binding. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) Concept Domain identifier.

...


* *_java.lang.String namespace_* - (*Mandatory*) Namespace of a concept domain

...


* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Code System URI/name that contains the concept domain.

...


* *_java.lang.String representsVersion_* - (*Mandatory*) Version of the Code System that contains the concept domain.

...


* *_java.net.UIR valueSetURI_* - (*Mandatory*) URI of a value set.

...


* *_org.lexevs.cts2.core.update.RevisionInfo

...

 revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* | *_boolean_* - True; if binding remove was

...

Exception:

 success |
|| *Exception:* | *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
revisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 3:_ Call remove binding method by passing the code system, concept domain and value set information:

...


{code

...

}
boolean removed = cdAuthOp.removeConceptDomainToValueSetBinding("CD0001", "Automobiles-CD", "urn:oid:11.11.0.99", "1.0", "some_value_set_uri", revInfo);

...

Versionable Change Operations

Versionable Change operation provides capability to modify versionable attributes of Concept Domain like Status, Effective Date, Expiration Date, isActive and Owner.

updateConceptDomainStatus

This function modifies the status of a concept domain.

updateConceptDomainStatus(String conceptDomainId, String namespace, String newStatus, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)

...

Description:

...

Modifies the status of a concept domain.

...

Input:

...

{code} |


h3. Versionable Change Operations
Versionable Change operation provides capability to modify versionable attributes of Concept Domain like Status, Effective Date, Expiration Date, isActive and Owner.

h4. updateConceptDomainStatus
This function modifies the status of a concept domain. 

{{updateConceptDomainStatus(String conceptDomainId, String namespace, String newStatus, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)}}

|| *Description:* | Modifies the status of a concept domain. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) identifier of a concept domain.
* *_java.lang.String namespace_* - (*Mandatory*) Mamespace of a concept domain.
* *_java.lang.String status_* - (*Mandatory*) Modified status value.
* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Code System URI that contains the concept domain.
* *_java.lang.String codeSystemVersion_* - (*Mandatory*) Version of the Code System that contains the concept domain.
* *_org.lexevs.cts2.core.update.RevisionInfo revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* | *_boolean_* - True; if update was

...

Exception:

 success |
|| *Exception:* | *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
revisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 2:_ Call status change method by passing the code system, concept domain and status information:

...


{code

...

}
boolean changed = cdAuthOp.updateConceptDomainStatus("CD00001", "Automobiles-CD", "Active", "urn:oid:11.11.0.99", "1.0", revInfo);

...

activateConceptDomain

This function activates concept domain so that it can be accessed in the terminology service.

activateConceptDomain(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)

...

Description:

...

Activates concept domain.

...

Input:


{code} |


h4. activateConceptDomain
This function activates concept domain so that it can be accessed in the terminology service. 

{{activateConceptDomain(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)}}

|| *Description:* | Activates concept domain. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) identifier of a concept domain.

...


* *_java.lang.String namespace_* - (*Mandatory*) Mamespace of a concept domain.

...


* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Code System URI that contains the concept domain.

...


* *_java.lang.String codeSystemVersion_* - (*Mandatory*) Version of the Code System that contains the concept domain.

...


* *_org.lexevs.cts2.core.update.RevisionInfo revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* | *_boolean_* - True; if activation was

...

Exception:

 success |
|| *Exception:* | *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
revisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 2:_ Call activate method by passing the code system and concept domain information:

...


{code

...

}
boolean activated = cdAuthOp.activateConceptDomain("CD00001", "Automobiles-CD", "urn:oid:11.11.0.99", "1.0", revInfo);

...

deactivateConceptDomain

This function deactivates concept domain so that it can no longer be accessed in the terminology service.

deactivateConceptDomain(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)

...

Description:

...

Deactivates concept domain.

...

Input:


{code} |


h4. deactivateConceptDomain
This function deactivates concept domain so that it can no longer be accessed in the terminology service. 

{{deactivateConceptDomain(String conceptDomainId, String namespace, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)}}

|| *Description:* | Deactivates concept domain. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) identifier of a concept domain.

...


* *_java.lang.String namespace_* - (*Mandatory*) Mamespace of a concept domain.

...


* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Code System URI that contains the concept domain.

...


* *_java.lang.String codeSystemVersion_* - (*Mandatory*) Version of the Code System that contains the concept domain.

...


* *_org.lexevs.cts2.core.update.RevisionInfo revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* | *_boolean_* - True; if deactivation was

...

Exception:

 success |
|| *Exception:* | *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
revisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...

{code}
* _Step 2:_ Call deactivate method by passing the code system and concept domain information:

...


{code

...

}
boolean deactivated = cdAuthOp.deactivateConceptDomain("CD00001", "Automobiles-CD", "urn:oid:11.11.0.99", "1.0", revInfo);

...

updateConceptDomainVersionable

This function provides capability to modify concept domain versionable attributes like effective date, expiration date, owner, status etc.

updateConceptDomainVersionable(String conceptDomainId, String namespace, Versionable changedVersionable, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)

...

Description:

...

Update concept domain versionable attributes like effective date, expiration date, owner, status etc.

...

Input:

...


{code} |


h4. updateConceptDomainVersionable
This function provides capability to modify concept domain versionable attributes like effective date, expiration date, owner, status etc.

{{updateConceptDomainVersionable(String conceptDomainId, String namespace, Versionable changedVersionable, String codeSystemNameOrURI, String codeSystemVersion, RevisionInfo revisionInfo)}}

|| *Description:* | Update concept domain versionable attributes like effective date, expiration date, owner, status etc. |
|| *Input:* | * *_java.lang.String conceptDomainId_* - (*Mandatory*) identifier of a concept domain.
* *_java.lang.String namespace_* - (*Mandatory*) Mamespace of a concept domain.
* *_org.LexGrid.commonTypes.Versionable changedVersionable_* - (*Mandatory*) versionable (like:owner, effectiveDate, expirationDate, status etc) changes.

...


* *_java.lang.String codeSystemNameOrURI_* - (*Mandatory*) Code System URI that contains the concept domain.

...


* *_java.lang.String

...

 codeSystemVersion_* - (*Mandatory*) Version of the Code System that contains the concept domain.

...


* *_org.lexevs.cts2.core.update.RevisionInfo revision_* - (*Mandatory*) Contains revision information like unique RevisionId, change description, author information etc.

...

 |
|| *Output:

...

* | *_boolean_* - True; if update was

...

Exception:

 success |
|| *Exception:* | *_org.LexGrid.LexBIG.Exceptions.LBException

...

Sample Call:

...

_* |
|| *Sample Call:* | * _Step 1:_ Instantiate ConceptDomainAuthoringOperation if it is not done yet:
{code}
org.lexevs.cts2.author.ConceptDomainAuthoringOperation cdAuthorOp = LexEvsCTS2Impl.defaultInstance().getAuthoringOperation().getConceptDomainAuthoringOperation();

...


{code}
* _Step 2:_ Populate RevisionInfo object:

...


{code

...

}
revisionInfo revInfo = new RevisionInfo();
revInfo.setChangeAgent("change Agent Name");
revInfo.setChangeInstruction("here goes the change Instructions");
revInfo.setDescription("description of the resource");
revInfo.setEditOrder(1L);
revInfo.setRevisionDate(new Date());
revInfo.setRevisionId(UUID.randomUUID().toString());

...


{code}
* _Step 2:_ Populate versionable changes:

...


{code

...

}
Versionable changedVersionable = new Versionable();
changedVersionable.setEffectiveDate(new Date());
changedVersionable.setIsActive(true);
changedVersionable.setOwner("new Owner");
changedVersionable.setStatus("new status");

...


{code}
* _Step 3:_ Call change versionable method by passing the code system, concept domain and changed versionable information:

...


{code

...

}
boolean changed = cdAuthOp.updateConceptDomainVersionable("CD00001", "Automobiles-CD", changedVersionable, "urn:oid:11.11.0.99", "1.0", revInfo);

...

{code} |

{scrollbar:icons=false}