UserCriteria - Inclus dans le périmètre

L’API UserCriteria vous permet de créer, modifier ou supprimer des enregistrements de critères d’utilisateur à l’aide de scripts.

Pour utiliser cette classe dans une application incluse dans le périmètre, utilisez l’identificateur d’espace de noms sn_uc. Le module d’extension User Criteria Scoped API (ID : com.glideapp.user_criteria.scoped.api) doit être activé pour accéder à l’API UserCriteria .

UserCriteria inclus dans le champ d’application : create(Object columnValues, Boolean standardUpdate)

Crée un critère d’utilisateur avec des valeurs spécifiées dans la table user_criteria. Les valeurs spécifiées dans columnValues remplacent les valeurs fournies par les régleurs.

Tableau 1. Paramètres

Nom	Type	Description
columnValues (colonnes de valeurs)	Objet	Paires de clés et de valeurs pour une colonne et sa valeur.
standardUpdate (mise à jour standard)	Booléen	Définissez la valeur sur true pour activer l’exécution des moteurs et du workflow.

Tableau 2. Renvoie

Type	Description
Chaîne	sys_id des critères d’utilisateur créés.

var uc = new sn_uc.UserCriteria(); 
uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
uc.setActive(true); 
uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
var UserCriteriaId = uc.create();
gs.info(UserCriteriaId);

Sortie :

41bea3d53790200044e0bfc8bcbe5dec

UserCriteria inclus dans le champ d’application : deleteRecord()

Supprime les critères d’utilisateur actuels.

Tableau 3. Paramètres

Nom	Type	Description
Aucun

Tableau 4. Renvoie

Type	Description
Booléen	Si la valeur est vrai, les critères d’utilisateur sont supprimés. Si la valeur est false, aucun critère d’utilisateur à supprimer n’est trouvé.

var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");
uc.deleteRecord();

Sortie :

true

UserCriteria inclus dans le champ d’application : read (colonnes de chaîne)

Affiche le mappage pour les paires d’attributs et de valeurs de l’élément de catalogue.

Tableau 5. Paramètres

Nom	Type	Description
colonnes	Chaîne	Tableau des attributs d’élément de catalogue.

Tableau 6. Renvoie

Type	Description
Objet	Mappage pour les paires d’attributs et de valeurs de l’élément de catalogue.

var uc = new sn_uc.UserCriteria("7b8a6927ef732100438236caa5c0fb89");
var obj = uc.read(["company","name"]);
gs.info(JSON.stringify(obj));

Sortie :

Script: {"name":"All ACME Corporation employees","company":"e7c1f3d53790200044e0bfc8bcbe5deb,227cdfb03710200044e0bfc8bcbe5d6b,86c1f3193790200044e0bfc8bcbe5d95,98c37b193790200044e0bfc8bcbe5dbe,81f95197ac1d55eb35432fd1e068385e,df7d53303710200044e0bfc8bcbe5dac,81fdf9ebac1d55eb4cb89f136a082555,4b7d13f03710200044e0bfc8bcbe5db6,81f87336ac1d55eb06002def816d139f,81fbfe03ac1d55eb286d832de58ae1fd,81fca4cbac1d55eb355b4b6db0e3c80f,187d13f03710200044e0bfc8bcbe5df2,81fd65ecac1d55eb42a426568fc87a63,31bea3d53790200044e0bfc8bcbe5dec,81f75fcaac1d55eb2b0781d6f2c3c260"}

UserCriteria inclus dans l’étendue : setActive(booléen actif)

Spécifie si les critères d’utilisateur sont actifs.

Tableau 7. Paramètres

Nom	Type	Description
Actif	Booléen	Si la valeur est définie sur vrai, les critères d’utilisateur sont actifs. Si la valeur est définie sur false, les critères d’utilisateur sont inactifs.

Tableau 8. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setActive(true); 

UserCriteria inclus dans le champ d’application : setAdvanced(booléen avancé)

Spécifie si les critères d’utilisateur ont un script avancé.

Tableau 9. Paramètres

Nom	Type	Description
Avancé	Booléen	Si la valeur est vrai, les critères d’utilisateur ont un script avancé. Si la valeur est définie sur false, les critères d’utilisateur n’ont pas de script avancé.

Tableau 10. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setAdvanced(true); 

UserCriteria inclus dans le périmètre : setCompanies(String companies)

Définit la propriété de l’entreprise pour les critères d’utilisateur.

