Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

Example:

Code Block
wget -O- -q \
  --header 'x-user:x' \
  --header 'x-password:y' \
'http://cdws21.ificlaims.com/report/create?name=a-csv-report&type=csv\
&source=list&criteria=US-20140255094-A1,ES-2478140-A8,ES-2486245-T3'
 


Response JSON

Code Block
 
{
   "status" : "success"
   "time" : "0.015465",
   "report" : {
      "id" : "63cfdeb1-0162-444f-9ffa-a1ddd18de7d1"
   },
}



response objectResponse Object
memberMember
valueValue
 @statussuccess | error
 @timeInternal request time in seconds
 @report.idUnique identifier of the report
 @messageIn case of error, this may optionally contain the reason for failure

...

MethodGET

Path

/report/queue

ParamParameter ValuesDescription
 @idString: ex. e16eebc9-6965...Report identifier
 @nthreadsInteger: ex. 4Maximum number of backend processes used to generate report (2, 4 or 8, default=4)
 @batchsizeInteger: ex. 100Number of documents to process per thread (default=200)
 @batchprefixString: ex. my-prefix

Output file name(s) prefix. For example, running an xml report with @package_type=batched, output tar file will contain:

<report-name>.tar:
my-prefix.00000001.xml
my-prefix.00000002.xml
my-prefix.00000003.xml
my-prefix.00000004.xml 

Default=batch

 @package_typeString: ex. archived

Report package type. Valid types include:

  • single: output single file. For report type csv, this is the only available package_type, for report type xml, the output file will contain multiple XML documents
  • archived: (xml only) output tar archive with predictable path to individual documents
  • archived_attachments: (xml only) archived package including associated attachments
  • batched: (xml only) output tar archive containing raw batches
 @package_suffixUnused: generated internally based on package_type and package_compression

The following table shows the generated suffix:

Type
No compression
Gzip
Zip
single<report-name>.csv | .xml<report-name>.gz<report-name>.zip
archived<report-name>.tar<report-name>.tar.gz<report-name>.tar.zip
batched<report-name>.tar<report-name>.tar.gz.<report-name>.tar.zip
 @package_compressionString: ex. gzipValid values are one of: __none__ (default), gzip or zip
 @priorityInteger: ex. 1Setting a priority > 0 will prioritize processing of report higher. Default behavior is to process each report in order of en-queue.

 

Example:

Code Block
wget -O- -q \
  --header 'x-user:x' \
  --header 'x-password:y' \
'http://cdws21.ificlaims.com/report/queue?id=99a479b9-4a73-4f27-b8b1-44b052844e23'

 

Response JSON

Code Block
{
   "status" : "success",
   "time" : "0.064897"
   "queue" : {
      "id" : 257
   },
}

response objectResponse Object
memberMember
valueValue
 @statussuccess | error
 @queue.idReport queue identifier (currently unused in other requests)
 @messageIn case of error, this may optionally contain the reason for failure

...

 

Example:

Code Block
wget -O- \
  --header 'x-user:x' \
  --header 'x-password:y' \
'http://cdws21.ificlaims.com/report/status?id=99a479b9-4a73-4f27-b8b1-44b052844e23'


Response JSON

Code Block
{
   "time" : " 0.041137",
   "status" : "success",
   "report" : {
      "percent_complete" : "0.000",
      "completed_status" : null,
      "completed_stamp" : null,
      "ndocs" : 0,
      "completed_error" : null,
      "ndocs_processed" : 0,
      "running_status" : "queued",
      "entered_stamp" : "2014-09-28 14:52:57",
      "completed_url" : null
   },
}

response objectResponse Object
memberMember
valueValue
 @statussuccess | error
 @messageIn case of error, this may optionally contain the reason for failure
 @report.entered_stampTime stamp when report was queued for processing
 @report.running_status

Stage of processing:

  • queued
  • preparing
  • extracting
  • packaging
  • complete

 

 @report.completed_urlWhen complete, the url of package
 @report.completed_statussuccess | error
 @report.completed_errorIf @completed_status == 'error', this may contain an optional error message pertaining to processing
 @report.completed_stampTime stamp report processing completed
 @report.ndocsTotal number of documents in report. Note: This value will be 0 until @running_status completes the preparation (preparing) stage.
 @report.ndocs_processedTotal number of documents already processed
 @report.percent_completeConvenience value of @ndocs_processed / @ndocs as a floating point, e.g., 0.000

...