The Lookup Table Modification API

From MircWiki
Revision as of 13:11, 25 June 2015 by Johnperry (Talk | contribs)

Jump to: navigation, search

This article describes how to update the DICOM Anonymizer lookup table through an external program. The intended audience of this article is software developers. See The CTP Lookup Table Editor for a description of the lookup table structure.

An external program can add or modify a single entry in the lookup table for a DicomAnonymizer stage by accessing the CTP LookupServlet with this URL path:



  • id is the id attribute of the DicomAnonymizer stage whose lookup table is to be modified
  • key is the key of the lookup table entry to be created or modified
  • value is the value to be assigned to the key

Note, this API requires that the DicomAnonymizer stage have an id attribute.

To be effective, the key must include both the KeyType and the PHI value. For example:

adds the ptid/567 entry to the table and assigns it the value 777.

The LookupServlet supports this API through both the HTTP GET and PUT methods. GET is supported only to make initial testing easy. Developers are encouraged to implement using the PUT method as the GET support will be removed in the near future.

The servlet returns one of these response codes:

  • 200: OK - the update succeeded.
  • 403: Forbidden - the requesting user is either not authenticated or does not have the admin role.
  • 304: Not modified - the request could not be serviced with the supplied parameters.

The Not modified response can occur if any one of these conditions are met:

  • any of the three parameters are missing
  • the id parameter does not reference a registered PipelineStage
  • the id parameter references a PipelineStage that is not a DicomAnonymizer

If the update succeeds, the servlet returns the text OK; otherwise, the response is empty.