BMC Helix Remedyforce

統合バージョン: 11.0

ユースケース

  1. インシデントの取り込みを実行する
  2. トリアージ アクションを実行する（レコードの更新/作成/削除）

OAuth 認証を構成する方法

ユーザー名とパスワードを使用する基本認証方法が機能しないことがあります。これは、アカウントで MFA が有効になっている場合に発生することがあります。このような場合は、OAuth 認証を構成する必要があります。

手順:

  1. [設定] -> [アプリマネージャ] に移動します。
  2. [New Connected App] ボタンを押します。
  3. [Connected App Name]（接続アプリ名）、[API Name]（API 名）、[Contact Email]（連絡先メールアドレス）を入力します。
  4. [OAuth 設定の有効化] を true に設定する必要があります。
  5. [コールバック URL] を [https://localhost] に設定します。
  6. 「full」と「refresh_token」のスコープを追加します。API にアクセスするには、両方が必要です。
  7. アプリを保存します。
  8. アプリの構成を開き、[コンシューマ キー] と [コンシューマ シークレット] をコピーします。統合構成では、「コンシューマ キー」は「クライアント ID」、「コンシューマ シークレット」は「クライアント シークレット」です。
  9. 「OAuth 認証コードの取得」アクションに移動します。「リダイレクト URL」は「コールバック URL」です。
  10. アクションを実行します。JSON 結果に認可 URL が含まれます。このリンクをコピーしてブラウザに貼り付ける必要があります。最終的にリダイレクトされ、URL は「https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D」のようになります。「code=」の後のすべてをコピーし、URL デコードを必ず実行してください。%3D は「=」文字です。
  11. 「OAuth 更新トークンの取得」アクションに移動します。「リダイレクト URL」は「コールバック URL」で、「認証コード」は前のリクエストの「コード」です。
  12. すべてが正しく行われた場合、JSON 結果に「refresh_token」が表示されます。
  13. この更新トークンを統合構成にコピーし、テスト実行を行います。

Google Security Operations で BMC Helix Remedyforce の統合を構成する

Google SecOps で統合を構成する方法について詳しくは、統合を構成するをご覧ください。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名 種類 デフォルト値 必須 説明
API ルート 文字列 https://.my.salesforce.com はい BMC Helix Remedyforce インスタンスの API ルート。
ユーザー名 文字列 なし いいえ BMC Helix Remedyforce のユーザー名。
パスワード パスワード なし いいえ BMC Helix Remedyforce のパスワード。
クライアント ID 文字列 なし いいえ 接続されているアプリの BMC Helix Remedyforce クライアント ID。このパラメータは OAuth 認証に必要です。注: このパラメータは、ユーザー名とパスワードによる認証よりも優先されます。
クライアント シークレット パスワード なし いいえ 接続されているアプリの BMC Helix Remedyforce クライアント シークレット。このパラメータは OAuth 認証に必要です。注: このパラメータは、ユーザー名とパスワードによる認証よりも優先されます。
更新トークン パスワード なし いいえ OAuth 認証の更新トークン。
SSL を確認 チェックボックス オン はい 有効になっている場合は、BMC Helix Remedyforce サーバーへの接続用の SSL 証明書が有効であることを確認します。
ログイン API ルート 文字列 https://login.salesforce.com はい BMC Helix Remedyforce で認証に使用される API ルート。

操作

レコードを作成する

説明

BMC Helix Remedyforce でレコードを作成します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
レコードタイプ 文字列 なし はい 作成する必要があるレコードのタイプを指定します。使用可能なレコードの種類がわからない場合は、「レコードの種類のリスト」アクションを実行してください。
レコード ペイロード JSON

{

"field":"value"

}

 はい 必要なフィールドと値がすべて含まれた JSON オブジェクトを指定します。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "id": "0015e000005dVbKAAU",
    "success": true,
    "errors": []
}
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
201（is_success = true）の場合: 「BMC Helix Remedyforce で {レコードタイプ} レコードが正常に作成されました。」

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:「アクション「レコードの作成」の実行エラー。理由: {0}」.format(error.Stacktrace)