Tableau 11. Paramètres

Nom	Type	Description
Entreprises	Chaîne	Liste séparée par des virgules des sys_ids de société à définir pour les critères d’utilisateur.

Tableau 12. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria inclus dans le champ d’application : setDepartments(String departments)

Définit la propriété du département pour les critères d’utilisateur.

Tableau 13. Paramètres

Nom	Type	Description
départements	Chaîne	Liste séparée par des virgules des sys_ids de département à définir pour les critères d’utilisateur.

Tableau 14. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setDepartments("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria inclus dans le champ d’application : setGroups(String groups)

Définit la propriété de groupe pour les critères d’utilisateur.

Tableau 15. Paramètres

Nom	Type	Description
groupes	Chaîne	Liste séparée par des virgules des sys_ids de groupe à définir pour les critères d’utilisateur.

Tableau 16. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setGroups("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria inclus dans le périmètre : setLocations(String locations)

Définit la propriété d’emplacement pour les critères d’utilisateur.

Tableau 17. Paramètres

Nom	Type	Description
emplacements	Chaîne	Liste séparée par des virgules des sys_ids d’emplacement à définir pour les critères d’utilisateur.

Tableau 18. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setLocations("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria inclus dans l’étendue : setMatchAll(match_all booléen)

Définit la propriété match_all pour les critères d’utilisateur.

Tableau 19. Paramètres

Nom	Type	Description
Néant	match_all	Si vrai, toutes les conditions définies en tant que propriétés pour les critères d’utilisateur doivent être remplies. Si la valeur est false, au moins une condition définie en tant que propriété pour les critères d’utilisateur doit être remplie.

Tableau 20. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setMatchAll(true); 

UserCriteria inclus dans l’étendue : setName(nom de chaîne)

Définit la propriété name pour les critères d’utilisateur.

Tableau 21. Paramètres

Nom	Type	Description
nom	Chaîne	Nom des critères d'utilisateur.

Tableau 22. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setName("Property1"); 

UserCriteria inclus dans le champ d’application : setRoles(String roles)

Définit la propriété de rôle pour les critères d’utilisateur.

Tableau 23. Paramètres

Nom	Type	Description
roles	Chaîne	Liste séparée par des virgules des sys_ids de rôles à définir pour les critères d’utilisateur.

Tableau 24. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setRoles("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria inclus dans le périmètre : setScript(String script)

Définit le script pour les critères d’utilisateur.

Tableau 25. Paramètres

Nom	Type	Description
script	Chaîne	Script à définir pour les critères d’utilisateur avancés.

Tableau 26. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setScript("function scriptTest() {
  var retVal;
  if (gs.getUser().getRecord().getDisplayValue('department') == 'Product Management') {
      retVal = true;
  } else {
      retVal = false;
  }
  return retVal;
}"); 

UserCriteria inclus dans le champ d’application : setUsers(String users)

Définit la propriété utilisateur pour les critères d’utilisateur.

Tableau 27. Paramètres

Nom	Type	Description
utilisateurs	Chaîne	Liste des sys_ids d’utilisateur séparés par des virgules à définir pour les critères d’utilisateur.

Tableau 28. Renvoie

Type	Description
nul

var uc = new sn_uc.UserCriteria();
uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria inclus dans le champ d’application : update(Object columnValues, String reason)

Met à jour l’élément de catalogue actuel avec les valeurs spécifiées.

Tableau 29. Paramètres

Nom	Type	Description
columnValues (colonnes de valeurs)	Objet	Mappage pour le nom de colonne et les paires de valeurs.
motif	Chaîne	Motif de la mise à jour de l’élément de catalogue.

Tableau 30. Renvoie

Type	Description
Chaîne	Renvoie la sys_id des critères d’utilisateur créés.

var uc = new sn_uc.UserCriteria();
uc.update("name": "Updated name", "The existing name is not relevant. Setting a relevant name"); 

Sortie :

31bea3d53790200044e0bfc8bcbe5dec

UserCriteria inclus dans l’étendue : UserCriteria()

Crée une instance de la classe UserCriteria.

var uc = new sn_uc.UserCriteria();

UserCriteria inclus dans l’étendue : UserCriteria(String sys_id)

Crée une instance de la classe UserCriteria avec le sys_id spécifié.

Tableau 31. Paramètres

Nom	Type	Description
sys_id	Chaîne	sys_id des critères d’utilisateur.

var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");