PADomainUtils : Global

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

Verwenden Sie diese API in Serverskripts, um Performance Analytics -Datensätze wie Indikatoren, Aufgliederungen und Dashboards in andere Domänen zu kopieren. Mit dieser API können Sie einen Performance Analytics -Datensatz in einer Domäne erstellen und diesen Datensatz in eine beliebige Anzahl zusätzlicher Domänen kopieren.

Hinweis:

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

Warnung:

Wenn Konfigurationsdatensätze in eine andere Domäne verschoben werden, kann auf Punktzahlen nicht zugegriffen werden.

Um PADomainUtilszu verwenden, müssen Sie die folgenden Anforderungen erfüllen:

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

PADomainUtils – PADomainUtils()

Instanziiert ein neues PADomainUtils-Objekt, um Performance Analytics -Datensätze aus der globalen Domäne zu verschieben oder zu kopieren.

Verwenden Sie den PADomainUtils(String 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(String domainFrom)

Instanziiert ein neues PADomainUtils-Objekt, um Performance Analytics -Datensätze aus der angegebenen Domäne zu verschieben oder zu kopieren.

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

Tabelle : 2. Parameter

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

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

PADomainUtils – copy(String runAs)

Kopiert Datensätze Performance Analytics in eine andere Domäne.

Informationen zum Kopieren von Dashboards oder regelmäßigen Aufgaben finden Sie unter copyDashboard und copyJob .

Tabelle : 3. Parameter

Name	Typ	Beschreibung
runAs	Zeichenfolge	Benutzer, in dessen Domäne Datensätze in kopiert werden sollen.

Tabelle : 4. Rückgaben

Typ	Beschreibung
void

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

PADomainUtils – copyDashboard(String dashboardId, String runAs)

Kopiert ein Dashboard in eine andere Domäne.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
dashboardId	Zeichenfolge	Sys_id des zu kopierenden Dashboards.
runAs	Zeichenfolge	Benutzer, in dessen Domäne Sie das Dashboard kopieren möchten.

Tabelle : 6. Rückgaben

Typ	Beschreibung
void

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

PADomainUtils – copyJob(String paJob, String runAs)

Kopiert einen Performance Analytics-Datensatz einer regelmäßigen Datenerfassungsaufgabe in eine andere Domäne.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
paJob	Zeichenfolge	Sys_id eines Datensatzes für den geplanten Datensammlungsauftrag [sysauto_pa] Performance Analytics ].
runAs	Zeichenfolge	Benutzer, 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 vorliegt.

// 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(String table, String id)

Evaluieren Sie, ob Sie in einen bestimmten Datensatz schreiben können, der durch Tabelle und sys_id identifiziert wurde.

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. Ergebnisse

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

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

PADomainUtils – move(String runAs)

Verschiebt Performance Analytics -Datensätze in eine andere Domäne.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
runAs	Zeichenfolge	Der Benutzer, in dessen Domäne Datensätze kopiert werden sollen.

Tabelle : 12. Ergebnisse

Typ	Beschreibung
void

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

PADomainUtils – setFoundation(Boolean foundation)

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

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

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

Andere Performance Analytics -Datensätze wie -Widgets und -Indikatoren sind keine grundlegenden Datensätze. Legen Sie diese Methode auf „false“ fest, um diese zusätzlichen Datensätze ebenfalls zu verschieben oder zu kopieren.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
foundation	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(Boolean overrides)

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 die übergeordnete Zieldomäne ist, hat das Festlegen des sys_override-Werts keine Auswirkungen auf das Verhalten. Sie können eine Überschreibung nur beim Kopieren von Datensätzen festlegen, nicht beim Verschieben von Datensätzen.

Tabelle : 15. Parameter

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

Tabelle : 16. Ergebnisse

Typ	Beschreibung
PADomainUtils	Das Objekt, das diese Funktion aufruft.

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