NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Old Version 8

changes.mady.by.user Unknown User (wileyal)

Saved on

compared with

New Version 9

changes.mady.by.user Unknown User (wileyal)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The LexEVS authoring task assumes that there is an external authoring tool that persists partially formed content and performs the necessary validation and reasoning tasks prior to their the content being incrementally loaded into the LexEVS services.

We see this as being a necessary separation, as the potential combination of editors, reasoners, terminology models, etc. other terminology management tooling is almost limitless, and each of these will have its own requirements when it comes to completeness and validity.

Tip
titleImportant Note

Before the changed terminology content is sent to LexEVS Authoring API to process, the client application should make sure that the contents are valid.

  • The contents should either be in LexGrid XML format or a LexGrid java object.
  • The entry level for the changed contents should be at either systemRelease or revision level.
  • The input format will be validated against the LexGrid schema for compliance. If validation fails, an exception will be thrown.
  • Each change request in the revision package is validated sequentially. Each individual request validation will be performed based on the premise that all requests that precede it have been applied (for example, if there are two change requests, one to create a new coding scheme and the second to create a new entity for the coding scheme, the new entity request is validated on the assumption that the coding scheme has been created. The service may validate the entire revision or it may cease validation at any point after an error is detected. This is up to the service provider.
  • If no errors are detected in previous step, the change package is submitted to the business rules "hook", which can apply additional validation, logging and error checking. If the business rules hook returns an error, no further processing is done and the result is returned to the submitter.
  • If the submission passed step two, the complete set of changes will be applied to the service. If, for any reason, an error occurs, such as a network failure or a database failure, the entire revision will be rolled back. Otherwise, the set of changes will be committed.

...

The intent of the change requests is as follows:

...