Megosztás a következőn keresztül:

Választható keresési paraméterek

Az erőforrások keresése alapvető fontosságú az FHIR® szolgáltatásban. Az FHIR szolgáltatás minden erőforrása elemkészletként tartalmazza az információkat. A keresési paraméterek az ezekben az elemekben található információk lekérdezéséhez működnek. Az FHIR szolgáltatás üzembe helyezésekor a beépített keresési paraméterek alapértelmezés szerint engedélyezve vannak. Az FHIR szolgáltatás az adatok betöltése során az FHIR-erőforrások adott tulajdonságainak kinyerésével és indexelésével végez hatékony keresést.

A választható keresési paraméterek lehetővé teszik a beépített keresési paraméterek engedélyezését vagy letiltását. Ezzel a funkcióval több erőforrást tárolhat a lefoglalt tárterületen, és csak a szükséges keresési paraméterek engedélyezésével javíthatja a teljesítményt.

Ha állapotfrissítéseket szeretne végrehajtani a keresési paramétereken, kövesse az alábbi lépéseket:

  1. A keresési paraméterek állapotának lekérése.
  2. Frissítse a keresési paraméterek állapotát.
  3. Újraindexelt feladat végrehajtása.

Ebben a cikkben az FHIR keresési szintaxisát mutatjuk be a példa API-hívásokban a {{FHIR_URL}} helyőrzővel az FHIR-kiszolgáló URL-címének megjelenítéséhez.

Keresési paraméterek állapotának lekérése

A keresési paraméterek állapotának megtekintéséhez egy API-végpontot ('$status') biztosítunk. A válasznak négy állapota van:

Állapot Leírás
Támogatott A keresési paramétert az FHIR szolgáltatás támogatja, és kéréseket küldött a keresési paraméter engedélyezéséhez. Futtassa az újraindexelési műveletet a támogatottról az engedélyezésre való futtatáshoz.
Engedélyezve A keresési paraméter engedélyezve van a kereséshez. Ez az állapot a támogatott állapot utáni következő lépés.
PendingDisable A keresési paraméter letiltása az újraindexelési művelet végrehajtása után függőben van.
Disabled (Letiltva) A keresési paraméter le van tiltva.

Az összes keresési paraméter állapotának lekéréséhez használja a következő kérést, amely az összes keresési paraméter és azok állapotát adja vissza. Görgessen végig a listán a szükséges keresési paraméter megkereséséhez.

GET {{FHIR_URL}}/SearchParameter/$status

Az egyéni vagy a keresési paraméterek egy részhalmazának azonosításához használja az alábbi szűrőket.

  • Név. A keresési paraméter állapotának név szerinti azonosításához használja ezt a kérést.
   GET {{FHIR_URL}}/SearchParameter/$status?code=<name of search parameter/ sub string>
  • URL-cím. A keresési paraméter állapotának a canonical azonosítójával való azonosításához használja ezt a kérést.
GET {{FHIR_URL}}/SearchParameter/$status?url=<SearchParameter url>
  • Erőforrás típusa. Az FHIR-ben a keresési paraméterek engedélyezve vannak az egyes erőforrásszinteken, hogy lehetővé tegyék az erőforrások adott részhalmazának szűrését és lekérését. Az erőforráshoz hozzárendelt összes keresési paraméter állapotának azonosításához használja ezt a kérést.
GET {{FHIR_URL}}/SearchParameter/$status?resourcetype=<ResourceType name>

Az $status végpontra irányuló GET-kérésre válaszul a rendszer a keresési paraméter állapotával adja vissza a paraméterek erőforrástípusát. Íme egy példa egy válaszra.

{
  "resourceType" : "Parameters",
  "parameter" : [
    "name" : "searchParameterStatus",
    "part" : {
        {
        "name" : "url",
        "valueString" : "http://hl7.org/fhir/SearchParameter/Account-identifier"
        },
        {
        "name" : "status",
        "valueString" : "supported"
        }
    }
  ]
}

A keresési paraméterek állapotának frissítése

A keresési paraméterek állapotának lekérése után frissítse a keresési paraméterek állapotát a következőre Supported vagy Disabled.

Feljegyzés

A keresési paraméterek állapotának frissítéséhez szüksége van a Search Parameter Manager Azure RBAC szerepkörre.

A keresési paraméter állapota frissíthető egyetlen keresési paraméterhez vagy tömegesen.

Egyetlen keresési paraméter állapotának frissítése

Egyetlen keresési paraméter állapotának frissítéséhez használja az alábbi API-kérést.

PUT {{FHIR_URL}}/SearchParameter/$status
{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "searchParameterStatus",
            "part": [
                {
                    "name": "url",
                    "valueUrl": "http://hl7.org/fhir/SearchParameter/Resource-test-id"
                },
                {
                    "name": "status",
                    "valueString": "Supported"
                }
            ]
        }
    ]
}

A használati esettől függően a keresési paraméter állapotértékét a "Támogatott" vagy a "Letiltva" értékben is megtarthatja. Amikor elküldi az állapotot Disabled a kérelemben, a válasz úgy tér vissza, hogy PendingDisable egy újraindexelési feladatnak futnia kell a társítások teljes eltávolításához.

Ha 400 HTTP-állapotkódot kap a válaszban, az azt jelenti, hogy nincs egyedi egyezés az azonosított keresési paraméterrel. Ellenőrizze a keresési paraméter azonosítóját.

Keresési paraméter állapotának tömeges frissítése

A keresési paraméterek állapotának tömeges frissítéséhez a "PUT" kérésnek rendelkeznie kell a "Paraméterek" erőforráslistával a kérelem törzsében. A listának tartalmaznia kell a frissíteni kívánt egyes keresési paramétereket.

PUT {{FHIR_URL}}/SearchParameter/$status
{
  "resourceType" : "Parameters",
  "parameter" : [
    {
     "name" : "searchParameterStatus",
     "part" :[
			{
				"name" : "url",
				"valueString" : "http://hl7.org/fhir/SearchParameter/Endpoint-name"
			},
			{ 
				"name" : "status",
				"valueString" : "Supported"
			}
		]
    },
	{
     "name" : "searchParameterStatus",
     "part" :[
		 {
			"name" : "url",
			"valueString" : "http://hl7.org/fhir/SearchParameter/HealthcareService-name"
		 },
		 { 
			"name" : "status",
			"valueString" : "Supported"
		 }
	 ]
    },
    ...
  ]
}

Újraindexelési feladat végrehajtása

Miután frissítette a keresési paraméter állapotát SupportedDisabled, a következő lépés egy újraindexeléses feladat végrehajtása.

Amíg a keresési paraméter indexelése nem történik meg, a Enabled keresési paraméterek állapota és Disabled állapota nem aktiválódik. A feladat újraindexelése a következő állapotot SupportedEnabledPendingDisableDisabledfrissíti:

Az újraindexelési feladat végrehajtható a teljes FHIR szolgáltatásadatbázison vagy adott keresési paramétereken. Az újraindexelési feladatok teljesítményigényesek lehetnek. További információ: Újraindexeléses feladat futtatása.

Feljegyzés

A képességutasítási dokumentum az FHIR-kiszolgálók viselkedési halmaza. Enabled A keresési paraméterek szerepelnek az FHIR szolgáltatás képességi utasításában. A /metadata végponthoz egy képességutasítás érhető el.

Gyakori kérdések

Mi a viselkedés, ha a lekérdezés tartalmaz egy "Támogatott" állapotú keresési paramétert?

A "Támogatott" állapotú keresési paramétert újra kell indexelni. Addig a keresési paraméter nincs aktiválva. Ha nem aktív keresési paraméteren hajt végre lekérdezést, az FHIR szolgáltatás a keresési paraméter figyelembe vétele nélkül jelenít meg választ. A válaszban egy figyelmeztető üzenet jelenik meg, amely azt jelzi, hogy a keresési paraméter nem indexelt, és nem lett használva a lekérdezésben. Ha ilyen helyzetekben hibát szeretne megjeleníteni, használja a "Prefer: handling" fejlécet a "szigorú" értékkel. A fejléc beállításával a figyelmeztetések hibaüzenetként jelennek meg.

Következő lépések

Egyéni keresési paraméterek definiálása

Feljegyzés

Az FHIR® a HL7 bejegyzett védjegye, amelyet a HL7 engedélyével használnak.