I datastore FHIR all'interno dell'API Cloud Healthcare supportano più versioni di le risorse Fast Healthcare Interoperability (FHIR) specifica pubblicata da Health Level 7 International (HL7).
L'API v1 supporta le seguenti versioni:
- R4 versione 4.0.1 (Release 4)
- STU3 versione 3.0.1 (Release 3 - Standard per uso di prova)
- DSTU2 versione 1.0.2 (Bozza standard per l'uso di prova)
Quando crei un datastore FHIR, specifichi la versione FHIR come parametro
il metodo fhirStores.create
. Non puoi modificare la versione FHIR dopo il
viene creato un datastore.
L'interfaccia API per ogni datastore è conforme alla versione FHIR di quel datastore. Per
Ad esempio, l'interazione conformance
DSTU2 è diversa da STU3
interazione capabilities
, ma entrambi condividono il percorso REST /fhir/metadata
,
il percorso restituisce risposte diverse in base alla versione FHIR del datastore.
La funzionalità aggiunta nelle versioni FHIR successive è disponibile nei negozi che utilizzano
Versioni FHIR se non creano incompatibilità. Ad esempio, patch
l'interazione è disponibile in un archivio DSTU2 anche se tale interazione è
definita a partire da STU3.
Dettagli delle funzionalità supportate nell'API v1 dalla versione FHIR
R4
L'input del server dichiarazione di capacità indica le parti della specifica supportate.
- Archiviazione e recupero di tutti i dati Risorse R4, inclusa l'assistenza per elementi di estensione. L'API accetta, archivia e restituisce le estensioni su qualsiasi elemento di dati.
- Tutti i metodi nella
API RESTful
che utilizzano il tipo di contenuto JSON, ad eccezione di:
- .
- A livello di tipo e di sistema cronologia le interazioni che recuperano la cronologia su più risorse supportati. La cronologia delle risorse può essere recuperata solo per una risorsa su una volta.
- La batch/transaction l'interazione non supporta le operazioni di ricerca all'interno del bundle.
- Profilo e la convalida e l'applicazione forzata.
- I parametri di ricerca definiti dall'utente, comprese le ricerche di elementi delle estensioni, sono supportati nell'API v1beta1.
Tutta la ricerca è supportata, ad eccezione di:
- I parametri di ricerca
Group-characteristic-value
,Location-near
,Bundle-composition
eBundle-message
non sono supportati. - I parametri di ricerca che eseguono la corrispondenza fonetica non sono supportati.
- I parametri dei risultati di ricerca
_contained
,_containedType
,_summary=count
e_summary=true
non sono supportati. - Il parametro di ricerca speciale
_content
cerca in tutti i campi della risorsa a cui fanno riferimento i parametri di ricerca. Sono esclusi i campi che non sono disponibili per la ricerca. Non supporta contenuti espliciti diAND
(i termini sono implicitamente combinato conAND
) o parentesi. - I parametri di ricerca speciali
_query
,_filter
e_list
non sono supportati. - Il parametro
_sort
, se utilizzato in campi con elementi ripetuti, ordina in base al primo elemento; differisce dalla specifica. Tutti i parametri di ricerca supportati sono idonei per_sort
, ad eccezione dei parametro di ricerca speciale_content
. - Il modificatore di ricerca di token
:of-type
e quello di ricerca nei riferimenti:identifier
non sono supportati. - Le ricerche nei riferimenti canonici non sono supportate. Riferimenti canonici vengono trattati come normali riferimenti.
- Quando utilizzi il parametro
_type
, vengono utilizzati solo i parametri di ricerca comuni (a tutte le risorse) e non l'intersezione dei tipi di risorse specificati. È supportato il seguente sottoinsieme di parametri di ricerca compositi:
DocumentReference-relationship
Observation-code-value-concept
Observation-code-value-date
Observation-code-value-quantity
Observation-code-value-string
Observation-combo-code-value-concept
Observation-combo-code-value-quantity
Observation-component-code-value-concept
Observation-component-code-value-quantity
Gli altri parametri di ricerca composita non sono supportati.
La ricerca con il metodo
POST
non accettaapplication/x-www-form-urlencoded
nel corpo della richiesta.Il carattere jolly (
*
) è supportato per_include
, ma non è supportato per_revinclude
.
- I parametri di ricerca
Le aree non supportate includono:
- Più alta operazioni estese non sono implementate.
- Il tipo di contenuto XML non è supportato.
- L'operazione di applicazione patch non supporta XML Patch o
FHIRPath
Patch. - Le richieste HTTP HEAD non sono supportate.
Aree in cui l'API si discosta dalla specifica FHIR per consentire la compatibilità con le versioni precedenti:
- Il campo
null
è accettato per i campi obbligatori - È accettato un codice vuoto per i campi obbligatori
urn:uuid
riferimenti consentiti nei bundle batch
STU3
L'input del server dichiarazione di capacità indica le parti della specifica supportate.
- Archiviazione e recupero di tutti i dati Risorse STU3 tra cui il supporto per elementi di estensione. L'API accetta, archivia e restituisce le estensioni su qualsiasi elemento di dati.
Tutti i metodi nella API RESTful che utilizzano il tipo di contenuto JSON, ad eccezione di:
- A livello di tipo e di sistema cronologia le interazioni che recuperano la cronologia su più risorse supportati. La cronologia delle risorse può essere recuperata solo per una risorsa su una volta.
- La batch/transaction l'interazione non supporta le operazioni di ricerca all'interno del bundle.
Profilo e la convalida e l'applicazione forzata.
I parametri di ricerca definiti dall'utente, comprese le ricerche di elementi delle estensioni, sono supportati nell'API v1beta1.
Tutta la ricerca è supportata, ad eccezione di:
- I parametri di ricerca
Group-characteristic-value
,Sequence-coordinate
,Location-near
,Location-near-distance
Bundle-composition
eBundle-message
non sono supportati. - I parametri di ricerca che eseguono la corrispondenza fonetica non sono supportati.
- I parametri dei risultati di ricerca
_contained
,_containedType
,_summary=count
e_summary=true
non sono supportati. - Il parametro di ricerca speciale
_content
cerca in tutti i campi della a cui fanno riferimento i parametri di ricerca. Esclude i campi non disponibili per la ricerca. Non supporta contenuti espliciti diAND
(i termini sono implicitamente combinato con AND) o tra parentesi. - I parametri di ricerca speciali
_query
,_filter
e_list
non sono supportati. - Il parametro
_sort
, se utilizzato in campi con elementi ripetuti, ordina in base al primo elemento; differisce dalla specifica. Tutti i parametri di ricerca supportati sono idonei per_sort
, ad eccezione dei parametro di ricerca speciale_content
. - La ricerca con il metodo
POST
non accettaapplication/x-www-form-urlencoded
nel corpo della richiesta. - Il carattere jolly (
*
) è supportato per_include
, ma non è supportato per_revinclude
.
- I parametri di ricerca
Le aree non supportate includono:
- Più alta operazioni estese non sono implementate.
- Il tipo di contenuto XML non è supportato.
- L'operazione di patch non supporta XML Patch o FHIRPath Patch.
Aree in cui l'API si discosta dalla specifica FHIR per consentire la compatibilità con le versioni precedenti:
- Il campo
null
è accettato per i campi obbligatori - È accettato un codice vuoto per i campi obbligatori
urn:uuid
riferimenti consentiti nei bundle batch
DSTU2
L'input del server dichiarazione di conformità indica le parti della specifica supportate.
- Archiviazione e recupero di tutti i dati Risorse DSTU2 tra cui il supporto per elementi di estensione. L'API accetta, archivia e restituisce le estensioni su qualsiasi elemento di dati.
- Tutti i metodi nella
API RESTful
che utilizzano il tipo di contenuto JSON, ad eccezione di:
- .
- A livello di tipo e di sistema cronologia le interazioni che recuperano la cronologia su più risorse supportati. La cronologia delle risorse può essere recuperata solo per una risorsa alla pagina una volta.
- La batch/transaction l'interazione non supporta le operazioni di ricerca all'interno del bundle.
- Profilo e la convalida e l'applicazione forzata.
- Tutti i
cerca
è supportata, ad eccezione di:
- .
- I parametri di ricerca
Group-characteristic-value
,Location-near
,Location-near-distance
,Bundle-composition
,Bundle-message
Coverage-dependent
eCoverage-sequence
non sono supportati. - I parametri di ricerca definiti negli elementi dell'estensione non sono supportati.
- I parametri di ricerca che eseguono la corrispondenza fonetica non sono supportati.
- I parametri dei risultati di ricerca
_contained
,_containedType
,_summary=count
e_summary=true
non sono supportati. - Il parametro di ricerca speciale
_content
cerca in tutti i campi della a cui fanno riferimento i parametri di ricerca. Esclude i campi non disponibili per la ricerca. Non supporta contenuti espliciti diAND
(i termini sono implicitamente combinato con AND) o tra parentesi. - I parametri di ricerca speciali
_query
,_filter
e_list
non sono supportati. - Il parametro
_sort
, se utilizzato in campi con elementi ripetuti, ordina dal primo elemento; differisce dalla specifica. Tutti supportati parametri di ricerca sono idonei per_sort
, ad eccezione dei parametri speciali parametro di ricerca_content
. - La ricerca con il metodo
POST
non accettaapplication/x-www-form-urlencoded
nel corpo della richiesta. - Il carattere jolly (
*
) è supportato per_include
, ma non è supportato per_revinclude
.
- I parametri di ricerca
Le aree non supportate includono:
- Più alta operazioni estese non sono implementate.
- I parametri di ricerca definiti dall'utente non sono supportati per DSTU2.
- Il tipo di contenuto XML non è supportato.
Aree in cui l'API si discosta dalla specifica FHIR per consentire la compatibilità con le versioni precedenti:
- Il campo
null
è accettato per i campi obbligatori - È accettato un codice vuoto per i campi obbligatori
urn:uuid
riferimenti consentiti nei bundle batch
Dettagli delle operazioni al di fuori della specifica pubblicata
- La configurazione del datastore FHIR include un'opzione per inviare una notifica Argomento Pub/Sub per tutte le modifiche alle risorse nell'archivio. Questo il meccanismo di notifica è comune a tutti gli archivi dell'API Cloud Healthcare e non è destinata a sostituire l'abbonamento FHIR (DSTU2, STU3 e R4) funzionalità.
- L'operazione di esportazione del datastore FHIR nelle destinazioni Cloud Storage offre solo un'esportazione collettiva dell'intero store. Non è un'implementazione del Dati collettivi FHIR di una bozza di specifica.
- L'operazione di importazione del datastore FHIR non è definita nella specifica.
- L'operazione
Resource-purge
che rimuove le versioni storiche di non è definito nella specifica. Questa API potrebbe cambiare in futuro se gli standard elaborano o altre implementazioni FHIR convergono su un altro metodo API per questo caso d'uso. - L'endpoint
ExecuteBundle
accettahistory
bundle nella versione v1beta1 per creare versioni storiche delle risorse.