---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# PDAutomationProvider - スコープ指定、グローバル

# PDAutomationProvider - スコープ指定、グローバル {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：17分

PDAutomationProvider API を使用すると、実行中にオプションのアクティビティをプロセスに挿入できます。

この API は プレイブック プラグイン (com.glide.pad.core) の一部であり、 `sn_pad` 名前空間で実行されます。  
この API でスクリプトを呼び出すには、次のうちの 1 つまたは両方に該当する必要があります。

* 発信者が、オプションのアクティビティトリガーが作成されたのと同じスコープ内にいる必要がある。
* 管理者権限がある。
{#PDAutomationProviderBothAPI__ul_glp_zx2_5rb}

プロセスは、レーンで順序付けされた一連のアクティビティです。オプションのアクティビティは、プロセス設計時に事前定義されます。アクティビティは正確な時間に実行されるようにスケジュールされていません。アクティビティをレーンにアサインし、レーンの実行中に実行できるようにすることができます。アクティビティをプロセスにアサインし、レーンの実行中に実行できるようにすることができます。

オプションのアクティビティを作成するには、アクティビティ \[sys_pd_activity\] テーブルで \[開始ルール\] が \[手動\] に設定されている必要があります。 プレイブック では現在、手動アクティビティの作成はサポートされていません。

エージェントは、オプションのアクティビティを、別のアクティビティに関連してレーンまたはアクティビティに追加します。オプションのアクティビティを挿入するには、プロセスが実行されている必要があります。  
関連項目：

* [自動化プロセスを設計する](https://www.servicenow.com/docs/access?context=design-automated-process&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US)
* [Process Automation Designer のレーンとアクティビティ](https://www.servicenow.com/docs/access?context=process-automation-designer-lanes-activities&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US)
{#PDAutomationProviderBothAPI__ul_a1m_lxj_5rb}

## PDAutomationProvider -- activateProcess(文字列 processDefinitionSysId) {#ariaid-title2}

プレイブックをアクティブ化します。
{#PDAuto-activateProcess_S__table_zkb_lbs_1cc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| プロセス定義 SysID | 文字列 | プロセス定義 \[sys_pd_process_definition\] テーブルにあるプレイブックのsys_id。 |
[表 : 1. パラメーター]

{#PDAuto-activateProcess_S__table_zkb_lbs_1cc} {#PDAuto-activateProcess_S__table_alb_lbs_1cc__entry__2}

| プロパティ | 説明 |
|-|-|
| オブジェクト | プロセス定義のアクティブ化の詳細を含むオブジェクト。 { "errors": [Array] "process_definition": {Object}, "state": "String" } |
| エラー | エラーのリスト。成功した場合は空。 データタイプ:文字列のアレイ |
| process_definition | アクティブ化されたプレイブックとそのプロパティ。 データタイプ: オブジェクト "process_definition": { "active": Boolean, "snapshot": {Object}, "status": "String" } |
| process_definition.active | 非アクティブ化されたプレイブックのプロセス定義がアクティブかどうかを示すフラグ。プロセス定義 \[sys_pd_process_definition\] リストでプロセス定義を検索します。 有効な値： * true:非アクティブ化されたプレイブックのプロセス定義がアクティブです。 * false:非アクティブ化されたプレイブックのプロセス定義は非アクティブです。 {#PDAuto-activateProcess_S__ul_vl4_xtp_ccc} データタイプ：ブーリアン |
| process_definition.snapshot | アクティブ化時のプロセス定義に関する詳細が含まれます。 データタイプ: オブジェクト { "snapshot": { "created": "String", "processDefinitionSysId": "String" } } |
| process_definition。スナップショット。作成 | プレイブックが作成された日付。 データタイプ：文字列 |
| process_definition。スナップショット。プロセス定義 SysID | アクティブ化されたプレイブックのsys_id。 データタイプ：文字列 |
| process_definition.status | プレイブックの公開ステータスを示します。 可能な値： * draft:プレイブックはドラフトステータスです。 * 公開済み:プレイブックは公開済みステータスです。 {#PDAuto-activateProcess_S__ul_exj_hj3_2cc} データタイプ：文字列 |
| state | アクティブ化の要求が成功したかどうかを示します。 可能な値： * 成功:プレイブックが正常にアクティブ化されました。 * エラー:プレイブックの ID が見つかりませんでした。 データタイプ: オブジェクト |
[表 : 2. 返される内容]

{#PDAuto-activateProcess_S__table_alb_lbs_1cc}  
次の例は、プレイブックをアクティブ化する方法を示しています。

    var myPlaybook = sn_pad.PDAutomationProvider.activateProcess('cdd1b85e43000210d96e29c28ab8f275');
    gs.info(JSON.stringify(myPlaybook));

出力:

    {
      "process_definition": {
        "active": true,
        "snapshot": {
          "processDefinitionId": "cdd1b85e43000210d96e29c28ab8f275",
          "created": "2024-02-19 22:58:12"
        },
        "status": "published"
      },
      "state": "SUCCESS",
      "errors": []
    }

## PDAutomationProvider -- addOptionalActivityRelativeToActivityContext(文字列 contextID, 文字列 activityId, 文字列 where, 文字列 relatedToId) {#ariaid-title3}

指定されたオプションのアクティビティを、プロセスの実行中に別のアクティビティに関連して実行されるように追加します。
プロセスが実行されると、アクティビティごとにアクティビティコンテキストが作成されます。このコンテキストは、アクティビティが実行を処理する方法も処理します。詳細については、「 [Process Automation Designer のレーンとアクティビティ](https://www.servicenow.com/docs/access?context=process-automation-designer-lanes-activities&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US)」を参照してください。
{#PDAuto-addRelToActvtyCntxt_S_S_S_S__PDAutoParms__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| contextID | 文字列 | オプションのアクティビティを追加するアクティビティ実行の sys_id。アクセスするには、プロセス実行 \[sys_pd_context\] テーブルにリストされているプロセスをクリックします。選択した実行はステータスが \[処理中\] である必要があります。 |
| activityId | 文字列 | アクティビティ \[sys_pd_activity\] テーブルにリストされているオプションのアクティビティの sys_id。 注: オプションのアクティビティを作成するには、アクティビティ \[sys_pd_activity\] テーブルで \[開始ルール\] が \[手動\] に設定されている必要があります。 |
| where | 文字列 | プロセス内のどこにアクティビティを配置するかを示します。 有効な値： * AFTER -- 相対アクティビティの後にこのアクティビティを実行します。 コンテキスト。 * WITH -- アクティビティを別の相対アクティビティと同時に実行します。 コンテキスト。 {#PDAuto-addRelToActvtyCntxt_S_S_S_S__ul_tlq_mdl_lrb} |
| relativeToId | 文字列 | オプションのアクティビティの前または一緒に実行される相対アクティビティコンテキストの ID。アクティビティコンテキスト \[sys_pd_activity_context\] テーブルのリストにあります。 |
[表 : 3. パラメーター]

{#PDAuto-addRelToActvtyCntxt_S_S_S_S__PDAutoParms} {#PDAuto-addRelToActvtyCntxt_S_S_S_S__PDAutoReturns__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | アクティビティの実行が正常にスケジュールされたかどうかを示すフラグ。 有効な値： * true：アクティビティの実行が正常にスケジュールされています。出力は成功を示す文字列です。 * false：アクティビティの実行が正常にスケジュールされていません。出力は、1 つ以上のエラーメッセージのアレイです。 {#PDAuto-addRelToActvtyCntxt_S_S_S_S__ul_a4j_yvl_nrb} エラーが発生した場合は、1 つ以上のエラーメッセージのリスト。それ以外の場合は、0 個以上の要素のアレイを示すメッセージ。 |
| アレイ | エラーが発生した場合は、1 つ以上のエラーメッセージのリスト。それ以外の場合は、0 個以上の要素のアレイを示すメッセージ。 考えられるエラーメッセージ： * 無効なオプションのアクティビティ ID - activityId パラメーターに指定された sys_id が無効です。 * 無効な PD コンテキスト ID - contextID パラメーターで指定されたプロセスデザイナー (PD) の sys_id が無効です。 * 無効なポジションタイプ - 指定されたポジションタイプは無効です。有効なタイプについては、where パラメーターの説明を参照してください。 * 無効な Relative-to ID - relativeToId パラメーターに指定された sys_id が無効です。 * オプションのアクティビティが見つかりません - activityId パラメーターに指定された sys_id が見つかりませんでした。 * プロセスは引き続きアクティブである必要があります - オプションのアクティビティを実行するには、このアクティビティを含むプロセスがアクティブである必要があります。 * 相対アクティビティコンテキストが見つかりません 相対アクティビティコンテキストが見つかりません {#PDAuto-addRelToActvtyCntxt_S_S_S_S__ul_o5f_p12_5rb} |
[表 : 4. 返される内容]

{#PDAuto-addRelToActvtyCntxt_S_S_S_S__PDAutoReturns}  
次の例は、オプションのアクティビティを相対アクティビティコンテキストと同時に実行する方法を示しています。

    var contextId = '<context_id>';
    var optionalActivityId = '<optional_activity_id>';
    var where = 'WITH'; // options AFTER, WITH
    var relativeToId = '<relative_activity_context_id>'; // relative activity context ID

    var response = sn_pad.PDAutomationProvider.addOptionalActivityRelativeToActivityContext(contextId, optionalActivityId, where, relativeToId);

    gs.info(JSUtil.describeObject(response));

出力 (成功)：

    success: boolean = true
    errors: Array of 0 elements

## PDAutomationProvider -- addOptionalActivityRelativeToLaneContext(文字列 contextID, 文字列 activityId, 文字列 where, 文字列 relatedToId) {#ariaid-title4}

レーンの実行コンテキスト中に実行するオプションのアクティビティをレーンにアサインします。
プロセスが実行されると、レーンごとにレーンコンテキストが作成されます。このコンテキストは、レーンが実行を処理する方法も処理します。詳細については、「 [Process Automation Designer のレーンとアクティビティ](https://www.servicenow.com/docs/access?context=process-automation-designer-lanes-activities&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US)」を参照してください。
{#PDAuto-addRelToLaneContext_S_S_S_S__PDAutoParms__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| contextID | 文字列 | オプションのアクティビティを追加するアクティビティ実行の sys_id。アクセスするには、プロセス実行 \[sys_pd_context\] テーブルにリストされているプロセスをクリックします。選択した実行はステータスが \[処理中\] である必要があります。 |
| activityId | 文字列 | アクティビティ \[sys_pd_activity\] テーブルにリストされているオプションのアクティビティの sys_id。 注: オプションのアクティビティを作成するには、アクティビティ \[sys_pd_activity\] テーブルで \[開始ルール\] が \[手動\] に設定されている必要があります。 |
| where | 文字列 | プロセス内のどこにアクティビティを配置するかを示します。 有効な値： * LAST -- レーンの最後のアクティビティとして実行します。 コンテキスト。 * NEXT -- レーンの次のアクティビティで実行します。 コンテキスト。 {#PDAuto-addRelToLaneContext_S_S_S_S__ul_tlq_mdl_lrb} |
| relativeToId | 文字列 | オプションのアクティビティが実行される相対レーンコンテキストの ID。レーンコンテキスト \[sys_pd_lane_context\] テーブルのリストにあります。 |
[表 : 5. パラメーター]

{#PDAuto-addRelToLaneContext_S_S_S_S__PDAutoParms} {#PDAuto-addRelToLaneContext_S_S_S_S__PDAutoReturns__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | アクティビティの実行が正常にスケジュールされたかどうかを示すフラグ。 有効な値： * true：アクティビティの実行が正常にスケジュールされています。出力は成功を示す文字列です。 * false：アクティビティの実行が正常にスケジュールされていません。出力は、1 つ以上のエラーメッセージのアレイです。 {#PDAuto-addRelToLaneContext_S_S_S_S__ul_a4j_yvl_nrb} |
| アレイ | エラーが発生した場合は、1 つ以上のエラーメッセージのリスト。それ以外の場合は、0 個以上の要素のアレイを示すメッセージ。 考えられるエラーメッセージ： * 無効なオプションのアクティビティ ID - activityId パラメーターに指定された sys_id が無効です。 * 無効な PD コンテキスト ID - contextID パラメーターで指定されたプロセスデザイナー (PD) の sys_id が無効です。 * 無効なポジションタイプ - 指定されたポジションタイプは無効です。有効なタイプについては、where パラメーターの説明を参照してください。 * 無効な Relative-to ID - relativeToId パラメーターに指定された sys_id が無効です。 * オプションのアクティビティをレーンに追加することはできません - activityId パラメーターで指定されたオプションのアクティビティを relativeToId パラメーターで指定されたレーンに関連して追加することができません。選択した \[アクティビティの実行\] が \[処理中\] ステータスであることを確認してください。 * オプションのアクティビティが見つかりません - activityId パラメーターに指定された sys_id が見つかりませんでした。 * プロセスは引き続きアクティブである必要があります - オプションのアクティビティを実行するには、このアクティビティを含むプロセスがアクティブである必要があります。 * 相対レーンコンテキストが見つかりません 相対アクティビティコンテキストが見つかりません {#PDAuto-addRelToLaneContext_S_S_S_S__ul_xw3_422_5rb} |
[表 : 6. 返される内容]

{#PDAuto-addRelToLaneContext_S_S_S_S__PDAutoReturns}  
次の例は、オプションのアクティビティをレーンコンテキスト内の最後のアクティビティとして実行する方法を示しています。

    var contextId = '<context_id>';
    var optionalActivityId = '<optional_activity_id>';
    var where = 'LAST'; // options LAST, NEXT
    var relativeToId = '<relative_lane_context_id>'; // relative lane context ID

    var response = sn_pad.PDAutomationProvider.addOptionalActivityRelativeToLaneContext(contextId, optionalActivityId, where, relativeToId);

    gs.info(JSUtil.describeObject(response));

出力 (成功)：

    success: boolean = true
    errors: Array of 0 elements

## PDAutomationProvider -- deactivateProcess(文字列 processDefinitionSysId) {#ariaid-title5}

プレイブックを非アクティブ化します。
{#PDAuto-deactivateProcess_S__table_zkb_lbs_1cc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| プロセス定義 SysID | 文字列 | プロセス定義 \[sys_pd_process_definition\] テーブルにあるプレイブックのsys_id。 |
[表 : 7. パラメーター]

{#PDAuto-deactivateProcess_S__table_zkb_lbs_1cc} {#PDAuto-deactivateProcess_S__table_alb_lbs_1cc__entry__2}

| プロパティ | 説明 |
|-|-|
| オブジェクト | プロセス定義の非アクティブ化の詳細を含むオブジェクト。 { "errors": [Array] "process_definition": {Object}, "state": "String" } |
| エラー | エラーのリスト。成功した場合は空。 データタイプ:文字列のアレイ |
| process_definition | 非アクティブ化されたプレイブックとそのプロパティ。 データタイプ: オブジェクト "process_definition": { "active": Boolean, "snapshot": {Object}, "status": "String" } |
| process_definition.active | 非アクティブ化されたプレイブックのプロセス定義がアクティブかどうかを示します。プロセス定義 \[sys_pd_process_definition\] リストでプロセス定義を検索します。 可能な値： * true:非アクティブ化されたプレイブックのプロセス定義がアクティブです。 * false:非アクティブ化されたプレイブックのプロセス定義は非アクティブです。 {#PDAuto-deactivateProcess_S__ul_idr_br3_2cc} データタイプ：ブーリアン |
| process_definition.説明 | 非アクティブ化されたプレイブックの詳細。 データタイプ：文字列 |
| process_definition.label | ユーザーのインターフェイスに表示される非アクティブ化されたプレイブックの名前。 データタイプ：文字列 |
| process_definition.name | コード内の非アクティブ化されたプレイブックの名前。スクリプティングで要求パラメーターとしてのみ使用されます。 データタイプ：文字列 |
| process_definition.スコープ | プレイブックが非アクティブ化されるアプリケーションスコープのsys_id。 データタイプ：文字列 |
| process_definition.status | プレイブックが公開されると、ドラフトに戻ります。 データタイプ：文字列 |
| state | 非アクティブ化が成功したかどうかを示します。 可能な値： * 成功:プレイブックが正常に非アクティブ化されました。 * エラー:プレイブックの ID が見つかりませんでした。 {#PDAuto-deactivateProcess_S__ul_zfl_k34_2cc} データタイプ：文字列 |
[表 : 8. 返される内容]

{#PDAuto-deactivateProcess_S__table_alb_lbs_1cc}  
プレイブックを非アクティブ化します。

    sn_pad.PDAutomationProvider.deactivateProcess('cdd1b85e43000210d96e29c28ab8f275')

出力：

    {"process_definition":{"scope":"global","name":"test","active":true,"description":"","label":"test","status":"draft"},"state":"SUCCESS"}

## PDAutomationProvider -- duplicateProcess(文字列 processDefinitionSysId, 文字列 label, 文字列 description, 文字列 scopeId, 文字列 triggerTypeId) {#ariaid-title6}

プレイブックを複製します。
{#PDAuto-duplicateProcess_S_S_S_S_S__table_zkb_lbs_1cc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| プロセス定義 SysID | 文字列 | プロセス定義 \[sys_pd_process_definition\] テーブルにあるプレイブックのsys_id。 |
| label | 文字列 | 複製されたプレイブックの名前。 |
| 説明 | 文字列 | オプション。プレイブックの詳細を追加します。 |
| scopeId | 文字列 | プレイブックを実行するアプリケーションスコープのsys_id。スコープ名は、プロセス定義 \[sys_pd_process_definition\] テーブルから取得した `scope.name` 形式の名前です。グローバルスコープのsys_idを入力すると、任意のアプリケーションスコープでプレイブックを実行できます。 |
| triggerTypeId | 文字列 | プレイブックの実行を開始するトリガーのsys_id。トリガータイプ \[sys_pd_trigger_type\] テーブルでトリガータイプを検索し、そのsys_idをコピーします。 |
[表 : 9. パラメーター]

{#PDAuto-duplicateProcess_S_S_S_S_S__table_zkb_lbs_1cc} {#PDAuto-duplicateProcess_S_S_S_S_S__table_alb_lbs_1cc__entry__2}

| プロパティ | 説明 |
|-|-|
| オブジェクト | プロセス定義重複の詳細を含むオブジェクト。 { "errors": [Array] "processDefinitionSysId": "String", "state": "String" } |
| エラー | エラーのリスト。成功した場合は空。 データタイプ:文字列のアレイ 考えられるエラーメッセージ： * scopeId:xyz のスコープが見つかりません * ID:xyz のプロセス定義が見つかりません * triggerTypeId:xyz のトリガータイプが見つかりません {#PDAuto-duplicateProcess_S_S_S_S_S__ul_df4_hkt_bcc} |
| プロセス定義 SysID | プロセス定義 \[sys_pd_process_definition\] テーブル内の新しいプレイブックのsys_id。 データタイプ：文字列 |
| state | プレイブックの複製が成功したかどうかを示します。 可能な値： * 成功:プレイブックが正常に複製されました。 * FAILURE:プレイブック、アプリケーションスコープ、またはトリガーの ID が見つかりませんでした。 {#PDAuto-duplicateProcess_S_S_S_S_S__ul_zq2_434_2cc} データタイプ: オブジェクト |
[表 : 10. 返される内容]

{#PDAuto-duplicateProcess_S_S_S_S_S__table_alb_lbs_1cc}  
この例では、sys_id `f8ca6192ec210210f8772cbd595eab20` を使用してプレイブックを複製する方法を示します。新しいプレイブックの名前は 「プレイブック 2.0」で、アプリケーションスコープは 「グローバル」で、レコードが作成されるとトリガーされます。\[レコード作成\] トリガータイプのsys_idは `ab6951170f1200108c87f4f0ff767e4f` です。

    sn_pad.PDAutomationProvider.duplicateProcess('f8ca6192ec210210f8772cbd595eab20', 'Playbook 2.0', '', 'global', 'ab6951170f1200108c87f4f0ff767e4f');

出力:

    {"processDefinitionSysId":"6e4f0b8fece9c210f8772cbd595eabda","state":"SUCCESS"}