TNM STAGING AS AN HTTP SERVICE

Transcription

1 TNM STAGING AS AN HTTP SERVICE Developing a RESTful HTTP Service as a frontend for the CDC TNM Staging API Roger Chui, Kentucky Cancer Registry

2 BACKGROUND The cancer registry community is switching from AJCC s Collaborative Staging (CS) System to the Tumor, Node, Metastasis (TNM) System CDC developed the TNM Staging Library which allows programmatic stage calculations and provides staging help The library is implemented as a single-user library targeted for Windows; Kentucky needs to use it in a multi-user, cross-platform, server environment Kentucky created a TNM HTTP Service to overcome these limitations

3 HTTP, REST, AND JSON Foundations of the open web HyperTextTransfer Protocol (HTTP) is the language browsers and web servers use to communicate

4 A BASIC HTTP REQUEST 1. Connect to example.com 2. Negotiate encryption 3. Browser sends request GET /images/banana.gif 4. Server sends response 200 OK Content-Type: image/gif Content-Length: 41403

5 HTTP, REST, AND JSON Foundations of the open web HyperTextTransfer Protocol (HTTP) is the language browsers and web servers use to communicate REpresentational State Transfer (REST) is a design philosophy which simplifies interactions between applications and servers Request paths reflect purpose Standardized HTTP verbs (GET, POST, PUT, DELETE) represent easily understood behaviors

6 RESTFUL REQUESTS POST /emr/patient { firstname : New, lastname : Patient } { created :true, mrn :12345} GET /emr/patient/12345 { firstname : New, lastname : Patient } PUT /emr/patient/12345 { firstname : Charlotte, lastname : Bronte } { updated :true, message : Patient record updated } DELETE /emr/patient/12345 { deleted :true, message : Patient record deleted }

7 HTTP, REST, AND JSON Foundations of the open web HyperTextTransfer Protocol (HTTP) is the language browsers and web servers use to communicate REpresentational State Transfer (REST) is a design philosophy which simplifies interactions between applications and servers Request paths reflect purpose Standardized HTTP verbs (GET, POST, PUT, DELETE) for easily understood behavior JavaScript Object Notation (JSON) is a common way to transfer structured and/or ordered information in an easy-to-understand format

8 JSON { } "firstname": "John", "lastname": "Smith", "age": 25, "address": { "streetaddress": "21 2nd Street", "city": "New York", "state": "NY", "postalcode": "10021 }, "phonenumber": [ { "type": "home", "number": " }, { "type": "fax", "number": " } ], "gender": { "type": "male" }

9 CROSS PLATFORM CDC TNM Library is released as a.net library Kentucky Cancer Registry s hospital registry software runs on Java Java cannot directly access.net libraries Kentucky built an HTTP Service allowing any platform with an HTTP client to interface with the TNM Library Kentucky Hospital Registry Software (Java) Java HTTPClient RESTful HTTP Other Registry Software (Native code) Native HTTP Client TNM Library HTTP Service CDC TNM Staging Library

10 MULTI-USER CDC TNM Library is designed for single-user access, typically on a Windows PC, but a server environment allows many simultaneous users Allowing multiple users to access the same software library can cause problems, such as one user getting another s results The TNM HTTP Service protects access to the TNM Library so that multiple users can safely access the library

11 EXAMPLE USAGE Which TNM schema is used for a case diagnosed this year at site C34.3, histology 8046/3? /tnmapi/calc/schema?datacard={ "site":"c343", "histology":"8046", "behavior":"3", "diagnosis_year":"2017" }

12 EXAMPLE USAGE What is schema 37? /tnmapi/schema/37

13 EXAMPLE USAGE What are the valid options for pathologic T for a Lung schema? /tnmapi/schema/37/table/1

14 EXAMPLE USAGE What stage is defined for a lung tumor with these tumor, node, and metastatic parameters? /tnmapi/calc/stage/?datacard={ "site": "C341", "histology": "8046", "diagnosis_year": "2017", "age": "64", "behavior": "3", "sex": "1", "clinical_t": "c2b", "clinical_n": "c3", "clinical_m": "c1b", "path_t": "p1a", "path_n": "p3", "path_m": "p1b" }

15 EXAMPLE USAGE IN KENTUCKY S REGISTRY SOFTWARE

16 WEB APPLICATIONS

17 CONCLUSIONS Creating a multi-user HTTP service has expanded the utility of the original CDC TNM Library Implementation in the Kentucky hospital registry software has reduced the number of TNM staging errors among Kentucky abstractors

18 THANK YOU Peter Kim & Joe Rogers at the CDC for the opportunity to collaborate on an incredibly useful utility Jim Hofferkamp, Frances Ross, and my KCR colleagues for helping test the implementation

19 This image cannot currently be displayed. MORE INFORMATION AND QUESTIONS Demonstration available at Roger Chui, Kentucky Cancer Registry - roger@kcr.uky.edu