400 の場合: 「アクション「レコードの作成」の実行エラー。理由: {メッセージ}。

レコードタイプが見つからなかった場合: アクション「レコードの作成」の実行エラー。理由: {レコードタイプ} が BMC Helix Remedyforce に見つかりませんでした。「レコードタイプのリスト」アクションを使用して、使用可能なレコードタイプのリストを取得してください。

JSON ペイロードが無効な場合: 「アクション「レコードの作成」の実行中にエラーが発生しました。理由: パラメータ「レコード ペイロード」で指定された JSON ペイロードが無効です。構造を確認してください。

 一般

レコードの削除

説明

BMC Helix Remedyforce でレコードを削除します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
レコードタイプ 文字列 なし はい 削除する必要があるレコードのタイプを指定します。使用可能なレコードの種類がわからない場合は、「レコードの種類のリスト」アクションを実行してください。
レコード ID 文字列 なし はい 削除する必要があるレコードの ID を指定します。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
204（is_success = true）の場合: 「BMC Helix Remedyforce で ID {record id} の {レコードタイプ} レコードが正常に削除されました。

404 の場合（is_success=true）:「ID {record id} の {レコードタイプ} レコードは BMC Helix Remedyforce に存在しません。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「レコードの削除」の実行エラー。理由: {0}」.format(error.Stacktrace)

レコードタイプが見つからなかった場合: アクション「レコードの削除」の実行エラー。理由: {レコードタイプ} が BMC Helix Remedyforce に見つかりませんでした。「レコードタイプのリスト」アクションを使用して、使用可能なレコードタイプのリストを取得してください。

 全般

カスタムクエリを実行する

説明

BMC Helix Remedyforce でカスタム SOQL クエリを実行します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
SOQL クエリ 文字列 なし はい 実行するクエリを指定します。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "OwnerId": "00G5e000001mqf7EAA",
    "IsDeleted": false,
    "Name": "00000002",
    "CreatedDate": "2021-05-10T19:00:26.000+0000",
    "CreatedById": "0055e000001zFloAAE",
    "LastModifiedDate": "2021-05-10T19:00:26.000+0000",
    "LastModifiedById": "0055e000001zFloAAE",
    "SystemModstamp": "2021-05-10T19:00:26.000+0000",
    "LastActivityDate": null,
    "LastViewedDate": "2021-05-14T10:26:38.000+0000",
    "LastReferencedDate": "2021-05-14T10:26:38.000+0000",
    "BMCServiceDesk__ACApprovalStatus__c": null,
    "BMCServiceDesk__ACSeverity__c": null,
    "BMCServiceDesk__Actual_Outage_Time_Hours__c": 0.0,
    "BMCServiceDesk__Additional_email_information__c": null,
    "BMCServiceDesk__AllTaskCloseController__c": false,
    "BMCServiceDesk__Approved__c": false,
    "BMCServiceDesk__BLANK__c": null,
    "BMCServiceDesk__Category_ID__c": "Hardware",
    "BMCServiceDesk__RecurringParentRecordId__c": null,
    "BMCServiceDesk__RequestDetailCloneId__c": null,
    "BMCServiceDesk__VIP_Client__c": "-",
    "BMCServiceDesk__WorkflowController__c": null,
    "BMCServiceDesk__actualDuration__c": null,
    "BMCServiceDesk__actualOutageDuration__c": null,
    "BMCServiceDesk__call__c": 1.0,
    "BMCServiceDesk__clientEmail__c": "bmcremedyforcetrial@example.com",
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりしないようにする必要があります。
少なくとも 1 つが見つかった場合（is_success = true）: 「BMC Helix Remedyforce でクエリ「{query}」の結果が正常に返されました。

何も見つからなかった場合（is_success=true）: 「BMC Helix Remedyforce でクエリ「{query}」の結果が見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:「アクション「カスタムクエリの実行」の実行エラー。理由: {0}」.format(error.Stacktrace)

 一般
