Create tumor reporting templates as dynamic Web forms on a Web platform.
Novel application of a modern software technology for ordinary Web users
Helpful tips on using the Web Platform
Q. What is JSON (JavaScript Object Notation)?
A. JSON stands for "JavaScript Object Notation" and is pronounced "Jason". It's a human-readable and compact solution to represent a complex data structure and facilitate data-interchange between systems. You don't have to know any computer program to understand JSON.
Q. Why use JSON to create dynamic Web form?.
A. JSON has become the dominant form of data exchange. Here are reasons we choose it.
It's readable and comprehensive to non-tech persons.
Its structure is easy to understand and to learn
It doesn't use a full markup structure, unlike XML, and thus is "clean" and compact.
It's easy to parse, especially in JavaScript.
There are gazillion JSON libraries are available for most programming languages
Working with a template in json is very similar to working with a text document. You just need to know a handful simple rules.
Q. What are the essentials to know to be able to work with reporting template in json ?
A. Working with a template in json is very similar to working with a text document. You just need to know a handful simple rules*:
Information (text) content are in five categories (more properly "types") -- arrays, objects, string, number and integer.
Each category (type) is always encapsulated with a pair of brackets, { } or [ ].
One data type can contain other data types which can further contain other types. But each type at each level is ALWAYS enclosed by a pair of brackets.
Some syntaxes (characters) are not not allowed in json. They are "Offensive" characters that can disable the function of the json file. They must be escaped (i.e. make them be ignored) using the backslash character.
The format of content data must be consistent with its category. For example, type "number" must be in whole number format instead of letters or decimals.
* Advice and experiences from a programming-illiterate (member of this project team).
Q. After I filled out a form and submitted it, the pN - Comment were missing?
A. There is a bug in the pT staging note. It is fixed now
Q. I could not find the final pathology report below "Submit" button any more, why?
A. It's been changed for good -- now the final pathology report, after you click "Submit", opens in a separate pop-up window. Click on "Open Report" button to see the final report.
Q. How could I copy the final report (and paste it to another document)?
A. After you submit your form and open the final report, you can do one of two things
Highlight (select) the content in the report window, then press Ctrl+C or right click on it to select "Copy" function from the list. The report content is copied/stored in clipboard.
Click "Download Report" button, your report will be downloaded as a text document to your computer, usually to the Download folder by default. Open the downloaded document and copy the content in the way you like.
Now go to your destination document and paste it.
Q. Does this platform works in all browsers?
A. It's tested in Google Chrome, Firefox, Opera, Microsoft Edge and Internet Explore (7). This Web platform works well with Chrome, Firefox and Opera, OK with Edge. Performance of IE is inconsistent. We recommend Chrome, Firefox and Opera.
Comments