EFA Anwendungsdienste (logische Spezifikation)
K (→createECR: PIM-Klasse zur Verbesserung der Lesbarkeit aufgelöst. Parameter ecrStatus entfernt, da Wertvorgabe konstant.) |
(→listPartitionContent) |
||
(8 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 66: | Zeile 66: | ||
|retrieveData | |retrieveData | ||
|EFA Document Repository | |EFA Document Repository | ||
+ | |- | ||
+ | |[[cdaefa:EFA_Kommunikationsmuster#Invalidieren_eines_Dokuments|Invalidieren eines Dokuments]] | ||
+ | |invalidateData | ||
+ | |EFA Document Registry | ||
|} | |} | ||
Das Zusammenspiel von Diensten und Operationen ist in der folgenden Darstellung noch einmal im Überblick dargestellt. | Das Zusammenspiel von Diensten und Operationen ist in der folgenden Darstellung noch einmal im Überblick dargestellt. | ||
− | [[Datei: | + | [[Datei:cdaefa_SFM_Operationen.png|639px]] |
Die gestrichelt dargestellten internen Operationsaufrufe vom Ressource Manager zu den anderen Diensten sind optional in dem Sinne als dass die geforderte Funktionalität der Speicherung und Registrierung von Einwilligungen und Einwilligungsdokumenten auch über interne Mechanismen des EFA-Providers erfolgen kann. | Die gestrichelt dargestellten internen Operationsaufrufe vom Ressource Manager zu den anderen Diensten sind optional in dem Sinne als dass die geforderte Funktionalität der Speicherung und Registrierung von Einwilligungen und Einwilligungsdokumenten auch über interne Mechanismen des EFA-Providers erfolgen kann. | ||
Zeile 89: | Zeile 93: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
!Operation | !Operation | ||
− | + | |colspan="2"|createECR | |
|- | |- | ||
− | + | !Funktionalität | |
| colspan="2"|Diese Operation erzeugt eine [[cdaefa:EFA_Business_Informationsmodell#Fallakte|Fallakte]]. Wenn die Fallakte für den Patienten und für den Zweck bereits besteht, werden die bestehende und die neue Fallakte fusioniert. Die Einwilligung der bestehenden Fallakte wird invalidiert und mit der neuen Einwilligung ersetzt. | | colspan="2"|Diese Operation erzeugt eine [[cdaefa:EFA_Business_Informationsmodell#Fallakte|Fallakte]]. Wenn die Fallakte für den Patienten und für den Zweck bereits besteht, werden die bestehende und die neue Fallakte fusioniert. Die Einwilligung der bestehenden Fallakte wird invalidiert und mit der neuen Einwilligung ersetzt. | ||
|- | |- | ||
− | + | !Aufrufer | |
| colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | | colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | ||
|- | |- | ||
− | + | !rowspan="5"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
Zeile 113: | Zeile 117: | ||
|Sofern die Einwilligungserklärung des Patienten als (gescanntes) elektronisches Dokument vorliegt, kann diese bei der Anlage der Akte direkt in die Akte eingestellt werden. | |Sofern die Einwilligungserklärung des Patienten als (gescanntes) elektronisches Dokument vorliegt, kann diese bei der Anlage der Akte direkt in die Akte eingestellt werden. | ||
|- | |- | ||
− | + | !rowspan="2"|Rückgabe | |
|statusInfo | |statusInfo | ||
|Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
Zeile 120: | Zeile 124: | ||
|Eindeutige ID der initial zu der neuen Akte angelegten Partition. Mit Hilfe dieser ID kann der EFA-Teilnehmer weitere Operationen, wie z.B. das Einstellen von Dokumenten in die Fallakte, durchführen. | |Eindeutige ID der initial zu der neuen Akte angelegten Partition. Mit Hilfe dieser ID kann der EFA-Teilnehmer weitere Operationen, wie z.B. das Einstellen von Dokumenten in die Fallakte, durchführen. | ||
|- | |- | ||
− | + | !Vorbedingungen | |
| colspan="2"| | | colspan="2"| | ||
* Das übergebene [[cdaefa:EFA_Business_Informationsmodell#consentInfo|consentInfo]] Dokument ist konsistent: | * Das übergebene [[cdaefa:EFA_Business_Informationsmodell#consentInfo|consentInfo]] Dokument ist konsistent: | ||
Zeile 129: | Zeile 133: | ||
** Sofern im ''consentInfo'' ein Fallaktenmanager identifiziert ist, MUSS dieser mit der im EFA-Netzwerk für diese Rolle benannten Person übereinstimmen (die Festlegung des Fallaktenmanagers erfolgt nicht durch den Patienten und muss daher nicht zwingend in den kodierten Informationen zur Einwilligung enthalten sein). | ** Sofern im ''consentInfo'' ein Fallaktenmanager identifiziert ist, MUSS dieser mit der im EFA-Netzwerk für diese Rolle benannten Person übereinstimmen (die Festlegung des Fallaktenmanagers erfolgt nicht durch den Patienten und muss daher nicht zwingend in den kodierten Informationen zur Einwilligung enthalten sein). | ||
|- | |- | ||
− | + | !Ablauf | |
| colspan="2"| | | colspan="2"| | ||
# Übersetze das consentInfo-Dokument in eine EFA-Berechtigungsregel. | # Übersetze das consentInfo-Dokument in eine EFA-Berechtigungsregel. | ||
Zeile 142: | Zeile 146: | ||
# Gib die Kennung der neuen Partition (partitionID) und den Status dem Aufrufer. | # Gib die Kennung der neuen Partition (partitionID) und den Status dem Aufrufer. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
| colspan="2"| | | colspan="2"| | ||
Folgende Fehler müssen erkannt und rückgemeldet werden: | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
Zeile 154: | Zeile 158: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
!Operation | !Operation | ||
− | + | | colspan="2"|createPartition | |
|- | |- | ||
− | + | !Funktionalität | |
| colspan="2"|Diese Operation erzeugt eine Partition für eine bestehende Fallakte. | | colspan="2"|Diese Operation erzeugt eine Partition für eine bestehende Fallakte. | ||
|- | |- | ||
− | + | !Aufrufer | |
| colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | | colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | ||
|- | |- | ||
− | + | ! rowspan="4"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
Zeile 175: | Zeile 179: | ||
|Bei der Anlage einer Partition können initial in diese Partition einzustellende Dokumente mit übergeben werden. | |Bei der Anlage einer Partition können initial in diese Partition einzustellende Dokumente mit übergeben werden. | ||
|- | |- | ||
− | + | ! rowspan="2"|Rückgabe | |
|statusInfo | |statusInfo | ||
|Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
Zeile 182: | Zeile 186: | ||
|Eindeutige ID der neu angelegten Partition. Mit Hilfe dieser ID kann der EFA-Teilnehmer weitere Operationen, wie z.B. das Einstellen von Dokumenten in diese Partition, durchführen. | |Eindeutige ID der neu angelegten Partition. Mit Hilfe dieser ID kann der EFA-Teilnehmer weitere Operationen, wie z.B. das Einstellen von Dokumenten in diese Partition, durchführen. | ||
|- | |- | ||
− | + | !Vorbedingungen | |
| colspan="2"| | | colspan="2"| | ||
* Die übergebenen Metadaten der anzulegenden Partition sind vollständig und valide. | * Die übergebenen Metadaten der anzulegenden Partition sind vollständig und valide. | ||
|- | |- | ||
− | + | !Ablauf | |
| colspan="2"| | | colspan="2"| | ||
# Erzeuge eine Partition. Verknüpfe sie mit dem Eingabeparametern ecrRef und partitionInfo. | # Erzeuge eine Partition. Verknüpfe sie mit dem Eingabeparametern ecrRef und partitionInfo. | ||
Zeile 193: | Zeile 197: | ||
# Gib die Kennung der neuen Partition (partitionID) und den Status dem Aufrufer. | # Gib die Kennung der neuen Partition (partitionID) und den Status dem Aufrufer. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
| colspan="2"| | | colspan="2"| | ||
Folgende Fehler müssen erkannt und rückgemeldet werden: | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
Zeile 205: | Zeile 209: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
!Operation | !Operation | ||
− | + | | colspan="2"|closeECR | |
|- | |- | ||
− | + | !Funktionalität | |
| colspan="2"|Schließt eine Fallakte. Sie wechselt in den Status "Gesperrt" und ist nur für Fallaktenmanager verfügbar. | | colspan="2"|Schließt eine Fallakte. Sie wechselt in den Status "Gesperrt" und ist nur für Fallaktenmanager verfügbar. | ||
|- | |- | ||
− | + | !Aufrufer | |
| colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | | colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | ||
|- | |- | ||
− | + | ! rowspan="4"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
Zeile 226: | Zeile 230: | ||
|Sofern die Schließung der Akte auf eine Änderung der Einwilligung zurückzuführen ist, kann eine elektronische Version des entsprechenden Dokuments mit übergeben werden. Hierdurch ist auch nach dem Schließen der Akte der Grund für diese Operation noch nachvollziehbar. | |Sofern die Schließung der Akte auf eine Änderung der Einwilligung zurückzuführen ist, kann eine elektronische Version des entsprechenden Dokuments mit übergeben werden. Hierdurch ist auch nach dem Schließen der Akte der Grund für diese Operation noch nachvollziehbar. | ||
|- | |- | ||
− | + | !Rückgabe | |
|statusInfo | |statusInfo | ||
|Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
|- | |- | ||
− | + | !Vorbedingungen | |
| colspan="2"| | | colspan="2"| | ||
|- | |- | ||
− | + | !Ablauf | |
| colspan="2"| | | colspan="2"| | ||
# Ändere den Status der Fallakte (ecrStatus) auf "[[cdaefa:EFA_Business_Lebenszyklus#Lebenszyklus_einer_Fallakte|Gesperrt]]". | # Ändere den Status der Fallakte (ecrStatus) auf "[[cdaefa:EFA_Business_Lebenszyklus#Lebenszyklus_einer_Fallakte|Gesperrt]]". | ||
Zeile 243: | Zeile 247: | ||
# Gib statusInfo dem Aufrufer. | # Gib statusInfo dem Aufrufer. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
| colspan="2"| | | colspan="2"| | ||
Folgende Fehler müssen erkannt und rückgemeldet werden: | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
Zeile 254: | Zeile 258: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
!Operation | !Operation | ||
− | + | | colspan="2"|listPartitions | |
|- | |- | ||
− | + | !Funktionalität | |
| colspan="2"|Diese Operation listet die Informationen aller Partitionen (und deren übergeordneten Fallakte) auf, zu denen der Aufrufer über die vom betroffenen Patienten gegebenen Einwilligungen zugangsberechtigt ist. | | colspan="2"|Diese Operation listet die Informationen aller Partitionen (und deren übergeordneten Fallakte) auf, zu denen der Aufrufer über die vom betroffenen Patienten gegebenen Einwilligungen zugangsberechtigt ist. | ||
|- | |- | ||
− | + | !Aufrufer | |
| colspan="2"| | | colspan="2"| | ||
*EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne, | *EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne, | ||
*Ressource Manager einer benachbarten EFA-Provider-Domäne | *Ressource Manager einer benachbarten EFA-Provider-Domäne | ||
|- | |- | ||
− | + | ! rowspan="3"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
Zeile 271: | Zeile 275: | ||
|Die ID des betroffenen Patienten. | |Die ID des betroffenen Patienten. | ||
|- | |- | ||
− | |[[cdaefa:EFA_Business_Informationsmodell#purpose|purpose]] | + | |[[cdaefa:EFA_Business_Informationsmodell#purpose|purpose]] |
|Einschränkung der Suche auf Akten und Partitionen, die zu einem bestimmten Zweck angelegt wurden. | |Einschränkung der Suche auf Akten und Partitionen, die zu einem bestimmten Zweck angelegt wurden. | ||
|- | |- | ||
− | + | ! rowspan="2"|Rückgabe | |
|statusInfo | |statusInfo | ||
|Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
Zeile 281: | Zeile 285: | ||
|Liste von nach übergeordneten Fallakten strukturierten Partitionen des Patienten, die im Ergebnis der Suchanfrage gefunden wurden. | |Liste von nach übergeordneten Fallakten strukturierten Partitionen des Patienten, die im Ergebnis der Suchanfrage gefunden wurden. | ||
|- | |- | ||
− | + | !Vorbedingungen | |
| colspan="2"| | | colspan="2"| | ||
|- | |- | ||
− | + | !Ablauf | |
| colspan="2"| | | colspan="2"| | ||
# Identifiziere alle Partitionen, | # Identifiziere alle Partitionen, | ||
Zeile 292: | Zeile 296: | ||
# Gib partitionList und statusInfo dem Aufrufer. | # Gib partitionList und statusInfo dem Aufrufer. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
| colspan="2"| | | colspan="2"| | ||
Folgende Fehler müssen erkannt und rückgemeldet werden: | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
Zeile 303: | Zeile 307: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
|- | |- | ||
− | + | !Operation | |
|colspan="2"|registerConsent | |colspan="2"|registerConsent | ||
|- | |- | ||
− | + | !Funktionalität | |
|colspan="2"|Registriert eine neue Patienteneinwilligung für eine bestehende Fallakte. Zweck, Gültigkeitsdauer und Teilnehmerkreis der Akte werden gemäß der neuen Einwilligung festgesetzt. Die zuvor gültige Einwilligung wird invalidiert. | |colspan="2"|Registriert eine neue Patienteneinwilligung für eine bestehende Fallakte. Zweck, Gültigkeitsdauer und Teilnehmerkreis der Akte werden gemäß der neuen Einwilligung festgesetzt. Die zuvor gültige Einwilligung wird invalidiert. | ||
|- | |- | ||
− | + | !Aufrufer | |
|colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | |colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | ||
|- | |- | ||
− | + | !rowspan="4"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager ''[[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|openContext]]''. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager ''[[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|openContext]]''. | ||
Zeile 333: | Zeile 337: | ||
Wenn consentDoc gegeben ist, dann MUSS consentDoc über docRelationship (Wert "ersetzt") mit dem gültigen consentDoc-Dokument in der Fallakte assoziiert werden. | Wenn consentDoc gegeben ist, dann MUSS consentDoc über docRelationship (Wert "ersetzt") mit dem gültigen consentDoc-Dokument in der Fallakte assoziiert werden. | ||
|- | |- | ||
− | + | !Rückgabe | |
|statusInfo | |statusInfo | ||
|Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
|- | |- | ||
− | + | !Vorbedingungen | |
|colspan="2"| | |colspan="2"| | ||
*Das übergebene [[cdaefa:EFA_Business_Informationsmodell#consentInfo|consentInfo]] Dokument ist konsistent: | *Das übergebene [[cdaefa:EFA_Business_Informationsmodell#consentInfo|consentInfo]] Dokument ist konsistent: | ||
Zeile 344: | Zeile 348: | ||
**Die Angaben zu den Rollen der Teilnehmer ermöglichen eine Zuordnung der Teilnehmer zu mit konkreten Zugriffsrechten hinterlegten EFA-Rollen. | **Die Angaben zu den Rollen der Teilnehmer ermöglichen eine Zuordnung der Teilnehmer zu mit konkreten Zugriffsrechten hinterlegten EFA-Rollen. | ||
|- | |- | ||
− | + | !Ablauf | |
|colspan="2"| | |colspan="2"| | ||
#Passe ecrRef.purpose der Partitionen der Fallakte an den Zweck der neuen Einwilligung an. | #Passe ecrRef.purpose der Partitionen der Fallakte an den Zweck der neuen Einwilligung an. | ||
Zeile 354: | Zeile 358: | ||
#Gib statusInfo an den Aufrufer. | #Gib statusInfo an den Aufrufer. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
|colspan="2"| | |colspan="2"| | ||
Folgende Fehler müssen erkannt und rückgemeldet werden: | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
Zeile 365: | Zeile 369: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
!Operation | !Operation | ||
− | + | | colspan="2"|notifyOfConsent | |
|- | |- | ||
− | + | !Funktionalität | |
| colspan="2"|Benachrichtigt den EFA Ressource Manager über ein consentInfo-Dokument, das bei einem benachbarten EFA-Provider registriert wurde. | | colspan="2"|Benachrichtigt den EFA Ressource Manager über ein consentInfo-Dokument, das bei einem benachbarten EFA-Provider registriert wurde. | ||
|- | |- | ||
− | + | !Aufrufer | |
| colspan="2"| Ressource Manager einer benachbarten EFA-Provider-Domäne | | colspan="2"| Ressource Manager einer benachbarten EFA-Provider-Domäne | ||
|- | |- | ||
− | + | ! rowspan="3"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
Zeile 383: | Zeile 387: | ||
|Die Referenz des consentInfo-Dokuments. | |Die Referenz des consentInfo-Dokuments. | ||
|- | |- | ||
− | + | !Rückgabe | |
|colspan="2"| | |colspan="2"| | ||
|- | |- | ||
− | + | !Vorbedingungen | |
| colspan="2"| | | colspan="2"| | ||
|- | |- | ||
− | + | !Ablauf | |
| colspan="2"| | | colspan="2"| | ||
# Rufe die Operation [[cdaefa:EFA_Anwendungsdienste_(logische_Spezifikation)#retrieveData|''retrieveData'']] des Document Repository auf, das im Eingabe-Parameter documentID referenziert ist. | # Rufe die Operation [[cdaefa:EFA_Anwendungsdienste_(logische_Spezifikation)#retrieveData|''retrieveData'']] des Document Repository auf, das im Eingabe-Parameter documentID referenziert ist. | ||
Zeile 396: | Zeile 400: | ||
# Passe die bestehende EFA-Berechtigungsregel beim Policy Provider an. | # Passe die bestehende EFA-Berechtigungsregel beim Policy Provider an. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
| colspan="2"| | | colspan="2"| | ||
Folgende Fehler müssen erkannt und zurückgemeldet werden: | Folgende Fehler müssen erkannt und zurückgemeldet werden: | ||
Zeile 409: | Zeile 413: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
|- | |- | ||
− | + | !Operation | |
|colspan="2"|listRecordLocations | |colspan="2"|listRecordLocations | ||
|- | |- | ||
− | + | !Funktionalität | |
|colspan="2"|Listet die an einer Fallakte beteiligten EFA-Provider-Domänen auf. | |colspan="2"|Listet die an einer Fallakte beteiligten EFA-Provider-Domänen auf. | ||
|- | |- | ||
− | + | !Aufrufer | |
|colspan="2"|Ressource Manager einer benachbarten EFA-Provider-Domäne | |colspan="2"|Ressource Manager einer benachbarten EFA-Provider-Domäne | ||
|- | |- | ||
− | + | !rowspan="2"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager ''[[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|openContext]]''. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager ''[[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|openContext]]''. | ||
Zeile 425: | Zeile 429: | ||
|Referenziert die Fallakte, deren EFA-Provider-Domänen aufgelistet werden sollen. | |Referenziert die Fallakte, deren EFA-Provider-Domänen aufgelistet werden sollen. | ||
|- | |- | ||
− | + | !Rückgabe | |
|[[cdaefa:EFA_Business_Informationsmodell#communityID|MountPoint]]* | |[[cdaefa:EFA_Business_Informationsmodell#communityID|MountPoint]]* | ||
|Liste der Mount-Points | |Liste der Mount-Points | ||
|- | |- | ||
− | + | !Vorbedingungen | |
|colspan="2"| | |colspan="2"| | ||
|- | |- | ||
− | + | !Ablauf | |
|colspan="2"| | |colspan="2"| | ||
#Gib die Liste der Mount-Points dem Aufrufer. | #Gib die Liste der Mount-Points dem Aufrufer. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
|colspan="2"| | |colspan="2"| | ||
Folgende Fehler müssen erkannt und zurückgemeldet werden: | Folgende Fehler müssen erkannt und zurückgemeldet werden: | ||
Zeile 448: | Zeile 452: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
|- | |- | ||
− | + | !Operation | |
|colspan="2"|registerRecordLocation | |colspan="2"|registerRecordLocation | ||
|- | |- | ||
− | + | !Funktionalität | |
|colspan="2"|Registriert eine EFA-Provider-Domäne als weiteren Speicherort für Partitionen einer Fallakte. Beim Aufrufer wurde ein Offline-Token eingereicht, das vom aufgerufenen EFA-Provider ausgestellten worden ist. | |colspan="2"|Registriert eine EFA-Provider-Domäne als weiteren Speicherort für Partitionen einer Fallakte. Beim Aufrufer wurde ein Offline-Token eingereicht, das vom aufgerufenen EFA-Provider ausgestellten worden ist. | ||
|- | |- | ||
− | + | !Aufrufer | |
|colspan="2"|Ressource Manager der EFA-Provider-Domäne, in der das Offline-Token eingereicht wurde. | |colspan="2"|Ressource Manager der EFA-Provider-Domäne, in der das Offline-Token eingereicht wurde. | ||
|- | |- | ||
− | + | !rowspan="3"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager ''[[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|openContext]]''. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager ''[[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|openContext]]''. | ||
Zeile 471: | Zeile 475: | ||
|Kennung der lokalen EFA-Provider-Domäne, bei der das Offline-Token eingereicht wurde. | |Kennung der lokalen EFA-Provider-Domäne, bei der das Offline-Token eingereicht wurde. | ||
|- | |- | ||
− | + | !Rückgabe | |
|statusInfo | |statusInfo | ||
|Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
|- | |- | ||
− | + | !Vorbedingungen | |
|colspan="2"| | |colspan="2"| | ||
|- | |- | ||
− | + | !Ablauf | |
|colspan="2"| | |colspan="2"| | ||
#Verknüpfe und speichre den Eingabeparameter ecrRef mit der ecrRef-Instanz des accessPolicyToken. | #Verknüpfe und speichre den Eingabeparameter ecrRef mit der ecrRef-Instanz des accessPolicyToken. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
|colspan="2"| | |colspan="2"| | ||
Folgende Fehler müssen erkannt und zurückgemeldet werden: | Folgende Fehler müssen erkannt und zurückgemeldet werden: | ||
Zeile 489: | Zeile 493: | ||
*Der Sicherheitskontext enthält kein Access Policy Token, das von diesem EFA-Provider ausgestellt wurde. | *Der Sicherheitskontext enthält kein Access Policy Token, das von diesem EFA-Provider ausgestellt wurde. | ||
|} | |} | ||
+ | |||
=== Operationen des EFA Document Registry === | === Operationen des EFA Document Registry === | ||
<tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Enndn.01.02}</tt> | <tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Enndn.01.02}</tt> | ||
Zeile 499: | Zeile 504: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
!Operation | !Operation | ||
− | + | | colspan="2"|registerData | |
|- | |- | ||
− | + | !Funktionalität | |
| colspan="2"|Diese Operation registriert von Daten an einer bestehenden Partition einer Fallakte. | | colspan="2"|Diese Operation registriert von Daten an einer bestehenden Partition einer Fallakte. | ||
|- | |- | ||
− | + | !Aufrufer | |
| colspan="2"|Document Repository der gleichen EFA-Provider-Domäne. Die Absicherung der Kommunikation durch einen zwischen beiden Diensten gespannten Sicherheitskontext ist Aufgabe des EFA-Providers und kann mit EFA-unabhängigen Mechanismen realisiert werden. | | colspan="2"|Document Repository der gleichen EFA-Provider-Domäne. Die Absicherung der Kommunikation durch einen zwischen beiden Diensten gespannten Sicherheitskontext ist Aufgabe des EFA-Providers und kann mit EFA-unabhängigen Mechanismen realisiert werden. | ||
|- | |- | ||
− | + | ! rowspan="4"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
Zeile 520: | Zeile 525: | ||
|Beziehungen der neu zu registrierenden Daten zu bestehenden Dokumenten. Diese müssen so registriert werden, dass sie bei der Auflistung von Dokumenten mit bereit gestellt werden können. | |Beziehungen der neu zu registrierenden Daten zu bestehenden Dokumenten. Diese müssen so registriert werden, dass sie bei der Auflistung von Dokumenten mit bereit gestellt werden können. | ||
|- | |- | ||
− | + | !Rückgabe | |
|statusInfo | |statusInfo | ||
|Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
|- | |- | ||
− | + | !Vorbedingungen | |
| colspan="2"| | | colspan="2"| | ||
* Die übergebenen Metadaten der einzustellenden Daten sind vollständig und valide. | * Die übergebenen Metadaten der einzustellenden Daten sind vollständig und valide. | ||
* Die Konfiguration der angesprochenen Akte erlaubt das Einstellen der übergebenen Dokumente. | * Die Konfiguration der angesprochenen Akte erlaubt das Einstellen der übergebenen Dokumente. | ||
|- | |- | ||
− | + | !Ablauf | |
| colspan="2"| | | colspan="2"| | ||
# Speichre docMetadata, docRelationship und den Bezug zu partitionID. | # Speichre docMetadata, docRelationship und den Bezug zu partitionID. | ||
# Gib das statusInfo-Objekt dem Aufrufer. | # Gib das statusInfo-Objekt dem Aufrufer. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
| colspan="2"| | | colspan="2"| | ||
Folgende Fehler müssen erkannt und rückgemeldet werden: | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
Zeile 545: | Zeile 550: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
!Operation | !Operation | ||
− | + | | colspan="2"|listPartitionContent | |
|- | |- | ||
− | + | !Funktionalität | |
| colspan="2"|Diese Operation gibt die Liste der Dokumente, die in einer Partition enthalten sind, zurück. Die Liste enthält die Dokument-Metadaten und Dokument-Beziehungen. | | colspan="2"|Diese Operation gibt die Liste der Dokumente, die in einer Partition enthalten sind, zurück. Die Liste enthält die Dokument-Metadaten und Dokument-Beziehungen. | ||
|- | |- | ||
− | + | !Aufrufer | |
| colspan="2"| | | colspan="2"| | ||
*EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne, | *EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne, | ||
*Document Registry einer benachbarten EFA-Provider-Domäne | *Document Registry einer benachbarten EFA-Provider-Domäne | ||
|- | |- | ||
− | + | ! rowspan="2"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
Zeile 562: | Zeile 567: | ||
|Eindeutige Identifizierung der Partition, deren Inhalte ausgelesen werden sollen. | |Eindeutige Identifizierung der Partition, deren Inhalte ausgelesen werden sollen. | ||
|- | |- | ||
− | + | ! rowspan="2"|Rückgabe | |
|[[cdaefa:EFA_Business_Informationsmodell#docMetadata|docMetadata]][0..*] | |[[cdaefa:EFA_Business_Informationsmodell#docMetadata|docMetadata]][0..*] | ||
|Metadaten der an der ausgewählten Partition registrierten Dokumente | |Metadaten der an der ausgewählten Partition registrierten Dokumente | ||
Zeile 569: | Zeile 574: | ||
|Beziehungen zwischen den Dokumenten der zu listenden Partition und Dokumenten dieser und anderer Partitionen. | |Beziehungen zwischen den Dokumenten der zu listenden Partition und Dokumenten dieser und anderer Partitionen. | ||
|- | |- | ||
− | + | !Vorbedingungen | |
| colspan="2"| | | colspan="2"| | ||
|- | |- | ||
− | + | !Ablauf | |
| colspan="2"| | | colspan="2"| | ||
# Identifiziere alle Dokumente, | # Identifiziere alle Dokumente, | ||
Zeile 580: | Zeile 585: | ||
# Gib die Metadaten der Dokumente und deren Dokument-Beziehungen dem Aufrufer. | # Gib die Metadaten der Dokumente und deren Dokument-Beziehungen dem Aufrufer. | ||
|- | |- | ||
− | |Fehler und Warnungen | + | !Fehler und Warnungen |
+ | | colspan="2"| | ||
+ | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
+ | * [[cdaefa:EFA Fehlermeldungen und Warnungen|Gemeinsame Fehlermeldungen und Warnungen]] | ||
+ | |} | ||
+ | |||
+ | ==== ''invalidateData'' ==== | ||
+ | |||
+ | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
+ | !Operation | ||
+ | | colspan="2"|invalidateData | ||
+ | |- | ||
+ | !Funktionalität | ||
+ | | colspan="2"|Invalidieren eines Dokuments in einer Fallakte. | ||
+ | |- | ||
+ | !Aufrufer | ||
+ | | colspan="2"| | ||
+ | *EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne, | ||
+ | |- | ||
+ | ! rowspan="2"|Eingabe | ||
+ | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
+ | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
+ | |- | ||
+ | |[[cdaefa:EFA_Business_Informationsmodell#documentID|documentID]] | ||
+ | |Eindeutige Identifizierung des zu invalidierenden Dokuments. Das zu invalidierende Dokument DARF NICHT vom Typ [[cdaefa:EFA_Business_Informationsmodell#consentInfo|consentInfo]] oder [[cdaefa:EFA_Business_Informationsmodell#consentDoc|consentDoc]] sein. | ||
+ | |- | ||
+ | ! rowspan="1"|Rückgabe | ||
+ | |statusInfo | ||
+ | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
+ | |- | ||
+ | !Vorbedingungen | ||
+ | | colspan="2"| | ||
+ | |- | ||
+ | !Ablauf | ||
+ | | colspan="2"| | ||
+ | Das Document Registry | ||
+ | # ... ändert den Wert des Attributs ''[[cdaefa:EFA_Business_Informationsmodell#docMetadata|Status]]'' des Dokuments auf ''ungültig''. | ||
+ | # ... sendet eine Information zum Ausführungsstatus der Operation an den Nutzer zurück. | ||
+ | |- | ||
+ | !Fehler und Warnungen | ||
| colspan="2"| | | colspan="2"| | ||
Folgende Fehler müssen erkannt und rückgemeldet werden: | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
Zeile 596: | Zeile 640: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
!Operation | !Operation | ||
− | + | | colspan="2"|provideData | |
|- | |- | ||
− | + | !Funktionalität | |
| colspan="2"|Diese Operation stellt Daten in eine Partition einer Fallakte ein. | | colspan="2"|Diese Operation stellt Daten in eine Partition einer Fallakte ein. | ||
|- | |- | ||
− | + | !Aufrufer | |
| colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | | colspan="2"|EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | ||
|- | |- | ||
− | + | ! rowspan="4"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
Zeile 617: | Zeile 661: | ||
|Beziehungen der neu zu registrierenden Daten zu bestehenden Dokumenten. | |Beziehungen der neu zu registrierenden Daten zu bestehenden Dokumenten. | ||
|- | |- | ||
− | + | !Rückgabe | |
|statusInfo | |statusInfo | ||
|Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
|- | |- | ||
− | + | !Vorbedingungen | |
| colspan="2"| | | colspan="2"| | ||
* Die übergebenen Metadaten der einzustellenden Daten sind vollständig und valide. | * Die übergebenen Metadaten der einzustellenden Daten sind vollständig und valide. | ||
|- | |- | ||
− | + | !Ablauf | |
| colspan="2"| | | colspan="2"| | ||
# Speichre die Dokument-Daten. | # Speichre die Dokument-Daten. | ||
Zeile 631: | Zeile 675: | ||
# Gib das statusInfo-Objekt dem Aufrufer. | # Gib das statusInfo-Objekt dem Aufrufer. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
| colspan="2"| | | colspan="2"| | ||
Folgende Fehler müssen erkannt und rückgemeldet werden: | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
Zeile 642: | Zeile 686: | ||
{|class="wikitable" style="text-align: left; cellpadding: 10;" | {|class="wikitable" style="text-align: left; cellpadding: 10;" | ||
!Operation | !Operation | ||
− | + | | colspan="2"|retrieveData | |
|- | |- | ||
− | + | !Funktionalität | |
| colspan="2"|Abrufen von Daten aus einer Fallakte. | | colspan="2"|Abrufen von Daten aus einer Fallakte. | ||
|- | |- | ||
− | + | !Aufrufer | |
| colspan="2"| | | colspan="2"| | ||
*EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne, | *EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne, | ||
*Ressource Manager einer benachbarten EFA-Provider-Domäne | *Ressource Manager einer benachbarten EFA-Provider-Domäne | ||
|- | |- | ||
− | + | ! rowspan="2"|Eingabe | |
|[[cdaefa:EFA_Security_Informationsmodell#context|context]] | |[[cdaefa:EFA_Security_Informationsmodell#context|context]] | ||
|Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | |Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager [[cdaefa:EFA_Context_Manager_SFM#Operation:_OpenContext|''openContext'']]. | ||
Zeile 659: | Zeile 703: | ||
|Eindeutige Identifizierung der abzurufenden Dokumente | |Eindeutige Identifizierung der abzurufenden Dokumente | ||
|- | |- | ||
− | + | ! rowspan="2"|Rückgabe | |
|statusInfo | |statusInfo | ||
|Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | |Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) | ||
Zeile 666: | Zeile 710: | ||
|angeforderte Dokumente | |angeforderte Dokumente | ||
|- | |- | ||
− | + | !Vorbedingungen | |
| colspan="2"| | | colspan="2"| | ||
|- | |- | ||
− | + | !Ablauf | |
| colspan="2"| | | colspan="2"| | ||
Das Document Repository | Das Document Repository | ||
Zeile 675: | Zeile 719: | ||
# ... sendet eine Information zum Ausführungsstatus der Operation sie wie die angefragten Dokumente an den Nutzer zurück. | # ... sendet eine Information zum Ausführungsstatus der Operation sie wie die angefragten Dokumente an den Nutzer zurück. | ||
|- | |- | ||
− | + | !Fehler und Warnungen | |
| colspan="2"| | | colspan="2"| | ||
Folgende Fehler müssen erkannt und rückgemeldet werden: | Folgende Fehler müssen erkannt und rückgemeldet werden: | ||
Zeile 681: | Zeile 725: | ||
|} | |} | ||
− | |||
+ | |||
+ | ---- | ||
+ | |||
+ | |||
+ | {{NoteBox|'''Referenzen und Querverweise''' | ||
* [[cdaefa:EFA_Spezifikation_v2.0|EFA-2.0-Spezifikation]] | * [[cdaefa:EFA_Spezifikation_v2.0|EFA-2.0-Spezifikation]] | ||
+ | <nowiki></nowiki> | ||
+ | }} |
Aktuelle Version vom 17. Februar 2016, 07:50 Uhr
Dieses Material ist Teil des Leitfadens CDA für die elektronische Fallakte.
|
Anmerkung: Die Kürzel unter den einzelnen Überschriften dienen der Unterstützung des Kommentierungsverfahrens. Bitte geben Sie bei einem Kommentar oder einem Verbesserungsvorschlag zu dieser Spezifikation immer das Kürzel des Abschnitts an, auf den sich Ihr Kommentar bezieht. Alle Kommentare werden in der Lasche "Diskussion" zu der kommentierten Seite gesammelt und gegenkommentiert.
Hinweise zum Kommentierungsverfahren einschließlich aller Formulare und Kontaktadressen finden Sie auf der Seite "Kommentierung EFAv2.0".
Inhaltsverzeichnis
EFA Anwendungsarchitektur: Service Functional Model
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01}
Die nachfolgende Tabelle listet zu den EFA-Kommunikationsmustern die zu deren Umsetzung benötigten Operationen auf. Die Gesamtheit dieser Operationen bildet das Service Functional Model der EFA-Anwendungsarchitektur, d.h. liefert eine vollständige plattformunabhängige Beschreibung der technisch umzusetzenden EFA-Funktionalität.
Kommunikationsmuster | Operation (logisch) | Umsetzender Dienst (logisch) |
---|---|---|
Anlegen einer Fallakte | createECR | EFA Ressource Manager |
Anlegen einer Partition zu einer bestehenden Fallakte | createPartition | EFA Ressource Manager |
Schließen einer Fallakte | closeECR | EFA Ressource Manager |
Auflisten von Partitionen | listPartitions | EFA Ressource Manager |
Registrierung einer neuen Einwilligung | registerConsent | EFA Ressource Manager |
Verteilen einer Einwilligung im EFA-Verbund | notifyOfConsent | EFA Ressource Manager |
Anfordern eines Berechtigungstoken | issueAccessToken | EFA Ressource Manager |
Einlösen eines Berechtigungstoken | redeemAccessToken | EFA Ressource Manager |
listRecordLocations | EFA Ressource Manager | |
registerRecordLocation | EFA Ressource Manager | |
Einstellen von Dokumenten | provideData | EFA Document Repository |
registerData | EFA Document Registry | |
Auflisten von Dokumenten (einer Partition) | listPartitionContent | EFA Document Registry |
Abrufen von Dokumenten | retrieveData | EFA Document Repository |
Invalidieren eines Dokuments | invalidateData | EFA Document Registry |
Das Zusammenspiel von Diensten und Operationen ist in der folgenden Darstellung noch einmal im Überblick dargestellt.
Die gestrichelt dargestellten internen Operationsaufrufe vom Ressource Manager zu den anderen Diensten sind optional in dem Sinne als dass die geforderte Funktionalität der Speicherung und Registrierung von Einwilligungen und Einwilligungsdokumenten auch über interne Mechanismen des EFA-Providers erfolgen kann.
Für alle Operationen gilt:
- Der vom Teilnehmersystem übermittelte Sicherheitskontext muss gültig, vollständig, authentisch und von einer vertrauenswürdigen Stelle für den Aufrufer ausgestellt worden sein.
- Der EFA-Dienst muss den Aufrufer anhand des Eingabeparameters context authentifizieren können.
- Die beteiligten Systeme schreiben einen Audit-Trail.
Operationen des EFA Ressource Manager
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.01}
Der EFA Ressource Manager muss die in diesem Abschnitt enthaltenen Operationen implementieren.
createECR
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.01.01}
Operation | createECR | |
---|---|---|
Funktionalität | Diese Operation erzeugt eine Fallakte. Wenn die Fallakte für den Patienten und für den Zweck bereits besteht, werden die bestehende und die neue Fallakte fusioniert. Die Einwilligung der bestehenden Fallakte wird invalidiert und mit der neuen Einwilligung ersetzt. | |
Aufrufer | EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
patientID | Die ID des Patienten, für den die Fallakte angelegt werden soll. | |
purpose | Der Zweck für den die Fallakte angelegt werden soll. Er muss mit dem Zweck übereinstimmen, der im Eingabe-Parameter consentInfo angegeben ist. | |
consentInfo | Das strukturierte Dokument, das die Einwilligung des Patienten für die Anlage der Fallakte abbildet. | |
consentDoc (optional) | Sofern die Einwilligungserklärung des Patienten als (gescanntes) elektronisches Dokument vorliegt, kann diese bei der Anlage der Akte direkt in die Akte eingestellt werden. | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
partitionID | Eindeutige ID der initial zu der neuen Akte angelegten Partition. Mit Hilfe dieser ID kann der EFA-Teilnehmer weitere Operationen, wie z.B. das Einstellen von Dokumenten in die Fallakte, durchführen. | |
Vorbedingungen |
| |
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden:
|
createPartition
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.01.02}
Operation | createPartition | |
---|---|---|
Funktionalität | Diese Operation erzeugt eine Partition für eine bestehende Fallakte. | |
Aufrufer | EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
ecrRef | Eindeutige Identifizierung der Fallakte, zu der die Partition hinzugefügt werden soll. | |
partitionInfo | Metadaten zu der neu anzulegenden Partition (Titel, etc.) | |
initialDoc (optional) | Bei der Anlage einer Partition können initial in diese Partition einzustellende Dokumente mit übergeben werden. | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
partitionID | Eindeutige ID der neu angelegten Partition. Mit Hilfe dieser ID kann der EFA-Teilnehmer weitere Operationen, wie z.B. das Einstellen von Dokumenten in diese Partition, durchführen. | |
Vorbedingungen |
| |
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden:
|
closeECR
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.01.03}
Operation | closeECR | |
---|---|---|
Funktionalität | Schließt eine Fallakte. Sie wechselt in den Status "Gesperrt" und ist nur für Fallaktenmanager verfügbar. | |
Aufrufer | EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
ecrRef | Eindeutige Identifizierung der Fallakte, die geschlossen werden soll. | |
consentInfo | Angaben zum Grund für das Schließen der Fallakte (z.B. Rücknahme der Einwilligung durch den Patienten). | |
consentDoc (optional) | Sofern die Schließung der Akte auf eine Änderung der Einwilligung zurückzuführen ist, kann eine elektronische Version des entsprechenden Dokuments mit übergeben werden. Hierdurch ist auch nach dem Schließen der Akte der Grund für diese Operation noch nachvollziehbar. | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
Vorbedingungen | ||
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden: |
listPartitions
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.01.04}
Operation | listPartitions | |
---|---|---|
Funktionalität | Diese Operation listet die Informationen aller Partitionen (und deren übergeordneten Fallakte) auf, zu denen der Aufrufer über die vom betroffenen Patienten gegebenen Einwilligungen zugangsberechtigt ist. | |
Aufrufer |
| |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
patientID | Die ID des betroffenen Patienten. | |
purpose | Einschränkung der Suche auf Akten und Partitionen, die zu einem bestimmten Zweck angelegt wurden. | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
partitionList | Liste von nach übergeordneten Fallakten strukturierten Partitionen des Patienten, die im Ergebnis der Suchanfrage gefunden wurden. | |
Vorbedingungen | ||
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden: |
registerConsent
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.01.05}
Operation | registerConsent | |
---|---|---|
Funktionalität | Registriert eine neue Patienteneinwilligung für eine bestehende Fallakte. Zweck, Gültigkeitsdauer und Teilnehmerkreis der Akte werden gemäß der neuen Einwilligung festgesetzt. Die zuvor gültige Einwilligung wird invalidiert. | |
Aufrufer | EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
ecrRef | Eindeutige Identifizierung der Fallakte, zu der eine neue Einwilligung vorliegt. | |
consentInfo
docRelationship |
Angaben zur neuen Einwilligung auf deren Basis Zweck, Gültigkeitsdauer und Teilnehmerkreis der Akte an Änderungen in der Behandlungsorganisation oder der Behandlungssituation angepasst werden sollen.
consentInfo MUSS über docRelationship (Wert "ersetzt") mit dem gültigen consentInfo-Dokument in der Fallakte assoziiert werden. | |
consentDoc (optional)
docRelationship |
Eine ggf. verfügbare elektronische Version des Einwilligungsdokuments kann im Rahmen dieser Operation zur Ablage in der Akte übergeben werden.
Wenn consentDoc gegeben ist, dann MUSS consentDoc über docRelationship (Wert "ersetzt") mit dem gültigen consentDoc-Dokument in der Fallakte assoziiert werden. | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
Vorbedingungen |
| |
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden: |
notifyOfConsent
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.01.08}
Operation | notifyOfConsent | |
---|---|---|
Funktionalität | Benachrichtigt den EFA Ressource Manager über ein consentInfo-Dokument, das bei einem benachbarten EFA-Provider registriert wurde. | |
Aufrufer | Ressource Manager einer benachbarten EFA-Provider-Domäne | |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
ecrRef | Eindeutige Identifizierung der Fallakte, zu der eine neue Einwilligung vorliegt. | |
documentID | Die Referenz des consentInfo-Dokuments. | |
Rückgabe | ||
Vorbedingungen | ||
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und zurückgemeldet werden:
|
listRecordLocations
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.01.09}
Operation | listRecordLocations | |
---|---|---|
Funktionalität | Listet die an einer Fallakte beteiligten EFA-Provider-Domänen auf. | |
Aufrufer | Ressource Manager einer benachbarten EFA-Provider-Domäne | |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
ecrRef | Referenziert die Fallakte, deren EFA-Provider-Domänen aufgelistet werden sollen. | |
Rückgabe | MountPoint* | Liste der Mount-Points |
Vorbedingungen | ||
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und zurückgemeldet werden:
|
registerRecordLocation
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.01.10}
Operation | registerRecordLocation | |
---|---|---|
Funktionalität | Registriert eine EFA-Provider-Domäne als weiteren Speicherort für Partitionen einer Fallakte. Beim Aufrufer wurde ein Offline-Token eingereicht, das vom aufgerufenen EFA-Provider ausgestellten worden ist. | |
Aufrufer | Ressource Manager der EFA-Provider-Domäne, in der das Offline-Token eingereicht wurde. | |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
MountPoint.sourcePatientId
MountPoint.patientId MountPoint.purpose |
Referenziert die Fallakte bei dem Peer, bei dem das Offline-Token eingereicht wurde. sourcePatientId ist die lokal gültige Patienten-ID. patientId ist die Patienten-ID, die in der Ziel-Provider-Domäne gültig ist. | |
MountPoint.communityID | Kennung der lokalen EFA-Provider-Domäne, bei der das Offline-Token eingereicht wurde. | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
Vorbedingungen | ||
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und zurückgemeldet werden:
|
Operationen des EFA Document Registry
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.02}
Die EFA Document Registry muss die in diesem Abschnitt enthaltenen Operationen implementieren.
registerData
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.02.01}
Operation | registerData | |
---|---|---|
Funktionalität | Diese Operation registriert von Daten an einer bestehenden Partition einer Fallakte. | |
Aufrufer | Document Repository der gleichen EFA-Provider-Domäne. Die Absicherung der Kommunikation durch einen zwischen beiden Diensten gespannten Sicherheitskontext ist Aufgabe des EFA-Providers und kann mit EFA-unabhängigen Mechanismen realisiert werden. | |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
partitionID | Eindeutige Identifizierung der Partition, an der die Daten registriert werden sollen. | |
docMetadata[1..*] | Metadaten der bereits im Document Repository abgelegten Daten, die am Document Registry registriert werden sollen. | |
docRelationship[0..*] | Beziehungen der neu zu registrierenden Daten zu bestehenden Dokumenten. Diese müssen so registriert werden, dass sie bei der Auflistung von Dokumenten mit bereit gestellt werden können. | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
Vorbedingungen |
| |
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden: |
listPartitionContent
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.02.02}
Operation | listPartitionContent | |
---|---|---|
Funktionalität | Diese Operation gibt die Liste der Dokumente, die in einer Partition enthalten sind, zurück. Die Liste enthält die Dokument-Metadaten und Dokument-Beziehungen. | |
Aufrufer |
| |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
partitionID | Eindeutige Identifizierung der Partition, deren Inhalte ausgelesen werden sollen. | |
Rückgabe | docMetadata[0..*] | Metadaten der an der ausgewählten Partition registrierten Dokumente |
docRelationship[0..*] | Beziehungen zwischen den Dokumenten der zu listenden Partition und Dokumenten dieser und anderer Partitionen. | |
Vorbedingungen | ||
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden: |
invalidateData
Operation | invalidateData | |
---|---|---|
Funktionalität | Invalidieren eines Dokuments in einer Fallakte. | |
Aufrufer |
| |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
documentID | Eindeutige Identifizierung des zu invalidierenden Dokuments. Das zu invalidierende Dokument DARF NICHT vom Typ consentInfo oder consentDoc sein. | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
Vorbedingungen | ||
Ablauf |
Das Document Registry
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden: |
Operationen des EFA Document Repository
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.03}
Das EFA Document Repository muss die in diesem Abschnitt enthaltenen Operationen implementieren.
provideData
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.03.01}
Operation | provideData | |
---|---|---|
Funktionalität | Diese Operation stellt Daten in eine Partition einer Fallakte ein. | |
Aufrufer | EFA-Teilnehmersystem der gleichen EFA-Provider-Domäne | |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
partitionID | Eindeutige Identifizierung der Partition, in die die Daten eingestellt werden sollen. | |
document[1..*] | In die Partition einzustellende Dokumente mitsamt ihrer Metadaten. | |
docRelationship[0..*] | Beziehungen der neu zu registrierenden Daten zu bestehenden Dokumenten. | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
Vorbedingungen |
| |
Ablauf |
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden: |
retrieveData
Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Enndn.01.03.02}
Operation | retrieveData | |
---|---|---|
Funktionalität | Abrufen von Daten aus einer Fallakte. | |
Aufrufer |
| |
Eingabe | context | Gibt den Sicherheitskontext vor, in dem die Operation ausgeführt wird. Bezugsquelle: EFA Kontext Manager openContext. |
documentID | Eindeutige Identifizierung der abzurufenden Dokumente | |
Rückgabe | statusInfo | Informationen zur Durchführung der Operation (z.B. aufgetretene Fehler oder für die weitere EFA-Nutzung potenziell relevante Warnungen) |
docData[0..n] | angeforderte Dokumente | |
Vorbedingungen | ||
Ablauf |
Das Document Repository
| |
Fehler und Warnungen |
Folgende Fehler müssen erkannt und rückgemeldet werden: |
Referenzen und Querverweise |