ケースウォール 名前: 結果 全般

Execute Simple Query

説明

BMC Helix Remedyforce のパラメータに基づいて SOQL クエリを実行します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
レコードタイプ 文字列 なし はい クエリするレコード タイプを指定します。
Where フィルタ 文字列 なし いいえ 実行する必要のあるクエリの WHERE フィルタを指定します。注: 時間フィルタ、制限、並べ替えを指定する必要はありません。また、ペイロードで WHERE 文字列を指定する必要はありません。
期間 DDL

Last Hour

有効な値:

Last Hour

過去 6 時間

過去 24 時間

先週

先月

カスタム

 いいえ 結果の期間を指定します。「カスタム」を選択した場合は、「開始時刻」も指定する必要があります。
開始時刻 文字列 なし いいえ 結果の開始時刻を指定します。[期間] パラメータに [カスタム] が選択されている場合、このパラメータは必須です。形式: ISO 8601
終了時刻 文字列 なし いいえ 結果の終了時刻を指定します。形式: ISO 8601。何も指定されず、「期間」パラメータで「カスタム」が選択されている場合、このパラメータは現在の時刻を使用します。
返されるフィールド CSV なし いいえ 返すフィールドを指定します。何も指定しないと、アクションですべてのフィールドが返されます。
フィールドの並べ替え 文字列 CreatedDate いいえ 並べ替えに使用するパラメータを指定します。
並べ替え順序 DDL

昇順

有効な値:

昇順

DESC

 いいえ 並べ替えの順序を指定します。
返される結果の最大数 整数 50 いいえ 返す結果の数を指定します。デフォルト: 50。 最大値は 200 です。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "OwnerId": "00G5e000001mqf7EAA",
    "IsDeleted": false,
    "Name": "00000002",
    "CreatedDate": "2021-05-10T19:00:26.000+0000",
    "CreatedById": "0055e000001zFloAAE",
    "LastModifiedDate": "2021-05-10T19:00:26.000+0000",
    "LastModifiedById": "0055e000001zFloAAE",
    "SystemModstamp": "2021-05-10T19:00:26.000+0000",
    "LastActivityDate": null,
    "LastViewedDate": "2021-05-14T10:26:38.000+0000",
    "LastReferencedDate": "2021-05-14T10:26:38.000+0000",
    "BMCServiceDesk__ACApprovalStatus__c": null,
    "BMCServiceDesk__ACSeverity__c": null,
    "BMCServiceDesk__Actual_Outage_Time_Hours__c": 0.0,
    "BMCServiceDesk__Additional_email_information__c": null,
    "BMCServiceDesk__AllTaskCloseController__c": false,
    "BMCServiceDesk__Approved__c": false,
    "BMCServiceDesk__BLANK__c": null,
    "BMCServiceDesk__Category_ID__c": "Hardware",
    "BMCServiceDesk__RecurringParentRecordId__c": null,
    "BMCServiceDesk__RequestDetailCloneId__c": null,
    "BMCServiceDesk__VIP_Client__c": "-",
    "BMCServiceDesk__WorkflowController__c": null,
    "BMCServiceDesk__actualDuration__c": null,
    "BMCServiceDesk__actualOutageDuration__c": null,
    "BMCServiceDesk__call__c": 1.0,
    "BMCServiceDesk__clientEmail__c": "bmcremedyforcetrial@example.com",
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりしないようにする必要があります。
少なくとも 1 つが見つかった場合（is_success = true）: 「BMC Helix Remedyforce でクエリ「{query}」の結果が正常に返されました。

何も見つからなかった場合（is_success=true）: 「BMC Helix Remedyforce でクエリ「{query}」の結果が見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:「アクション「単純なクエリの実行」の実行エラー。理由: {0}」.format(error.Stacktrace)

 一般
ケースウォール 名前: 結果 全般

レコードの詳細を取得する

説明

