---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ProcessMiningIntegrationAPI :スコープ指定

# ProcessMiningIntegrationAPI :スコープ指定 {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：35分

ProcessMiningIntegrationAPI スクリプトインクルードは、プロセスマイニングプロジェクトを管理し、結果とブレークダウンを取得するためのメソッドを提供します。

このスクリプトインクルードには、プロセスマイニングプラグイン (sn_po) が必要です。詳細については、「[Process Mining](https://www.servicenow.com/docs/access?context=process-mining&version=australia&pubname=australia-now-intelligence&ft:locale=en-US)」を参照してください。

呼び出し元ユーザーには、sn_process_mining_analyst または sn_process_mining_power_user ロールが必要です。  
次のシステムプロパティを使用して、API 機能を管理できます。

promin.limit.api.project_creation

:   API を使用して毎日作成できるプロジェクトの数を制限します。デフォルト値:25。

promin.limit.api.max_daily_minings

:   API を使用して毎日スケジュールできるマイニングの数を制限します。 デフォルト値:25。

promin.limit.api.max_daily_minings_per_project

:   API を使用してプロジェクトごとに毎日スケジュールできるマイニングの数を制限します。デフォルト値は 1 です。

promin.api.allow_no_role_mining

:   sn_process_mining_analyst ロールを持たないユーザーがプロジェクトをマイニングできるようにします。デフォルト値:false。

promin.api.auto_share_project_with_creator

:   プロジェクトの作成者とプロジェクトを自動的に共有します。デフォルト値:false。

## ProcessMiningIntegrationAPI - createProject(文字列テーブル、アレイアクティビティ、アレイブレークダウン、文字列 encodedQuery、文字列 templateType、オブジェクト権限、ブール値 autoRetire) {#ariaid-title2}

プロセスマイニングプロジェクトを作成します。
プロジェクトは、プロセスマイニング操作の詳細計画として機能します。マイニングが行われるプロセスと、マイニング中に考慮されるプロセスの属性を選択します。
{#ProcMinInt-createProj_S_O_O_S_S_O_B__table_xs3_lqs_kdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| table | 文字列 | 分析するデータを含むテーブルの名前。 |
| アクティビティ | アレイ | プロジェクトのアクティビティ定義。 アクティビティ定義は、ステータスやアサイン先グループなど、マイニング中に考慮するプロセスの属性です。tableパラメーターで指定されたテーブルの列である必要があります。プロジェクトをマイニングするには、少なくとも 1 つのアクティビティ定義が必要です。アクティビティ定義の詳細については、「 [Set activity definitions](https://www.servicenow.com/docs/access?context=set-activity-def&version=australia&pubname=australia-now-intelligence&ft:locale=en-US)」を参照してください。 注: アクティビティ定義は、 templateType パラメーターで指定されたプロジェクトテンプレートにも含まれます。activities パラメーターを使用して、テンプレートに含まれていない追加のアクティビティを指定します。 ["<column_name>"] |
| ブレークダウン | アレイ | プロジェクトのブレークダウン定義。 ブレークダウン定義を使用すると、レコードをフィルタリングし、優先度やビジネスカテゴリなどのカテゴリ別にプロセスマップを分析できます。tableパラメーターで指定されたテーブルの列である必要があります。プロジェクトをマイニングするためにブレークダウン定義は必要ありません。ブレークダウン定義の詳細については、「 [Set breakdown definitions](https://www.servicenow.com/docs/access?context=breakdown&version=australia&pubname=australia-now-intelligence&ft:locale=en-US)」を参照してください。 注: ブレークダウン定義は、 templateType パラメーターで指定されたプロジェクトテンプレートにも含まれます。breakdowns パラメーターを使用して、テンプレートに含まれていない追加のブレークダウンを指定します。 ["<column_name>"] |
| encodedQuery | 文字列 | 分析するデータを選択するためのエンコードクエリ。これにより、指定した期間のデータのみを選択するなどして、分析されるデータを制限できます。 テーブルのすべてのデータを含めるには、空の文字列を渡します。 |
| templateType | 文字列 | プロジェクトに使用するテンプレートのタイプ。 有効な値： * デフォルト * デジタルポートフォリオ管理 * ベンダー管理 * WFO {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_xgh_dzh_xdc} ワークフォース最適化 (WFO)、ベンダー管理、または デジタルポートフォリオ管理 の一部ではないプロジェクトの場合は、\[デフォルト\] を選択します。たとえば、パフォーマンスアナリティクスプロジェクトを作成するには、\[デフォルト\] を選択します。 |
| permissions | オブジェクト | プロジェクトを共有するグループ、ロール、およびユーザーのマップ。キーはsys_idで、値はタイプ (グループ、ロール、またはユーザー) を指定します。 プロジェクトを共有しているすべてのユーザーは、分析されたモデルを表示し、プロジェクト構成を表示できます。sn_process_optimization_analystまたはsn_process_optimization_power_userを持つユーザーのみがプロジェクトをマイニングできます。 { "<user_sys_id>":"user", "<role_sys_id>":"role", "<group_sys_id>":"group" } |
| autoRetire | ブーリアン | オプション。プロジェクトを自動的に廃止するかどうかを示すフラグ。 有効な値： * true:プロジェクトは作成から 7 日後に自動的に廃止されます。 * false:プロジェクトは自動的に廃止されません。 {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_kq1_jck_xdc} デフォルト値：False |
[表 : 1. パラメーター]

{#ProcMinInt-createProj_S_O_O_S_S_O_B__table_xs3_lqs_kdc} {#ProcMinInt-createProj_S_O_O_S_S_O_B__id_x1l_krq_c2c__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | プロジェクトに関する情報を含むオブジェクト。 { "entity": {Object}, "findingDefinitionKPIMap": {Object}, "id": "String", "lastMined": String", "miningState": "String", "name": "String", "permissions": [Array], "retiredDate": "String" } |
| \<Object\>.entity | プロジェクトで分析されたデータに関する情報を含むオブジェクト。 データタイプ: オブジェクト { "activityDefinitions": [Array], "breakdownDefinitions": [Array], "condition": "String," "table": "String" } |
| \<Object\>.entity.activityDefinitions | プロジェクトのアクティビティ定義。 データタイプ：アレイ [ { "activityOfInterest":Boolean, "field":"String", "type":"String" } ] |
| \<Object\>.entity.activityDefinitions.activityOfInterest | フィールドの変更をアナリストワークベンチに表示するかどうかを示すフラグ。 有効な値： * true:フィールドの変更がアナリストワークベンチに表示されます。 * false:フィールドの変更はアナリストワークベンチには表示されませんが、移行または検出結果のコンテキスト条件で引き続き使用できます。 {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_hds_v2k_xdc} |
| \<Object\>.entity.activityDefinitions.field | 分析するデータを含むフィールド。フィールドは、 table パラメーターで指定されたテーブルからのものである必要があります。 |
| \<Object\>.entity.activityDefinitions.type | マイニングする値のタイプ。 有効な値： * フィールド値 (デフォルト):これがデフォルトの選択です。このオプションは、アクティビティ定義を作成するたびに使用できます。 * 日時:監査履歴ではなく実際のレコードの日時値を使用し、プロセスマップにグループ化されたノードとして表示されます。 * 複合:監査履歴ではなく実際のレコードの複数フィールド値の変化を表す 1 つのノードまたはプロセスグラフ。 * 添付された子:このオプションは、テーブル構成用に 2 つのテーブルを選択し、子親関係を設定している場合に使用できます。このオプションは、親テーブル構成でのみ使用できます。可視化では、プロセスで子がいつ添付されたかが表示されます。 * 添付された親:このオプションは、親レコードがいつ子に添付されたかを表すノードを子プロセスに作成します。 {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_bjc_ffk_xdc} |
| \<Object\>.entity.breakdownDefinitions | プロジェクトのブレークダウン定義。 データタイプ：アレイ [ { "field":"String", "fieldLabel":"String" } ] |
| \<Object\>.entity.breakdownDefinitions.field | ブレークダウンで使用されるフィールドの名前。 データタイプ：文字列 |
| \<Object\>.entity.breakdownDefinitions.fieldLabel | ブレークダウンで使用されるフィールドのラベル。 データタイプ：文字列 |
| \<Object\>.entity.condition | 分析するデータを選択するためのエンコードクエリ。 データタイプ：文字列 |
| \<Object\>.entity.table | 分析するデータを含むテーブルの名前。 データタイプ：文字列 |
| \<Object\>.findingDefinitionKPIMap | 改善の機会と重要業績評価指標 (KPI) のマップ。マップキーは改善の機会sys_idであり、値は改善の機会の影響を受ける KPI のsys_idsのアレイです。 改善の機会は、検索定義 \[promin_finding_def\] テーブルと自動検索定義 \[promin_automated_finding\] テーブルにあります。KPI はインジケーター \[pa_indicators\] テーブルにあります。 改善の機会と KPI の詳細については、「 [Setting improvement opportunities](https://www.servicenow.com/docs/access?context=working-with-imp-opp&version=australia&pubname=australia-now-intelligence&ft:locale=en-US) と [Viewing business insights](https://www.servicenow.com/docs/access?context=view-business-findings&version=australia&pubname=australia-now-intelligence&ft:locale=en-US)」を参照してください。 データタイプ: オブジェクト { "<finding_def_sys_id":[ "<kpi_sys_id>" ] } |
| \<Object\>.id | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] データタイプ：文字列 |
| \<Object\>.lastMined | プロジェクトが最後にマイニングされた日付。 データタイプ：文字列 |
| \<Object\>.miningState | プロジェクトのマイニング状況。 マイニング状況の説明については、「 [Mining states](https://www.servicenow.com/docs/access?context=generate-process-map&version=australia&pubname=australia-now-intelligence&section=extraction-states&ft:locale=en-US)」を参照してください。 データタイプ：文字列 |
| \<Object\>.name | プロジェクトの名前。 データタイプ：文字列 |
| \<Object\>.permissions | プロジェクトのグループ権限、ロール権限、およびユーザー権限。 データタイプ: オブジェクト [ { "type":"String", "value":"String" } ] |
| \<Object\>.permissions.type | 権限のタイプ。 有効な値： * グループ * ロール * ユーザー {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_unx_q1l_ydc} データタイプ：文字列 |
| \<Object\>.permissions.value | 権限を付与するグループ、ロール、またはユーザーのSys_id。 データタイプ：文字列 |
| \<Object\>.retiredDate | プロジェクトが廃止される日付。 データタイプ：文字列 |
[表 : 2. 返される内容]

{#ProcMinInt-createProj_S_O_O_S_S_O_B__id_x1l_krq_c2c}  
この例では、先月作成されたインシデントのデータを使用してプロジェクトを作成します。

    SNC.ProcessMiningIntegrationAPI
    .createProject(
    "incident", // table name
    ["state"], // activity definitions
    ["priority"], // breakdown definitions
    "sys_created_onONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()", // incident created on last month
    "DEFAULT", // template type
    {"02acf036b3120010ed7fc9c316a8dc0c":"user"}, // map of permissions "sys_id":"type"
    true // auto retire project
    );

出力：

    {
       "entity":{
          "table":"incident",
          "condition":"sys_created_onONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()",
          "activityDefinitions":[
             {
                "field":"assignment_group",
                "type":"DEFAULT",
                "activityOfInterest":false
             },
             {
                "field":"business_service",
                "type":"DEFAULT",
                "activityOfInterest":false
             },
             {
                "field":"category",
                "type":"DEFAULT",
                "activityOfInterest":false
             },
             {
                "field":"priority",
                "type":"DEFAULT",
                "activityOfInterest":false
             },
             {
                "field":"state",
                "type":"DEFAULT",
                "activityOfInterest":false
             }
          ],
          "breakdownDefinitions":[
             {
                "field":"contact_type",
                "fieldLabel":"Channel"
             },
             {
                "field":"assignment_group",
                "fieldLabel":"Assignment group"
             },
             {
                "field":"location",
                "fieldLabel":"Location"
             },
             {
                "field":"priority",
                "fieldLabel":"Priority"
             },
             {
                "field":"category",
                "fieldLabel":"Category"
             }
          ]
       },
       "name":"Incident Process",
       "permissions":[
          {
             "value":"62826bf03710200044e0bfc8bcbe5df1",
             "type":"user"
          },
          {
             "value":"02acf036b3120010ed7fc9c316a8dc0c",
             "type":"user"
          }
       ],
       "id":"a4286c4f4f831210c98b8a4a91ce0bf5",
       "miningState":"NEW",
       "findingDefinitionKPIMap":{
          "f23c20c34fc31210c98b8a4a91ce0bac":[
             "002d65c3d7131100b96d45a3ce6103e2"
          ]
       },
       "retiredDate":null,
       "lastMined":null
    }

## ProcessMiningIntegrationAPI - deleteProject(文字列 projectId) {#ariaid-title3}

プロセスマイニングプロジェクトを削除します。
{#ProcMinInt-deleteProject_S__table_cfn_f5t_kdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| projectId | 文字列 | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] |
[表 : 3. パラメーター]

{#ProcMinInt-deleteProject_S__table_cfn_f5t_kdc} {#ProcMinInt-deleteProject_S__table_dfn_f5t_kdc__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 4. 返される内容]

{#ProcMinInt-deleteProject_S__table_dfn_f5t_kdc}  
この例では、プロセスマイニングプロジェクトを削除します。

    SNC.ProcessMiningIntegrationAPI.deleteProject("a4286c4f4f831210c98b8a4a91ce0bf5");

## ProcessMiningIntegrationAPI - getBreakDownStats(文字列 projectId) {#ariaid-title4}

プロセスマイニングプロジェクトのブレークダウン統計情報を取得します。
ブレークダウンを使用すると、レコードをフィルタリングし、優先度やビジネスカテゴリなどのカテゴリ別にプロセスを分析できます。
{#ProcMinInt-getBreakDownStats_S__table_qqp_l5t_kdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| projectId | 文字列 | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] |
[表 : 5. パラメーター]

{#ProcMinInt-getBreakDownStats_S__table_qqp_l5t_kdc} {#ProcMinInt-getBreakDownStats_S__table_rqp_l5t_kdc__entry__2}

| タイプ | 説明 |
|-|-|
| アレイ | ブレークダウンオブジェクトのアレイ。各オブジェクトには、ブレークダウンの統計情報が含まれています。 [ { "caseCount": Number, "field": "String", "fieldValue": "String", "performanceStats": {Object}, "tableName": "String", "variantCount": Number } ] |
| \<Array\>.caseCount | このブレークダウンに含まれているケースレコード \[promin_case_record\] テーブルのケースの数。 データタイプ：数値 |
| \<Array\>.field | ブレークダウンに使用されるフィールド。 データタイプ：文字列 |
| \<Array\>.fieldValue | ブレークダウンに使用されるフィールド値。 データタイプ：文字列 |
| \<Array\>.performanceStats | ブレークダウンのパフォーマンス統計情報。 { "max": Number, "mean": Number, "median": Number, "min": Number, "n": Number, "q1": Number, "q3": Number, "q4": Number, "stdDeviation": Number, "sum": Number, "total": Number, "trimmedAverage": Number, "trimmedPercentage": Number } データタイプ: オブジェクト |
| \<アレイ\>.performanceStats.max | レコードがルートを完了するまでにかかった最長時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.mean | レコードがオープンされてからクローズされるまでの、レコードがルートを完了するのにかかった平均時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.median | 期間の中央値、または中央の 2 つの値の平均。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.min | レコードがルートを完了するまでにかかった最短時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.n | このブレークダウンの一部であるレコードの数。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.q1 | 期間の最初の四分位値。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.q3 | 期間の第 3 四分位値。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.q4 | 期間の 4 番目の四分位値 (最大)。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.stdDeviation | ルート期間の平均値からの偏差。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.sum | ルートをたどるすべてのレコードについて、最初のイベントから最後のイベントまでのすべての期間の合計時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.total | ルートをたどるすべてのレコードについて、最初のイベントから最後のイベントまでのすべての期間の合計時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.trimmedAverage | レコードがルートを完了するのにかかった平均時間。最小値と最大値の割合を削除した後に計算されます。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.trimmedPercentage | trimmedAverage値の計算に使用されるパーセンテージ。 データタイプ：数値 |
| \<Array\>.tableName | ブレークダウンに使用されるテーブル。 データタイプ：文字列 |
| \<Array\>.variantCount | このブレークダウンに対応するバリアント (プロセスで実行されるアクティビティの一意のシーケンス) の数。 データタイプ：数値 |
[表 : 6. 返される内容]

{#ProcMinInt-getBreakDownStats_S__table_rqp_l5t_kdc}  
この例では、プロジェクトのブレークダウン統計情報を取得します。

    SNC.ProcessMiningIntegrationAPI.getBreakDownStats("a4286c4f4f831210c98b8a4a91ce0bf5");

出力：

    [
       {
          "fieldValue":"1",
          "field":"priority",
          "tableName":"incident",
          "variantCount":21,
          "caseCount":33,
          "performanceStats":{
             "sum":6.4945381E7,
             "min":0.0,
             "max":5.2334704E7,
             "n":33,
             "median":0.0,
             "mean":0.0,
             "total":64945381,
             "stdDeviation":9144841.0,
             "trimmedAverage":165594.0,
             "trimmedPercentage":-1.0,
             "q1":0.0,
             "q3":313333.0,
             "q4":5.2334704E7
          }
       }
    ]

## ProcessMiningIntegrationAPI - getFindings(文字列 projectId) {#ariaid-title5}

プロセスマイニングプロジェクトの結果を取得します。
{#ProcMinInt-getFindings_S__table_syh_k5t_kdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| projectId | 文字列 | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] |
[表 : 7. パラメーター]

{#ProcMinInt-getFindings_S__table_syh_k5t_kdc} {#ProcMinInt-getFindings_S__table_tyh_k5t_kdc__entry__2}

| タイプ | 説明 |
|-|-|
| アレイ | 検出結果オブジェクトのアレイ。 [ { "caseIds":[Array], "category": "String", "categoryDescription": "String", "categoryLabel": "String", "createdOn": Number, "findingDefId": "String", "id": "String", "impactedKpis": [Array], "matchingRecords": Number, "message": "String", "performanceStats": {Object}, "shortMessage": "String", "tableName": "String", "totalRecords": Number, "type": "String", "typeLabel": "String", "versionId": "String" } ] |
| \<Array\>.caseIds | 検索パターンに一致するケースの ID のリスト。ケースレコード \[promin_case_record\] テーブルのケース ID 列にあります。 データタイプ：アレイ |
| \<Array\>.category | 検出結果のカテゴリ。 可能な値： * 自動化 * COMPLIANCE * 適合率 * コスト * パフォーマンス * 品質 * 速度 {#ProcMinInt-getFindings_S__ul_u2f_1kq_c2c} データタイプ：文字列 |
| \<Array\>.categoryDescription | 結果カテゴリの説明。 データタイプ：文字列 |
| \<Array\>.categoryLabel | 検索結果カテゴリのラベル。 データタイプ：文字列 |
| \<Array\>.createdOn | 検出結果の作成日。 データタイプ：数値 |
| \<Array\>.findingDefId | 改善の機会のSys_id。 改善の機会は、検索定義 \[promin_finding_def\] テーブルと自動検索定義 \[promin_automated_finding\] テーブルにあります。 データタイプ：文字列 |
| \<Array\>.id | 検出結果のSys_id。結果 \[promin_finding\] テーブルにあります。 データタイプ：文字列 |
| \<Array\>.impactedKpis | 検出結果の影響を受ける KPI のsys_idsのリスト。インジケーター \[pa_indicators\] テーブルにあります。 データタイプ：アレイ |
| \<Array\>.matchingRecords | 検索パターンに一致するケースレコード \[promin_case_record\] テーブルのケース ID の数。 データタイプ：数値 |
| \<Array\>.message | 改善の機会からのメッセージ。 データタイプ：文字列 |
| \<Array\>.performanceStats | 検出結果のパフォーマンス統計情報。 { "max": Number, "mean": Number, "median": Number, "min": Number, "n": Number, "q1": Number, "q3": Number, "q4": Number, "stdDeviation": Number, "sum": Number, "total": Number, "trimmedAverage": Number, "trimmedPercentage": Number } データタイプ: オブジェクト |
| \<アレイ\>.performanceStats.max | レコードがルートを完了するまでにかかった最長時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.mean | レコードがオープンされてからクローズされるまでの、レコードがルートを完了するのにかかった平均時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.median | 期間の中央値、または中央の 2 つの値の平均。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.min | レコードがルートを完了するまでにかかった最短時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.n | この検出結果の一部であるレコードの数。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.q1 | 期間の最初の四分位値。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.q3 | 期間の第 3 四分位値。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.q4 | 期間の 4 番目の四分位値 (最大)。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.stdDeviation | ルート期間の平均値からの偏差。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.sum | ルートをたどるすべてのレコードについて、最初のイベントから最後のイベントまでのすべての期間の合計時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.total | ルートをたどるすべてのレコードについて、最初のイベントから最後のイベントまでのすべての期間の合計時間。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.trimmedAverage | レコードがルートを完了するのにかかった平均時間。最小値と最大値の割合を削除した後に計算されます。 データタイプ：数値 単位：ミリ秒 |
| \<Array\>.performanceStats.trimmedPercentage | trimmedAverage値の計算に使用されるパーセンテージ。 データタイプ：数値 |
| \<Array\>.shortMessage | 改善の機会からの短いメッセージ。 データタイプ：文字列 |
| \<Array\>.tableName | 検出結果で使用されたテーブルの名前。 データタイプ：文字列 |
| \<Array\>.totalRecords | マイニングで分析されたレコードの合計数。 データタイプ：数値 |
| \<Array\>.type | 改善の機会のタイプ。 可能な値： * EXTRA_STEP * EXTREME_DURATION * EXTREME_REPETITION * OTHER * パターン * PERFORMANCE_OUTLIER * ピンポン * やり直し {#ProcMinInt-getFindings_S__ul_jzp_smq_c2c} 詳細については、「[Setting Automated improvement opportunities](https://www.servicenow.com/docs/access?context=automated-findings&version=australia&pubname=australia-now-intelligence&ft:locale=en-US)」を参照してください。 |
| \<Array\>.typeLabel | 改善の機会タイプのラベル。 データタイプ：文字列 |
| \<Array\>.versionId | プロジェクトバージョンのSys_id。プロジェクト定義バージョン \[promin_model_def_version\] テーブルにあります。 データタイプ：文字列 |
[表 : 8. 返される内容]

{#ProcMinInt-getFindings_S__table_tyh_k5t_kdc}  
この例では、プロジェクトの結果を取得します。

    SNC.ProcessMiningIntegrationAPI.getFindings("a4286c4f4f831210c98b8a4a91ce0bf5");

出力：

    [
       {
          "message":"Rework on Closed",
          "id":"0ef09b2e1c6cf0d98045e6ba1c3c9edb",
          "type":"REWORK",
          "createdOn":1727036052.000000000,
          "category":"AUTOMATION",
          "tableName":"incident",
          "categoryLabel":"Automation",
          "matchingRecords":111,
          "versionId":"9a2f187177b412102f7a1b56ba5a99e2",
          "totalRecords":19758,
          "findingDefId":"791f587177b412102f7a1b56ba5a99eb",
          "categoryDescription":"Category that groups all opportunities that are subject to automation.",
          "impactedKpis":[
             
          ],
          "performanceStats":{
             "sum":2.09532828E8,
             "min":1.0,
             "max":6563078.0,
             "n":111,
             "median":1036715.0,
             "mean":1.0,
             "total":209532828,
             "stdDeviation":1855944.0,
             "trimmedAverage":1716904.0,
             "trimmedPercentage":-1.0,
             "q1":776859.0,
             "q3":2246368.0,
             "q4":6563078.0
          },
          "typeLabel":"Automation",
          "shortMessage":"Closed",
          "caseIds":[
             "119e4a569397fd14849bbcd74dba1018",
             "b16b355f47197190498cc044846d43b0",
             "cf9bca7597fe7d90ef889504a253af9e",
          ]
       }
    ]

## ProcessMiningIntegrationAPI - getMiningStatus(文字列 projectId) {#ariaid-title6}

プロセスマイニングプロジェクトのマイニングステータスを取得します。
{#ProcMinInt-getMiningStatus_S__table_r12_j5t_kdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| projectId | 文字列 | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] |
[表 : 9. パラメーター]

{#ProcMinInt-getMiningStatus_S__table_r12_j5t_kdc} {#ProcMinInt-getMiningStatus_S__table_s12_j5t_kdc__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | プロジェクトsys_idとトラッカーを含むオブジェクト。 { "projectId":"String", "trackerId":"String" } |
| \<Object\>.projectId | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] データタイプ：文字列 |
| \<Object\>.trackerId | プロジェクトのマイニングの進行状況を監視するトラッカーのSys_id。 テーブル:実行トラッカー \[sys_execution_tracker\] データタイプ：文字列 |
[表 : 10. 返される内容]

{#ProcMinInt-getMiningStatus_S__table_s12_j5t_kdc}  
この例では、プロジェクトのマイニングステータスを取得します。

    SNC.ProcessMiningIntegrationAPI.getMiningStatus("c0b91f0cff01121047cae835f2cb14bc");

出力：

    {
       "trackerId":"aec9530cff01121047cae835f2cb147e",
       "projectId":"c0b91f0cff01121047cae835f2cb14bc"
    }

## ProcessMiningIntegrationAPI - getProject(文字列 projectId) {#ariaid-title7}

プロセスマイニングプロジェクトを取得します。
{#ProcMinInt-getProject_S__table_ik3_d5t_kdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| projectId | 文字列 | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] |
[表 : 11. パラメーター]

{#ProcMinInt-getProject_S__table_ik3_d5t_kdc} {#ProcMinInt-getProject_S__id_x1l_krq_c2c__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | プロジェクトに関する情報を含むオブジェクト。 { "entity": {Object}, "findingDefinitionKPIMap": {Object}, "id": "String", "lastMined": String", "miningState": "String", "name": "String", "permissions": [Array], "retiredDate": "String" } |
| \<Object\>.entity | プロジェクトで分析されたデータに関する情報を含むオブジェクト。 データタイプ: オブジェクト { "activityDefinitions": [Array], "breakdownDefinitions": [Array], "condition": "String," "table": "String" } |
| \<Object\>.entity.activityDefinitions | プロジェクトのアクティビティ定義。 データタイプ：アレイ [ { "activityOfInterest":Boolean, "field":"String", "type":"String" } ] |
| \<Object\>.entity.activityDefinitions.activityOfInterest | フィールドの変更をアナリストワークベンチに表示するかどうかを示すフラグ。 有効な値： * true:フィールドの変更がアナリストワークベンチに表示されます。 * false:フィールドの変更はアナリストワークベンチには表示されませんが、移行または検出結果のコンテキスト条件で引き続き使用できます。 {#ProcMinInt-getProject_S__ul_hds_v2k_xdc} |
| \<Object\>.entity.activityDefinitions.field | 分析するデータを含むフィールド。フィールドは、 table パラメーターで指定されたテーブルからのものである必要があります。 |
| \<Object\>.entity.activityDefinitions.type | マイニングする値のタイプ。 有効な値： * フィールド値 (デフォルト):これがデフォルトの選択です。このオプションは、アクティビティ定義を作成するたびに使用できます。 * 日時:監査履歴ではなく実際のレコードの日時値を使用し、プロセスマップにグループ化されたノードとして表示されます。 * 複合:監査履歴ではなく実際のレコードの複数フィールド値の変化を表す 1 つのノードまたはプロセスグラフ。 * 添付された子:このオプションは、テーブル構成用に 2 つのテーブルを選択し、子親関係を設定している場合に使用できます。このオプションは、親テーブル構成でのみ使用できます。可視化では、プロセスで子がいつ添付されたかが表示されます。 * 添付された親:このオプションは、親レコードがいつ子に添付されたかを表すノードを子プロセスに作成します。 {#ProcMinInt-getProject_S__ul_bjc_ffk_xdc} |
| \<Object\>.entity.breakdownDefinitions | プロジェクトのブレークダウン定義。 データタイプ：アレイ [ { "field":"String", "fieldLabel":"String" } ] |
| \<Object\>.entity.breakdownDefinitions.field | ブレークダウンで使用されるフィールドの名前。 データタイプ：文字列 |
| \<Object\>.entity.breakdownDefinitions.fieldLabel | ブレークダウンで使用されるフィールドのラベル。 データタイプ：文字列 |
| \<Object\>.entity.condition | 分析するデータを選択するためのエンコードクエリ。 データタイプ：文字列 |
| \<Object\>.entity.table | 分析するデータを含むテーブルの名前。 データタイプ：文字列 |
| \<Object\>.findingDefinitionKPIMap | 改善の機会と重要業績評価指標 (KPI) のマップ。マップキーは改善の機会sys_idであり、値は改善の機会の影響を受ける KPI のsys_idsのアレイです。 改善の機会は、検索定義 \[promin_finding_def\] テーブルと自動検索定義 \[promin_automated_finding\] テーブルにあります。KPI はインジケーター \[pa_indicators\] テーブルにあります。 改善の機会と KPI の詳細については、「 [Setting improvement opportunities](https://www.servicenow.com/docs/access?context=working-with-imp-opp&version=australia&pubname=australia-now-intelligence&ft:locale=en-US) と [Viewing business insights](https://www.servicenow.com/docs/access?context=view-business-findings&version=australia&pubname=australia-now-intelligence&ft:locale=en-US)」を参照してください。 データタイプ: オブジェクト { "<finding_def_sys_id":[ "<kpi_sys_id>" ] } |
| \<Object\>.id | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] データタイプ：文字列 |
| \<Object\>.lastMined | プロジェクトが最後にマイニングされた日付。 データタイプ：文字列 |
| \<Object\>.miningState | プロジェクトのマイニング状況。 マイニング状況の説明については、「 [Mining states](https://www.servicenow.com/docs/access?context=generate-process-map&version=australia&pubname=australia-now-intelligence&section=extraction-states&ft:locale=en-US)」を参照してください。 データタイプ：文字列 |
| \<Object\>.name | プロジェクトの名前。 データタイプ：文字列 |
| \<Object\>.permissions | プロジェクトのグループ権限、ロール権限、およびユーザー権限。 データタイプ: オブジェクト [ { "type":"String", "value":"String" } ] |
| \<Object\>.permissions.type | 権限のタイプ。 有効な値： * グループ * ロール * ユーザー {#ProcMinInt-getProject_S__ul_unx_q1l_ydc} データタイプ：文字列 |
| \<Object\>.permissions.value | 権限を付与するグループ、ロール、またはユーザーのSys_id。 データタイプ：文字列 |
| \<Object\>.retiredDate | プロジェクトが廃止される日付。 データタイプ：文字列 |
[表 : 12. 返される内容]

{#ProcMinInt-getProject_S__id_x1l_krq_c2c}  
この例では、プロセスマイニングプロジェクトを取得します。

    SNC.ProcessMiningIntegrationAPI.getProject("fa465748ff01121047cae835f2cb1473");

出力：

    {
       "entity":{
          "table":"incident",
          "activityDefinitions":[
             {
                "field":"assignment_group",
                "type":"DEFAULT",
                "activityOfInterest":false
             },
             {
                "field":"business_service",
                "type":"DEFAULT",
                "activityOfInterest":false
             },
             {
                "field":"state",
                "type":"DEFAULT",
                "activityOfInterest":false
             },
             {
                "field":"category",
                "type":"DEFAULT",
                "activityOfInterest":false
             },
             {
                "field":"priority",
                "type":"DEFAULT",
                "activityOfInterest":false
             }
          ],
          "condition":"",
          "breakdownDefinitions":[
             {
                "field":"contact_type",
                "fieldLabel":"Channel"
             },
             {
                "field":"close_code",
                "fieldLabel":"Resolution code"
             },
             {
                "field":"assignment_group",
                "fieldLabel":"Assignment group"
             },
             {
                "field":"location",
                "fieldLabel":"Location"
             },
             {
                "field":"priority",
                "fieldLabel":"Priority"
             },
             {
                "field":"category",
                "fieldLabel":"Category"
             }
          ]
       },
       "name":"Incident Process",
       "permissions":[
          {
             "value":"some_group_sys_id",
             "type":"group"
          },
          {
             "value":"some_role_sys_id",
             "type":"role"
          },
          {
             "value":"some_user_sys_id",
             "type":"user"
          }
       ],
       "id":"fa465748ff01121047cae835f2cb1473",
       "miningState":"NEW",
       "findingDefinitionKPIMap":{
          
       },
       "retiredDate":1728292672.622894000,
       "lastMined":null
    }

## ProcessMiningIntegrationAPI - scheduleMining(文字列 projectId) {#ariaid-title8}

マイニングのためにプロセスマイニングプロジェクトを送信します。
{#ProcMinInt-scheduleMining_S__table_yyx_h5t_kdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| projectId | 文字列 | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] |
[表 : 13. パラメーター]

{#ProcMinInt-scheduleMining_S__table_yyx_h5t_kdc} {#ProcMinInt-scheduleMining_S__table_s12_j5t_kdc__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | プロジェクトsys_idとトラッカーを含むオブジェクト。 { "projectId":"String", "trackerId":"String" } |
| \<Object\>.projectId | プロジェクトのSys_id。 テーブル:プロジェクト定義 \[promin_project\] データタイプ：文字列 |
| \<Object\>.trackerId | プロジェクトのマイニングの進行状況を監視するトラッカーのSys_id。 テーブル:実行トラッカー \[sys_execution_tracker\] データタイプ：文字列 |
[表 : 14. 返される内容]

{#ProcMinInt-scheduleMining_S__table_s12_j5t_kdc}  
この例では、マイニングのためにプロジェクトを送信します。

    SNC.ProcessMiningIntegrationAPI.scheduleMining("c0b91f0cff01121047cae835f2cb14bc");

出力：

    {
       "trackerId":"aec9530cff01121047cae835f2cb147e",
       "projectId":"c0b91f0cff01121047cae835f2cb14bc"
    }