diff --git a/docs/erp_eml-epa-notes.adoc b/docs/erp_eml-epa-notes.adoc index 4f2f4c6b..82e4879c 100644 --- a/docs/erp_eml-epa-notes.adoc +++ b/docs/erp_eml-epa-notes.adoc @@ -360,7 +360,7 @@ NOTE: Zur Veranschaulichung der Daten kann der link:https://bfarm-referenzdatenb Die Darstellung von Rezepturen und Kombipackungen in der ePA unterscheidet sich zum Profil KBV_PR_ERP_Medication_Compounding. -In KBV_PR_ERP_Medication_Compounding sind alle Bestandteile einer Rezeptur in _einer_ Medication als PZN Codes unter .ingredient aufgelistet. Dies bietet Vorteile für die Datensparsamkeit und reduziert die Komplexität der Daten. +In KBV_PR_ERP_Medication_Compounding sind die Bestandteile einer Rezeptur in _einer_ Medication als PZN Codes unter .ingredient aufgelistet. Dies bietet Vorteile für die Datensparsamkeit und reduziert die Komplexität der Daten. Für die Abgabe von Rezepturen hat das technisch u.A. den Nachteil, dass nicht für jeden PZN-Bestandteil der Rezeptur eine Angabe zur Chargeninformation angegeben werden kann. @@ -385,9 +385,9 @@ Die ePA bietet folgende Profile mit Besonderheiten: ==== Rezepturen -Für Rezepturen wird genau eine EPA Medication erzeugt. Diese Medication enthält unter .extension:type den Wert "Extemporaneous preparation (product)". Damit ist diese Medication als Rezeptur gekennzeichnet. +Für Rezepturen wird eine übergeordnete EPA Medication erzeugt. Diese Medication enthält unter .extension:type den Wert "Extemporaneous preparation (product)". Damit ist diese Medication als Rezeptur gekennzeichnet. -Für jeden Bestandteil der Rezeptur wird eine EPA Medication Ingredient erzeugt und als .contained hinzugefügt. Die EPA Medication Ingredient Objekte können keine weiteren Medications enthalten, sondern nur die Angaben zu einem Bestandteil einer Rezeptur. +Für die einzelnen Bestandteile der Rezeptur wird eine EPA Medication Ingredient erzeugt und als .contained hinzugefügt. Die EPA Medication Ingredient Objekte können keine weiteren Medications enthalten, sondern nur die Angaben zu einem Bestandteil einer Rezeptur. Schematisch stellt sich eine Rezeptur wie folgt dar: @@ -712,3 +712,14 @@ Ab Profilversion 1.4 übergibt das AVS diese Informationen getrennt in einem Par Schematisch kann das so dargestellt werden: image:fdv-bundle.png[width=70%] + +=== Beispiele für den Aufruf GET /MedicationDispense + +Folgende Beispielhafte Responses für den Aufruf GET /MedicationDispense können genutzt werden, um die neuen Profile zu testen: + +* link:https://github.com/gematik/fhir-profiles-erp/blob/master/Resources/fsh-generated/resources/Bundle-SimpleMedicationDispenseBundle.json[Bundle mit einer MedicationDispense 1.4 mit einfacher Medication ] +* link:https://github.com/gematik/fhir-profiles-erp/blob/master/Resources/fsh-generated/resources/Bundle-KomplexMedicationDispenseBundle.json[Bundle mit MedicationDispense 1.4 mit komplexer Medication (Rezeptur) ] +* link:https://github.com/gematik/fhir-profiles-erp/blob/master/Resources/fsh-generated/resources/Bundle-MultipleMedicationDispenseBundle.json[Bundle mit mehreren MedicationDispense 1.4 und einfacher Medication ] +* link:https://github.com/gematik/fhir-profiles-erp/blob/master/Resources/fsh-generated/resources/Bundle-SearchSetMultipleMedicationDispenseBundle.json[Bundle mit 2x MedicationDispense 1.4, MedicationDispense 1.3 und MedicationDispense 1.2 ] + +NOTE: Search Mode gibt an, wie Ressourcen in das Rückgabebundle aufgenommen wurden. Der Aufruf GET /MedicationDispense nimmt an, dass per default _include=MedicationDispense:medication gesetzt ist. Entries mit SearchMode "match" sind also die MedicationDispense Ressourcen, die auf die Suchanfrage zutreffen. Entries mit SearchMode "match" sind die Medication Ressourcen, die von MedicationDispenses referenziert werden. diff --git a/docs/erp_fhir_infos.adoc b/docs/erp_fhir_infos.adoc index fb8c820b..2c015ebb 100644 --- a/docs/erp_fhir_infos.adoc +++ b/docs/erp_fhir_infos.adoc @@ -50,6 +50,21 @@ Für die QES-Erstellung durch den Konnektor liegen im Unterordner link:../sample Durchgängige Beispieldatensätze von der Verordnung und qualifizierter Signatur über Quittung bis zu den Abrechnungsdaten stehen im https://github.com/gematik/eRezept-Examples[Examples-Repo] zur Verfügung. +=== Referenzierung von FHIR-Objekten in Bundles +Der FHIR-Standard definiert wie Ressourcen in einem Bundle referenziert werden sollen. Siehe hierzu link:https://hl7.org/fhir/R4/references.html[Referezen] und link:http://hl7.org/fhir/R4/bundle.html[Bundles]. + +Bei Verwendung von relativer Referenzierung in Bundles muss darauf geachtet werden, dass die id der fullUrl der Ressource mit der id der Ressource übereinstimmt. + +Beispielsweise ist folgende Konstellation ungültig, da der hintere Teil der fullUrl nicht mit der Ressourcen-ID übereinstimmt (b54dd6cad655 ≠ 000000000000): + +[source,xml] +---- + + + + +---- + == Tools und Hinweise zu FHIR diff --git a/docs_sources/erp_eml-epa-notes-source.adoc b/docs_sources/erp_eml-epa-notes-source.adoc index 02ca3b9f..b9b4a403 100644 --- a/docs_sources/erp_eml-epa-notes-source.adoc +++ b/docs_sources/erp_eml-epa-notes-source.adoc @@ -64,7 +64,7 @@ NOTE: Zur Veranschaulichung der Daten kann der link:https://bfarm-referenzdatenb Die Darstellung von Rezepturen und Kombipackungen in der ePA unterscheidet sich zum Profil KBV_PR_ERP_Medication_Compounding. -In KBV_PR_ERP_Medication_Compounding sind alle Bestandteile einer Rezeptur in _einer_ Medication als PZN Codes unter .ingredient aufgelistet. Dies bietet Vorteile für die Datensparsamkeit und reduziert die Komplexität der Daten. +In KBV_PR_ERP_Medication_Compounding sind die Bestandteile einer Rezeptur in _einer_ Medication als PZN Codes unter .ingredient aufgelistet. Dies bietet Vorteile für die Datensparsamkeit und reduziert die Komplexität der Daten. Für die Abgabe von Rezepturen hat das technisch u.A. den Nachteil, dass nicht für jeden PZN-Bestandteil der Rezeptur eine Angabe zur Chargeninformation angegeben werden kann. @@ -89,9 +89,9 @@ Die ePA bietet folgende Profile mit Besonderheiten: ==== Rezepturen -Für Rezepturen wird genau eine EPA Medication erzeugt. Diese Medication enthält unter .extension:type den Wert "Extemporaneous preparation (product)". Damit ist diese Medication als Rezeptur gekennzeichnet. +Für Rezepturen wird eine übergeordnete EPA Medication erzeugt. Diese Medication enthält unter .extension:type den Wert "Extemporaneous preparation (product)". Damit ist diese Medication als Rezeptur gekennzeichnet. -Für jeden Bestandteil der Rezeptur wird eine EPA Medication Ingredient erzeugt und als .contained hinzugefügt. Die EPA Medication Ingredient Objekte können keine weiteren Medications enthalten, sondern nur die Angaben zu einem Bestandteil einer Rezeptur. +Für die einzelnen Bestandteile der Rezeptur wird eine EPA Medication Ingredient erzeugt und als .contained hinzugefügt. Die EPA Medication Ingredient Objekte können keine weiteren Medications enthalten, sondern nur die Angaben zu einem Bestandteil einer Rezeptur. Schematisch stellt sich eine Rezeptur wie folgt dar: @@ -140,4 +140,15 @@ Ab Profilversion 1.4 übergibt das AVS diese Informationen getrennt in einem Par Schematisch kann das so dargestellt werden: -image:fdv-bundle.png[width=70%] \ No newline at end of file +image:fdv-bundle.png[width=70%] + +=== Beispiele für den Aufruf GET /MedicationDispense + +Folgende Beispielhafte Responses für den Aufruf GET /MedicationDispense können genutzt werden, um die neuen Profile zu testen: + +* link:https://github.com/gematik/fhir-profiles-erp/blob/master/Resources/fsh-generated/resources/Bundle-SimpleMedicationDispenseBundle.json[Bundle mit einer MedicationDispense 1.4 mit einfacher Medication ] +* link:https://github.com/gematik/fhir-profiles-erp/blob/master/Resources/fsh-generated/resources/Bundle-KomplexMedicationDispenseBundle.json[Bundle mit MedicationDispense 1.4 mit komplexer Medication (Rezeptur) ] +* link:https://github.com/gematik/fhir-profiles-erp/blob/master/Resources/fsh-generated/resources/Bundle-MultipleMedicationDispenseBundle.json[Bundle mit mehreren MedicationDispense 1.4 und einfacher Medication ] +* link:https://github.com/gematik/fhir-profiles-erp/blob/master/Resources/fsh-generated/resources/Bundle-SearchSetMultipleMedicationDispenseBundle.json[Bundle mit 2x MedicationDispense 1.4, MedicationDispense 1.3 und MedicationDispense 1.2 ] + +NOTE: Search Mode gibt an, wie Ressourcen in das Rückgabebundle aufgenommen wurden. Der Aufruf GET /MedicationDispense nimmt an, dass per default _include=MedicationDispense:medication gesetzt ist. Entries mit SearchMode "match" sind also die MedicationDispense Ressourcen, die auf die Suchanfrage zutreffen. Entries mit SearchMode "match" sind die Medication Ressourcen, die von MedicationDispenses referenziert werden. \ No newline at end of file diff --git a/docs_sources/erp_fhir_infos-source.adoc b/docs_sources/erp_fhir_infos-source.adoc index f4d3a62d..f8da5425 100644 --- a/docs_sources/erp_fhir_infos-source.adoc +++ b/docs_sources/erp_fhir_infos-source.adoc @@ -35,6 +35,21 @@ Für die QES-Erstellung durch den Konnektor liegen im Unterordner link:../sample Durchgängige Beispieldatensätze von der Verordnung und qualifizierter Signatur über Quittung bis zu den Abrechnungsdaten stehen im https://github.com/gematik/eRezept-Examples[Examples-Repo] zur Verfügung. +=== Referenzierung von FHIR-Objekten in Bundles +Der FHIR-Standard definiert wie Ressourcen in einem Bundle referenziert werden sollen. Siehe hierzu link:https://hl7.org/fhir/R4/references.html[Referezen] und link:http://hl7.org/fhir/R4/bundle.html[Bundles]. + +Bei Verwendung von relativer Referenzierung in Bundles muss darauf geachtet werden, dass die id der fullUrl der Ressource mit der id der Ressource übereinstimmt. + +Beispielsweise ist folgende Konstellation ungültig, da der hintere Teil der fullUrl nicht mit der Ressourcen-ID übereinstimmt (b54dd6cad655 ≠ 000000000000): + +[source,xml] +---- + + + + +---- + == Tools und Hinweise zu FHIR