BMC Helix Remedyforce からレコードの詳細情報を取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
レコードタイプ 文字列 なし はい 詳細を取得するレコードのタイプを指定します。使用可能なレコードの種類がわからない場合は、「レコードの種類のリスト」アクションを実行してください。
レコード ID CSV なし はい 詳細を返すレコードの ID を指定します。
返されるフィールド CSV なし いいえ 返すフィールドを指定します。指定されたフィールドが見つからない場合、アクションは失敗します。何も指定しないと、アクションですべてのフィールドが返されます。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "OwnerId": "00G5e000001mqf7EAA",
    "IsDeleted": false,
    "Name": "00000002",
    "CreatedDate": "2021-05-10T19:00:26.000+0000",
    "CreatedById": "0055e000001zFloAAE",
    "LastModifiedDate": "2021-05-10T19:00:26.000+0000",
    "LastModifiedById": "0055e000001zFloAAE",
    "BMCServiceDesk__Total_Duration__c": 0.0,
    "BMCServiceDesk__Incorrect_category__c": false,
    "Client_VIP__c": false,
    "BMCServiceDesk__Incorrect_owner__c": false,
    "BMCServiceDesk__LockedRecordTimestamp__c": null,
    "BMCServiceDesk__Queue__c": "Incident Queue",
    "BMCServiceDesk__Reassigned_Count__c": null,
    "BMCServiceDesk__isServiceRequest__c": false,
    "BMCServiceDesk__Approval_Status__c": null,
    "Alternate_Contact_Name__c": null,
    "Alternate_Contact_Number__c": null,
    "Client_Phone__c": null,
    "External_Ticket_Ref__c": null,
    "Affected_Application__c": null,
    "Affected_Hardware__c": null,
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
少なくとも 1 つの ID のデータが利用可能な場合（is_success = true）: 「次の ID のレコード タイプ {Record Type} に関する詳細が正常に返されました: {record ids}」。

少なくとも 1 つの ID のデータがない場合（is_success=true）: 「アクションでは、次の ID のレコードタイプ {Record Type} に関する詳細情報が見つかりませんでした: {record ids}」。

すべてのデータが利用できない場合（is_success=false）: レコードが見つかりませんでした。

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:「アクション「レコードの詳細を取得」の実行エラー。理由: {0}」.format(error.Stacktrace)

レコードタイプが見つからなかった場合: アクション「レコードの詳細を取得」の実行エラー。理由: {レコードタイプ} が BMC Helix Remedyforce に見つかりませんでした。「レコードタイプのリスト」アクションを使用して、使用可能なレコードタイプのリストを取得してください。

「返されるフィールド」で指定されたフィールドが見つからなかった場合: 「アクション「レコードの詳細を取得」の実行エラー。理由: 指定されたフィールドが見つかりませんでした。スペルを確認してください。」

 全般
Case Wall テーブル

名前: レコード {レコード ID} の詳細

列:

キー

値

 全般

OAuth 認証コードの取得

説明

BMC Helix Remedyforce で OAuth 認証コードを生成します。詳しくは、ドキュメント ポータルをご覧ください。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
リダイレクト URL 文字列 https://localhost はい 「コネクタアプリ」の作成時に使用したリダイレクト URL を指定します。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

「Successfully generated Authorization code URL in BMC Helix Remedyforce. Please copy paste it in the browser. After that, copy the "code" part from the URL. この認証コードは、「OAuth 更新トークンの取得」アクションで使用されます。

 全般
リンク

名前: 認証コードリンク
URL: {生成されたリンク}

OAuth 更新トークンの取得

説明

