πŸ‘©πŸΌβ€πŸ’» Example CLI Calls

ADAM Validation

java -jar p21-client-2.2.1.jar \ 
--api.key={Enterprise server key} \
--web.host=https://{your company}.pinnacle21.net \
--group=enterprise_cli \
--project=adam-compliance \
--study=adam-compliance-101 \
--standard=adam \
--standard.version=1.0 \
--meddra.version=19.0 \
--cdisc.ct.sdtm.version=2017-06-30 \
--cdisc.ct.adam.version=2017-03-31 \
--source.adam="aspera:///adam-v1.0/compliance" \
--source.sdtm="aspera:///sdtm/compliance" \
--source.define="aspera:///adam/define/inprogress" \
--source.comment="Your comment text goes here" \
--report="/adam-v1.0/reports/compliance.xlsx"

SDTM Validation in a new data package

In this example, the web.host and api.key arguments are not present on the command line. Instead, they are provided through the pinnacle21.conf file.

java -jar p21-client-2.2.1.jar \
--project="Project Name" \
--study="Study Name" \
--datapackage="New DP Name" \
--source.sdtm="aspera:///path/to/data" \
--standard.version=3.2 \
--standard=SDTM \
--meddra.version=21.0 \
--cdisc.ct.sdtm.version=2018-12-21 \
--whodrug.version=GLOBALB3Sep19 \
--snomed.version=2019-09-01 \
--unii.version=2019-07-12 \
--ndf-rt.version=2019-09-03 \
--report=path/to/report.xlsx

SDTM Validation using existing data package attributes

java -jar p21-client-2.2.1.jar \
--project="Project Name" \
--study="Study Name" \
--datapackage="DP Name" \
--source.sdtm="aspera:///path/to/data" \
--standard.version=3.2 \
--standard=SDTM \
--report=path/to/report.xlsx

Define.XML Validation

In order to run define.xml validations, the CLI will also need the "Define Designer" role assigned to the API key it uses.

java -jar p21-client-2.2.1.jar \
--project=adam-define \
--study=adam-define-101 \
--source.define=/define/define-2017-12-18T15-05.xml \
--standard.version=1.0 \
--standard=adam \
--cdisc.ct.sdtm.version=2017-06-30 \
--cdisc.ct.adam.version=2017-03-31 \
--report=/reports/define-valid-report.xlsx

Upload Excel Spec

java -jar p21-client-2.2.1.jar \
--project=xls-spec \
--study=xls-spec-101 \
--standard=sdtm \
--standard.version=3.2 \
--source=/define-2017-12-18T15-01.xlsx \
--output=/define_gen_serv.xml

From SAS Using javaobj

The CLI can be invoked from the SAS program using javaobj API.

If the p21-client-<version>.jar file in the classpath SAS macro can load ProcessUtils class and call startFromCommandLine method.

SAS Macro Exampledata _pinnacle21_cli;  
dcl javaobj jCmd("net/pinnacle21/oce/utils/ProcessUtils");
length exitCode 8.;

* s - string that contains a list of command line parameters; = jCmd.callStaticVoidMethod("startFromCommandLine",s);
jCmd.callStaticIntMethod("exit", exitCode); put exitCode=;
run;

πŸ‘£ What's Next?

Learn more in How do I use P21 Enterprise via API/CLI?

Email questions or feedback to support@pinnacle21.atlassian.net.

Did this answer your question?