forked from NCIP/nci-diff-CDISC
-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathReadMe.txt
100 lines (73 loc) · 3.16 KB
/
ReadMe.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
CDISC Changes Report Generator v2.1
===================================
This program will generate a changes report between two CDISC releases.
The releases may span any amount of time.
Requirements (with install commands for *nix gurus)
---------------------------------------------------
Git (sudo apt-get install git)
Apache Ant (sudo apt-get install ant)
Java Developers Kit (sudo apt-get install openjdk-8-jdk)
Building the program
--------------------
Download this entire project as a .zip.
OR
Clone the DiffCDISC repository onto your local filesystem using Git:
C:\> git clone https://github.com/NCIEVS/diff-cdisc.git
Open a Command Prompt and navigate to the repository directory.
Run an ant build
C:\DiffCDISC> ant build
This will create a 'classes' and add a jar file to the 'dist' directory
where program dependancies are stored. The program is now ready to run.
NOTE: If the build fails, you may need to inspect your ant configurations.
See: https://ant.apache.org/manual/
Preparing data for the program
------------------------------
Users should pull two reports in .txt format from the same EVS CDISC
Archive directory (e.g., ADaM, SDTM, SEND).
Included in this repository are two example reports from the SDTM Archive
directory. The example below will demonstrate how to run the program
using these two files.
Running the program
-------------------
Each report is input into the program (newest followed by oldest),
followed by a "release date" and then the filename of the output.
C:\DiffCDISC\dist>RunChanges "..\docs\SDTM Terminology 2015-09-25.txt" "..\docs\SDTM Terminology 2015-06-26.txt" "9/25/2015" Changes.txt
Initializing diff report...
Getting changes...
Printing changes report...
About the program
-----------------
The following changes between CDISC releases are detected. In the event
of an Update, original and new values are reported.
- Add new CDISC Synonym
- Add new term to existing codelist
- Add new term to new codelist
- Addition of new codelist
- Remove CDISC Synonym
- Remove term entirely from codelist
- Remove term from retired codelist
- Retire codelist
- Update CDISC Codelist Name
- Update CDISC Definition
- Update CDISC Extensible List
- Update CDISC Submission Value
- Update CDISC Synonym
- Update NCI Preferred Term
Known issues
------------
The 'Request Code' column will always be empty as they are stored in the
JIRA tracking system. This column is manually populated by EVS before
each quarterly release.
Version 2.0 was implemented in 2015
Version 2.1 was implemented in Q2 of 2017
Release notes between 1.0 and 2.0
---------------------------------
1. Initialize the diff program if and only if there are 4 program arguments
2. The "Request Code" column values no longer appear as "unknown" (they are now empty)
3. Reported changes on non-differing Codelists have been removed
4. Report changes on removed Codelists
5. Verbaige updates to "Change Types" ("Add" or "Remove" on "CDISC Synonyms" is now just "Update" for existing codelists.)
6. Improved handling of inputs
2.0 and 2.1
-----------
1. Default character set for input Scanner is now windows-1252 to allow reported differences on special characters such as non-breaking spaces.