PADomainUtils – Global

Die PADomainUtils Mit der API können Sie kopieren Performance AnalyticsDatensätze zwischen verschiedenen Domänen in derselben Instanz.

Verwenden Sie diese API in Serverskripts zum Kopieren Performance AnalyticsDatensätze wie Indikatoren, Aufgliederungen und Dashboards für verschiedene Domänen. Mit dieser API können Sie erstellen Performance AnalyticsZeichnen Sie einen Datensatz in einer Domäne auf, und kopieren Sie diesen Datensatz in eine beliebige Anzahl zusätzlicher Domänen.

Hinweis:

Diese API kann keine Datensätze in die globale Domäne kopieren.

Warnung:

Wenn Konfigurationsdatensätze in eine andere Domäne verschoben werden, sind Punktzahlen nicht zugänglich.

Zu verwenden PADomainUtils , Sie müssen diese Anforderungen erfüllen:

• Performance Analytics Muss aktiviert sein.
• Der Anwender, der das Skript ausführt, muss über die Administratorrolle verfügen.
• Die Instanz muss Domänentrennung verwenden.
• Das Skript muss in der globalen Domäne ausgeführt werden.
• Beim Verschieben oder Kopieren von Datensätzen müssen sich die Quell- und Zieldomänen unterscheiden.

PADomainUtils: PADomainUtils()

Instanziiert ein neues PADomainUtils-Objekt zum Verschieben oder Kopieren Performance AnalyticsDatensätze aus der globalen Domäne.

Verwenden Sie PADomainUtils(Zeichenfolge domainFrom) Konstruktor stattdessen beim Verschieben oder Kopieren von Datensätzen aus einer anderen Domäne als der globalen Domäne.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

// PADomainUtils initialized with the global domain
var globalUtils = new SNC.PADomainUtils();

PADomainUtils – PADomainUtils(Zeichenfolge domainFrom)

Instanziiert ein neues PADomainUtils-Objekt zum Verschieben oder Kopieren Performance AnalyticsDatensätze aus der angegebenen Domäne.

Verwenden Sie PADomainUtils() Konstruktor stattdessen beim Verschieben oder Kopieren aus der globalen Domäne.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Domäne aus	Zeichenfolge	Die Domäne, aus der Datensätze kopiert werden sollen.

// c90d4b084a362312013398f051272c0d is the sys id of the ACME domain
var acmeUtils = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');

PADomainUtils – Copy(ZeichenfolgenrUNAS)

Kopien Performance AnalyticsDatensätze in einer anderen Domäne.

Informationen zum Kopieren von Dashboards oder geplanten Aufgaben finden Sie unter CopyDashboard Und CopyJob .

Tabelle : 3. Parameter

Name	Typ	Beschreibung
RUNAS	Zeichenfolge	Anwender, in dessen Domäne Sie Datensätze kopieren möchten.

Tabelle : 4. Rückgaben

Typ	Beschreibung
Ungültig

// copy all the Performance Analytics records from global to user's domain
var pa = new SNC.PADomainUtils();
pa.copy('09ff3d105f231000b12e3572f2b4775d');

PADomainUtils – copyDashboard(Zeichenfolgen-DashboardId, Zeichenfolgen-RUNAS)

Kopieren Sie ein Dashboard in eine andere Domäne.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
dashboardId	Zeichenfolge	SYS_ID des zu kopierenden Dashboards.
RUNAS	Zeichenfolge	Anwender, in dessen Domäne Sie das Dashboard kopieren möchten.

Tabelle : 6. Rückgaben

Typ	Beschreibung
Ungültig

//Copy Incident Management dashboard from global to user's domain
var pa = new SNC.PADomainUtils();
pa.copyDashboard('a64b7031d7201100b96d45a3ce610335','09ff3d105f231000b12e3572f2b4775d');

PADomainUtils – copyJob(Zeichenfolge paJob, Zeichenfolgen-RUNAS)

Kopiert A Performance AnalyticsDatensatz des geplanten Datensammlungsauftrags an eine andere Domäne.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
PaJob	Zeichenfolge	SYS_ID von Performance AnalyticsDatensatz der geplanten Datensammlungsaufgabe [sysauto_PA].
RUNAS	Zeichenfolge	Anwender, in dessen Domäne Sie den Auftrag kopieren möchten.

Tabelle : 8. Rückgaben

Typ	Beschreibung
Zeichenfolge	Fehlermeldung, wenn ein Fehler auftritt, oder eine leere Zeichenfolge, wenn kein Fehler auftritt.

