UserCriteria : délimité

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • 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 API de critères d’utilisateur inclus dans le périmètre (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(String 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, booléen, 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 setters.

    Tableau 2. Paramètres
    Nom Type Description
    columnValues Objet Paires clé/valeur pour une colonne et sa valeur.
    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

    Critères d’utilisateur : deleteRecord()

    Supprime les critères d’utilisateur actuels.

    Tableau 4. Paramètres
    Nom Type Description
    Néant
    Tableau 5. Renvoie
    Type Description
    Booléen Si la valeur est 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 : read (colonnes de chaîne)

    Affiche le mappage des paires attribut et valeur 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 attribut et valeur 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 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é Booléen Si vrai, les critères d’utilisateur ont un script avancé.

    Si la valeur est définie sur faux, 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 la société pour les critères d’utilisateur.

    Tableau 12. Paramètres
    Nom Type Description
    Sociétés parentes 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");

    Critères d’utilisateur : 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é du 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(emplacements de chaîne)

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

    Tableau 18. Paramètres
    Nom Type Description
    emplacements Chaîne Liste séparée par des virgules de l’emplacement sys_ids à 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
    Néant match_all Si vrai, toutes les conditions définies comme propriétés des critères d’utilisateur doivent être remplies.

    Si la valeur est faux, au moins une condition définie en tant que propriété pour les 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 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é du 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ôle à 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é 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’utilisateurs à 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 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 l’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