UserCriteria - Dans le champ d’application

L’API UserCriteria fournit des méthodes pour créer, modifier et 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 de l’API incluse dans le périmètre des critères d’utilisateur (ID : com.glideapp.user_criteria.scoped.api) doit être activé pour accéder à cette API.

UserCriteria : UserCriteria()

Crée une instance de la classe UserCriteria.

var uc = new sn_uc.UserCriteria();

UserCriteria : UserCriteria (chaîne sys_id)

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

Tableau 1. Paramètres

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

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

UserCriteria : create(Object columnValues, Boolean standardUpdate)

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

Tableau 2. 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 vrai pour activer l’exécution des moteurs et du workflow.

Tableau 3. 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 : deleteRecord()

Supprime les critères d’utilisateur actuels.

Tableau 4. Paramètres

Nom	Type	Description
Aucun

Tableau 5. Renvoie

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

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

Sortie :

true

UserCriteria : lire (colonnes de chaîne)

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

Tableau 6. Paramètres

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

Tableau 7. Renvoie

Type	Description
Objet	Mappage des 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 : setActive(booléen actif)

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

Tableau 8. Paramètres

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

Tableau 9. Renvoie

Type	Description
nul

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

UserCriteria : setAdvanced(booléen avancé)

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

Tableau 10. Paramètres

Nom	Type	Description
Avancés	Booléen	Si 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 11. Renvoie

Type	Description
nul

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

UserCriteria : setCompanies(String companies)

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

Tableau 12. 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 13. Renvoie

Type	Description
nul

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

UserCriteria : setDepartments(String departments)

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

Tableau 14. 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 15. Renvoie

Type	Description
nul

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

UserCriteria : setGroups(groupes de chaînes)

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

Tableau 16. 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 17. Renvoie

Type	Description
nul

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

UserCriteria : setLocations(String locations)

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

Tableau 18. Paramètres

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

Tableau 19. Renvoie

Type	Description
nul

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

UserCriteria : setMatchAll(booléen match_all)

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

Tableau 20. Paramètres

Nom	Type	Description
Aucun	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 définie sur false, au moins une condition définie en tant que propriété des critères d’utilisateur doit être remplie.

Tableau 21. Renvoie

Type	Description
nul

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

UserCriteria : setName(nom de la chaîne)

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

Tableau 22. Paramètres

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

Tableau 23. Renvoie

Type	Description
nul

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

UserCriteria : setRoles(rôles de chaîne)

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

Tableau 24. 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 25. Renvoie

Type	Description
nul

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

UserCriteria : setScript(script de chaîne)

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

Tableau 26. Paramètres

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

Tableau 27. 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 : setUsers(String users)

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

Tableau 28. Paramètres

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

Tableau 29. Renvoie

Type	Description
nul

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

UserCriteria : update(Object columnValues, String reason)

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

Tableau 30. 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 31. 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