UserCriteria - Inclus dans l’étendue

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 de l’espace de noms sn_uc . Le module d’extension API 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, 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 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éfinir 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 la valeur est Vrai, les critères d’utilisateur sont supprimés.

    Si la valeur est définie sur false, 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 pour les paires attribut et valeur de l’élément de catalogue.

    Tableau 6. Paramètres
    Nom Type Description
    colonnes Chaîne Tableau des 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)

    Indique si les critères d’utilisateur sont actifs.

    Tableau 8. Paramètres
    Nom Type Description
    actif Booléen Si la valeur est 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 la valeur est Vrai, le critère d’utilisateur a un script avancé.

    Si la valeur est false, le critère d’utilisateur n’a pas de script avancé.
    Tableau 11. Renvoie
    Type Description
    nul 
    var uc = new sn_uc.UserCriteria();
uc.setAdvanced(true);

    UserCriteria : setCompanies(sociétés à chaînes)

    Définit la propriété de la société 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 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 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(Boolean 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 pour les critères d’utilisateur doivent être remplies.

    Si la valeur est définie sur Faux, au moins une condition définie comme 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é du 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 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’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 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 le 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