コンテンツにスキップ

ケースリンクの管理🔗

ケース上の外部システム(ServiceNow、4Me など)または内部リソースへのリンクを作成、更新、削除します。

mutation createCaseLink($input: CreateCaseLinkInput!) {
    createCaseLink(input: $input) {
        id
        caseId
        url
        title
        type
        isInternal
        createdAt
    }
}

変数🔗

{
    "input": {
        "caseId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "url": "https://company.service-now.com/nav_to.do?uri=/incident.do?sys_id=123abc",
        "reference": "INC0123456",
        "title": "ServiceNow Incident",
        "type": "ServiceNow",
        "isInternal": false
    }
}

更新は部分的です(PATCH セマンティクス)— 指定されたフィールドのみが変更されます。

mutation updateCaseLink($input: UpdateCaseLinkInput!) {
    updateCaseLink(input: $input) {
        id
        caseId
        url
        title
        type
        isInternal
        updatedAt
    }
}

変数🔗

{
    "input": {
        "id": "550e8400-e29b-41d4-a716-446655440400",
        "title": "ServiceNow Incident (Resolved)",
        "reference": "INC0123456"
    }
}
mutation deleteCaseLink($input: DeleteCaseLinkInput!) {
    deleteCaseLink(input: $input) {
        id
        caseId
        url
    }
}

変数🔗

{
    "input": {
        "id": "550e8400-e29b-41d4-a716-446655440400"
    }
}

注意🔗

  • リンクは外部システム(ServiceNow、4Me など)または内部リソースを参照できます。
  • reference はリンク先リソースの任意の識別子です。
  • isInternal のリンクは内部ユーザーにのみ表示され、デフォルトは false です。これを true に設定できるのは、パートナー/MDR プロバイダーユーザーのみです。
  • ケースの既存のリンクは、case クエリの links フィールドから取得します。ケースの取得 を参照してください。
  • deleteCaseLink は完全削除です。データは復元できません。