PADomainUtils - グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：8分

    • PADomainUtils API を使用すると、同じインスタンス上の異なるドメイン間でパフォーマンスアナリティクスレコードをコピーできます。

    サーバースクリプトでこの API を使用して、インジケーター、ブレークダウン、ダッシュボードなどの パフォーマンスアナリティクス レコードを別のドメインにコピーします。この API を使用すると、1 つのドメインに パフォーマンスアナリティクス レコードを作成し、そのレコードを任意の数の追加ドメインにコピーできます。

    注:
    この API はレコードをグローバルドメインにコピーできません。
    警告:
    構成レコードが別のドメインに移動されると、スコアにアクセスできなくなります。
    PADomainUtils を使用するには、次の要件を満たす必要があります。
    • パフォーマンスアナリティクス を有効にする必要があります。
    • スクリプトを実行するユーザーには admin ロールが必要です。
    • インスタンスではドメインセパレーションを使用する必要があります。
    • スクリプトはグローバルドメインから実行する必要があります。
    • レコードを移動またはコピーする場合は、ソースドメインとターゲットドメインが異なる必要があります。

    PADomainUtils:PADomainUtils()

    新しい PADomainUtils オブジェクトをインスタンス化して、グローバルドメインから パフォーマンスアナリティクス レコードを移動またはコピーします。

    グローバルドメイン以外のドメインからレコードを移動またはコピーする場合は、代わりに PADomainUtils(String domainFrom) コンストラクターを使用します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし 
    // PADomainUtils initialized with the global domain
var globalUtils = new SNC.PADomainUtils();

    PADomainUtils:PADomainUtils(文字列 domainFrom)

    新しい PADomainUtils オブジェクトをインスタンス化して、指定されたドメインから パフォーマンスアナリティクス レコードを移動またはコピーします。

    グローバルドメインを移動またはグローバルドメインからコピーする場合は、代わりに PADomainUtils() コンストラクターを使用してください。

    表 : 2. パラメーター
    名前 タイプ 説明
    ドメイン送信元 文字列 レコードのコピー元のドメイン。 
    // c90d4b084a362312013398f051272c0d is the sys id of the ACME domain
var acmeUtils = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');

    PADomainUtils - copy(文字列 runAs)

    パフォーマンスアナリティクスレコードを別のドメインにコピーします。

    ダッシュボードまたはスケジュール済みジョブをコピーするには、「 copyDashboard 」および「 copyJob」を参照してください。

    表 : 3. パラメーター
    名前 タイプ 説明
    runAs 文字列 レコードをコピーするドメインのユーザー。
    表 : 4. 返される内容
    タイプ 説明
    なし 
    // copy all the Performance Analytics records from global to user's domain
var pa = new SNC.PADomainUtils();
pa.copy('09ff3d105f231000b12e3572f2b4775d');

    PADomainUtils - copyDashboard(文字列 dashboardId, 文字列 runAs)

    ダッシュボードを別のドメインにコピーします。

    表 : 5. パラメーター
    名前 タイプ 説明
    dashboardId 文字列 コピーするダッシュボードのSys_id。
    runAs 文字列 ダッシュボードのコピー先のドメインのユーザー。
    表 : 6. 返される内容
    タイプ 説明
    なし 
    //Copy Incident Management dashboard from global to user's domain
var pa = new SNC.PADomainUtils();
pa.copyDashboard('a64b7031d7201100b96d45a3ce610335','09ff3d105f231000b12e3572f2b4775d');

    PADomainUtils - copyJob(文字列 paJob, 文字列 runAs)

    パフォーマンスアナリティクススケジュール設定済みデータ収集ジョブレコードを別のドメインにコピーします。

    表 : 7. パラメーター
    名前 タイプ 説明
    paJob 文字列 パフォーマンスアナリティクススケジュール済みデータ収集ジョブ [sysauto_pa] レコードのSys_id。
    runAs 文字列 ジョブのコピー先のドメインのユーザー。
    表 : 8. 返される内容
    タイプ 説明
    文字列 エラーが発生した場合はエラーメッセージ、エラーがない場合は空の文字列。 
    // No source domain needs to be set
