PADomainUtils : global

L’API PADomainUtils vous permet de copier Analyse des performances des enregistrements entre différents domaines sur la même instance.

Utilisez cette API dans les scripts serveur pour copier Analyse des performances des enregistrements tels que des indicateurs, des répartitions et des tableaux de bord vers différents domaines. Cette API vous permet de créer un Analyse des performances enregistrement dans un domaine et de copier cet enregistrement dans un nombre illimité de domaines supplémentaires.

Remarque :

Cette API ne peut pas copier les enregistrements dans le domaine global.

Avertissement :

Lorsque les enregistrements de configuration sont déplacés vers un autre domaine, les scores ne sont pas accessibles.

Pour utiliser PADomainUtils, vous devez satisfaire à ces exigences :

• Analyse des performances doit être activé.
• L’utilisateur exécutant le script doit avoir le rôle d’administrateur.
• L’instance doit utiliser Séparation de domaine.
• Le script doit être exécuté à partir du domaine global.
• Lors du déplacement ou de la copie d’enregistrements, les domaines source et cible doivent être différents.

PADomainUtils : PADomainUtils()

Instancie un nouvel objet PADomainUtils pour déplacer ou copier Analyse des performances des enregistrements à partir du domaine global.

Utilisez plutôt le constructeur PADomainUtils(String domainFrom) lors du déplacement ou de la copie d’enregistrements d’un domaine autre que le domaine global.

Tableau 1. Paramètres

Nom	Type	Description
Aucun

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

PADomainUtils : PADomainUtils(chaîne domainFrom)

Instancie un nouvel objet PADomainUtils pour déplacer ou copier Analyse des performances des enregistrements à partir du domaine spécifié.

Utilisez plutôt le constructeur PADomainUtils() lors du déplacement ou de la copie à partir du domaine global.

Tableau 2. Paramètres

Nom	Type	Description
domaineDe	Chaîne	Le domaine à partir duquel copier les enregistrements.

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

PADomainUtils : copy(String runAs)

Copie Analyse des performances les enregistrements vers un domaine différent.

Pour copier des tableaux de bord ou des travaux planifiés, consultez copyDashboard et copyJob.

Tableau 3. Paramètres

Nom	Type	Description
exécuter en tant que	Chaîne	Utilisateur dont vous souhaitez copier le domaine.

Tableau 4. Renvoie

Type	Description
nul

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

PADomainUtils : copyDashboard(chaîne dashboardId, chaîne runAs)

Copiez un tableau de bord dans un autre domaine.

Tableau 5. Paramètres

Nom	Type	Description
dashboardId	Chaîne	Sys_id du tableau de bord à copier.
exécuter en tant que	Chaîne	Utilisateur dont vous souhaitez copier le domaine du tableau de bord.

Tableau 6. Renvoie

Type	Description
nul

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

PADomainUtils : copyJob(Chaîne, paJob, chaîne runAs)

Copie un enregistrement de tâche de Analyse des performances collecte de données planifiée vers un autre domaine.

Tableau 7. Paramètres

Nom	Type	Description
paJob	Chaîne	Sys_id d’un Analyse des performances enregistrement de tâche de collecte de données planifiée [sysauto_pa].
exécuter en tant que	Chaîne	Utilisateur dont vous souhaitez copier le domaine de la tâche.

Tableau 8. Renvoie

Type	Description
Chaîne	Message d’erreur si une erreur se produit, ou chaîne vide s’il n’y a pas d’erreur.

// 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 de chaînes, ID de chaîne)

Évaluez si vous pouvez écrire dans un enregistrement spécifique identifié par table et sys_id.

Tableau 9. Paramètres

Nom	Type	Description
Table	Chaîne	Nom de la table contenant l’enregistrement à interroger, par exemple pa_indicators.
id	Chaîne	L’sys_id de l’enregistrement à interroger.

Tableau 10. Renvoie

Type	Description
Booléen	Indique que vous pouvez écrire dans l’enregistrement spécifié. Renvoie la valeur vrai si l’enregistrement existe dans le domaine de l’utilisateur actuel. Renvoie la valeur false si l’enregistrement n’existe pas ou s’il se trouve dans un domaine différent.

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

PADomainUtils : move(String runAs)

Déplace Analyse des performances les enregistrements vers un domaine différent.

Tableau 11. Paramètres

Nom	Type	Description
exécuter en tant que	Chaîne	L’utilisateur vers le domaine duquel vous souhaitez copier les enregistrements.

Tableau 12. Renvoie

Type	Description
nul

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

PADomainUtils : setFoundation(Fondation booléenne)

Utilisez cette méthode pour déplacer ou copier uniquement les enregistrements de base dans une configuration de domaine hybride.

Vous pouvez implémenter une approche hybride en conservant certains types d’enregistrements dans un domaine parent et d’autres types dans des domaines enfants. En général, le domaine parent contient des enregistrements de base et le domaine enfant contient des enregistrements de niveau supérieur, tels que des widgets. Les types d’enregistrement suivants sont considérés comme des enregistrements fondamentaux.

• Sous-groupes
• Compartiments
• Scripts
• Sources de répartition
• Sources d'indicateurs
• Filtres
• Répartitions
• Sources gérées
• Répartitions manuelles
• Mappages de répartition
• Relations de répartitions

D’autres Analyse des performances enregistrements, tels que les widgets et les indicateurs, ne sont pas des enregistrements fondamentaux. Définissez cette méthode sur faux pour déplacer ou copier également ces enregistrements supplémentaires.

Tableau 13. Paramètres

Nom	Type	Description
fondation	Booléen	Indique si seuls les enregistrements de base doivent être copiés ou déplacés par cet objet PADomainUtils.

Tableau 14. Renvoie

Type	Description
PADomainUtils	Objet appelant cette fonction.

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

PADomainUtils : setOverrides(remplacements booléens)

Utilisez cette méthode avant de copier des enregistrements pour définir la valeur sys_override du nouvel enregistrement sur l’enregistrement parent d’origine.

Cette méthode vous permet de remplacer automatiquement les enregistrements d’un domaine parent. En remplaçant les enregistrements parents, les enregistrements parents n’ont aucun impact sur le domaine enfant. Si le domaine source n’est pas le parent du domaine cible lors de la copie d’enregistrements, la définition de la valeur sys_override n’aura aucun impact sur le comportement. Vous pouvez spécifier un remplacement uniquement lors de la copie d’enregistrements, et non lors du déplacement d’enregistrements.

Tableau 15. Paramètres

Nom	Type	Description
Substitue	Booléen	Indique que les enregistrements copiés dans un domaine enfant doivent remplacer l’enregistrement source dans le domaine parent. Cette valeur est vraie par défaut.

Tableau 16. Renvoie

Type	Description
PADomainUtils	Objet appelant cette fonction.

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