resources/doc/tutorials/integrations.md
This page details some integrations of dwv. These PACS integrations use the Web Access to Dicom Object (WADO-URI) protocol (see [conformance](./tutorial-conformance.html#wado-uri)). The PACS handles the searching and once the data is found allows the user to launch the viewer.
Quick summary: [Orthanc](#orthanc) ✅, [Google](#google) ✅, [Conquest](#conquest) ✅, [dcm4chee](#dcm4chee) ✅
Other type: [WordPress](#wordpress) ✅
## Orthanc
[Orthanc](http://www.orthanc-server.com/): _"Orthanc aims at providing a simple, yet powerful standalone DICOM server. Orthanc can turn any computer running Windows or Linux into a DICOM store (in other words, a mini-PACS system). Its architecture is lightweight, meaning that no complex database administration is required, nor the installation of third-party dependencies."_ ([entry](http://www.idoimaging.com/program/409) on idoimaging). License: GPL (see Licensing on the [download](http://www.orthanc-server.com/download.php) page).
Follow the steps described on the [dwv-orthanc-plugin](https://github.com/ivmartel/dwv-orthanc-plugin) page.
Operational since dwv `v0.8.0beta` and issue [#110](https://github.com/ivmartel/dwv/issues/110).
DICOM-web support since `v0.31.0`. Check it using this example 'unsafe' dicom web configuration (json):
```json
{
"Name": "${ORTHANC_NAME} in Docker Compose",
"RemoteAccessAllowed": true,
"Plugins": ["/usr/local/share/orthanc/plugins"],
"DicomWeb": {
"Servers": {
"self": {
"Url": "http://localhost:8042/dicom-web/",
"Username": "orthanc",
"Password": "orthanc",
"HasDelete": true
}
}
},
"ServeFolders": {
"/dwv": "/usr/local/dwv"
}
}
```
DWV is served via the `ServeFolders` to allow it to request files (and not create CORS errors).
This configuration is then passed (as `orthanc-config.json`) to the folowing example docker compose (yaml):
```yaml
version: "3.1"
services:
orthanc:
image: jodogne/orthanc-plugins:1.9.7
command: [/run/secrets/, --trace-dicom]
ports:
- 4242:4242
- 8042:8042
secrets:
- orthanc.json
environment:
- ORTHANC_NAME=OrthancTest
volumes:
- /home/yves/dev/src/github/dwv:/usr/local/dwv
secrets:
orthanc.json:
file: orthanc-config.json
```
Adapt this to the folder containing the dwv code under the `volumes` setting.
Launch it with: `sudo docker-compose up`
You can then access orthanc at [explorer](http://localhost:8042/app/explorer.html). DWV provides a test page to do QIDO and launch the viewer: [dcmweb](http://localhost:8042/dwv/tests/pacs/dcmweb.html) (do not forget to modify the test viewer for it to set the multipart header with the `_dicomWeb` flag).
## Google
Available via the [dwv-jqmobile](https://github.com/ivmartel/dwv-jqmobile) project.
- Google [Drive web](http://drive.google.com/): right click on a DICOM file and choose `Open with`. DWV should appear in the `Suggested apps`, if not, choose `Connect more apps`, search for 'dwv' and connect it (see [managing drive apps](https://support.google.com/drive/answer/2523073) for details)
- Google Chrome store: [dwv app](https://chrome.google.com/webstore/detail/dwv/elkmgopbfeoimigdmekflnapemieceja) (see the [chrome apps help](https://support.google.com/chrome/answer/3060053) for details)
## Conquest
[Conquest](http://ingenium.home.xs4all.nl/dicom.html): _"a full featured DICOM server based on the public domain UCDMC DICOM code"_ ([entry](http://www.idoimaging.com/program/183) on idoimaging). License: Public Domain (see [medfloss](http://www.medfloss.org/node/93)).
Tested version: [1.4.17](http://forum.image-systems.biz/viewtopic.php?f=33&t=18892). See this [thread](http://85.214.110.44/forum/forum/index.php?thread/17196-conquest-and-html5-js-dicom-viewer-dwv-dwv016-below/) on the Conquest forum and the issue [#15](https://github.com/ivmartel/dwv/issues/15). Operational since dwv `v0.3.0`, available in the [dwv-jqmobile](https://github.com/ivmartel/dwv-jqmobile), [dwv-jqui](https://github.com/ivmartel/dwv-jqui) and [dwv-simplistic](https://github.com/ivmartel/dwv-simplistic) demos.
To setup DWV, follow the instructions written in the lua files of the respective demos `resources/scripts` folder.
Conquest installation details:
- Under Fedora 18: [install under ubuntu linux](http://blog.kyodium.net/2010/10/install-conquest-on-ubuntu-1004.html) after [installing apache](http://www.howtoforge.com/installing-apache2-with-php5-and-mysql-support-on-fedora-17-lamp)
- the g++ fedora package is called `gcc-c++`
- the cgi-bin folder is in `/var/www`
- launching services is done using `systemctl`: for example `systemctl start httpd.service` and `systemctl start mysqld.service`
- Under Windows7:
- using [wamp5](http://www.wampserver.com/) (install as admin, see [forum](http://forum.wampserver.com/read.php?1,88043)), the cgi bin folder is in `wamp/bin/apache/apache##/cgi-bin`
- to launch the PACS: start the wamp service and run the `ConquestDICOMServer.exe`, you can then access the web interface at http://127.0.0.1/cgi-bin/dgate.exe?mode=top.
## Dcm4chee
[dcm4che](http://www.dcm4che.org/): _"DICOM archive and image manager, forming the server side of a PACS system"_ ([entry](http://www.idoimaging.com/program/360) on idoimaging). License: GPL (see [license](http://www.dcm4che.org/confluence/display/proj/license)).
Follow the steps described on the [dwv-dcm4chee-web](https://github.com/ivmartel/dwv-dcm4chee-web) page.
Operational since dwv `v0.7.0` and issue [#1](https://github.com/ivmartel/dwv/issues/1).
## WordPress
See [dicom-support](https://wordpress.org/plugins/dicom-support/) plugin and a [demo](https://tyarcaouen.synology.me/wordpress/dwvblog/).