var pa = new SNC.PADomainUtils();
// copy the '[PA Incident] Daily Data Collection job'
// set the 'run as' of the new record to be the 'acme.itil' user
// first argument is the sys_id of the sysauto_pa record
// the second is the sys_id of the acme.itil user record
pa.copyJob('82ba2023d7101100b96d45a3ce6103cd','797d14341f1310005a3637b8ec8b7010');

    PADomainUtils - isWriteable(文字列テーブル, 文字列 ID)

    テーブルとsys_idで識別される特定のレコードに書き込むことができるかどうかを評価します。

    表 : 9. パラメーター
    名前 タイプ 説明
    table 文字列 クエリするレコードを含むテーブルの名前 (pa_indicators など)。
    ID 文字列 クエリするレコードのsys_id。
    表 : 10. 返される内容
    タイプ 説明
    Boolean 指定されたレコードに書き込むことができることを示します。レコードが現在のユーザーのドメイン内に存在する場合は true を返します。レコードが存在しない場合、または別のドメインにある場合は false を返します。 
    var pa = new SNC.PADomainUtils();
pa.isWriteable('pa_incidents','cd8125b5140012007665a83e633b028d');

    PADomainUtils - move(文字列 runAs)

    パフォーマンスアナリティクスレコードを別のドメインに移動します。

    表 : 11. パラメーター
    名前 タイプ 説明
    runAs 文字列 レコードをコピーするドメインのユーザー。
    表 : 12. 返される内容
    タイプ 説明
    なし 
    // move all the Performance Analytics records from the global to the customers domain
var pa = new SNC.PADomainUtils();
pa.move('774190f01f1310005a3637b8ec8b70ef')

    PADomainUtils - setFoundation(ブール基盤)

    ハイブリッドドメイン構成で基盤レコードのみを移動またはコピーするには、この方法を使用します。

    一部のタイプのレコードを親ドメインで管理し、一部のタイプのレコードを子ドメインで管理することで、ハイブリッドアプローチを実装できます。通常、親ドメインには基盤レコードが含まれ、子ドメインにはウィジェットなどの上位レベルのレコードが含まれます。次のタイプのレコードは、基盤レコードと見なされます。
    • バケットグループ
    • バケット
    • スクリプト
    • ブレークダウンソース
    • インジケーターソース
    • フィルター
    • ブレークダウン
    • 管理ソース
    • 手動ブレークダウン
    • ブレークダウンマッピング
    • ブレークダウンの関連付け
    ウィジェットやインジケーターなどの他の パフォーマンスアナリティクス レコードは、基盤レコードではありません。これらの追加レコードも移動またはコピーするには、このメソッドを false に設定します。
    表 : 13. パラメーター
    名前 タイプ 説明
    基盤 Boolean この PADomainUtils オブジェクトで基盤レコードのみをコピーまたは移動するかどうかを示します。
    表 : 14. 返される内容
    タイプ 説明
    PADomainUtil この関数を呼び出すオブジェクト。 
    var pa = new SNC.PADomainUtils().setFoundation(true);
pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');

    PADomainUtils - setOverrides(ブール値オーバーライド)

    レコードをコピーする前にこのメソッドを使用して、新しいレコードのsys_override値を元の親レコードに設定します。

    この方法を使用すると、親ドメインのレコードを自動的に上書きできます。親レコードを上書きすることで、親レコードは子ドメインに影響を与えません。レコードのコピー時にソースドメインがターゲットドメインの親でない場合、sys_override値を設定しても動作に影響はありません。上書きを指定できるのは、レコードのコピー時のみで、レコードの移動時には指定できません。

    表 : 15. パラメーター
    名前 タイプ 説明
    上書き Boolean 子ドメインのコピーされたレコードが親ドメインのソースレコードを上書きする必要があることを示します。デフォルトでは、この値は true です。
    表 : 16. 返される内容
    タイプ 説明
    PADomainUtil この関数を呼び出すオブジェクト。 
    var pa = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');
pa.setOverrides(false);
pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');