Mentions légales du service

Skip to content
Snippets Groups Projects
Commit a4c045a2 authored by Youn Cadoret's avatar Youn Cadoret
Browse files

I added documentation for RMU and XDSMU

parent 1fa669ed
No related branches found
No related tags found
No related merge requests found
---
title: User Manual
subtitle: RMU & XDSMU Simulator
subtitle: RMU Simulator
author: Youn Cadoret
function: Developer
date: 28/06/2019
......
---
title: User Manual
subtitle: RMU & XDSMU Simulator
subtitle: RMU Simulator
author: Youn Cadoret
function: Developer
date: 28/06/2019
......
---
title: User Manual
subtitle: RMU & XDSMU Simulator
subtitle: XDSMU Simulator
author: Youn Cadoret
function: Developer
date: 28/06/2019
toolversion: 1.1.0
version: 0.01
status: to be reviewed
reference: KER1-MAN-IHE-RMU_SIMULATOR_INSTALLATION_USER
reference: KER1-MAN-IHE-XDSMU_SIMULATOR_INSTALLATION_USER
customer: IHE-EUROPE
---
# EPR RMU MockUp
# EPR ITI-57 Update Metadata Set MockUp
## Overview
The RMU MockUp is a SoapUI webservice (mock) that provides Cross-Gateway Update Document Set [ITI-X1] Response. This mock requires that the Update Metadata Registry MockUp is started.
The ITI-57 Update Metadata Set MockUp is a SoapUI webservice (mock) that provides Update Document Set [ITI-57] Response.
* default_wsdl_url: http://ehealthsuisse.ihe-europe.net:8095/restricted-metadata-update?wsdl
* default_path: /restricted-metadata-update
* default_port: 8095
* default_mock_name: RespondingGateway_Binding_Soap12 MockService
* default_wsdl_url: http://ehealthsuisse.ihe-europe.net:8094/update-document-set?wsdl
* default_path: /update-document-set
* default_port: 8094
* default_mock_name: DocumentRegistry_Binding_Soap12 MockService
* default_mock_path: /opt/simulators/epr-restricted-metadata-update-mockup
* default_soapui_path: /usr/local/SmartBear/SoapUI-5.3.0/
* default_soapui_mock_log: /var/log/soapui/epr-restricted-metadata-update.log
* default_init.d: /etc/init.d/rmuRespondingGatewayMock
* default_soapui_mock_log: /var/log/soapui/epr-update-document-set.log
* default_init.d: /etc/init.d/UpdateMetadataSetMock
* default_keystore_path: /opt/gazelle/cert/jboss.jks
......@@ -32,9 +33,9 @@ The RMU MockUp is a SoapUI webservice (mock) that provides Cross-Gateway Update
[https://www.soapui.org/](https://www.soapui.org/)
## Install EPR RMU MockUp
## Install EPR Assertion Provider MockUp
### Get the git project
### Get the Git project
```bash
git clone https://gitlab.inria.fr/gazelle/specific-tools/epr/metadata-update-responders.git $EPR_RMU_MOCK_DIR
......@@ -59,15 +60,15 @@ Edit the init.d scripts `$EPR_RMU_MOCK_DIR/init.d/rmuRespondingGatewayMock` and
Type the following commands register the init.d script as service
```bash
sudo cp $EPR_RMU_MOCK_DIR/init.d/rmuRespondingGatewayMock /etc/init.d/rmuRespondingGatewayMock
sudo chmod u+x /etc/init.d/rmuRespondingGatewayMock
sudo chmod 775 /etc/init.d/rmuRespondingGatewayMock
sudo cp $EPR_RMU_MOCK_DIR/init.d/UpdateMetadataSetMock /etc/init.d/UpdateMetadataSetMock
sudo chmod u+x /etc/init.d/UpdateMetadataSetMock
sudo chmod 775 /etc/init.d/UpdateMetadataSetMock
```
If you want the service to start at each machine start up
```bash
sudo update-rc.d rmuRespondingGatewayMock defaults
sudo update-rc.d UpdateMetadataSetMock defaults
```
Be careful to allow the service to write logs into your target directory. As example
......@@ -82,19 +83,19 @@ sudo chmod 775 /var/log/soapui
To run the mock
```bash
sudo /etc/init.d/rmuRespondingGatewayMock start
sudo /etc/init.d/UpdateMetadataSetMock start
```
To stop the mock
```bash
sudo /etc/init.d/rmuRespondingGatewayMock stop
sudo /etc/init.d/UpdateMetadataSetMock stop
```
To get status of the mock
```bash
sudo /etc/init.d/rmuRespondingGatewayMock status
sudo /etc/init.d/UpdateMetadataSetMock status
```
......@@ -113,7 +114,6 @@ sudo mv /root/.soapuios/ /root/.soapuios_old
```
# EPR ITI-18 Registry Stored Query MockUp
## Overview
......@@ -214,107 +214,3 @@ You might need to resolve errors when starting the mock
```bash
sudo mv /root/.soapuios/ /root/.soapuios_old
```
# EPR ITI-57 Update Metadata Set MockUp
## Overview
The ITI-57 Update Metadata Set MockUp is a SoapUI webservice (mock) that provides Update Document Set [ITI-57] Response.
* default_wsdl_url: http://ehealthsuisse.ihe-europe.net:8094/update-document-set?wsdl
* default_path: /update-document-set
* default_port: 8094
* default_mock_name: DocumentRegistry_Binding_Soap12 MockService
* default_mock_path: /opt/simulators/epr-restricted-metadata-update-mockup
* default_soapui_path: /usr/local/SmartBear/SoapUI-5.3.0/
* default_soapui_mock_log: /var/log/soapui/epr-update-document-set.log
* default_init.d: /etc/init.d/UpdateMetadataSetMock
* default_keystore_path: /opt/gazelle/cert/jboss.jks
## Install SoapUI
[https://www.soapui.org/](https://www.soapui.org/)
## Install EPR Assertion Provider MockUp
### Get the Git project
```bash
git clone https://gitlab.inria.fr/gazelle/specific-tools/epr/metadata-update-responders.git $EPR_RMU_MOCK_DIR
```
## Mock as a service
### Prepare the init.d script
Edit the init.d scripts `$EPR_RMU_MOCK_DIR/init.d/rmuRespondingGatewayMock` and set the following environment variables
* SOAPUI_PATH => Path of SoapUI folder
* SOAPUI_PROJECT_PATH => Path of SoapUI project script
* SOAPUI_MOCK_NAME => Name of the SoapUI mock
* SOAPUI_MOCK_PORT => Port of the SoapUI mock
* SOAPUI_MOCK_ENDPOINT => Path of the SoapUI mock
* SOAPUI_MOCK_LOG => Path where to publish log file
### Declare the service
Type the following commands register the init.d script as service
```bash
sudo cp $EPR_RMU_MOCK_DIR/init.d/UpdateMetadataSetMock /etc/init.d/UpdateMetadataSetMock
sudo chmod u+x /etc/init.d/UpdateMetadataSetMock
sudo chmod 775 /etc/init.d/UpdateMetadataSetMock
```
If you want the service to start at each machine start up
```bash
sudo update-rc.d UpdateMetadataSetMock defaults
```
Be careful to allow the service to write logs into your target directory. As example
```bash
sudo mkdir /var/log/soapui
sudo chmod 775 /var/log/soapui
```
### Start the mock
To run the mock
```bash
sudo /etc/init.d/UpdateMetadataSetMock start
```
To stop the mock
```bash
sudo /etc/init.d/UpdateMetadataSetMock stop
```
To get status of the mock
```bash
sudo /etc/init.d/UpdateMetadataSetMock status
```
## Troubleshouting
You might need to install those following packets
```bash
sudo apt-get install -y libxrender1 libxtst6 libxi6
```
You might need to resolve errors when starting the mock
```bash
sudo mv /root/.soapuios/ /root/.soapuios_old
```
---
title: User Manual
subtitle: RMU & XDSMU Simulator
subtitle: XDSMU Simulator
author: Youn Cadoret
function: Developer
date: 28/06/2019
toolversion: 1.1.0
version: 0.01
status: to be reviewed
reference: KER1-MAN-IHE-RMU_SIMULATOR_USER
reference: KER1-MAN-IHE-XDSMU_SIMULATOR_USER
customer: IHE-EUROPE
---
eHealthSuisse RMU Update Responder MockUp
eHealthSuisse XDS Metadata Update MockUp
-----------------------------------------
ehealthSuisse RMU Update Responder MockUp simulates a Update Responder actor.
ehealthSuisse XDS Metadata Update MockUp simulates a Document Recipient.
The RMU profile provides a capability to change selected metadata attributes of documents registered and stored in another community.
The XDS Metadata Update profile provides a capability to change selected metadata attributes of documents registered.
The actors involved in this profile are : Initiator, Responder and Document Registry/recipient.
......@@ -48,7 +48,6 @@ The actors involved in this profile are : Initiator, Responder and Document Regi
### EndPoint
* [RMU : http://ehealthsuisse.ihe-europe.net/restricted-metadata-update?wsdl](http://ehealthsuisse.ihe-europe.net:8095/xcmu-responding-gateway?wsdl)
......@@ -56,8 +55,217 @@ The actors involved in this profile are : Initiator, Responder and Document Regi
* [ITI-18 : http://ehealthsuisse.ihe-europe.net/registry-stored-query?wsdl](http://ehealthsuisse.ihe-europe.net:8095/registry-stored-query?wsdl)
* It requires TLS mutual authentication with testing certificate (from GSS PKI). [The wsdl can be browsed here](https://ehealthsuisse.ihe-europe.net:10443/xcmu-responding-gateway?wsdl)
### XDS Metadata Update \[ITI-57\] Request example
```xml
<soap12:Envelope xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Header>
<wsa:Action soap12:mustUnderstand="1">urn:ihe:iti:2010:UpdateDocumentSet</wsa:Action>
<wsa:MessageID>urn:uuid:7f24a8b1-05f5-430f-8e2d-87b8ef91dcc0</wsa:MessageID>
<wsa:ReplyTo>
<wsa:Address>http://www.w3.org/2005/08/addressing/anonymous</wsa:Address>
</wsa:ReplyTo>
<wsa:To/>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"/>
</soap12:Header>
<soap12:Body>
<lcm:SubmitObjectsRequest xmlns:lcm="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0" xmlns:rim="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns:rs="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0" xmlns:xdsb="urn:ihe:iti:xds-b:2007" xmlns:xop="http://www.w3.org/2004/08/xop/include">
<rim:RegistryObjectList>
<rim:RegistryPackage id="urn:uuid:fd22545f-d7f6-4ca1-8ff1-d8bae7364ac1" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:RegistryPackage" home="urn:oid:1.2.3.4.5.6.2.333.23">
<rim:Slot name="submissionTime">
<rim:ValueList>
<rim:Value>20180115120619</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Name>
<rim:LocalizedString value="XDS Submission Set"/>
</rim:Name>
<rim:Classification classificationScheme="urn:uuid:aa543740-bdda-424e-8c96-df4873be8500" classifiedObject="urn:uuid:0216e18f-55d4-4593-b73d-3d23d2bab035" id="urn:uuid:05a39635-af04-4802-8c8a-7640dfde61da" nodeRepresentation="419891008" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Classification">
<rim:Slot name="codingScheme">
<rim:ValueList>
<rim:Value>2.16.840.1.113883.6.96</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Name>
<rim:LocalizedString value="Other Composition"/>
</rim:Name>
</rim:Classification>
<rim:Classification classificationNode="urn:uuid:a54d6aa5-d40d-43f9-88c5-b4633d873bdd" classifiedObject="urn:uuid:fd22545f-d7f6-4ca1-8ff1-d8bae7364ac1" id="urn:uuid:d2947dde-7346-437b-87d5-6f4812f68509" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Classification"/>
<rim:ExternalIdentifier id="urn:uuid:c8f14902-d156-43a4-8513-f3f67d2f5dce" identificationScheme="urn:uuid:554ac39e-e3fe-47fe-b233-965d2a147832" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:ExternalIdentifier" registryObject="urn:uuid:fd22545f-d7f6-4ca1-8ff1-d8bae7364ac1" value="1.3.6.1.4.1.21367.2012.2.1.4">
<rim:Name>
<rim:LocalizedString value="XDSSubmissionSet.sourceId"/>
</rim:Name>
</rim:ExternalIdentifier>
<rim:ExternalIdentifier id="urn:uuid:f602bd54-7716-4318-9c69-70e65b4e458e" identificationScheme="urn:uuid:96fdda7c-d067-4183-912e-bf5ee74998a8" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:ExternalIdentifier" registryObject="urn:uuid:fd22545f-d7f6-4ca1-8ff1-d8bae7364ac1" value="1.3.6.1.4.1.12559.11.1.2.2.1.1.4.101633">
<rim:Name>
<rim:LocalizedString value="XDSSubmissionSet.uniqueId"/>
</rim:Name>
</rim:ExternalIdentifier>
<rim:ExternalIdentifier id="c5a27d7a-069a-43c9-b3d5-495110b61575" identificationScheme="urn:uuid:6b5aea1a-874d-4603-a4bc-96a0a7b38446" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:ExternalIdentifier" registryObject="urn:uuid:fd22545f-d7f6-4ca1-8ff1-d8bae7364ac1" value="CHPAM34^^^CHPAM&amp;1.3.6.1.4.1.12559.11.20.1&amp;ISO">
<rim:Name>
<rim:LocalizedString value="XDSSubmissionSet.patientId"/>
</rim:Name>
</rim:ExternalIdentifier>
</rim:RegistryPackage>
<!--==== /Submission Part ====-->
<!--==== Document Entry Part ====-->
<rim:ExtrinsicObject id="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" mimeType="text/xml" objectType="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1" status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved" lid="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" home="urn:oid:1.2.3.4.5.6.2.333.23">
<rim:Slot name="repositoryUniqueId">
<rim:ValueList>
<rim:Value>1.3.6.1.4.1.12559.11.25.1.11.2</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Slot name="hash">
<rim:ValueList>
<rim:Value>e564e98733d1ecdff0255fe0b50a33075940015c</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Slot name="size">
<rim:ValueList>
<rim:Value>9995</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Slot name="languageCode">
<rim:ValueList>
<rim:Value>en-us</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Slot name="creationTime">
<rim:ValueList>
<rim:Value>20180712030836</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Slot name="sourcePatientId">
<rim:ValueList>
<rim:Value>CHPAM34^^^CHPAM&amp;1.3.6.1.4.1.12559.11.20.1&amp;ISO</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Name>
<rim:LocalizedString value="XDSDocument Entry 1"/>
</rim:Name>
<rim:VersionInfo versionName="1"/>
<rim:Classification classificationScheme="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a" classifiedObject="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" id="urn:uuid:6e9c5cff-a1db-4e62-93fd-a257fccc83d5" nodeRepresentation="1241000195103" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Classification">
<rim:Slot name="codingScheme">
<rim:ValueList>
<rim:Value>2.16.840.1.113883.6.96</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Name>
<rim:LocalizedString value="Note on Procedure (record artifact)"/>
</rim:Name>
<rim:VersionInfo versionName="1"/>
</rim:Classification>
<rim:Classification classificationScheme="urn:uuid:f4f85eac-e6cb-4883-b524-f2705394840f" classifiedObject="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" id="urn:uuid:de59c2f8-75a2-4d1b-80ed-c491666b30b3" nodeRepresentation="1131000195104" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Classification">
<rim:Slot name="codingScheme">
<rim:ValueList>
<rim:Value>2.16.840.1.113883.6.96</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Name>
<rim:LocalizedString value="eingeschrenkt"/>
</rim:Name>
<rim:VersionInfo versionName="1"/>
</rim:Classification>
<rim:Classification classificationScheme="urn:uuid:a09d5840-386c-46f2-b5ad-9c3699a4309d" classifiedObject="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" id="urn:uuid:32641cd9-b238-4d56-99ed-1a97d7c85aeb" nodeRepresentation="\*" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Classification">
<rim:Slot name="codingScheme">
<rim:ValueList>
<rim:Value>2.16.756.5.30.1.127.77.10.5.2</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Name>
<rim:LocalizedString value="\*"/>
</rim:Name>
<rim:VersionInfo versionName="1"/>
</rim:Classification>
<rim:Classification classificationScheme="urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1" classifiedObject="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" id="urn:uuid:0e941bd5-e24b-418f-b527-92e0db255fff" nodeRepresentation="394778007" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Classification">
<rim:Slot name="codingScheme">
<rim:ValueList>
<rim:Value>2.16.840.1.113883.6.96</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Name>
<rim:LocalizedString value="Client's or patient's home (environment)"/>
</rim:Name>
<rim:VersionInfo versionName="1"/>
</rim:Classification>
<rim:Classification classificationScheme="urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead" classifiedObject="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" id="urn:uuid:dc659cbe-b5b5-4235-a9b0-fbb9a2de2746" nodeRepresentation="8918198" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Classification">
<rim:Slot name="codingScheme">
<rim:ValueList>
<rim:Value>2.16.840.1.113883.6.96</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Name>
<rim:LocalizedString value="Community Medication Treatment Plan"/>
</rim:Name>
<rim:VersionInfo versionName="1"/>
</rim:Classification>
<rim:Classification classificationScheme="urn:uuid:f0306f51-975f-434e-a61c-c59651d33983" classifiedObject="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" id="urn:uuid:b6e6d57d-eae0-4391-9146-90aabaff52f9" nodeRepresentation="721912009" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Classification">
<rim:Slot name="codingScheme">
<rim:ValueList>
<rim:Value>2.16.840.1.113883.6.96</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Name>
<rim:LocalizedString value="Medication summary document (record artifact)"/>
</rim:Name>
<rim:VersionInfo versionName="1"/>
</rim:Classification>
<rim:ExternalIdentifier id="urn:uuid:7d976a2b-8784-41fc-a939-af0b0d71cbcd" identificationScheme="urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:ExternalIdentifier" registryObject="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" value="1.3.6.1.4.1.12559.11.25.1.16.2.20171010072756850">
<rim:Name>
<rim:LocalizedString value="XDSDocumentEntry.uniqueId"/>
</rim:Name>
<rim:VersionInfo versionName="1"/>
</rim:ExternalIdentifier>
<rim:ExternalIdentifier id="urn:uuid:355feb7f-a3d2-41f5-9e4e-698ed3ffc4bd" identificationScheme="urn:uuid:58a6f841-87b3-4a3e-92fd-a8ffeff98427" objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:ExternalIdentifier" registryObject="urn:uuid:811da817-e516-4331-b9e2-f649086a5481" value="CHPAM34^^^CHPAM&amp;1.3.6.1.4.1.12559.11.20.1&amp;ISO">
<rim:Name>
<rim:LocalizedString value="XDSDocumentEntry.patientId"/>
</rim:Name>
<rim:VersionInfo versionName="1"/>
</rim:ExternalIdentifier>
</rim:ExtrinsicObject>
<!--==== /Document Entry Part ====-->
<rim:Association associationType="urn:oasis:names:tc:ebxml-regrep:AssociationType:HasMember" id="98359cee-59bb-4f9d-a199-151e933eeb66" sourceObject="urn:uuid:fd22545f-d7f6-4ca1-8ff1-d8bae7364ac1" targetObject="urn:uuid:e72a86d7-9d50-4b24-9c8c-2f57f6560ff8">
<rim:Slot name="SubmissionSetStatus">
<rim:ValueList>
<rim:Value>Original</rim:Value>
</rim:ValueList>
</rim:Slot>
<rim:Slot name="PreviousVersion">
<rim:ValueList>
<rim:Value>1</rim:Value>
</rim:ValueList>
</rim:Slot>
</rim:Association>
</rim:RegistryObjectList>
</lcm:SubmitObjectsRequest>
</soap12:Body>
</soap12:Envelope>
```
### XDS Metadata Update \[ITI-57\] Success response example
```xml
<soap12:Envelope xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing">
<soap12:Header>
<wsa:Action xmlns="http://www.w3.org/2005/08/addressing">urn:ihe:iti:2010:UpdateDocumentSetResponse</wsa:Action>
<wsa:MessageID>urn:uuid:247d1b0a-477b-4539-ad61-18833df5b327</wsa:MessageID>
<wsa:To>http://www.w3.org/2005/08/addressing/anonymous</wsa:To>
<wsa:RelatesTo>urn:uuid:43182b89-24d6-43cf-bc86-da4d710650e0</wsa:RelatesTo>
</soap12:Header>
<soap12:Body>
<rs:RegistryResponse status="urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Success" xmlns:rs="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0"/>
</soap12:Body>
</soap12:Envelope>
```
### Restricted Update Document Set \[ITI-92\] Request example
```xml
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment