Komponenty Knowledge Accelerators musí být nejprve načteny do produktu Watson Knowledge Catalog předtím, než je lze upravit.

Administrátor projektu může importovat produkt Knowledge Accelerators do produktu Watson Knowledge Catalog pomocí koncových bodů rozhraní REST API poskytovaného jako součást obsahu a k dispozici pro volání prostřednictvím uživatelského rozhraní produktu Knowledge Accelerators OpenAPI .

v1/knowledge_accelerators/api/explorer/

/v1/knowledge_accelerators/{ka_id}
/import_items

/v3/governance_artifact_types/
import/status/{process_id}

• Požadavky a oprávnění

  Produkt Knowledge Accelerators je k dispozici pro import do produktu Watson Knowledge Catalog, do uživatelů IBM Cloud Pak for Data s následujícími oprávněními uživatele plan and .

  Plán nabídky

  Můžete přidat Knowledge Accelerators do struktury regulace, máte-li podnikový plán IBM Cloud Pak for Data . Další informace o podnikovém plánu naleznete v tématu Plány služebWatson Knowledge Catalog.

  Požadovaná oprávnění

  Chcete-li importovat Knowledge Accelerators, musíte mít toto oprávnění uživatele :

  • Správa kategorií regulace

• Vyhledání Knowledge Accelerators v galerii
  • Přihlaste se do galerie Cloud Pak for Data as a Service https://dataplatform.cloud.ibm.com/gallery.
  • Vyberte volbu Filtrovat > Značky > Knowledge Accelerators.
  • Otevřete dlaždici galerie pro konkrétní odvětví Knowledge Accelerators .

• Přístup ke koncovým bodům Knowledge Accelerators OpenAPI
  Koncové body rozhraní REST API pro instanci IBM Cloud Pak for Data lze najít připojením v1/knowledge_accelerators/api/explorer/ k adrese URL IBM Cloud Pak for Data .

  Například:

  • https://api.dataplatform.cloud.ibm.com se stává https://api.dataplatform.cloud.ibm.com/v1/knowledge_accelerators/api/explorer/

  Tip: Popisy koncových bodů rozhraní API pro Knowledge Accelerators lze najít na adrese https://cloud.ibm.com/apidocs/watson-data-api#getknowledgeaccelerators.

• Výběr položek produktu Knowledge Accelerator pro import

  Při plánování importu obsahu produktu Knowledge Accelerators jsou k dispozici dvě hlavní volby.

  Import výběru obchodních rozsahů

  Výběr obchodních rozsahů produktu Knowledge Accelerator je možné importovat samostatně, například Data Privacy a další obory specifické pro odvětví. Pokud jeden nebo více z těchto obchodních rozsahů existuje pro oblast, o kterou máte zájem, a pokud chcete raději začít s relativně malým počtem obchodních termínů, například 200 až 500, můžete nainstalovat jeden nebo více těchto samostatných rozsahů.

  Import některých nebo všech slovníčků produktu Knowledge Accelerator

  Slovníky Knowledge Accelerators existují pro každý ze čtyř specifických odvětví a obsahují kompletní obchodní slovníček, odvětvové zarovnávací slovníky a všechny obchodní rozsahy. Můžete zvolit import všech nebo vybraných slovníčků. Je-li třeba importovat rozsáhlou sadu obchodních termínů za účelem řešení šíře průmyslu, například z 5000 na 20 000, vyberte tuto volbu.

  Podrobný seznam všech dostupných položek pro každý sektor, včetně definice, identifikátorů a dalších informací, viz odkazy níže.

  • Knowledge Accelerator for Cross Industry
  • Knowledge Accelerator for Energy and Utilities
  • Knowledge Accelerator for Financial Services
  • Knowledge Accelerator for Healthcare
  • Knowledge Accelerator for Insurance

