Web Application Properties - dcm4che/dcm4chee-arc-light GitHub Wiki

• Overview
• Web Application Properties Configurations based on use cases
  • WADO / QIDO Exporter used in Pre fetch of WADO objects feature.
  • DICOM to UPS Exporter / FHIR HL7 PDQ Service
  • Archive as STOW client in STOW RS Exporter
  • RESTful Forward Rules
  • Invoke Image Display with Weasis Viewer Integration
  • CD Import feature in professional version of archive

Some Web Application configured in archive may require certain web application specific properties to be configured for it, depending upon where each of these web applications get used in the archive.

Properties	Configurable values	Default	Notes
allow-any-hostname	true false	false	If HTTPS is used you may set this property to true to accept server certificates which does not match the actual host name of the server.
disable-trust-manager	true false	false	If HTTPS is used you may set this property to true to do not need to configure a truststore for verifying the server certificate

Properties	Configurable values	Default	Notes
allow-any-hostname	true false	false	If HTTPS is used you may set this property to true to accept server certificates which does not match the actual host name of the server.
disable-trust-manager	true false	false	If HTTPS is used you may set this property to true to do not need to configure a truststore for verifying the server certificate
bearer-token	eg. UmFuZG9tbHkgdG9rZW4u		Send specified token in HTTP header Authorization: Bearer <TokenValue>
basic-auth	eg. admin:secret		Use HTTP Basic Authentication with specified <user>:<password>
content-type	true false		indicates to copy all patient attributes from entity to the created UPS workitem

Properties	Configurable values	Default	Notes
allow-any-hostname	true false	false	If HTTPS is used you may set this property to true to accept server certificates which does not match the actual host name of the server.
disable-trust-manager	true false	false	If HTTPS is used you may set this property to true to do not need to configure a truststore for verifying the server certificate
bearer-token	eg. UmFuZG9tbHkgdG9rZW4u		Send specified token in HTTP header Authorization: Bearer <TokenValue>
basic-auth	eg. admin:secret		Use HTTP Basic Authentication with specified <user>:<password>
chunked	true false	false	Indicates to send STOW-RS requests in chunked transfer mode
transfer-syntax	eg. JPEGLosslessSV1		Comma separated list of Transfer Syntax identified by its UID or keyword acceptable by the STOW-RS service. If absent or if the Transfer Syntax of object stored at archive matches with one of the configured values, send the object in the Transfer Syntax as it is stored at the archive. Otherwise send the object decompressed to Explicit VR Little Endian. If the specified list does not include Explicit VR Little Endian, but Implicit VR Little Endian, the objects will be send decompressed to Implicit VR Little Endian.
concurrency		1	Specifies maximal number of concurrently invoked STOW-RS requests.

Properties	Configurable values	Default	Notes
allow-any-hostname	true false	false	If HTTPS is used you may set this property to true to accept server certificates which does not match the actual host name of the server.
disable-trust-manager	true false	false	If HTTPS is used you may set this property to true to do not need to configure a truststore for verifying the server certificate

Properties	Configurable values	Notes
IID_PATIENT_URL	weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "patientID={{patientID}}" --query-ext "&includedefaults=false"	- {{patientID}} - Replaced by Patient ID (0010,0020) formatted as HL7® 2 CX data type - {{patientName}} - Replaced by Patient's Name (0010,0010) encoded in the DICOM PN format - {{patientBirthDate}} - Replaced by Patient Birth Date (0010,0030) encoded in the XML primitive dateTime format {{patientName}} and {{patientBirthDate}} can be passed in Weasis URL similar to {{patientID}}
IID_STUDY_URL	weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "studyUID={{studyUID}}" --query-ext "&includedefaults=false"	- {{studyUID}} - Replaced by Study Instance UID (0020,000D) of the SOP Instance - {{studyUID}} - Replaced by Accession Number (0008,0050) of the SOP Instance {{accessionNumber}} can be passed in Weasis URL similar to {{studyUID}}
IID_URL_TARGET	_self _blank	Recommended _self to avoid opening a new empty window in the web browser

Notes :

• {{currentDateTime-P[{years}Y][{months}M][{weeks}W][{days]D]}} - Replaced by past time encoded in the XML primitive dateTime

• {{qidoBaseURL}} is replaced by the current REST service specific URL. Web Service Path of the Web Application is not used.

• {{qidoBasePath}} is replaced by the Web Service Path of the Web Application.

• For secured REST services in archive, pass {{access_token}} in the IID_PATIENT_URL and IID_STUDY_URL which is replaced by OpenID Connect JWT Access Token.

  IID_PATIENT_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "patientID={{patientID}}" --query-ext "&includedefaults=false" -H "Authorization: Bearer {{access_token}}
  IID_STUDY_URL=weasis://$dicom:rs --url "{{qidoBaseURL}}{{qidoBasePath}}" -r "studyUID={{studyUID}}" --query-ext "&includedefaults=false" -H "Authorization: Bearer {{access_token}}"
  

• {{currentDateTime-P[{days}D][T[{hours}H][{min}M]}} may be passed as value of

  Parameter Name	REQ	Description	Notes
  lowerDateTime	O	Used to constrain the earliest study date/time.	Shall be encoded in the XML primitive dateTime format.
  upperDateTime	O	Used to constrain the latest study date/time.	Shall be encoded in the XML primitive dateTime format.

Properties	Configurable values	Notes
MWLAccessionNumberGenerator	<name-of-cd-import-acc-no-id-generator>	Requires an Accession Number specific ID Generator to be configured first.
STOWWebApp	<name-of-cd-import-stow-web-app>	Requires a Web Application with STOW_RS Web Service Class configuration first.