統合構成に必要な更新トークンを生成します。認証コードは、「OAuth 認証コードの取得」を使用して生成できます。詳しくは、ドキュメント ポータルをご覧ください。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
リダイレクト URL 文字列 https://localhost はい 「コネクタアプリ」の作成時に使用したリダイレクト URL を指定します。
認証コード 文字列 なし はい 「OAuth 認証コードの取得」アクションから認証コードを指定します。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "access_token": "00D090000083B1p!ARkAQHJhzO.oDwNuldyoWlNDlLV9805VyWlZmcBvMF7qetVGpQWXi6pND0riSCiFs4fnrxmuVjBv.Io..ooN_JAIlGdGT_Gk",
    "signature": "6+xAwCccuYI0ivDbXtZzlguynNuKGRHaj+HpyZXM6ms=",
    "scope": "refresh_token api full",
    "instance_url": "https://202107220535170700.my.salesforce.com",
    "id": "https://login.salesforce.com/id/00D090000083B1pEAE/00509000007hMVJAA2",
    "token_type": "Bearer",
    "issued_at": "1626958668640"
}
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりしないようにする必要があります。
200（is_success = true）の場合: 「BMC Helix Remedyforce で更新トークンが正常に生成されました。」

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:「アクション「OAuth 更新トークンの取得」の実行エラー。理由: {0}」.format(error.Stacktrace)

ステータス コードが 200 以外の場合: "Error executing action "Get OAuth Refresh Token".Reason: {0}''.format(error_description)

 全般

レコードタイプの一覧を取得する

説明

BMC Helix Remedyforce の使用可能なレコードタイプを一覧表示します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
フィルタ ロジック DDL

等しい

DDL

等しい

Contains

 いいえ 適用するフィルタ ロジックを指定します。
フィルタ値 文字列 なし いいえ フィルタで使用する値を指定します。「Equal」が選択されている場合、アクションはレコードタイプ間で完全一致の検索を試行します。「Contains」が選択されている場合、アクションはその部分文字列を含むレコードタイプを検索します。このパラメータに何も指定しないと、フィルタは適用されません。
返されるレコードタイプの最大数 Integer 50 いいえ 返すレコードタイプの数を指定します。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりしないようにする必要があります。
少なくとも 1 つが見つかった場合（is_success = true）: 「BMC Helix Remedyforce で指定された条件に基づいて、利用可能なレコードタイプが正常に一覧表示されました。

何も見つからなかった場合（is_success=true）:「BMC Helix Remedyforce で指定された条件に基づくレコード タイプが見つかりませんでした」

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:「アクション「レコードタイプの一覧表示」の実行エラー。理由: {0}」.format(error.Stacktrace)

 一般
ケースウォール

名前: 使用可能なレコードタイプ

列:

名前

ラベル

カスタム

 全般

Ping

説明

[Google Security Operations Marketplace] タブの統合構成ページで提供されるパラメータを使用して、BMC Helix Remedyforce への接続性をテストします。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
成功した場合: 「指定された接続パラメータを使用して BMC Helix Remedyforce サーバーに正常に接続されました。」

アクションが失敗し、ハンドブックの実行が停止します。
成功しなかった場合: 「BMC Helix Remedyforce サーバーへの接続に失敗しました。エラーは {0}」.format(exception.stacktrace)

 全般

レコードの更新

説明

BMC Helix Remedyforce のレコードを更新します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
レコードタイプ 文字列 なし はい 更新する必要があるレコードのタイプを指定します。使用可能なレコードの種類がわからない場合は、「レコードの種類のリスト」アクションを実行してください。
レコード ID 文字列 なし はい 更新する必要があるレコードの ID を指定します。
更新するフィールド JSON

{

"field":"value"

}

 はい 必要なすべてのフィールドと更新する値を含む JSON オブジェクトを指定します。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
204（is_success = true）の場合: 「BMC Helix Remedyforce で {レコード ID} の {レコードタイプ} レコードが正常に更新されました。」

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:「アクション「レコードの更新」の実行エラー。理由: {0}」.format(error.Stacktrace)

404 または 400 の場合: 「アクション「レコードの更新」の実行エラー。理由: {メッセージ}。

レコードタイプが見つからなかった場合: アクション「レコードの更新」の実行エラー。理由: {レコードタイプ} が BMC Helix Remedyforce に見つかりませんでした。「レコードタイプのリスト」アクションを使用して、使用可能なレコードタイプのリストを取得してください。

無効な JSON ペイロードの場合: 「アクション「レコードの更新」の実行エラー。理由: パラメータ「更新するフィールド」で指定された JSON ペイロードが無効です。構造を確認してください。

 全般