• Ověřování a autorizace

  Chcete-li provést ověření s produktem Cloud Pak for Data, musíte generovat token IAM produktu IBM Cloud .

  1. Získejte klíč rozhraní API. Pokyny naleznete v tématu: https://cloud.ibm.com/docs/account? topic = account-userapikey#create_user_key.
  2. Vygenerujte token IAM pomocí svého klíče rozhraní API. Pokyny naleznete v tématu: https://cloud.ibm.com/docs/account? topic = account-iamtoken_from_apikey.
  3. Klepněte na volbu Autorizovat a v poli Hodnota:vložte hodnotu tokenu.
  4. Jakmile jste autorizováni, klepněte na tlačítko Zavřít. Na tlačítku Autorizovat je zobrazen symbol zámku.

• Kontrola, které položky jsou k dispozici pro import
  Chcete-li zkontrolovat, které Knowledge Accelerators jsou k dispozici pro import, zavolejte na koncový bod rozhraní API GET /v1/knowledge_accelerators Get all Knowledge Accelerators .

  1. Vyberte GET /v1/knowledge_accelerators a klepněte na Vyzkoušejte.
  2. Klepněte na tlačítko Provést.

  Příklad odezvy:

  {
    "počet": 6,
    " knowledgesti_Accelerators:
      {
        "id": "kahc20",
        "name": "Knowledge Accelerator for Healthcare",
        "definice": "IBM Knowledge Accelerator for Healthcare
        Licencované materiály-vlastnictví IBM 
        © Copyright IBM Corp. 2020, 2023. Všechna práva vyhrazena. 
        Documentation pro tuto nabídku https://www.ibm.com/docs/SSQNUZ_4.7.x/ka/ka-cpd.HTML. 
        Oznámení pro tuto nabídku https://www.ibm.com/docs/SSQNUZ_4.7.x/ka/notices.html ",
        "type": "knowledge_accelerator",
        "format": "wkc_glossary",
        "verze": " .....
        …....

• Kontrola, které položky jsou k dispozici pro import na odvětví
  Chcete-li zkontrolovat, které Knowledge Accelerators jsou k dispozici pro import, zavolejte na koncový bod rozhraní API GET /v1/knowledge_accelerators/{id} Get a specific Knowledge Accelerator API.

  1. Vyberte GET /v1/knowledge_accelerators/{id} a klepněte na Vyzkoušejte.
  2. Zadejte hodnotu id pro odvětví Znalostní akcelerátor. Platné hodnoty naleznete v následující tabulce.

     Křížový průmysl	Energie a technické vybavení	finanční služby	Zdravotní péče	Pojištění
     kaci20	kaeu20	kafs20	kahc20	kain20

  3. Klepněte na tlačítko Provést.

  Příklad odezvy:

  {
    "id": "kafs20",
    "name": "Knowledge Accelerators",
    "definice": " Kategorie, která seskupuje artefakty řízení, které se používají v rámci 
  Knowledge Accelerators.
  Licencované materiály-vlastnictví IBM 
  © Copyright IBM Corp. 2020, 2023. Všechna práva vyhrazena.
  Documentation pro tuto nabídku https://www.ibm.com/docs/SSQNUZ_4.7.x/ka/ka-cpd.html
  Oznámení pro tuto nabídku https://www.ibm.com/docs/SSQNUZ_4.7.x/ka/notices.html",
    "type": "knowledge_accelerator", .....
        …....

• Kontrola, který produkt Knowledge Accelerators je již importován
  Chcete-li zkontrolovat, zda jsou některé Knowledge Accelerators naimportovány do instance produktu Watson Knowledge Catalog, volejte na koncový bod rozhraní API GET/v1/knowledge_accelerators/import_items Get what Knowledge Accelerator Items are currently imported into glosář .

  1. Vyberte GET /v1/knowledge_accelerators/import_items a klepněte na Vyzkoušejte.
  2. Klepněte na tlačítko Provést.

  Příklad odezvy:

  {
    "zpráva": "KA008I: Jsou importovány následující položky akcelerační klávesy",
    "import_evaluation": [
      {
        "knowledge_accelerator": "CPD_URL/v1/knowledge_accelerators/kaci20",
        "položky": [
          {
            "id": "personal-data",
            "evaluation": "imported_at_undeterminable_version",
            "latest_version": "2.0.2023XX"

• Import produktu Knowledge Accelerators

  Chcete-li importovat položky Knowledge Accelerators do instance produktu Watson Knowledge Catalog, volejte na koncový bod rozhraní API rozhraní API POST /v1/knowledge_accelerators/{ka_id}/import_items Importovat zadané položky znalostní akcelerátoru do slovníčku .

  1. Vyberte položky, které chcete instalovat. Přečtěte si téma Kontrola položek, které jsou k dispozici pro import , a Kontrola položek, které jsou k dispozici pro import na odvětví.
     Tip: Pro každý průmysl máte možnost importovat specifické obchodní rozsahy nebo celý odvětvový slovník pro obchodní jádro a volitelné odvětvové zarovnání slovníků. Podrobný seznam všech dostupných položek, včetně definice, identifikátorů a dalších informací, viz odkazy níže.

     • Knowledge Accelerator for Cross Industry
     • Knowledge Accelerator for Energy and Utilities
     • Knowledge Accelerator for Financial Services
     • Knowledge Accelerator for Healthcare
     • Knowledge Accelerator for Insurance
  2. Vyberte volbu POST /v1/knowledge_accelerators/{ka_id}/import_items a klepněte na tlačítko Vyzkoušejte.
  3. Zadejte hodnoty pro následující parametry.
     Například:

     Parametr	Popis	Příklad
     ID_ky	ID pro odvětví	kafs20
     ID	ID pro jednu nebo více položek produktu Knowledge Accelerator, které chcete importovat, oddělených čárkou. Vezměte prosím na vědomí, že lze importovat pouze jeden rozsah.	core-bpi,ccpa,fhir, gdpr
     volba_číslo	Volba sloučení, která má být použita při importu do produktu Watson Knowledge Catalog.	all
     závislosti	Označuje, které závislosti uvedených ID položek mají být také importovány.	mandatory
     do_import	Chcete-li zkontrolovat parametry, vyberte volbu false a zjistěte, co bude importováno. Vyberte true pro import.	false

  4. Klepněte na tlačítko Provést.
  5. V odpovědi vezměte na vědomí "process_id", jak jej můžete použít ke kontrole stavu úlohy importu v další sekci, Kontrola stavu úlohy importu. Může být nezbytné nebo žádoucí provést tuto kontrolu, protože někdy může import trvat určitou dobu, v závislosti na počtu a velikosti importovaných položek.

  Pozn.:

  • Pokud importujete více obchodních rozsahů KA KA, některé vztahy ze sdílených artefaktů, jako jsou zásady a pravidla do slovních pojmů, mohou být přepsány následným importem obchodního rozsahu.
  • Pokud importujete Knowledge Accelerators pro více průmyslových odvětví, vztahy ze sdílených artefaktů, jako jsou zásady a pravidla do slovníčku, nemusejí být sloučeny pro následný import-mapování z původně importovaných artefaktů KA se zachová. V protokolu importu se můžete podívat na některé zprávy (GIM00010E nebo GIM00015E), které souvisejí se zásadami a pravidly regulace, které lze ignorovat.

• Kontrola stavu úlohy importu
  Chcete-li zkontrolovat stav importu, zavolejte koncový bod rozhraní API GET/v3/governance_artifact_types/import/status/{process_id} , kde {process_id} je hodnota z části Import Knowledge Accelerators.

  Stav importu zůstane "IN_PROGRESS" , dokud nebudou naimportovány všechny artefakty.

  Příklady odezvy:

  • "IN_PROGRESS": Import právě probíhá a ukazuje, kolik kroků se proces nachází, z celkového počtu kroků.

    ..."status": "IN_PROGRESS",
    ....
        "step_number": 32,
        "total_steps": 50,.....

  • "SUCCEEDED": Odpověď zobrazuje, kolik artefaktů bylo vytvořeno nebo upraveno.

      "process_id": "ea29dd39-f46e-4a8f-beee-297b72d4f7f1",
      "status": "SUCCEEDED",
      "step_number": 50,
      "total_steps": 50,

  • "IMPORT_SYNCHRONIZATION": Proces synchronizace je dokončen a obsah je importován do produktu Watson Knowledge Catalog.

          "process_id": "e0f4c893-54b3-40d6-8e35-42baded25333",
          "type": "IMPORT_SYNCHRONIZATION",
          "name": "Import synchronization process",
          "status": "SUCCEEDED",
          "percentage": 100,

• Přidání spolupracovníků
  Je třeba přidat spolupracovníky do kategorií Knowledge Accelerators , jinak pouze ta osoba, která importuje akcelerátor, může artefakty používat. Podrobnosti o tom, jak to provést, najdete v tématu Správa přístupu ke kategorii .

• Kopírování do projektu
  Navíc můžete přidat artefakty Knowledge Accelerators jako soubory CSV v projektu Cloud Pak for Data pomocí koncového bodu rozhraní API POST /v1/knowledge_accelerators/{ka_id}/copy_items Copy Knowledge Accelerator into project .

  Rada:

  Soubory CSV lze stáhnout lokálně a obsah lze importovat pomocí uživatelského rozhraní produktu Watson Knowledge Catalog . Další informace o tom, jak používat import CSV v produktu Watson Knowledge Catalog, viz téma Import artefaktů regulace podle typu se soubory CSV.

  1. Vyberte volbu POST /v1/knowledge_accelerators/{ka_id}/copy_items a klepněte na tlačítko Vyzkoušejte.
  2. Zadejte ID odvětví produktu Knowledge Accelerator, ID položek, které chcete importovat, a ID projektu a klepněte na tlačítko Provést.

• Souhrn kroků importu a koncových bodů rozhraní API
  Metoda importu a koncové body rozhraní API jsou popsány v následující tabulce.

  Sekce	Koncový bod akce nebo rozhraní API	Popis
  Požadavky a oprávnění		Plán nabídky a uživatelská oprávnění nezbytná k importu Knowledge Accelerators.
  Vyhledání Knowledge Accelerators v galerii
  Přístup ke koncovým bodům Knowledge Accelerators OpenAPI		Jak přistoupit ke koncovým bodům rozhraní REST API.
  Výběr položek produktu Knowledge Accelerator pro import		Výběr artefaktů položek, které mají být importovány, například samostatné obchodní rozsahy nebo úplné slovníček Knowledge Accelerators .
  Ověřování a autorizace	Generujte token produktu IBM Cloud IAM pomocí klíče rozhraní API. Viz https://cloud.ibm.com/docs/account? topic = account-iamtoken_from_apikey.	Generuje token produktu IBM Cloud IAM pro použití s tlačítkem Autorizovat .
  Kontrola, které položky jsou k dispozici pro import	GET /v1/knowledge_accelerators	Vypíše všechny Knowledge Accelerators a položky, které lze importovat spolu se statistikami a závislostmi.
  Kontrola, které položky jsou k dispozici pro import na odvětví	GET /v1/knowledge_accelerators/ {id}	Vypisuje všechny položky, které lze importovat pro konkrétní odvětví, spolu se statistikami a závislostmi.
  Kontrola, která Knowledge Accelerators jsou již importována	GET /v1/knowledge_accelerators/ import_items	Vypisuje všechny Knowledge Accelerators , které jsou již importovány do instance Watson Knowledge Catalog .
  Import produktu Knowledge Accelerators	POST /v1/knowledge_accelerators/ import_items	Importuje položky produktu Knowledge Accelerator.
  Kontrola stavu úlohy importu	GET /v3/governance_artifact_types/ import/status/{process_id}	Kontroluje stav importu.
  Přidání spolupracovníků		Umožňuje ostatním uživatelům přístup k artefaktům.
  Kopírování do projektu	POST /v1/knowledge_accelerators/{ka_id}/copy_items	Zkopírovat položky produktu Knowledge Accelerator jako soubory CSV do projektu.