--- sourceDocument: Xanadu API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference Release : - xanadu ft:locale : - ja-JP ft:publication_title : - Xanadu API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # PADomainUtils - グローバル # PADomainUtils - グローバル {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分 PADomainUtils API を使用すると、同じインスタンス上の異なるドメイン間でパフォーマンスアナリティクスレコードをコピーできます。 サーバースクリプトでこの API を使用して、インジケーターやブレークダウン、ダッシュボードなどの パフォーマンスアナリティクス のレコードを別のドメインにコピーします。この API を使用すると、1 つのドメインに パフォーマンスアナリティクス レコードを作成し、そのレコードを任意の数の追加ドメインにコピーできます。 注: この API では、レコードをグローバル ドメインにコピーすることはできません。 警告: 設定レコードを別のドメインに移動すると、スコアにアクセスできなくなります。 PADomainUtils を使用するには、次の要件を満たす必要があります。 * パフォーマンスアナリティクス を有効にする必要があります。 * スクリプトを実行するユーザーには admin ロールが必要です。 * インスタンスがドメインセパレーションを使用する必要があります。 * グローバル ドメインからスクリプトを実行する必要があります。 * レコードを移動またはコピーする場合は、ソース ドメインとターゲット ドメインが異なる必要があります。 {#c_PADomainUtils__ul_fyh_sjs_ht} ## PADomainUtils - PADomainUtils() {#ariaid-title2} 新しい PADomainUtils オブジェクトのインスタンスを作成して、グローバルドメインから パフォーマンスアナリティクス のレコードを移動またはコピーします。 グローバルドメイン以外のドメインからレコードを移動またはコピーする際は、代わりに PADomainUtils(文字列 domainFrom) コンストラクターを使用します。 {#r_PADU-PADomainUtils__table_tm5_rmy_2t__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 1. パラメーター] {#r_PADU-PADomainUtils__table_tm5_rmy_2t} // PADomainUtils initialized with the global domain var globalUtils = new SNC.PADomainUtils(); ## PADomainUtils - PADomainUtils(文字列 domainFrom) {#ariaid-title3} 新しい PADomainUtils オブジェクトのインスタンスを作成して、指定したドメインから パフォーマンスアナリティクス のレコードを移動またはコピーします。 グローバルドメインから移動またはコピーする際は、代わりに PADomainUtils() コンストラクターを使用します。 {#r_PADU-PADomainUtils_String__table_ly4_5my_2t__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | domainFrom | 文字列 | レコードのコピー元のドメイン | [表 : 2. パラメーター] {#r_PADU-PADomainUtils_String__table_ly4_5my_2t} // c90d4b084a362312013398f051272c0d is the sys id of the ACME domain var acmeUtils = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d'); ## PADomainUtils - copy(文字列 runAs) {#ariaid-title4} パフォーマンスアナリティクス のレコードを別のドメインにコピーします。 ダッシュボードまたはスケジュール設定済みジョブをコピーするには、「[copyDashboard](https://servicenow-prod.fluidtopics.net/NPrbOHgRSgj3XNExbNzjwQ#PADU-copyDashboard_S_S "ダッシュボードを別のドメインにコピーします。")」および「[copyJob](https://servicenow-prod.fluidtopics.net/NPrbOHgRSgj3XNExbNzjwQ#r_PADU-copyJob_String_String "パフォーマンスアナリティクスのスケジュール設定済みデータ収集ジョブ レコードを別のドメインにコピーします。")」を参照してください。 {#r_PADU-copy_String__table_n55_zky_2t__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | runAs | 文字列 | レコードのコピー先のドメインのユーザー。 | [表 : 3. パラメーター] {#r_PADU-copy_String__table_n55_zky_2t} {#r_PADU-copy_String__table_o55_zky_2t__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 4. 返される内容] {#r_PADU-copy_String__table_o55_zky_2t} // copy all the Performance Analytics records from global to user's domain var pa = new SNC.PADomainUtils(); pa.copy('09ff3d105f231000b12e3572f2b4775d'); ## PADomainUtils - copyDashboard(文字列 dashboardId, 文字列 runAs) {#ariaid-title5} ダッシュボードを別のドメインにコピーします。 {#PADU-copyDashboard_S_S__table_yds_v55_yw__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | dashboardId | 文字列 | コピーするダッシュボードのSys_id。 | | runAs | 文字列 | ダッシュボードのコピー先のドメインのユーザー。 | [表 : 5. パラメーター] {#PADU-copyDashboard_S_S__table_yds_v55_yw} {#PADU-copyDashboard_S_S__table_zds_v55_yw__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 6. 返される内容] {#PADU-copyDashboard_S_S__table_zds_v55_yw} //Copy Incident Management dashboard from global to user's domain var pa = new SNC.PADomainUtils(); pa.copyDashboard('a64b7031d7201100b96d45a3ce610335','09ff3d105f231000b12e3572f2b4775d'); ## PADomainUtils - copyJob(文字列 paJob, 文字列 runAs) {#ariaid-title6} パフォーマンスアナリティクスのスケジュール設定済みデータ収集ジョブ レコードを別のドメインにコピーします。 {#r_PADU-copyJob_String_String__table_gvt_vky_2t__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | paJob | 文字列 | パフォーマンスアナリティクスのスケジュール設定済みデータ収集ジョブ \[sysauto_pa\] レコードの sys_id。 | | runAs | 文字列 | ジョブのコピー先のドメインのユーザー。 | [表 : 7. パラメーター] {#r_PADU-copyJob_String_String__table_gvt_vky_2t} {#r_PADU-copyJob_String_String__table_hvt_vky_2t__entry__2} | タイプ | 説明 | |-|-| | 文字列 | エラーが発生した場合はエラー メッセージが表示され、エラーがなければ空の文字列が返されます。 | [表 : 8. 返される内容] {#r_PADU-copyJob_String_String__table_hvt_vky_2t} // 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(文字列 table, 文字列 id) {#ariaid-title7} table と sys_id によって識別される特定のレコードに書き込むことができるかどうかを評価します。 {#r_PADU-isWriteable_String_String__table_vqc_gly_2t__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | table | 文字列 | pa_indicators などの、クエリーするレコードを含むテーブルの名前。 | | ID | 文字列 | クエリするレコードの sys_id。 | [表 : 9. パラメーター] {#r_PADU-isWriteable_String_String__table_vqc_gly_2t} {#r_PADU-isWriteable_String_String__table_wqc_gly_2t__entry__2} | タイプ | 説明 | |-|-| | ブーリアン | 指定されたレコードに書き込めることを示します。レコードが現在のユーザーのドメイン内に存在する場合は true を返します。レコードが存在しないか、別のドメインにある場合は false を返します。 | [表 : 10. 返される内容] {#r_PADU-isWriteable_String_String__table_wqc_gly_2t} var pa = new SNC.PADomainUtils(); pa.isWriteable('pa_incidents','cd8125b5140012007665a83e633b028d'); ## PADomainUtils - move(文字列 runAs) {#ariaid-title8} パフォーマンスアナリティクス のレコードを別のドメインに移動します。 {#r_PADU-move_String__table_plw_bly_2t__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | runAs | 文字列 | レコードのコピー先のドメインのユーザー。 | [表 : 11. パラメーター] {#r_PADU-move_String__table_plw_bly_2t} {#r_PADU-move_String__table_qlw_bly_2t__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 12. 返される内容] {#r_PADU-move_String__table_qlw_bly_2t} // move all the Performance Analytics records from the global to the customers domain var pa = new SNC.PADomainUtils(); pa.move('774190f01f1310005a3637b8ec8b70ef') ## PADomainUtils - setFoundation(ブーリアン foundation) {#ariaid-title9} ハイブリッドドメイン構成の基盤レコードのみを移動またはコピーするには、このメソッドを使用します。 レコードの一部のタイプを親ドメイン内で管理し、一部のタイプを子ドメイン内で管理することで、ハイブリッドアプローチを実施できます。通常、親ドメインには基盤レコードが入り、子ドメインにはウィジェットなどの上位レベルのレコードが入ります。基盤レコードとみなされるのは以下のタイプのレコードです。 * バケットグループ * バケット * スクリプト * ブレークダウンソース * インジケーターソース * フィルター * ブレークダウン * 管理ソース * 手動ブレークダウン * ブレークダウンマッピング * ブレークダウンの関連付け {#r_PADU-setFoundation_boolean__ul_ygw_ycf_ht}他の パフォーマンスアナリティクス のレコード (ウィジェットやインジケーターなど) は、基盤レコードではありません。これらの追加レコードも移動またはコピーするには、このメソッドを false に設定します。 {#r_PADU-setFoundation_boolean__table_tzb_nky_2t__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | foundation | ブーリアン | この PADomainUtils オブジェクトで基盤レコードのみをコピーまたは移動する必要があるかどうかを示します。 | [表 : 13. パラメーター] {#r_PADU-setFoundation_boolean__table_tzb_nky_2t} {#r_PADU-setFoundation_boolean__table_uzb_nky_2t__entry__2} | タイプ | 説明 | |-|-| | DomainUtils | この関数を呼び出すオブジェクト。 | [表 : 14. 返される内容] {#r_PADU-setFoundation_boolean__table_uzb_nky_2t} var pa = new SNC.PADomainUtils().setFoundation(true); pa.copy('bb6b58b01f1310005a3637b8ec8b70dd'); ## PADomainUtils - setOverrides(ブール overrides) {#ariaid-title10} レコードをコピーして新しいレコードの sys_override 値を元の親レコードに設定する前に、このメソッドを使用します。 このメソッドを使用すると、親ドメインのレコードを自動的に上書きできます。親レコードを上書きすることで、親レコードから子ドメインに影響を与えることはありません。レコードのコピー時にソースドメインがターゲットドメインの親でない場合は、sys_override 値を設定しても動作に影響はありません。レコードの移動時ではなく、レコードのコピー時にのみ上書きを指定できます。 {#r_PADU-setOverrides_boolean__table_hsj_qky_2t__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | overrides | ブーリアン | 子ドメインのコピーされたレコードが、親ドメインのソースレコードを上書きする必要があることを示します。この値のデフォルトは true です。 | [表 : 15. パラメーター] {#r_PADU-setOverrides_boolean__table_hsj_qky_2t} {#r_PADU-setOverrides_boolean__table_isj_qky_2t__entry__2} | タイプ | 説明 | |-|-| | DomainUtils | この関数を呼び出すオブジェクト。 | [表 : 16. 返される内容] {#r_PADU-setOverrides_boolean__table_isj_qky_2t} var pa = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d'); pa.setOverrides(false); pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');