Wait For Fields Update

説明

BMC Helix Remedyforce でフィールドが更新されるまで待ちます。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
レコードタイプ 文字列 なし はい 更新を待機するレコードのタイプを指定します。使用可能なレコードの種類がわからない場合は、「レコードの種類のリスト」アクションを実行してください。
レコード ID 文字列 なし はい 更新する必要があるレコードの ID を指定します。
確認するフィールド JSON

{

"field":"value"

}

 はい 必要なフィールドと値がすべて含まれた JSON オブジェクトを指定します。
タイムアウトした場合に失敗 チェックボックス オン はい 有効にすると、すべてのフィールドが更新されなかった場合にアクションが失敗します。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "BMCServiceDesk__FKImpact__c": "a2M5e000000l1HxEAI",
    "BMCServiceDesk__FKIncident__c": null,
    "BMCServiceDesk__FKLead__c": null,
    "BMCServiceDesk__FKOpenBy__c": "0055e000001zFloAAE",
    "BMCServiceDesk__FKPriority__c": "a2h5e000000nHTnAAM",
    "BMCServiceDesk__FKRequestDefinition__c": null,
    "BMCServiceDesk__FKRequestDetail__c": null,
    "BMCServiceDesk__FKServiceOffering__c": null,
    "BMCServiceDesk__FKStatus__c": "a3w5e000000U1xcAAC",
    "BMCServiceDesk__FKTemplate__c": null,
    "BMCServiceDesk__actualOutageDuration__c": null,
    "BMCServiceDesk__call__c": 1.0,
    "Client_VIP__c": false,
    "BMCServiceDesk__Incorrect_owner__c": false,
    "BMCServiceDesk__LockedRecordTimestamp__c": null,
    "BMCServiceDesk__Queue__c": "Incident Queue",
    "BMCServiceDesk__Reassigned_Count__c": null,
    "BMCServiceDesk__isServiceRequest__c": false,
    "BMCServiceDesk__Approval_Status__c": null,
    "Alternate_Contact_Name__c": null,
    "Alternate_Contact_Number__c": null,
    "Client_Phone__c": null,
    "External_Ticket_Ref__c": null,
    "Affected_Application__c": null,
    "Affected_Hardware__c": null,
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
Case Wall
結果のタイプ 値 / 説明 タイプ（エンティティ \ 全般）
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
201（is_success = true）の場合: 「BMC Helix Remedyforce で ID {record id} の {レコードタイプ} レコードが更新されました。」

フィールドの 1 つが更新されず、タイムアウト時に失敗が有効になっていない場合（is_success=false）:「BMC Helix Remedyforce の ID {レコード ID} の {レコードタイプ} レコードで次のフィールドが更新されませんでした: {更新されなかったフィールド}」

非同期メッセージ: BMC Helix Remedyforce の ID {record id} の {record type} レコードで次のフィールドが更新されるのを待機しています: {fields that were not updated}

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:「アクション「フィールドの更新を待機」の実行エラー。理由: {0}」.format(error.Stacktrace)

一部のフィールドが見つからない場合: 「アクション「Wait For Fields Update」の実行中にエラーが発生しました。理由: レコードの構造に次のフィールドが見つかりませんでした: {見つからなかったフィールド}。

レコードタイプが見つからなかった場合: アクション「フィールドの更新を待機」の実行エラー。理由: {レコードタイプ} が BMC Helix Remedyforce に見つかりませんでした。「レコードタイプのリスト」アクションを使用して、使用可能なレコードタイプのリストを取得してください。

フィールドのいずれかが更新されず、タイムアウト時に失敗が有効になっている場合（is_success=false）: 「アクション「フィールドの更新を待機」の実行中にエラーが発生しました。理由: BMC Helix Remedyforce の ID {record id} の {レコードタイプ} レコードで、次のフィールドが更新されませんでした: {更新されなかったフィールド}」

無効な JSON ペイロードの場合: 「アクション「フィールドの更新を待機」の実行中にエラーが発生しました。理由: パラメータ「Fields To Check」で指定された JSON ペイロードが無効です。構造を確認してください。

 全般