// 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 (Zeichenfolgentabelle, Zeichenfolgen-ID)

Bewerten Sie, ob Sie in einen bestimmten Datensatz schreiben können, der durch Tabelle und sys_ID identifiziert wird

Tabelle : 9. Parameter

Name	Typ	Beschreibung
table	Zeichenfolge	Der Name der Tabelle, die den abzufragenden Datensatz enthält, z. B. PA_indicators.
ID	Zeichenfolge	Die sys_ID des abzufragenden Datensatzes.

Tabelle : 10. Rückgaben

Typ	Beschreibung
Boolean	Gibt an, dass Sie in den angegebenen Datensatz schreiben können. Gibt „wahr“ zurück, wenn der Datensatz innerhalb der Domäne des aktuellen Anwenders vorhanden ist. Gibt „falsch“ zurück, wenn der Datensatz nicht vorhanden ist oder sich in einer anderen Domäne befindet.

var pa = new SNC.PADomainUtils();
pa.isWriteable('pa_incidents','cd8125b5140012007665a83e633b028d');

PADomainUtils – Move(ZeichenfolgenrUNAS)

Verschiebt Performance AnalyticsDatensätze in einer anderen Domäne.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
RUNAS	Zeichenfolge	Der Anwender, in dessen Domäne Sie Datensätze kopieren möchten.

Tabelle : 12. Rückgaben

Typ	Beschreibung
Ungültig

// move all the Performance Analytics records from the global to the customers domain
var pa = new SNC.PADomainUtils();
pa.move('774190f01f1310005a3637b8ec8b70ef')

PADomainUtils – setFoundation (boolesche Grundlage)

Verwenden Sie diese Methode, um nur grundlegende Datensätze in einer Hybriddomänenkonfiguration zu verschieben oder zu kopieren.

Sie können einen Hybridansatz implementieren, indem Sie einige Datensatztypen in einer übergeordneten Domäne und einige Typen in untergeordneten Domänen beibehalten. Im Allgemeinen enthält die übergeordnete Domäne grundlegende Datensätze, und die untergeordnete Domäne enthält Datensätze auf höherer Ebene, z. B. Widgets. Die folgenden Datensatztypen gelten als grundlegende Datensätze.

• Bucket-Gruppen
• Buckets
• Skripte
• Aufgliederungsquellen
• Indikatorquellen
• Filter
• Aufgliederungen
• Verwaltete Quellen
• Manuelle Aufgliederungen
• Aufgliederungszuordnungen
• Aufgliederungsbeziehungen

Sonstiges Performance AnalyticsDatensätze wie Widgets und Indikatoren sind keine grundlegenden Datensätze. Legen Sie diese Methode auf „falsch“ fest, um auch diese zusätzlichen Datensätze zu verschieben oder zu kopieren.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Grundlage	Boolean	Gibt an, ob nur grundlegende Datensätze von diesem PADomainUtils-Objekt kopiert oder verschoben werden sollen.

Tabelle : 14. Rückgaben

Typ	Beschreibung
PADomainUtils	Das Objekt, das diese Funktion aufruft.

var pa = new SNC.PADomainUtils().setFoundation(true);
pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');

PADomainUtils – setOverrides(boolesche Überschreibungen)

Verwenden Sie diese Methode, bevor Sie Datensätze kopieren, um den sys_override-Wert des neuen Datensatzes auf den ursprünglichen übergeordneten Datensatz festzulegen.

Mit dieser Methode können Sie Datensätze in einer übergeordneten Domäne automatisch überschreiben. Durch das Überschreiben der übergeordneten Datensätze wirken sich die übergeordneten Datensätze nicht auf die untergeordnete Domäne aus. Wenn die Quelldomäne beim Kopieren von Datensätzen nicht das übergeordnete Element der Zieldomäne ist, hat das Festlegen des Werts „sys_override“ keine Auswirkungen auf das Verhalten. Sie können eine Überschreibung nur beim Kopieren von Datensätzen angeben, nicht beim Verschieben von Datensätzen.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
Überschreibungen	Boolean	Gibt an, dass kopierte Datensätze in einer untergeordneten Domäne den Quelldatensatz in der übergeordneten Domäne überschreiben sollen. Dieser Wert ist standardmäßig „wahr“.

Tabelle : 16. Rückgaben

Typ	Beschreibung
PADomainUtils	Das Objekt, das diese Funktion aufruft.

var pa = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');
pa.setOverrides(false);
pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');