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 n’importe quel nombre de domaines supplémentaires.

Remarque :

Cette API ne peut pas copier d’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 aux exigences suivantes :

• Analyse des performances doit être activé.
• L’utilisateur exécutant le script doit avoir le rôle administrateur.
• L’instance doit utiliser Domain Separation.
• 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 : copie(chaîne runAs)

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

Pour copier des tableaux de bord ou des tâches planifiées, consultez copyDashboard et copyJob.

Tableau 1. Paramètres

Nom	Type	Description
runAs	Chaîne	Utilisateur vers le domaine duquel vous souhaitez copier les enregistrements.

Tableau 2. 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(String dashboardId, String runAs)

Copier un tableau de bord vers un autre domaine.

Tableau 3. Paramètres

Nom	Type	Description
ID tableau de bord	Chaîne	Sys_id du tableau de bord à copier.
runAs	Chaîne	Utilisateur vers le domaine duquel vous souhaitez copier le tableau de bord.

Tableau 4. 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(String paJob, String runAs)

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

Tableau 5. 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].
runAs	Chaîne	Utilisateur vers le domaine duquel vous souhaitez copier la tâche.

Tableau 6. Renvoie

Type	Description
Chaîne	Un message d’erreur si une erreur se produit ou une 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)

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

Tableau 7. Paramètres

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

Tableau 8. Renvoie

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

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

PADomainUtils : move(String runAs)

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

Tableau 9. Paramètres

Nom	Type	Description
runAs	Chaîne	Utilisateur vers le domaine duquel vous souhaitez copier les enregistrements.

Tableau 10. 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 : 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 à partir d’un domaine autre que le domaine global.

Tableau 11. Paramètres

Nom	Type	Description
Aucun

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

PADomainUtils : PADomainUtils(String 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 12. Paramètres

Nom	Type	Description
domainFrom	Chaîne	Domaine à partir duquel copier les enregistrements.

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

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 dans des domaines enfants. En règle générale, 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’enregistrements 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épartition

Les autres Analyse des performances enregistrements, tels que les widgets et les indicateurs, ne sont pas des enregistrements de base. 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.

L’utilisation de cette méthode vous permet de remplacer automatiquement les enregistrements d’un domaine parent. En remplaçant les enregistrements parents, ceux-ci n’ont pas d’incidence sur le domaine enfant. Si le domaine source n’est pas le parent du domaine cible lors de la copie des 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 définie sur true 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');