diff --git a/.ci/asciidoc-converter/src/main/kotlin/org/sdpi/ConvertAndVerifySupplement.kt b/.ci/asciidoc-converter/src/main/kotlin/org/sdpi/ConvertAndVerifySupplement.kt index 84ddeef..a78dc35 100644 --- a/.ci/asciidoc-converter/src/main/kotlin/org/sdpi/ConvertAndVerifySupplement.kt +++ b/.ci/asciidoc-converter/src/main/kotlin/org/sdpi/ConvertAndVerifySupplement.kt @@ -13,11 +13,11 @@ import org.sdpi.asciidoc.github.IssueImport import java.io.File import kotlin.system.exitProcess -fun main(args: Array) = ConvertAndVerifySupplement().main( - when (System.getenv().containsKey("CI")) { - true -> args.firstOrNull()?.split(" ") ?: listOf() // caution: blanks in quotes not covered here! - false -> args.toList() - } +fun main(args: Array) = ConvertAndVerifySupplement().main(args +// when (System.getenv().containsKey("CI")) { +// true -> args.firstOrNull()?.split(" ") ?: listOf() // caution: blanks in quotes not covered here! +// false -> args.toList() +// } ) class ConvertAndVerifySupplement : CliktCommand("convert-supplement") { diff --git a/.github/copy_images.sh b/.github/copy_images.sh index cb0b847..5e8ceff 100755 --- a/.github/copy_images.sh +++ b/.github/copy_images.sh @@ -3,7 +3,7 @@ sudo apt install graphviz gem install asciidoctor gem install asciidoctor-diagram asciidoctor -V -cd asciidoc +cd asciidoc || exit asciidoctor -r asciidoctor-diagram -D ../ sdpi-supplement.adoc cd .. mkdir sdpi-supplement diff --git a/.github/workflows/feature-review-build.yml b/.github/workflows/feature-review-build.yml index 12bdbe4..4e4b5f0 100755 --- a/.github/workflows/feature-review-build.yml +++ b/.github/workflows/feature-review-build.yml @@ -15,10 +15,10 @@ jobs: steps: - name: Checkout branch - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Set up JDK 11 - uses: actions/setup-java@v3 + uses: actions/setup-java@v4 with: java-version: '11' distribution: 'temurin' @@ -31,11 +31,12 @@ jobs: ruby-version: '3.0' # Not needed with a .ruby-version file bundler-cache: true # runs 'bundle install' and caches installed gems automatically + - name: Setup gradle + uses: gradle/actions/setup-gradle@v4 + - name: Create HTML with Gradle - uses: gradle/gradle-build-action@v2 - with: - arguments: run --args="--input-file ../../asciidoc/sdpi-supplement.adoc --output-folder ../../sdpi-supplement --github-token ${{ secrets.SDPI_API_ACCESS_TOKEN_SECRET }} --backend html" - build-root-directory: .ci/asciidoc-converter + run: ./gradlew run --args="--input-file ../../asciidoc/sdpi-supplement.adoc --output-folder ../../sdpi-supplement --github-token ${{ secrets.SDPI_API_ACCESS_TOKEN_SECRET }} --backend html" + working-directory: .ci/asciidoc-converter - name: Generate PlantUML diagrams and copy images run: .github/copy_images.sh @@ -47,7 +48,7 @@ jobs: - name: Upload artifact # if: success() && github.ref == 'refs/heads/master' - uses: actions/upload-artifact@v3 + uses: actions/upload-artifact@v4 with: name: sdpi-supplement-${{ steps.extract_branch.outputs.branch }} path: sdpi-supplement diff --git a/.github/workflows/latest-master-build.yml b/.github/workflows/latest-master-build.yml index 7990122..d358344 100755 --- a/.github/workflows/latest-master-build.yml +++ b/.github/workflows/latest-master-build.yml @@ -18,10 +18,10 @@ jobs: steps: - name: Checkout branch - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Set up JDK 11 - uses: actions/setup-java@v3 + uses: actions/setup-java@v4 with: java-version: '11' distribution: 'temurin' @@ -33,12 +33,13 @@ jobs: with: ruby-version: '3.0' # Not needed with a .ruby-version file bundler-cache: true # runs 'bundle install' and caches installed gems automatically - + + - name: Setup gradle + uses: gradle/actions/setup-gradle@v4 + - name: Create HTML with Gradle - uses: gradle/gradle-build-action@v2 - with: - arguments: run --args="--input-file ../../asciidoc/sdpi-supplement.adoc --output-folder ../../sdpi-supplement --github-token ${{ secrets.SDPI_API_ACCESS_TOKEN_SECRET }} --backend html" - build-root-directory: .ci/asciidoc-converter + run: ./gradlew run --args="--input-file ../../asciidoc/sdpi-supplement.adoc --output-folder ../../sdpi-supplement --github-token ${{ secrets.SDPI_API_ACCESS_TOKEN_SECRET }} --backend html" + working-directory: .ci/asciidoc-converter - name: Generate PlantUML diagrams and copy images run: .github/copy_images.sh diff --git a/CHANGELOG.md b/CHANGELOG.md index 1bbd533..ed1b5d6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -20,6 +20,10 @@ Each section shall contain a list of action items of the following format: ` + - - - - - + inkscape:current-layer="g114" /> + id="g114" + transform="translate(-160.01667,-113.68333)"> + id="rect384" + width="996.58801" + height="547.07806" + x="148.40143" + y="104.39114" /> + id="rect4" /> + d="m 695.167,241.167 h 189.666 v 78.666 H 695.167 Z m 0.666,78.333 -0.333,-0.333 h 189 l -0.333,0.333 v -78 l 0.333,0.333 h -189 l 0.333,-0.333 z" + id="path6" /> SOMDS FHIR + transform="translate(726.526,273)" + id="text8">SOMDS FHIR Gateway + transform="translate(746.193,302)" + id="text10">Gateway + id="rect12" /> Non + transform="translate(983.047,220)" + id="text14">Non - + transform="translate(1023.88,220)" + id="text16">- SOMDS + transform="translate(1031.21,220)" + id="text18">SOMDS Systems - + transform="translate(1004.4,249)" + id="text20">Systems + id="path22" /> + id="rect24" /> + d="m 695.167,329.167 h 189.666 v 78.666 H 695.167 Z m 0.666,78.333 -0.333,-0.333 h 189 l -0.333,0.333 v -78 l 0.333,0.333 h -189 l 0.333,-0.333 z" + id="path26" /> SOMDS V2 + transform="translate(736.36,361)" + id="text28">SOMDS V2 Gateway + transform="translate(746.193,390)" + id="text30">Gateway + id="rect32" /> SOMDS Connector + transform="translate(697.621,199)" + id="text34">SOMDS Connector {abstract} + transform="translate(740.767,228)" + id="text36">{abstract} + id="rect38" /> + d="m 695.167,417.167 h 189.666 v 78.666 H 695.167 Z m 0.666,78.333 -0.333,-0.333 h 189 l -0.333,0.333 v -78 l 0.333,0.333 h -189 l 0.333,-0.333 z" + id="path40" /> SOMDS Sensor + transform="translate(716.026,449)" + id="text42">SOMDS Sensor Gateway + transform="translate(746.193,478)" + id="text44">Gateway + id="rect46" /> + d="m 695.167,505.167 h 189.666 v 78.666 H 695.167 Z m 0.666,78.333 -0.333,-0.333 h 189 l -0.333,0.333 v -78 l 0.333,0.333 h -189 l 0.333,-0.333 z" + id="path48" /> SOMDS Smart + transform="translate(719.776,537)" + id="text50">SOMDS Smart App Platform + transform="translate(723.563,566)" + id="text52">App Platform + id="rect54" /> Smart Apps + transform="translate(987.77,536)" + id="text56">Smart Apps (incl. SAMD) - + transform="translate(983.717,565)" + id="text58">(incl. SAMD) + id="rect60" /> SOMDS + transform="translate(438.433,240)" + id="text62">SOMDS Provider + transform="translate(433.78,269)" + id="text64">Provider (MDIB, Services, …) + transform="translate(382.153,298)" + id="text66">(MDIB, Services, …) <<SOMDS Participant>> + transform="translate(357.284,186)" + id="text68"><<SOMDS Participant>> + id="rect70" /> SOMDS Consumer + transform="translate(385.35,468)" + id="text72">SOMDS Consumer (consume MDIB info, + transform="translate(373.823,497)" + id="text74">(consume MDIB info, invoke services, …) + transform="translate(385.103,526)" + id="text76">invoke services, …) <<SOMDS Participant>> + transform="translate(359.767,414)" + id="text78"><<SOMDS Participant>> <<SOMDS Participant>> - - + transform="translate(684.954,152)" + id="text80"><<SOMDS Participant>> Legend: + transform="translate(216.873,592)" + id="text82">Legend: + id="path84" /> + id="path86" /> SDC Communication + transform="translate(312.733,611)" + id="text88">SDC Communication Non + transform="translate(312.733,637)" + id="text90">Non - + transform="translate(344.399,637)" + id="text92">- SDC Communication + transform="translate(350.066,637)" + id="text94">SDC Communication + + Discovery + Proxy + + + + + + diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-24-resolve-match.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-24-resolve-match.xml index f41320e..48b79a3 100644 --- a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-24-resolve-match.xml +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-24-resolve-match.xml @@ -9,7 +9,7 @@ http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/ResolveMatches - urn:docs-oasis-open-org:ws-dd:ns:discovery:2009:01 + http://www.w3.org/2005/08/addressing/anonymous diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-46-bye.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-46-bye.xml new file mode 100644 index 0000000..6410b02 --- /dev/null +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-46-bye.xml @@ -0,0 +1,18 @@ + + + + http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/Bye + + urn:docs-oasis-open-org:ws-dd:ns:discovery:2009:01 + + + + + + + + + diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-46-directed-probe.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-46-directed-probe.xml new file mode 100644 index 0000000..f4bb37b --- /dev/null +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-46-directed-probe.xml @@ -0,0 +1,15 @@ + + + + http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/Probe + + urn:docs-oasis-open-org:ws-dd:ns:discovery:2009:01 + + + + + diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-34-bye.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-46-hello.xml similarity index 82% rename from asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-34-bye.xml rename to asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-46-hello.xml index aefdda9..4d80b17 100644 --- a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-34-bye.xml +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-46-hello.xml @@ -1,24 +1,23 @@ - - - - http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/Bye - - urn:docs-oasis-open-org:ws-dd:ns:discovery:2009:01 - - - - - - - - dpws:Device mdpws:MedicalDevice - - - - - + + + + http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/Hello + + urn:docs-oasis-open-org:ws-dd:ns:discovery:2009:01 + + + + + + + dpws:Device mdpws:MedicalDevice + sdc.mds.pkp:1.2.840.10004.20701.1.1 + + + + diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-bye.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-bye.xml new file mode 100644 index 0000000..6410b02 --- /dev/null +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-bye.xml @@ -0,0 +1,18 @@ + + + + http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/Bye + + urn:docs-oasis-open-org:ws-dd:ns:discovery:2009:01 + + + + + + + + + diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-hello.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-hello.xml new file mode 100644 index 0000000..4d80b17 --- /dev/null +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-hello.xml @@ -0,0 +1,23 @@ + + + + http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/Hello + + urn:docs-oasis-open-org:ws-dd:ns:discovery:2009:01 + + + + + + + dpws:Device mdpws:MedicalDevice + sdc.mds.pkp:1.2.840.10004.20701.1.1 + + + + diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-probe-match.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-probe-match.xml new file mode 100644 index 0000000..fa7a167 --- /dev/null +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-probe-match.xml @@ -0,0 +1,27 @@ + + + + http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/ProbeMatches + + + http://www.w3.org/2005/08/addressing/anonymous + + + + + + + + dpws:Device mdpws:MedicalDevice + sdc.mds.pkp:1.2.840.10004.20701.1.1 + + + + + + diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-probe.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-probe.xml new file mode 100644 index 0000000..158fadb --- /dev/null +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-probe.xml @@ -0,0 +1,18 @@ + + + + http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/Probe + + urn:docs-oasis-open-org:ws-dd:ns:discovery:2009:01 + + + + mdpws:MedicalDevice + sdc.mds.pkp:1.2.840.10004.20701.1.1 + + + diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-resolve-match.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-resolve-match.xml new file mode 100644 index 0000000..e786439 --- /dev/null +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-resolve-match.xml @@ -0,0 +1,27 @@ + + + + http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/ResolveMatches + + + http://www.w3.org/2005/08/addressing/anonymous + + + + + + + + dpws:Device mdpws:MedicalDevice + sdc.mds.pkp:1.2.840.10004.20701.1.1 + + + + + + diff --git a/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-resolve.xml b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-resolve.xml new file mode 100644 index 0000000..25e549b --- /dev/null +++ b/asciidoc/listings/vol2-clause-appendix-a-mdpws-dev-47-resolve.xml @@ -0,0 +1,18 @@ + + + + http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/Resolve + + urn:docs-oasis-open-org:ws-dd:ns:discovery:2009:01 + + + + + + + + + diff --git a/asciidoc/plantuml/common_style.inc.puml b/asciidoc/plantuml/common_style.inc.puml new file mode 100644 index 0000000..7e74ff0 --- /dev/null +++ b/asciidoc/plantuml/common_style.inc.puml @@ -0,0 +1,9 @@ +@startuml + +skinparam { + monochrome true + defaultFontSize 16 + dpi 100 +} + +@enduml \ No newline at end of file diff --git a/asciidoc/plantuml/vol1-figure-sdpi-a-delegation-example-sequence-diagram.puml b/asciidoc/plantuml/vol1-figure-sdpi-a-delegation-example-sequence-diagram.puml index e08c67d..a1dc9b8 100644 --- a/asciidoc/plantuml/vol1-figure-sdpi-a-delegation-example-sequence-diagram.puml +++ b/asciidoc/plantuml/vol1-figure-sdpi-a-delegation-example-sequence-diagram.puml @@ -1,5 +1,7 @@ @startuml +!include plantuml/common_style.inc.puml + !global $str_sdc_sc = "SOMDS Medical Alert Consumer" !global $str_sdc_sp = "SOMDS Medical Alert Provider" diff --git a/asciidoc/plantuml/vol1-figure-sdpi-a-reporting-example-sequence-diagram.puml b/asciidoc/plantuml/vol1-figure-sdpi-a-reporting-example-sequence-diagram.puml index 57ad69b..1959e9f 100644 --- a/asciidoc/plantuml/vol1-figure-sdpi-a-reporting-example-sequence-diagram.puml +++ b/asciidoc/plantuml/vol1-figure-sdpi-a-reporting-example-sequence-diagram.puml @@ -1,5 +1,7 @@ @startuml +!include plantuml/common_style.inc.puml + !global $str_sdc_sc = "SOMDS Medical Alert Consumer" !global $str_sdc_sp = "SOMDS Medical Alert Provider" diff --git a/asciidoc/plantuml/vol1-figure-sdpi-p-example-sequence-diagram.puml b/asciidoc/plantuml/vol1-figure-sdpi-p-example-sequence-diagram.puml index 72490b9..016ba07 100644 --- a/asciidoc/plantuml/vol1-figure-sdpi-p-example-sequence-diagram.puml +++ b/asciidoc/plantuml/vol1-figure-sdpi-p-example-sequence-diagram.puml @@ -1,7 +1,6 @@ @startuml -skinparam dpi 300 -skinparam monochrome true +!include plantuml/common_style.inc.puml !global $str_sdpi_p_somds_prov = "SOMDS Provider" !global $str_sdpi_p_somds_cons = "SOMDS Consumer" diff --git a/asciidoc/plantuml/vol1-figure-sdpi-p-managed-discovery-option-sequence-diagram.puml b/asciidoc/plantuml/vol1-figure-sdpi-p-managed-discovery-option-sequence-diagram.puml new file mode 100644 index 0000000..539fac3 --- /dev/null +++ b/asciidoc/plantuml/vol1-figure-sdpi-p-managed-discovery-option-sequence-diagram.puml @@ -0,0 +1,38 @@ +@startuml + +!include plantuml/common_style.inc.puml + +autonumber + + +!global $str_somds_provider = "SOMDS Provider" +!global $str_somds_discovery_proxy = "Discovery Proxy" +!global $str_somds_consumer = "SOMDS Consumer" + +participant "$str_somds_provider" as somds_provider +participant "$str_somds_discovery_proxy" as somds_discovery_proxy +participant "$str_somds_consumer" as somds_consumer + +==SDPi-P Managed Discovery Option== + +group secured + +somds_provider ->> somds_discovery_proxy: Update Network Presence + +end + +group secured + +somds_consumer ->> somds_discovery_proxy: Retrieve Network Presence +somds_discovery_proxy -->> somds_consumer: Return Network Presence + +end + +group secured + somds_consumer -> somds_provider: Discover BICEPS Services + somds_provider -->> somds_consumer + + note over somds_discovery_proxy: Normal SDPi-P CONSUMER / PROVIDER Interactions +end + +@enduml \ No newline at end of file diff --git a/asciidoc/plantuml/vol1-figure-sdpi-r-example-sequence-diagram.puml b/asciidoc/plantuml/vol1-figure-sdpi-r-example-sequence-diagram.puml index 8176c65..0dd7b41 100644 --- a/asciidoc/plantuml/vol1-figure-sdpi-r-example-sequence-diagram.puml +++ b/asciidoc/plantuml/vol1-figure-sdpi-r-example-sequence-diagram.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_sdc_sc = "SOMDS Medical Data Consumer" diff --git a/asciidoc/plantuml/vol1-figure-sdpi-xc-example-sequence-diagram.puml b/asciidoc/plantuml/vol1-figure-sdpi-xc-example-sequence-diagram.puml index 66bd751..0fede69 100644 --- a/asciidoc/plantuml/vol1-figure-sdpi-xc-example-sequence-diagram.puml +++ b/asciidoc/plantuml/vol1-figure-sdpi-xc-example-sequence-diagram.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_sdc_sc = "SOMDS Medical Control Consumer" diff --git a/asciidoc/plantuml/vol2-figure-dev-23-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-23-sequence.puml index d9361ea..d2e1054 100644 --- a/asciidoc/plantuml/vol2-figure-dev-23-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-23-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,11 +9,10 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Announce Network Presence [DEV-23]== -||| +==Announce Network Presence [DEV-23]== + group unsecured provider ->> consumer: Hello(Provider UID, Discovery Scope) end -||| @enduml \ No newline at end of file diff --git a/asciidoc/plantuml/vol2-figure-dev-24-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-24-sequence.puml index 17d8219..2bd0abc 100644 --- a/asciidoc/plantuml/vol2-figure-dev-24-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-24-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Discover Network Topology [DEV-24]== +==Discover Network Topology [DEV-24]== alt consumer ->> provider: Probe(Discovery Scope) diff --git a/asciidoc/plantuml/vol2-figure-dev-25-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-25-sequence.puml index a550b8d..09470e9 100644 --- a/asciidoc/plantuml/vol2-figure-dev-25-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-25-sequence.puml @@ -1,5 +1,6 @@ @startuml -skinparam monochrome true + +!include plantuml/common_style.inc.puml autonumber !global $str_sdpi_p_somds_cons = "SOMDS Consumer" @@ -8,7 +9,7 @@ autonumber participant "$str_sdpi_p_somds_cons" as sdpi_somds_consumer participant "$str_sdpi_p_somds_prov" as sdpi_somds_provider -==SDPi Discover BICEPS Services [DEV-25]== +==Discover BICEPS Services [DEV-25]== sdpi_somds_consumer -> sdpi_somds_provider: GetMetadata() sdpi_somds_consumer <<-- sdpi_somds_provider: GetMetadataResponse(BICEPS Services, Device Metadata, Model Metadata) diff --git a/asciidoc/plantuml/vol2-figure-dev-27-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-27-sequence.puml index 9280669..ff480e2 100644 --- a/asciidoc/plantuml/vol2-figure-dev-27-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-27-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Manage BICEPS Subscription [DEV-27]== +==Manage BICEPS Subscription [DEV-27]== consumer -> provider: Subscribe(Filter, Expiration Time) consumer <<-- provider: SubscribeResponse(Subscription Manager, Expiration Time) diff --git a/asciidoc/plantuml/vol2-figure-dev-28-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-28-sequence.puml index e22048d..ed74060 100644 --- a/asciidoc/plantuml/vol2-figure-dev-28-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-28-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Notify Change in System Context and Capabilities [DEV-28]== +==Notify Change in System Context and Capabilities [DEV-28]== consumer <<- provider: Notification(EpisodicContextReport) diff --git a/asciidoc/plantuml/vol2-figure-dev-29-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-29-sequence.puml index 55b17bf..b2e8bf1 100644 --- a/asciidoc/plantuml/vol2-figure-dev-29-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-29-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Publish BICEPS Update Reports [DEV-29]== +==Publish BICEPS Update Reports [DEV-29]== opt consumer <<- provider: Notification(EpisodicAlertReport) end diff --git a/asciidoc/plantuml/vol2-figure-dev-30-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-30-sequence.puml index a0a81e0..4cd4172 100644 --- a/asciidoc/plantuml/vol2-figure-dev-30-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-30-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Discover BICEPS Content [DEV-30]== +==Discover BICEPS Content [DEV-30]== consumer -> provider: GetMdib() consumer <<-- provider: GetMdibResponse(MdDescription, MdState [incl. ContextStates]) diff --git a/asciidoc/plantuml/vol2-figure-dev-34-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-34-sequence.puml index b8fca0c..f8b54ec 100644 --- a/asciidoc/plantuml/vol2-figure-dev-34-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-34-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Announce Network Departure [DEV-34]== +==Announce Network Departure [DEV-34]== ||| group unsecured provider ->> consumer: Bye(Provider UID) diff --git a/asciidoc/plantuml/vol2-figure-dev-35-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-35-sequence.puml index cec855d..145a50e 100644 --- a/asciidoc/plantuml/vol2-figure-dev-35-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-35-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Establish Medical Data Exchange [DEV-35]== +==Establish Medical Data Exchange [DEV-35]== consumer -> provider: Subscribe(Filter, Expiration Time) consumer <<-- provider: SubscribeResponse(Subscription Manager, Expiration Time) diff --git a/asciidoc/plantuml/vol2-figure-dev-36-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-36-sequence.puml index af459c9..b3f88ec 100644 --- a/asciidoc/plantuml/vol2-figure-dev-36-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-36-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Publish Medical Data [DEV-36]== +==Publish Medical Data [DEV-36]== consumer <<- provider: Notification(EpisodicMetricReport) diff --git a/asciidoc/plantuml/vol2-figure-dev-37-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-37-sequence.puml index 8ffe1a7..1c83558 100644 --- a/asciidoc/plantuml/vol2-figure-dev-37-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-37-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Retrieve Medical Data [DEV-37]== +==Retrieve Medical Data [DEV-37]== consumer -> provider: GetMdib() consumer <<-- provider: GetMdibResponse(MdDescription, MdState [incl. ContextStates]) diff --git a/asciidoc/plantuml/vol2-figure-dev-38-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-38-sequence.puml index b3129fd..8fd1d59 100644 --- a/asciidoc/plantuml/vol2-figure-dev-38-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-38-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Establish Medical Alert Exchange [DEV-38]== +==Establish Medical Alert Exchange [DEV-38]== consumer -> provider: Subscribe(Filter, Expiration Time) consumer <<-- provider: SubscribeResponse(Subscription Manager, Expiration Time) diff --git a/asciidoc/plantuml/vol2-figure-dev-39-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-39-sequence.puml index 1a2e839..c964043 100644 --- a/asciidoc/plantuml/vol2-figure-dev-39-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-39-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Publish Medical Alert Update [DEV-39]== +==Publish Medical Alert Update [DEV-39]== consumer <<- provider: Notification(EpisodicAlertReport) diff --git a/asciidoc/plantuml/vol2-figure-dev-40-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-40-sequence.puml index 90dcbf5..72d749e 100644 --- a/asciidoc/plantuml/vol2-figure-dev-40-sequence.puml +++ b/asciidoc/plantuml/vol2-figure-dev-40-sequence.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml autonumber !global $str_somds_consumer = "SOMDS Consumer" @@ -9,7 +9,7 @@ autonumber participant "$str_somds_consumer" as consumer participant "$str_somds_provider" as provider -==SDPi Medical Alert Status [DEV-40]== +==Medical Alert Status [DEV-40]== consumer -> provider: GetMdib() consumer <<-- provider: GetMdibResponse(MdDescription, MdState [incl. ContextStates]) diff --git a/asciidoc/plantuml/vol2-figure-dev-46-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-46-sequence.puml new file mode 100644 index 0000000..925389a --- /dev/null +++ b/asciidoc/plantuml/vol2-figure-dev-46-sequence.puml @@ -0,0 +1,19 @@ +@startuml + +!include plantuml/common_style.inc.puml +autonumber + + +!global $str_somds_provider = "SOMDS Provider" +!global $str_somds_discovery_proxy = "Discovery Proxy" + +participant "$str_somds_provider" as provider +participant "$str_somds_discovery_proxy" as discovery_proxy + +==Update Network Presence [DEV-46]== + +discovery_proxy <- provider: Hello(Provider UID, Discovery Scope) + +discovery_proxy <- provider: Bye(Provider UID) + +@enduml \ No newline at end of file diff --git a/asciidoc/plantuml/vol2-figure-dev-47-sequence.puml b/asciidoc/plantuml/vol2-figure-dev-47-sequence.puml new file mode 100644 index 0000000..3b3ce2c --- /dev/null +++ b/asciidoc/plantuml/vol2-figure-dev-47-sequence.puml @@ -0,0 +1,28 @@ +@startuml + +!include plantuml/common_style.inc.puml +autonumber + + +!global $str_somds_consumer = "SOMDS Consumer" +!global $str_somds_discovery_proxy = "Discovery Proxy" + +participant "$str_somds_consumer" as consumer +participant "$str_somds_discovery_proxy" as discovery_proxy + +==Retrieve Network Presence [DEV-47]== + +opt + discovery_proxy -> consumer: Hello(Provider UID, Discovery Scope) + discovery_proxy -> consumer: Bye(Provider UID) +end + +alt + consumer ->> discovery_proxy: Probe(Discovery Scope) + consumer <<-- discovery_proxy: ProbeMatch(Provider UID, Transport Address) +else + consumer ->> discovery_proxy: Resolve(Provider UID) + consumer <<-- discovery_proxy: ResolveMatch(Transport Address) +end + +@enduml \ No newline at end of file diff --git a/asciidoc/plantuml/vol2-figure-xyz.puml b/asciidoc/plantuml/vol2-figure-xyz.puml index e0bd7e9..624eefe 100644 --- a/asciidoc/plantuml/vol2-figure-xyz.puml +++ b/asciidoc/plantuml/vol2-figure-xyz.puml @@ -1,5 +1,5 @@ -skinparam dpi 300 -skinparam monochrome true +@startuml +!include plantuml/common_style.inc.puml autonumber !global $str_sdpi_p_somds_cons = "SOMDS Consumer" @@ -9,9 +9,8 @@ participant "$str_sdpi_p_somds_cons" as sdpi_somds_consumer participant "$str_sdpi_p_somds_prov" as sdpi_somds_provider ==SDPi Announce Network Presence [DEV-23]== -||| group unsecured ' sdpi_somds_provider -> sdpi_somds_consumer: SDC: Hello(EndpointReference, Types, Scopes, [XAddrs]) sdpi_somds_provider -> sdpi_somds_consumer: BICEPS: AnnounceNetworkPresence( PROVIDER UID, Discovery Type, ...) end -||| \ No newline at end of file +@enduml \ No newline at end of file diff --git a/asciidoc/plantuml/vol3-figure-biceps-content-module-physiomon.puml b/asciidoc/plantuml/vol3-figure-biceps-content-module-physiomon.puml index 2d8d9c6..274f534 100644 --- a/asciidoc/plantuml/vol3-figure-biceps-content-module-physiomon.puml +++ b/asciidoc/plantuml/vol3-figure-biceps-content-module-physiomon.puml @@ -1,6 +1,6 @@ @startuml -skinparam monochrome true +!include plantuml/common_style.inc.puml object Monitor_Mds Monitor_Mds : MDC_DEV_METER_PHYSIO_MULTI_PARAM_MDS diff --git a/asciidoc/sdpi-supplement-intro.adoc b/asciidoc/sdpi-supplement-intro.adoc index adbfd4e..39ab5aa 100644 --- a/asciidoc/sdpi-supplement-intro.adoc +++ b/asciidoc/sdpi-supplement-intro.adoc @@ -62,8 +62,6 @@ To that end, the supplement includes updates to all (3) IHE DEV TF volumes, incl * New content covering the application of ISO/IEEE 11073 SDC semantic standards to device content modules, with a primary focus on specifications related to the ISO/IEEE 11073-10207 BICEPS standard. -{empty} + - [#supplement_clause_joint_ihe_hl7_gemini_ses_mdi_project_development] === Joint IHE-HL7 Gemini SES+MDI Project Development This supplement is the result of a joint https://confluence.hl7.org/x/Xzf9Aw[IHE-HL7 Gemini Device Interoperability program] which began early 2020. diff --git a/asciidoc/sdpi-supplement.adoc b/asciidoc/sdpi-supplement.adoc index 70cbcbd..b85efab 100644 --- a/asciidoc/sdpi-supplement.adoc +++ b/asciidoc/sdpi-supplement.adoc @@ -81,9 +81,6 @@ See https://profiles.ihe.net/DEV/[*HERE*] for STU/Trial Implementation and Final A PDF version of the specification is available upon request. -{empty} + - - [#supplement_clause_foreword,sdpi_offset=clear] = Foreword diff --git a/asciidoc/volume0/tf0-ch-a-actors.adoc b/asciidoc/volume0/tf0-ch-a-actors.adoc index 6371474..d21cc7c 100644 --- a/asciidoc/volume0/tf0-ch-a-actors.adoc +++ b/asciidoc/volume0/tf0-ch-a-actors.adoc @@ -39,7 +39,11 @@ |[[actor_somds_dec_gateway,SOMDS DEC Gateway]] SOMDS DEC Gateway -|Exchanges information between SOMDS and IHE DEC-based environments. +|Exchanges information between <> and IHE DEC-based environments. + +|[[actor_somds_discovery_proxy,Discovery Proxy]] Discovery Proxy + +|Accepts and makes available <> endpoint metadata in a <>. |[[actor_somds_fhir_gateway,SOMDS FHIR Gateway]] SOMDS FHIR Gateway diff --git a/asciidoc/volume0/tf0-ch-b-transactions.adoc b/asciidoc/volume0/tf0-ch-b-transactions.adoc index 364b4c6..240ecef 100644 --- a/asciidoc/volume0/tf0-ch-b-transactions.adoc +++ b/asciidoc/volume0/tf0-ch-b-transactions.adoc @@ -153,8 +153,18 @@ include::../volume2/dev-40/tf2-dev-40-summary.adoc[] // include::../volume2/dev-45/tf2-dev-45-summary.adoc[] -.^| DEV-46 | _Reserved_ | -.^| DEV-47 | _Reserved_ | +.^| [[vol0_transaction_summary_dev_46,DEV-46 Update Network Presence]] +[[transaction_number_dev_46,DEV-46]] DEV-46 +| [[transaction_name_update_network_presence,Update Network Presence]] Update Network Presence +| +include::../volume2/dev-46/tf2-dev-46-summary.adoc[] + +.^| [[vol0_transaction_summary_dev_47,DEV-47 Retrieve Network Presence]] +[[transaction_number_dev_47,DEV-47]] DEV-47 +| [[transaction_name_retrieve_network_presence,Retrieve Network Presence]] Retrieve Network Presence +| +include::../volume2/dev-47/tf2-dev-47-summary.adoc[] + .^| DEV-48 | _Reserved_ | .^| DEV-49 | _Reserved_ | .^| DEV-50 | _Reserved_ | diff --git a/asciidoc/volume0/tf0-main.adoc b/asciidoc/volume0/tf0-main.adoc index fbc78c7..76b0cbc 100644 --- a/asciidoc/volume0/tf0-main.adoc +++ b/asciidoc/volume0/tf0-main.adoc @@ -42,7 +42,11 @@ The choice of any namespace prefix is arbitrary and not semantically significant |sdpi |urn:oid:1.3.6.1.4.1.19376.1.6.2.10.1.1.1 -|This specification +|This specification, used by <> extensions. + +|dp +|urn:oid:1.3.6.1.4.1.19376.1.6.2.10.1.2.2 +|This specification, used by the <> actor. |wsa |http://www.w3.org/2005/08/addressing diff --git a/asciidoc/volume1/tf1-ch-10-sdpi-p.adoc b/asciidoc/volume1/tf1-ch-10-sdpi-p.adoc index ed4ea02..bbb277a 100644 --- a/asciidoc/volume1/tf1-ch-10-sdpi-p.adoc +++ b/asciidoc/volume1/tf1-ch-10-sdpi-p.adoc @@ -52,8 +52,6 @@ image::../images/vol1-diagram-sdpi-p-actor.svg[] To claim conformity with this specification, an actor shall support all required transactions (labeled “R”) and may support the optional transactions (labeled “O”). Note that “Consumer” is indicated for actors that receive but do not directly respond to a specific transaction. -{empty} + - [#vol1_table_sdpi_p_actors_transactions] .SDPi-P Profile - Actors and Transactions [%autowidth] @@ -71,7 +69,7 @@ Note that “Consumer” is indicated for actors that receive but do not directl | ... | ... -.12+| <> +.13+| <> .^| <> .^| Initiator .^| R @@ -139,9 +137,14 @@ Note that “Consumer” is indicated for actors that receive but do not directl | R | <> -.12+| <> +.^| <> +.^| Initiator +.^| O ^(See^ ^Note^ ^2)^ +| <> + +.13+| <> .^| <> -.^| _Receiver_ ^(See^ ^Note^ ^2)^ +.^| _Receiver_ ^(See^ ^Note^ ^3)^ .^| O | <> @@ -168,12 +171,12 @@ Note that “Consumer” is indicated for actors that receive but do not directl | <> | <> -| _Receiver_ ^(See^ ^Note^ ^2)^ +| _Receiver_ ^(See^ ^Note^ ^3)^ | O | <> | <> -| _Receiver_ ^(See^ ^Note^ ^2)^ +| _Receiver_ ^(See^ ^Note^ ^3)^ | R | <> @@ -204,14 +207,32 @@ Note that “Consumer” is indicated for actors that receive but do not directl | <> -| _Receiver_ ^(See^ ^Note^ ^2)^ +| _Receiver_ ^(See^ ^Note^ ^3)^ | O | <> +| <> +| Initiator +| O ^(See^ ^Note^ ^2)^ +| <> + + +.2+| <> +.^| <> +.^| _Receiver_ ^(See^ ^Note^ ^2)^ +.^| R +| <> + +| <> +| Responder +| R +| <> + + // FOR THE NEXT ROW: // #TODO: TBD HOW TO REPLICATE TRANSACTIONS; ACTOR SUPPORTS ALL PROVIDER & CONSUMER TRANSACTIONS WITH SAME OPTIONALITY# | <> -| See Note 3 +| See Note 4 | ... | ... | ... @@ -225,7 +246,7 @@ Note that “Consumer” is indicated for actors that receive but do not directl // FOR THE NEXT ROW: // #TODO: TBD HOW TO REPLICATE TRANSACTIONS# | <> -| See Note 3 +| See Note 4 | ... | ... | ... @@ -243,16 +264,15 @@ Note that “Consumer” is indicated for actors that receive but do not directl | ... 5+<| -Note 1: _“Notify Change in System Context and Capabilities”_ is required if there are dynamic changes that may need to be sent to subscribing systems. +Note 1: _“Notify Change in System Context and Capabilities”_ is required if there are dynamic changes that may need to be sent to subscribing systems -Note 2: _“Receiver”_ is included in this column, in _italics_, to indicate that though a <> may "receive" the transaction, there is no response communicated to the message initiator. +Note 2: Optional transaction is required if the SDPi-P <> is enabled. Some deployments may support a mix of systems that use the <> Actor as well as the default "ad hoc" discovery mode. Additional details and requirements are provided in the <> discussion. -Note 3: *_SDPi Version Note:_* -- Full detailing of the transactions related to this actor will be addressed in a subsequent version of this specification. +Note 3: _“Receiver”_ is included in this column, in _italics_, to indicate that though a <> may "receive" the transaction, there is no response communicated to the message initiator. -|=== +Note 4: *_SDPi Version Note:_* -- Full detailing of the transactions related to this actor will be addressed in a subsequent version of this specification. -{empty} + -{empty} + +|=== <> shows the content-related actors defined in the SDPi-P Profile and the direction that the content is exchanged. @@ -265,8 +285,6 @@ Note that in the case of external control, where a <> or in <>. -{empty} + - [#vol1_figure_sdpi_p_biceps_content_actor_diagram] .SDPi-P BICEPS Content Actor Diagram @@ -349,11 +367,11 @@ Note 1: _All content exchanged on a SOMDS shall conform to the general SDPi “B |=== - ==== Actor Descriptions and Actor Profile Requirements + SDPi-P actor roles and responsibilities are described in the subsections below. -Unless otherwise specified below, individual transaction requirements are specified in TF-2 <>, and requirements related to content modules are detailed in TF-3 <>. +Unless otherwise specified below, individual transaction requirements are specified in TF-2 <>, and requirements related to content modules are detailed in TF-3 <>. This section documents any additional requirements on the profile’s content actors. <> illustrates a typical (not comprehensive) exchange scenario between SDPi-P actors: @@ -559,15 +577,23 @@ For robustness, a <> need only process the conten Note that although this SDPi-P content actor primarily supports information exchange between systems participating in a SOMDS network environment, they may be referenced by other non-SDPi profiles that utilize other non-SOMDS exchange architectures, transactions and technologies. +===== Discovery Proxy + +[#vol1_spec_sdpi_p_actor_discovery_proxy, reftext='Discovery Proxy'] +Actor Summary Definition: +[none] +. A centralized registry of system network presence and absence metadata. + +The <> Actor provides a centralized means for systems connected to a network to update a central registry when they are present and available, as well as notification when they are leaving and will be absent. +This is necessary for network configurations that do not support decentralized system discovery. + + [#vol1_clause_sdpi_p_actor_options] === SDPi-P Actor Options -[%noheader] -[%autowidth] -[cols="1"] -|=== -a| *{supplement_note}*: Profile options are out-of-scope for this version of the supplement. -Future versions *_MAY_* include options such as the following (not in priority order): +//// +TODO +Future versions *_MAY_* include options such as * Retrieve Remote Data * Streaming / Waveforms @@ -580,6 +606,102 @@ Future versions *_MAY_* include options such as the following (not in priority o * Mobile Health / Cloud Connected |=== +//// + +Options that may be selected for this Integration Profile are listed in the <> along with the actors to which they apply. +Dependencies between options when applicable are specified in +notes. + +[#vol1_table_sdpi_p_actors_transactions] +.SDPi-P Profile - Actors and Options +[%autowidth] +[cols="1,1,1"] +|=== +.^|Actor +.^|Option Name +.^|Vol. & Section + +| <> +| <> +| <> + +| <> +| <> +| <> + +| <> +| <> +| <> + +|=== + +[#vol1_clause_sdpi_p_option_discovery_proxy] +==== Managed Discovery Option +[#vol1_spec_sdpi_p_option_discovery_proxy, reftext='Managed Discovery Option'] + +The Discovery Proxy profile option provides an alternative means for <> Actors to discover the <> Actors that are present on the network. The default "ad hoc" approach using the <>, <> and <> transactions, requires use of unsecured multicast messaging; however, some deployments do not support or allow this mode of discovery. +The addition of a <> Actor enables a secure and non-multicast means for managing system discovery across the network. +The <> Actor acts as a man-in-the-middle system, with <> Actors using the <> transaction to provide endpoint metatdata and update their network presence or absence status. +<> Actors may then use the <> transaction to determine available <> systems and their endpoint metadata. + +<> provides an overview of the interactions of the SOMDS Consumer and Somes Provider Actors with the Discovery Proxy Actor. + +.SDPi-P Managed Discovery Option - transaction Sequence Diagram +[#figure_sdpi-p-managed-discovery-option-sequence-diagram] +[plantuml, target=target=puml-sdpi-p-managed-discovery-option-sequence-diagram, format=svg, format=svg] +.... +include::../plantuml/vol1-figure-sdpi-p-managed-discovery-option-sequence-diagram.puml[] +.... + +Once the discovery process is complete, actor interactions continue as normal. +See <> for additional detail. + +.R1021 +[sdpi_requirement#r1021,sdpi_req_level=shall] +**** + +When the <> is enabled for a <> Actor, then it shall use the <> transaction to update the <> Actor on its network presence and departure. +**** + +.R1022 +[sdpi_requirement#r1022,sdpi_req_level=shall] +**** + +If a <> Actor is configured or provisioned for the <>, but the proxy system is not available, then the <> shall revert back to "ad hoc" discovery mode. +**** + +.R1023 +[sdpi_requirement#r1023,sdpi_req_level=shall] +**** + +When the <> is enabled for a <> Actor, then it shall use the <> transaction to retrieve <> network presence metadata from the <> Actor. + +NOTE: When retrieving network presence metadata from a <> Actor, a <> may be specified as a filter to identify a specific subset of <> systems. + +NOTE: A <> may optionally use the <> transaction to subscribe to all metadata updates from a set of <> systems, essentially using the <> Actor as a pass through for <> <> and <> transactions. +**** + +.R1024 +[sdpi_requirement#r1024,sdpi_req_level=shall] +**** + +If a <> Actor is configured or provisioned for the <>, but the proxy system is not available, then the <> shall revert back to "ad hoc" discovery mode. +**** + +.R1025 +[sdpi_requirement#r1025,sdpi_req_level=shall] +**** + +In order to ensure that a system's network presence information is up-to-date and valid, during the period when the <> indicates that a system is present, it shall provide some means to determine that this state is still true. + +NOTE: For example, issuing a periodic "heartbeat" check message or cable-connected check. +Specification of these means will be provided for in the transport-specific implementation specification for the <> transaction. +**** + +Though it is not recommended, deployments may allow simultaneous use of both the default "ad hoc" discovery mode and the managed proxy-based discovery mode utilizing a <> Actor. +In these configurations, <> and <> systems should prioritize use of the <> Actor. + +NOTE: Provisioning of <> systems to support use of a <> Actor is out-of-scope for this specification. //// #TODO: Add description and detail specification in a subsequent SDPi Version# @@ -618,7 +740,6 @@ Future versions *_MAY_* include options such as the following (not in priority o [#vol1_clause_sdpi_p_required_actor_groupings] === SDPi-P Required Actor Groupings - [%noheader] [%autowidth] [cols="1"] diff --git a/asciidoc/volume1/tf1-ch-11-sdpi-r.adoc b/asciidoc/volume1/tf1-ch-11-sdpi-r.adoc index 99b734f..af658cd 100644 --- a/asciidoc/volume1/tf1-ch-11-sdpi-r.adoc +++ b/asciidoc/volume1/tf1-ch-11-sdpi-r.adoc @@ -47,8 +47,6 @@ actor groupings, including abstract with concrete, are detailed in <> and <> as well as the increasing prevalence of <> applications. (See https://confluence.hl7.org/x/Iw7xB["Paper: What is a device?"] for additional background.) These general concepts will help the technical framework reader understand the broader context into which the profile specifications are intended to be implemented. - -{empty} + |=== // 2.2 diff --git a/asciidoc/volume1/use-cases/tf1-ch-c-60601-1-8.adoc b/asciidoc/volume1/use-cases/tf1-ch-c-60601-1-8.adoc index 2b31f44..82c70d4 100644 --- a/asciidoc/volume1/use-cases/tf1-ch-c-60601-1-8.adoc +++ b/asciidoc/volume1/use-cases/tf1-ch-c-60601-1-8.adoc @@ -149,7 +149,6 @@ NOTE: An xDIS can be either a DIS or CDIS. Similarly an xDAS can be either a DA ^3^ Not recommended since there is no confirmation that the Source has received the commands |=== -{empty} + ===== ISO/IEC 60601-1-8 Definitions for DIS, DAS and CDAS @@ -181,10 +180,7 @@ NOTE: NOTE 2 A DISTRIBUTED ALARM SYSTEM is intended to notify OPERATORS of the e NOTE: NOTE 3 For the purposes of this document, technical confirmation means that each element of a DISTRIBUTED ALARM SYSTEM confirms or guarantees the successful delivery of the ALARM CONDITION to the next element or appropriate TECHNICAL ALARM CONDITIONS are created as described in clause 6.11.2.2.1 of <>. -{empty} + - .IEC 60601-1-8:2020, Figure 2 -- Functions of a DISTRIBUTED ALARM SYSTEM utilizing a MEDICAL IT NETWORK - image::../images/vol1-diagram-60601-1-8-2020-figure-2.svg[] Examples include: diff --git a/asciidoc/volume2/dev-23/tf2-dev-23.adoc b/asciidoc/volume2/dev-23/tf2-dev-23.adoc index 5d7ecb2..78bcac3 100644 --- a/asciidoc/volume2/dev-23/tf2-dev-23.adoc +++ b/asciidoc/volume2/dev-23/tf2-dev-23.adoc @@ -36,7 +36,7 @@ include::tf2-dev-23-summary.adoc[] ==== Messages .Message Interaction Diagram [{var_transaction_id}] -[plantuml#vol2_figure_dev_23_sequence, target=puml-dev-23-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_23_sequence, target=puml-dev-23-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-23-sequence.puml[] .... diff --git a/asciidoc/volume2/dev-24/tf2-ch-a-mdpws-dev-24.adoc b/asciidoc/volume2/dev-24/tf2-ch-a-mdpws-dev-24.adoc index 648e2bf..4a46847 100644 --- a/asciidoc/volume2/dev-24/tf2-ch-a-mdpws-dev-24.adoc +++ b/asciidoc/volume2/dev-24/tf2-ch-a-mdpws-dev-24.adoc @@ -46,6 +46,7 @@ include::../dev-a-default-trigger-events.adoc[] :var_expected_actions_ref: <> include::../dev-a-default-expected-actions.adoc[] +[#vol2_clause_appendix_mdpws_dev_24_additional_consideration] ====== Additional Consideration [sdpi_level=+1] diff --git a/asciidoc/volume2/dev-24/tf2-dev-24.adoc b/asciidoc/volume2/dev-24/tf2-dev-24.adoc index dab9ded..1186f43 100644 --- a/asciidoc/volume2/dev-24/tf2-dev-24.adoc +++ b/asciidoc/volume2/dev-24/tf2-dev-24.adoc @@ -38,7 +38,7 @@ include::tf2-dev-24-summary.adoc[] ==== Messages .Message Interaction Diagram [{var_transaction_id}] -[plantuml#vol2_figure_dev_24_sequence, target=puml-dev-24-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_24_sequence, target=puml-dev-24-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-24-sequence.puml[] .... diff --git a/asciidoc/volume2/dev-25/tf2-dev-25.adoc b/asciidoc/volume2/dev-25/tf2-dev-25.adoc index d3da493..5c34c73 100644 --- a/asciidoc/volume2/dev-25/tf2-dev-25.adoc +++ b/asciidoc/volume2/dev-25/tf2-dev-25.adoc @@ -29,7 +29,7 @@ include::tf2-dev-25-summary.adoc[] ==== Messages .Message Interaction Diagram [DEV-25] -[plantuml#vol2_figure_dev_25_sequence, target=puml-dev-25-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_25_sequence, target=puml-dev-25-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-25-sequence.puml[] diff --git a/asciidoc/volume2/dev-27/tf2-dev-27.adoc b/asciidoc/volume2/dev-27/tf2-dev-27.adoc index f848725..d1fd072 100644 --- a/asciidoc/volume2/dev-27/tf2-dev-27.adoc +++ b/asciidoc/volume2/dev-27/tf2-dev-27.adoc @@ -48,7 +48,7 @@ When at some point the subscription has to be ended, the <> diff --git a/asciidoc/volume2/dev-34/tf2-dev-34.adoc b/asciidoc/volume2/dev-34/tf2-dev-34.adoc index addd9a5..4dc617a 100644 --- a/asciidoc/volume2/dev-34/tf2-dev-34.adoc +++ b/asciidoc/volume2/dev-34/tf2-dev-34.adoc @@ -33,7 +33,7 @@ include::tf2-dev-34-summary.adoc[] ==== Messages .Message Interaction Diagram [{var_transaction_id}] -[plantuml#vol2_figure_dev_34_sequence, target=puml-dev-34-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_34_sequence, target=puml-dev-34-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-34-sequence.puml[] .... diff --git a/asciidoc/volume2/dev-35/tf2-dev-35.adoc b/asciidoc/volume2/dev-35/tf2-dev-35.adoc index c25886f..3241b17 100644 --- a/asciidoc/volume2/dev-35/tf2-dev-35.adoc +++ b/asciidoc/volume2/dev-35/tf2-dev-35.adoc @@ -35,7 +35,7 @@ include::tf2-dev-35-summary.adoc[] ==== Messages .Message Interaction Diagram [{var_transaction_id}] -[plantuml#vol2_figure_dev_35_sequence, target=puml-dev-35-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_35_sequence, target=puml-dev-35-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-35-sequence.puml[] .... diff --git a/asciidoc/volume2/dev-36/tf2-dev-36.adoc b/asciidoc/volume2/dev-36/tf2-dev-36.adoc index 15c9b79..f193238 100644 --- a/asciidoc/volume2/dev-36/tf2-dev-36.adoc +++ b/asciidoc/volume2/dev-36/tf2-dev-36.adoc @@ -31,7 +31,7 @@ include::tf2-dev-36-summary.adoc[] ==== Messages .Message Interaction Diagram [{var_transaction_id}] -[plantuml#vol2_figure_dev_36_sequence, target=puml-dev-36-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_36_sequence, target=puml-dev-36-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-36-sequence.puml[] .... diff --git a/asciidoc/volume2/dev-37/tf2-dev-37.adoc b/asciidoc/volume2/dev-37/tf2-dev-37.adoc index cefb096..3c72a24 100644 --- a/asciidoc/volume2/dev-37/tf2-dev-37.adoc +++ b/asciidoc/volume2/dev-37/tf2-dev-37.adoc @@ -32,7 +32,7 @@ include::tf2-dev-37-summary.adoc[] ==== Messages .Message Interaction Diagram [{var_transaction_id}] -[plantuml#vol2_figure_dev_37_sequence, target=puml-dev-37-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_37_sequence, target=puml-dev-37-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-37-sequence.puml[] .... diff --git a/asciidoc/volume2/dev-38/tf2-dev-38.adoc b/asciidoc/volume2/dev-38/tf2-dev-38.adoc index f932a28..8fab695 100644 --- a/asciidoc/volume2/dev-38/tf2-dev-38.adoc +++ b/asciidoc/volume2/dev-38/tf2-dev-38.adoc @@ -34,7 +34,7 @@ include::tf2-dev-38-summary.adoc[] ==== Messages .Message Interaction Diagram [{var_transaction_id}] -[plantuml#vol2_figure_dev_38_sequence, target=puml-dev-38-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_38_sequence, target=puml-dev-38-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-38-sequence.puml[] .... diff --git a/asciidoc/volume2/dev-39/tf2-dev-39.adoc b/asciidoc/volume2/dev-39/tf2-dev-39.adoc index 44228cc..483e40a 100644 --- a/asciidoc/volume2/dev-39/tf2-dev-39.adoc +++ b/asciidoc/volume2/dev-39/tf2-dev-39.adoc @@ -31,7 +31,7 @@ include::tf2-dev-39-summary.adoc[] ==== Messages .Message Interaction Diagram [{var_transaction_id}] -[plantuml#vol2_figure_dev_39_sequence, target=puml-dev-39-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_39_sequence, target=puml-dev-39-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-39-sequence.puml[] .... diff --git a/asciidoc/volume2/dev-40/tf2-dev-40.adoc b/asciidoc/volume2/dev-40/tf2-dev-40.adoc index ee33213..5e7fa15 100644 --- a/asciidoc/volume2/dev-40/tf2-dev-40.adoc +++ b/asciidoc/volume2/dev-40/tf2-dev-40.adoc @@ -33,7 +33,7 @@ include::tf2-dev-40-summary.adoc[] ==== Messages .Message Interaction Diagram [{var_transaction_id}] -[plantuml#vol2_figure_dev_40_sequence, target=puml-dev-40-sequence, format=svg, 40width=100%] +[plantuml#vol2_figure_dev_40_sequence, target=puml-dev-40-sequence, format=svg] .... include::../../plantuml/vol2-figure-dev-40-sequence.puml[] .... diff --git a/asciidoc/volume2/dev-46/tf2-ch-a-mdpws-dev-46.adoc b/asciidoc/volume2/dev-46/tf2-ch-a-mdpws-dev-46.adoc new file mode 100644 index 0000000..20bf928 --- /dev/null +++ b/asciidoc/volume2/dev-46/tf2-ch-a-mdpws-dev-46.adoc @@ -0,0 +1,121 @@ +:var_label_dev_46_message_hello: Hello +:var_label_dev_46_message_bye: Bye +:var_label_dev_46_message_directed_probe: DirectedProbe +:var_uri_dpws_messaging: http://docs.oasis-open.org/ws-dd/dpws/1.1/os/wsdd-dpws-1.1-spec-os.html#_Toc228672084 +:var_uri_dpws_discovery: https://docs.oasis-open.org/ws-dd/dpws/1.1/os/wsdd-dpws-1.1-spec-os.html#_Toc228672091 +:var_uri_ws_discovery_hello: https://docs.oasis-open.org/ws-dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html#_Toc234231821 +:var_uri_ws_discovery_bye: https://docs.oasis-open.org/ws-dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html#_Toc234231825 +:var_uri_ws_discovery_directed_probe: https://docs.oasis-open.org/ws-dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html#_Toc234231831 + +[#vol2_clause_appendix_mdpws_dev_46] +==== MDPWS: Update Network Presence [DEV-46] + +This section specifies the MDPWS data transmission for messages defined in <>. + +Additional implementation directions are defined in <>. + +// ---------- Hello --------- + +===== {var_label_dev_46_message_hello} Message + +The <> message is encoded by using {var_uri_dpws_messaging}[DPWS Messaging]. + +====== Referenced Standards + +* <> {var_uri_dpws_messaging}[Section 2 Messaging] +* <> {var_uri_ws_discovery_hello}[Section 4.1 Hello] + +====== Message Outline + +.{var_label_dev_46_message_hello} message +[source#vol2_clause_appendix_a_mdpws_dev_46_hello,xml] +---- +include::../../listings/vol2-clause-appendix-a-mdpws-dev-46-hello.xml[] +---- + +:var_trigger_events_ref: <> +include::../dev-a-default-trigger-events.adoc[] + +====== Message Semantics + +`s12:Envelope/s12:Body/wsd:Hello/wsa:EndpointReference/wsa:Address`:: The <>'s <> as URI. +`s12:Envelope/s12:Body/wsd:Hello/wsd:Scopes`:: The <>'s <> as a list of URIs. + +:var_expected_actions_ref: <> +include::../dev-a-default-expected-actions.adoc[] + + +// ---------- Bye --------- + +===== {var_label_dev_46_message_bye} Message + +The <> message is encoded by using {var_uri_dpws_messaging}[DPWS Messaging]. + +====== Referenced Standards + +* <> {var_uri_dpws_messaging}[Section 2 Messaging] +* <> {var_uri_ws_discovery_bye}[Section 4.2 Bye] + +====== Message Outline + +.{var_label_dev_46_message_bye} message +[source#vol2_clause_appendix_a_mdpws_dev_46_bye,xml] +---- +include::../../listings/vol2-clause-appendix-a-mdpws-dev-46-bye.xml[] +---- + +:var_trigger_events_ref: <> +include::../dev-a-default-trigger-events.adoc[] + +====== Message Semantics + +`s12:Envelope/s12:Body/wsd:Bye/wsa:EndpointReference/wsa:Address`:: The <>'s <> as URI. + +:var_expected_actions_ref: <> +include::../dev-a-default-expected-actions.adoc[] + + +// ---------- DirectedProbe --------- + +===== {var_label_dev_46_message_directed_probe} Message + +In addition to {var_label_dev_46_message_hello} and {var_label_dev_46_message_bye}, this section proposes a <> to periodically probe all <>s it has recorded as present in the <> by using a {var_label_dev_46_message_directed_probe} message. This allows for the <> to verify if <>s reachable. + +The {var_label_dev_46_message_directed_probe} message is encoded by using {var_uri_dpws_messaging}[DPWS Messaging]. + +====== Referenced Standards + +* <> {var_uri_dpws_messaging}[Section 2 Messaging] +* <> {var_uri_dpws_messaging}[Section 3 Discovery] +* <> {var_uri_ws_discovery_directed_probe}[Section 5.2 Probe] + +====== Message Outline + +.{var_label_dev_46_message_directed_probe} message +[source#vol2_clause_appendix_a_mdpws_dev_46_directed_probe,xml] +---- +include::../../listings/vol2-clause-appendix-a-mdpws-dev-46-directed-probe.xml[] +---- + +====== Trigger Events + +A <> may periodically send {var_label_dev_46_message_directed_probe} messages to all present <>s. +The periodicity can be determined by the <>. + +====== Message Semantics + +No payload is required as the probe is intended to be used for watchdog purposes only. + +====== Expected Actions + +If the request succeeds, there is no additional action required. + +If the request fails, the <> removes the <> endpoint metadata from its databases and informs <>s about the <>'s absence. + +.R7006 +[sdpi_requirement#r7006,sdpi_req_level=shall] +**** +If <> sends {var_label_dev_46_message_directed_probe} messages to verify presence of <>s, the <> shall notify all <>s subscribed to Bye messages about the <>'s absence. + +NOTE: Absence of <>s is notified to <>s by using the Bye message as specified in <>. +**** \ No newline at end of file diff --git a/asciidoc/volume2/dev-46/tf2-dev-46-summary.adoc b/asciidoc/volume2/dev-46/tf2-dev-46-summary.adoc new file mode 100644 index 0000000..36ba4b3 --- /dev/null +++ b/asciidoc/volume2/dev-46/tf2-dev-46-summary.adoc @@ -0,0 +1,3 @@ +// DEV-46 Transaction Summary + +Provide network presence and absence of <> Actors in a <> network by updating the metadata in a <> Actor. diff --git a/asciidoc/volume2/dev-46/tf2-dev-46.adoc b/asciidoc/volume2/dev-46/tf2-dev-46.adoc new file mode 100644 index 0000000..4065240 --- /dev/null +++ b/asciidoc/volume2/dev-46/tf2-dev-46.adoc @@ -0,0 +1,90 @@ +:var_transaction_id: DEV-46 + +:var_label_dev_46_message_hello: Hello +:var_label_dev_46_message_bye: Bye + + +//reset|+1|off +[#vol2_clause_dev_46,sdpi_offset=46] +=== Update Network Presence [{var_transaction_id}] + +==== Scope + +include::tf2-dev-46-summary.adoc[] + +==== Actor Roles + +.Actor Roles [{var_transaction_id}] +[cols="1,2"] +|=== +|Actor |Roles + +|<> +|Listens for <> or <> messages to add or remove <> endpoint metadata to/from its internal database. +|<> +|When joining a <>, it announces its presence to the <>. When deliberately leaving the <>, it announces its absence to the <>. +|=== + +==== Referenced Standards + +* <> Section 9. Discovery Model + +==== Messages + +.Message Interaction Diagram [{var_transaction_id}] +[plantuml#vol2_figure_dev_46_sequence, target=puml-dev-46-sequence, format=svg] +.... +include::../../plantuml/vol2-figure-dev-46-sequence.puml[] +.... + +[#vol2_clause_dev_46_message_hello] +===== {var_label_dev_46_message_hello} Message + +<> specifies an implicit discovery protocol for allowing <>s to receive a notification when a <> is ready to exchange messages with other <>s. +If a <> uses a <>, network presence is announced to the <> by using the _{var_label_dev_46_message_hello}_ message of this transaction. + +[#vol2_clause_dev_46_message_hello_trigger_events] +====== Trigger Events + +If a <> is known to the <>, this message is sent + +1. whenever a <> joins an <>, +2. when a <> returns to normal _on-line_ operation after having indicated temporary suspension of message exchanges, or +3. when a <> changes its <>. + +[#vol2_clause_dev_46_message_hello_semantics] +====== Message Semantics + +[[payload_dev_46_provider_uid_hello]]Provider UID:: The <>. +[[payload_dev_46_discovery_scope]]Discovery Scope:: The <> of the <>. + +[#vol2_clause_dev_46_message_hello_expected_actions] +====== Expected Actions + +When a <> sends this message, there is no expected or required response. +The <> is supposed to internally store the <>'s endpoint <> and <> in order to make it available to <>s via <> (see <>). + +[#vol2_clause_dev_46_message_bye] +===== {var_label_dev_46_message_bye} Message + +If a <> uses a <>, network absence is announced to the <> by using the _{var_label_dev_46_message_bye}_ message of this transaction. + +[#vol2_clause_dev_46_message_bye_trigger_events] +====== Trigger Events + +If a <> is known to the <>, this message is sent whenever a <> leaves the <> it previously joined via the {var_label_dev_46_message_hello} message. + +[#vol2_clause_dev_46_message_bye_semantics] +====== Message Semantics + +[[payload_dev_46_provider_uid_bye]]Provider UID:: The <>. + +[#vol2_clause_dev_46_message_bye_expected_actions] +====== Expected Actions + +When a <> sends this message, there is no expected or required response. +The <> is supposed to remove the <>'s <> and <> from its internal database and exposes the removal to <>s via <> (see <>). + +[#vol2_clause_dev_29_publish_biceps_update_reports_ses] +include::../dev-x-default-ses-secured-mode.adoc[] + diff --git a/asciidoc/volume2/dev-47/tf2-ch-a-mdpws-dev-47.adoc b/asciidoc/volume2/dev-47/tf2-ch-a-mdpws-dev-47.adoc new file mode 100644 index 0000000..b5afa9b --- /dev/null +++ b/asciidoc/volume2/dev-47/tf2-ch-a-mdpws-dev-47.adoc @@ -0,0 +1,222 @@ +:var_uri_ws_discovery_probe: http://docs.oasis-open.org/ws-dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html#_Toc234231831 +:var_uri_ws_discovery_probe_match: http://docs.oasis-open.org/ws-dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html#_Toc234231835 +:var_uri_ws_discovery_resolve: http://docs.oasis-open.org/ws-dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html#_Toc234231840 +:var_uri_ws_discovery_resolve_match: http://docs.oasis-open.org/ws-dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html#_Toc234231844 +:var_uri_dpws_discovery: http://docs.oasis-open.org/ws-dd/dpws/1.1/os/wsdd-dpws-1.1-spec-os.html#_Toc228672091 +:var_uri_matching_rule: http://docs.oasis-open.org/ws-dd/ns/discovery/2009/01/rfc3986 + +[#vol2_clause_appendix_mdpws_dev_47] +==== MDPWS: Retrieve Network Presence [DEV-47] + +This section specifies the MDPWS data transmission for messages defined in <>. + +Additional implementation directions are defined in <>. + +// ---------- Hello --------- + +===== {var_label_dev_47_message_hello} Message + +The <> message is encoded by using {var_uri_dpws_messaging}[DPWS Messaging]. + +====== Referenced Standards + +* <> {var_uri_dpws_messaging}[Section 2 Messaging] +* <> {var_uri_ws_discovery_hello}[Section 4.1 Hello] +* <> {var_uri_ws_discovery_hello}[Section 4.1 Hello] + +====== Message Outline + +.{var_label_dev_47_message_hello} message +[source#vol2_clause_appendix_a_mdpws_dev_47_hello,xml] +---- +include::../../listings/vol2-clause-appendix-a-mdpws-dev-47-hello.xml[] +---- + +:var_trigger_events_ref: <> +include::../dev-a-default-trigger-events.adoc[] + +====== Message Semantics + +`s12:Envelope/s12:Body/wsd:Hello/wsa:EndpointReference/wsa:Address`:: The <>'s <> as URI. +`s12:Envelope/s12:Body/wsd:Hello/wsd:Scopes`:: The <>'s <> as a list of URIs. + +:var_expected_actions_ref: <> +include::../dev-a-default-expected-actions.adoc[] + + +// ---------- Bye --------- + +[#vol2_clause_appendix_a_mdpws_dev_47_message_bye] +===== {var_label_dev_47_message_bye} Message + +The <> message is encoded by using {var_uri_dpws_messaging}[DPWS Messaging]. + +====== Referenced Standards + +* <> {var_uri_dpws_messaging}[Section 2 Messaging] +* <> {var_uri_ws_discovery_bye}[Section 4.2 Bye] + +====== Message Outline + +.{var_label_dev_47_message_bye} message +[source#vol2_clause_appendix_a_mdpws_dev_47_bye,xml] +---- +include::../../listings/vol2-clause-appendix-a-mdpws-dev-47-bye.xml[] +---- + +:var_trigger_events_ref: <> +include::../dev-a-default-trigger-events.adoc[] + +====== Message Semantics + +`s12:Envelope/s12:Body/wsd:Bye/wsa:EndpointReference/wsa:Address`:: The <>'s <> as URI. + +:var_expected_actions_ref: <> +include::../dev-a-default-expected-actions.adoc[] + + +// ---------- PROBE --------- + + +===== {var_label_dev_47_message_probe} Message + +The <> message is encoded by using {var_uri_ws_discovery_probe}[WS-Discovery Probe]. + +====== Referenced Standards + +* <> {var_uri_ws_discovery_probe}[Section 5.2 Probe] +* <> {var_uri_dpws_discovery}[Section 3 Discovery] +* <> mdpws:MedicalDevice +* <> sdc.mds.pkp:1.2.840.10004.20701.1.1 + +====== Message Outline + +.WS-Discovery Probe message +[source#vol2_clause_appendix_a_mdpws_dev_47_probe,xml] +---- +include::../../listings/vol2-clause-appendix-a-mdpws-dev-47-probe.xml[] +---- + +:var_trigger_events_ref: <> +include::../dev-a-default-trigger-events.adoc[] + +====== Message Semantics + +`s12:Envelope/s12:Body/wsd:Probe/wsa:Types`:: List that contains at least `mdpws:MedicalDevice` to express seeking <>s that conform to MDPWS. +`s12:Envelope/s12:Body/wsd:Probe/wsd:Scopes/@MatchBy`:: The algorithm used to compare the `s12:Envelope/s12:Body/wsd:Probe/wsd:Scopes` against the <>'s scopes. +`s12:Envelope/s12:Body/wsd:Probe/wsd:Scopes`:: The <> as a list of URIs to probe for. +[#vol2_clause_appendix_mdpws_dev_47_recurring_probe] + + +:var_expected_actions_ref: <> +include::../dev-a-default-expected-actions.adoc[] + +====== Additional Consideration + +All additional considerations specified in <> do also apply to <>. + + +// ---------- PROBE MATCH --------- + + +===== {var_label_dev_47_message_probe_match} Message + +The <> message is encoded by using {var_uri_ws_discovery_probe_match}[WS-Discovery Probe Match]. + +====== Referenced Standards + +* <> {var_uri_ws_discovery_probe_match}[Section 5.3 Probe Match] +* <> {var_uri_dpws_discovery}[Section 3 Discovery] +* <> mdpws:MedicalDevice +* <> sdc.mds.pkp:1.2.840.10004.20701.1.1 + +====== Message Outline + +.WS-Discovery Probe Match message +[source#vol2_clause_appendix_a_mdpws_dev_47_probe_match,xml] +---- +include::../../listings/vol2-clause-appendix-a-mdpws-dev-47-probe-match.xml[] +---- + +:var_trigger_events_ref: <> +include::../dev-a-default-trigger-events.adoc[] + +====== Message Semantics + +`s12:Envelope/s12:Body/wsd:ProbeMatches`:: All matches found by the <>. +`s12:Envelope/s12:Body/wsd:ProbeMatches/wsd:ProbeMatch/wsa:EndpointReference/wsa:Address`:: The <>'s <> encoded as URI. +`s12:Envelope/s12:Body/wsd:ProbeMatches/wsd:ProbeMatch/wsd:Types`:: List of types that contains at least `dpws:Device` and mdpws:MedicalDevice`, which expresses the <> to conform to DPWS and MDPWS. +`s12:Envelope/s12:Body/wsd:ProbeMatches/wsd:ProbeMatch/wsd:Scopes`:: The <> of the <>, encoded as a list of URIs. +`s12:Envelope/s12:Body/wsd:ProbeMatches/wsd:ProbeMatch/wsd:XAddrs`:: A list of HTTPS addresses under which the <> receives secured messages. +`s12:Envelope/s12:Body/wsd:ProbeMatches/wsd:ProbeMatch/wsd:MetadataVersion`:: A metadata version of the <>. + +:var_expected_actions_ref: <> +include::../dev-a-default-expected-actions.adoc[] + + +// ---------- RESOLVE --------- + + +===== {var_label_dev_47_message_resolve} Message + +The <> message is encoded by using {var_uri_ws_discovery_resolve}[WS-Discovery Resolve]. + +====== Referenced Standards + +* <> {var_uri_ws_discovery_resolve}[Section 6.2 Resolve] +* <> {var_uri_dpws_discovery}[Section 3 Discovery] + +====== Message Outline + +.WS-Discovery Resolve message +[source#vol2_clause_appendix_a_mdpws_dev_47_resolve,xml] +---- +include::../../listings/vol2-clause-appendix-a-mdpws-dev-47-resolve.xml[] +---- + +:var_trigger_events_ref: <> +include::../dev-a-default-trigger-events.adoc[] + +====== Message Semantics + +`s12:Envelope/s12:Body/wsd:Resolve/wsa:EndpointReference/wsa:Address`:: The <> to resolve, encoded as URI. + +:var_expected_actions_ref: <> +include::../dev-a-default-expected-actions.adoc[] + + +// ---------- RESOLVE MATCH --------- + + +===== {var_label_dev_47_message_resolve_match} Message + +The <> message is encoded by using {var_uri_ws_discovery_resolve_match}[WS-Discovery Resolve Match]. + +====== Referenced Standards + +* <> {var_uri_ws_discovery_resolve_match}[Section 6.3 Resolve Match] +* <> {var_uri_dpws_discovery}[Section 3 Discovery] +* <> mdpws:MedicalDevice +* <> sdc.mds.pkp:1.2.840.10004.20701.1.1 + +====== Message Outline + +.WS-Discovery Resolve Match message +[source#vol2_clause_appendix_a_mdpws_dev_47_resolve_match,xml] +---- +include::../../listings/vol2-clause-appendix-a-mdpws-dev-47-resolve-match.xml[] +---- + +:var_trigger_events_ref: <> +include::../dev-a-default-trigger-events.adoc[] + +====== Message Semantics + +`s12:Envelope/s12:Body/wsd:ResolveMatches/wsd:ResolveMatch/wsa:EndpointReference/wsa:Address`:: The <>'s <> encoded as URI. +`s12:Envelope/s12:Body/wsd:ResolveMatches/wsd:ResolveMatch/wsd:Types`:: List of types that contains at least `dpws:Device` and mdpws:MedicalDevice`, which expresses the <> to conform to DPWS and MDPWS. +`s12:Envelope/s12:Body/wsd:ResolveMatches/wsd:ResolveMatch/wsd:Scopes`:: The <> of the <>, encoded as a list of URIs. +`s12:Envelope/s12:Body/wsd:ResolveMatches/wsd:ResolveMatch/wsd:XAddrs`:: A list of HTTPS addresses under which the <> receives secured messages. +`s12:Envelope/s12:Body/wsd:ResolveMatches/wsd:ResolveMatch/wsd:MetadataVersion`:: A metadata version of the <>. + +:var_expected_actions_ref: <> +include::../dev-a-default-expected-actions.adoc[] diff --git a/asciidoc/volume2/dev-47/tf2-dev-47-summary.adoc b/asciidoc/volume2/dev-47/tf2-dev-47-summary.adoc new file mode 100644 index 0000000..ebb8d4f --- /dev/null +++ b/asciidoc/volume2/dev-47/tf2-dev-47-summary.adoc @@ -0,0 +1,3 @@ +// DEV-47 Transaction Summary + +Retrieve presence metadata from a <> Actor for a specified set of <> Actors that may be connected to a <> network. \ No newline at end of file diff --git a/asciidoc/volume2/dev-47/tf2-dev-47.adoc b/asciidoc/volume2/dev-47/tf2-dev-47.adoc new file mode 100644 index 0000000..0cba537 --- /dev/null +++ b/asciidoc/volume2/dev-47/tf2-dev-47.adoc @@ -0,0 +1,205 @@ +:var_transaction_id: DEV-47 + +:var_label_dev_47_message_hello: Hello +:var_label_dev_47_message_bye: Bye +:var_label_dev_47_message_probe: Probe +:var_label_dev_47_message_probe_match: ProbeMatch +:var_label_dev_47_message_resolve: Resolve +:var_label_dev_47_message_resolve_match: ResolveMatch + + +//reset|+1|off +[#vol2_clause_dev_47,sdpi_offset=47] +=== Retrieve Network Presence [{var_transaction_id}] + +==== Scope + +include::tf2-dev-47-summary.adoc[] + +==== Actor Roles + +.Actor Roles [{var_transaction_id}] +[cols="1,2"] +|=== +|Actor |Roles + +|<> +|Forwards <> and <> messages received from <>s. +Responds to incoming <> and <> messages. +|<> +|Uses <> and <> messages to seek endpoint metadata. +Optionally subscribes to a <> in order to receive <> and <> messages. +|=== + +==== Referenced Standards + +* <> Section 9. Discovery Model + +==== Messages + +.Message Interaction Diagram [{var_transaction_id}] +[plantuml#vol2_figure_dev_47_sequence, target=puml-dev-47-sequence, format=svg] +.... +include::../../plantuml/vol2-figure-dev-47-sequence.puml[] +.... + +// ---------- HELLO --------- + +[#vol2_clause_dev_47_message_hello] +===== {var_label_dev_47_message_hello} Message + +<> specifies an implicit discovery protocol for allowing <>s to receive a notification when a <> is ready to exchange messages with other <>s. +If a <> uses a <>, network presence is announced to the <> by using the _{var_label_dev_47_message_hello}_ message of this transaction. + +[#vol2_clause_dev_47_message_hello_trigger_events] +====== Trigger Events + +If a <> is known to the <> and the <> is interested in {var_label_dev_47_message_hello} messages, this message is sent + +1. whenever a <> known to the <> joins an <>, +2. when a <> known to the <> returns to normal _on-line_ operation after having indicated temporary suspension of message exchanges, or +3. when a <> known to the <> changes its <>. + +[#vol2_clause_dev_47_message_hello_semantics] +====== Message Semantics + +[[payload_dev_47_provider_uid_hello]]Provider UID:: The <>. +[[payload_dev_47_discovery_scope]]Discovery Scope:: The <> of the <>. + +[#vol2_clause_dev_47_message_hello_expected_actions] +====== Expected Actions + +When a <> sends this message, there is no expected or required response. + +// ---------- BYE --------- + +[#vol2_clause_dev_47_message_bye] +===== {var_label_dev_47_message_bye} Message + +If a <> uses a <>, network absence is announced to the <> by using the _{var_label_dev_47_message_bye}_ message of this transaction. + +[#vol2_clause_dev_47_message_bye_trigger_events] +====== Trigger Events + +If a <> is known to the <> and the <> is interested in {var_label_dev_47_message_bye} messages, this message is sent whenever a <> leaves the <> it previously joined via the {var_label_dev_46_message_hello} message. + +[#vol2_clause_dev_47_message_bye_semantics] +====== Message Semantics + +[[payload_dev_47_provider_uid_bye]]Provider UID:: The <>. + +[#vol2_clause_dev_47_message_bye_expected_actions] +====== Expected Actions + +When a <> sends this message, there is no expected or required response. + +// ---------- PROBE --------- + +[#vol2_clause_dev_47_message_probe] +===== {var_label_dev_47_message_probe} Message + +<> specifies an explicit discovery protocol for allowing <>s to discover all <>s that are ready to exchange messages with <>s. +The corresponding message to seek <>s based on filter criteria is called _{var_label_dev_47_message_probe}_. + +If a <> uses a <>, the <> can send a {var_label_dev_47_message_probe} message to the <> to seek endpoint information based on filter criteria. + +[#vol2_clause_dev_47_message_probe_trigger_events] +====== Trigger Events + +The {var_label_dev_47_message_probe} message is sent to a <> + +1. whenever a <> joins an <> and is ready to exchange messages with <>s or +2. when a <> runs in a mode where it periodically checks for availability of <>s matching specific filter criteria. + +[#vol2_clause_dev_47_message_probe_semantics] +====== Message Semantics + +[[payload_dev_47_probe_discovery_scope]]Discovery Scope:: A <> to filter against. + +[#vol2_clause_dev_47_message_probe_expected_actions] +====== Expected Actions + +When a <> sends this message, the <> answers with all endpoint records that match the requested <> by sending a <> message. + +// ---------- PROBE MATCH --------- + +[#vol2_clause_dev_47_message_probe_match] +===== {var_label_dev_47_message_probe_match} Message + +The {var_label_dev_47_message_probe_match} message is sent as part of the BICEPS _explicit discovery_ protocol in response to an incoming <> message. + +[#vol2_clause_dev_47_message_probe_match_trigger_events] +====== Trigger Events + +The {var_label_dev_47_message_probe_match} message is sent whenever a <> receives a <> message that contains a <> that matches zero or more <>'s <>s. + +[#vol2_clause_dev_47_message_probe_match_semantics] +====== Message Semantics + +[[payload_dev_47_probe_match_provider_uid]]Provider UID:: The <>. +[[payload_dev_47_probe_match_transport_address]]Transport Address:: The <> under which the <> can receive secured messages. + +[#vol2_clause_dev_47_message_probe_match_expected_actions] +====== Expected Actions + +The <> that receives a {var_label_dev_47_message_probe_match} message can use the <> to exchange secured messages with the <>s for which it received the <> message. + + +// ---------- RESOLVE --------- + + +[#vol2_clause_dev_47_message_resolve] +===== {var_label_dev_47_message_resolve} Message + +<> specifies an explicit discovery protocol for allowing <>s to discover all <>s that are ready to exchange messages with <>s. +The corresponding message to seek <>s based on a unique identifier is called _{var_label_dev_47_message_resolve}_. + +If a specific <> is known to a <>, the <> can send a {var_label_dev_47_message_resolve} message to a <>. + +[#vol2_clause_dev_47_message_resolve_trigger_events] +====== Trigger Events + +The {var_label_dev_47_message_resolve} message is sent to a <> + +1. whenever a <> joins an <> and is ready to exchange messages with a specific <> for which it knows its <> or +2. when a <> runs in a mode where it periodically checks for availability of <>s matching a specific <>. + +[#vol2_clause_dev_47_message_resolve_semantics] +====== Message Semantics + +[[payload_dev_47_resolve_provider_uid]]Provider UID:: The <> to resolve. + +[#vol2_clause_dev_47_message_resolve_expected_actions] +====== Expected Actions + +When a <> sends this message, the <> answers with the endpoint record that matches the requested <>. + +// ---------- RESOLVE MATCH --------- + + +[#vol2_clause_dev_47_message_resolve_match] +===== {var_label_dev_47_message_resolve_match} Message + +The {var_label_dev_47_message_resolve_match} message is sent as part of the BICEPS _explicit discovery_ protocol in response to an incoming <> message. + +[#vol2_clause_dev_47_message_resolve_match_trigger_events] +====== Trigger Events + +The {var_label_dev_47_message_resolve_match} message is sent whenever a <> receives a <> message. + +[#vol2_clause_dev_47_message_resolve_match_semantics] +====== Message Semantics + +[[payload_dev_47_provider_uid]]Provider UID:: The <>. +[[payload_dev_47_transport_address]]Transport Address:: The <> under which the <> can receive secured messages. + +NOTE: A {var_label_dev_47_message_resolve_match} message may not include a <> and <> if there was no match found for <>. + +[#vol2_clause_dev_47_message_resolve_match_expected_actions] +====== Expected Actions + +The <> that receives a {var_label_dev_47_message_resolve_match} message can use the <> to exchange secured messages with the <> for which it received the <> message. + +[#vol2_clause_dev_47_publish_biceps_update_reports_ses] +include::../dev-x-default-ses-secured-mode.adoc[] + diff --git a/asciidoc/volume2/discovery-proxy/tf2-ch-a-mdpws-discovery-proxy.adoc b/asciidoc/volume2/discovery-proxy/tf2-ch-a-mdpws-discovery-proxy.adoc new file mode 100644 index 0000000..35d1126 --- /dev/null +++ b/asciidoc/volume2/discovery-proxy/tf2-ch-a-mdpws-discovery-proxy.adoc @@ -0,0 +1,79 @@ +[#vol2_clause_appendix_mdpws_discovery_proxy] +=== Discovery Proxy implementation requirements + +This chapter describes requirements to the <> <> binding that go beyond message outlines and semantics specified in <> and <>. + +.R7007 +[sdpi_requirement#r7007,sdpi_req_level=shall] +**** + +A <> shall provide the Discovery Proxy service by implementing the port type +with the <> dp:DiscoveryProxy. + +NOTE: The <> port type is defined in <>. + +NOTE: The OID used for the target namespace of the <> WSDL file is listed in <>. +**** + +.R7008 +[sdpi_requirement#r7008,sdpi_req_level=shall] +**** + +A <> shall accept the WS-Eventing wse:Filter@Dialect +urn:oid:1.3.6.1.4.1.19376.1.6.2.10.1.2.1. + +NOTE: The OID used for the filter dialect is listed in <>. +**** + +.R7009 +[sdpi_requirement#r7009,sdpi_req_level=shall] +**** + +A <> shall add the filter dialect urn:oid:1.3.6.1.4.1.19376.1.6.2.10.1.2.1 to +every Subscribe request to a <>. + +NOTE: The OID used for the filter dialect is listed in <>. +**** + +==== Utilized OIDs + +All object identifiers used by the <> are specified in <>. + +[#vol2_table_appendix_mdpws_discovery_proxy_oids] +.WS-Eventing subscription filter dialect and WSDL target namespace OID assignments +[cols="2,3,1",options="autowidth, header"] +|=== +| Primary identifier +| Concept description +| Secondary identifier + +| 1.3.6.1.4.1.19376.1.6.2.10 +| Profile specific OID for SDPi +| sdpi + +| 1.3.6.1.4.1.19376.1.6.2.10.1 +| Describes namespaces for different purposes as specified by its sub-nodes +| namespaces + +| 1.3.6.1.4.1.19376.1.6.2.10.1.2 +| Identifies <> objects. +| discovery-proxy + +| 1.3.6.1.4.1.19376.1.6.2.10.1.2.1 +| Subscription filter dialect used to identify Hello/Bye subscriptions provided by a <>. +| subscription-filter + +| 1.3.6.1.4.1.19376.1.6.2.10.1.2.2 +| WSDL target namespace identifier for the <> actor. +| wsdl +|=== + +==== Discovery Proxy WSDL + +<> shows the WSDL file that specifies the <> Web Service interface. + +.Discovery Proxy WSDL outline +[source#vol2_clause_appendix_a_mdpws_wsdl,xml] +---- +include::../../../sources/discovery-proxy/DiscoveryProxy.wsdl[] +---- diff --git a/asciidoc/volume2/tf2-ch-a-mdpws.adoc b/asciidoc/volume2/tf2-ch-a-mdpws.adoc index 962d988..bbd2563 100644 --- a/asciidoc/volume2/tf2-ch-a-mdpws.adoc +++ b/asciidoc/volume2/tf2-ch-a-mdpws.adoc @@ -55,6 +55,12 @@ include::dev-34/tf2-ch-a-mdpws-dev-34.adoc[] // //=== Retrieve Medical Alert Status [DEV-40] +include::dev-46/tf2-ch-a-mdpws-dev-46.adoc[] + +include::dev-47/tf2-ch-a-mdpws-dev-47.adoc[] + +include::discovery-proxy/tf2-ch-a-mdpws-discovery-proxy.adoc[] + === Security Considerations In TR1164, <> requires a <> to protect <> services against unauthenticated access. diff --git a/asciidoc/volume2/tf2-main.adoc b/asciidoc/volume2/tf2-main.adoc index 0bf37c7..8f746dc 100644 --- a/asciidoc/volume2/tf2-main.adoc +++ b/asciidoc/volume2/tf2-main.adoc @@ -48,6 +48,12 @@ include::dev-39/tf2-dev-39.adoc[] //=== Retrieve Medical Alert Status [DEV-40] include::dev-40/tf2-dev-40.adoc[] +//=== Update Network Presence [DEV-46] +include::dev-46/tf2-dev-46.adoc[] + +//=== Retrieve Network Presence [DEV-47] +include::dev-47/tf2-dev-47.adoc[] + // TODO how does this differ from DEV-30 // //[appendix#clause-mdpws-constraints-corrigenda-adjuncts] diff --git a/asciidoc/volume3/tf3-ch-8.7.3-physiologic-monitor.adoc b/asciidoc/volume3/tf3-ch-8.7.3-physiologic-monitor.adoc index fb1ac25..1c317cb 100644 --- a/asciidoc/volume3/tf3-ch-8.7.3-physiologic-monitor.adoc +++ b/asciidoc/volume3/tf3-ch-8.7.3-physiologic-monitor.adoc @@ -18,7 +18,7 @@ The following BICEPS containment tree represents a highly-simplified physiologic .Physiologic Monitor Containment Tree Example -[plantuml#vol3-figure-biceps-content-module-physiomon, target=puml-figure-biceps-content-module-physiomon, format=svg,width=100%] +[plantuml#vol3-figure-biceps-content-module-physiomon, target=puml-figure-biceps-content-module-physiomon, format=svg, width=100%] .... include::../plantuml/vol3-figure-biceps-content-module-physiomon.puml[] .... diff --git a/asciidoc/volume3/tf3-ch-b-biceps-extension-namespace.adoc b/asciidoc/volume3/tf3-ch-b-biceps-extension-namespace.adoc index f205c1e..361caf1 100644 --- a/asciidoc/volume3/tf3-ch-b-biceps-extension-namespace.adoc +++ b/asciidoc/volume3/tf3-ch-b-biceps-extension-namespace.adoc @@ -30,4 +30,8 @@ A comprehensive listing of OIDs within the IHE Devices namespace is shown at the | Major version 1 for extensions to the BICEPS Participant and Message Model. In order to avoid proliferation of OIDs below `1.3.6.1.4.1.19376.1.6.2.10.1.1`, versions are incremented only if incompatible changes are made to an extension. | version1 + +| 1.3.6.1.4.1.19376.1.6.2.10.1.2 +| Subscription filter dialect used to identify Hello/Bye subscriptions provided by a <>. +| subscription-filter |=== diff --git a/sources/discovery-proxy/DiscoveryProxy.wsdl b/sources/discovery-proxy/DiscoveryProxy.wsdl new file mode 100644 index 0000000..ced4f1a --- /dev/null +++ b/sources/discovery-proxy/DiscoveryProxy.wsdl @@ -0,0 +1,100 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/sources/vol1-diagram-sdpi-p-actor.pptx b/sources/vol1-diagram-sdpi-p-actor.pptx index bbf2e3e..7d243f8 100644 Binary files a/sources/vol1-diagram-sdpi-p-actor.pptx and b/sources/vol1-diagram-sdpi-p-actor.pptx differ