コネクタ

BMC Helix Remedyforce - Incidents Connector

説明

BMC Helix Remedyforce からインシデントに関する情報を pull します。

Google SecOps で BMC Helix Remedyforce - Incidents Connector を構成する

Google SecOps でコネクタを構成する方法の詳細については、コネクタの構成をご覧ください。

コネクタ パラメータ

次のパラメータを使用してコネクタを構成します。

パラメータの表示名 種類 デフォルト値 必須 説明
プロダクト フィールド名 文字列 プロダクト名 ○ ソース フィールド名を入力してプロダクト フィールド名を取得します。
イベント フィールド名 文字列 BMCServiceDesk__Type__c はい ソース フィールド名を入力してイベント フィールド名を取得します。
環境フィールド名 文字列 "" いいえ

環境名が保存されるフィールドの名前を記述します。

環境フィールドがない場合、その環境がデフォルトの環境です。
環境の正規表現パターン 文字列 .* いいえ

[環境フィールド名] フィールドで見つかった値に対して実行する正規表現パターン。

デフォルトは、すべてキャッチして値を変更せずに返す .* です。

ユーザーが正規表現ロジックで環境フィールドを操作できるようにするために使用されます。

正規表現パターンが null か空の場合、または環境値が null の場合、最終的な環境の結果はデフォルト環境になります。
スクリプトのタイムアウト（秒） 整数 180 はい 現在のスクリプトを実行している Python プロセスのタイムアウト上限。
API ルート 文字列 https://.my.salesforce.com はい BMC Helix Remedyforce インスタンスの API ルート。
ユーザー名 文字列 なし はい BMC Helix Remedyforce のユーザー名。
パスワード パスワード なし はい BMC Helix Remedyforce のパスワード。
取得する最も低い優先度 Integer 5 いいえ インシデントの取得に使用される最も低い優先度。最大: 5。最小値: 1。何も指定しない場合、コネクタはすべてのインシデントを取り込みます。
優先度のないインシデントを取り込む チェックボックス オン いいえ 有効にすると、コネクタは優先度のないインシデントを取得します。この方法で作成された Google SecOps アラートの優先度は「情報」に設定されます。
タイプ フィルタ CSV Incident,Service Request いいえ インシデントのタイプ フィルタ。何も指定しない場合、コネクタはすべてのインシデントを取り込みます。例: インシデント、サービス リクエスト。
最大遡及時間 整数 1 いいえ インシデントを取得した時点からの経過時間数。
取得する最大インシデント数 Integer 10 いいえ 1 回のコネクタのイテレーションで処理するインシデントの数。最大値は 200 です。
許可リストを拒否リストとして使用 チェックボックス オン はい 有効にすると、許可リストが拒否リストとして使用されます。
SSL を確認 チェックボックス オン はい 有効になっている場合は、BMC Helix Remedyforce サーバーへの接続用の SSL 証明書が有効であることを確認します。
プロキシ サーバーのアドレス 文字列 なし いいえ 使用するプロキシ サーバーのアドレス。
プロキシのユーザー名 文字列 なし いいえ 認証に使用するプロキシのユーザー名。
プロキシ パスワード パスワード なし いいえ 認証に使用するプロキシ パスワード。
クライアント ID 文字列 なし いいえ 接続されているアプリの BMC Helix Remedyforce クライアント ID。このパラメータは OAuth 認証に必要です。注: このパラメータは、ユーザー名とパスワードによる認証よりも優先されます。
クライアント シークレット パスワード なし いいえ 接続されているアプリの BMC Helix Remedyforce クライアント シークレット。このパラメータは OAuth 認証に必要です。注: このパラメータは、ユーザー名とパスワードによる認証よりも優先されます。
ログイン API ルート 文字列 https://login.salesforce.com はい BMC Helix Remedyforce で認証に使用される API ルート。

コネクタ ルール

プロキシのサポート

コネクタはプロキシをサポートしています。

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。