GlideList (Next Experience) : client
L’API GlideList fournit des méthodes pour personnaliser les listes dans le Cadre de travail de l'interface utilisateur Next Experience fichier .
Cette API permet d’ajouter la fonctionnalité GlideList à un bouton de l’interface Expérience d'espace de travail utilisateur. Utilisez la variable g_list pour appeler chaque méthode.
Pour ajouter un bouton, créez une action de liste et ajoutez des appels de méthode GlideList dans la méthode onClick{} du champ de script client. Pour obtenir des instructions, consultez Utiliser l’API client GlideList dans l’interface utilisateur Workspace Experience.
- isUserList()
- setFirstRow()
- showHideGroups()
- showHideList()
- toggleList()
- toggleListNoPref()
GlideList (Next Experience) : addFilter(filtre de chaîne)
Ajoute un terme unique au filtre de requête de liste.
Voir aussi setFilter().
| Nom | Type | Description |
|---|---|---|
| filtre | Chaîne | Chaîne de requête codée au format Glide standard. Voir Chaînes de requête codées. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment récupérer une liste d’enregistrements actifs et actualiser la page.
g_list.addFilter("active=true");
g_list.refresh();
GlideList (Next Experience) – getChecked()
Renvoie une liste des sys_ids séparés par des virgules pour les éléments qui sont enregistrés dans la liste associée.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Liste séparée par des virgules des sys_ids pour les éléments qui sont enregistrés dans la liste. Ne vérifie pas que les éléments retournés peuvent être exécutés. |
L’exemple suivant montre comment obtenir les sys_ids de chaque enregistrement sélectionné dans une liste.
var myChecked = g_list.getChecked();
alert(myChecked);
g_list.refresh();
Sortie dans une zone d’alerte (vide si aucun enregistrement n’est sélectionné) :
079893e6b733330059128ac7ee11a967, 4fca6d45b7131010f03e9b7ade11a9d3, 5c460fbf1bd0011079e52131604bcbd9
GlideList (Next Experience) : getFixedQuery()
Renvoie la requête fixe.
Une requête fixe est la partie de la requête qui ne peut pas être supprimée du fil d’Ariane (c’est-à-dire qu’elle est fixe pour l’utilisateur).
Appliquez cette méthode sous Actions sur la liste connexe dans l’interface Expérience d'espace de travail utilisateur. Pour obtenir des instructions, consultez Utiliser l’API client GlideList dans l’interface utilisateur Workspace Experience.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Chaîne de requête fixe pour la liste. |
L’exemple suivant montre comment afficher une requête fixe avec un message de débogage dans le journal de la console du navigateur.
console.log(g_list.getFixedQuery() + " debug message");
Sortie après un clic sur le bouton de l’onglet Incidents enfants dans un enregistrement d’incident.
parent_incident=46f1784ba9fe19810018aa27fbb23482 debug message
GlideList (Next Experience) : getGroupBy()
Renvoie la liste des champs séparés par des virgules utilisés pour regrouper la liste.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Liste de champs ou de champs séparés par des virgules utilisés pour regrouper la liste. |
L’exemple suivant montre comment obtenir les valeurs de champ groupBy de la vue de liste actuelle.
var grpdBy = g_list.getGroupBy();
alert("The list is grouped by " + grpdBy);
g_list.refresh();
Sortie dans une zone d’alerte pour une liste regroupée par priorité :
The list is grouped by ^GROUPBYpriority
GlideList (Next Experience) : getListName()
Renvoie le nom de la liste, qui est généralement le nom de la table.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Le nom de la liste (généralement le nom de la table). |
L’exemple suivant montre comment appeler la méthode.
g_list.getListName();
GlideList (Next Experience) : getOrderBy()
Renvoie le premier champ utilisé pour ordonner la liste.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Champ selon lequel trier la liste. Vide si la liste n’est pas ordonnée. |
L’exemple suivant montre comment obtenir les valeurs de champ orderBy de la vue de liste actuelle.
var orderBy = g_list.getOrderBy();
alert("The list is ordered by " + orderBy);
g_list.refresh();
Sortie dans une zone d’alerte pour une liste classée par priorité :
The list is ordered by ^ORDERBYDESCpriority
GlideList (Next Experience) : getParentTable()
Renvoie le nom de la table parente d’une liste connexe (la table associée au formulaire).
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Nom de la table parente. |
L’exemple suivant montre comment appeler la méthode.
g_list.getParentTable();
g_list.refresh();
GlideList (Next Experience) : getQuery(Objet)
Renvoie la chaîne de requête codée pour la liste.
| Nom | Type | Description |
|---|---|---|
| <object> | Objet | Facultatif. Par défaut, cette méthode inclut orderBy, groupBy et la requête fixe dans les résultats. Vous pouvez définir des propriétés d’objet pour limiter les résultats à une ou plusieurs des trois options disponibles. |
| <object>.orderBy | Booléen | Facultatif. Marqueur indiquant s’il faut inclure orderBy dans les résultats. Valeurs valides :
Valeur par défaut : false |
| <object>.groupBy | Booléen | Facultatif. Marqueur indiquant s’il faut inclure groupBy dans les résultats. Valeurs valides :
Valeur par défaut : false |
| <object>.fixe | Booléen | Facultatif. Marqueur indiquant s’il faut inclure la requête fixe dans les résultats. Valeurs valides :
Valeur par défaut : false |
| Type | Description |
|---|---|
| Chaîne | Chaîne de requête codée pour la liste. |
L’exemple suivant montre comment afficher la requête codée de liste avec un message de débogage dans le journal de la console du navigateur.
var myQuery = g_list.getQuery();
console.log(myQuery + " message");
Sortie :
active=false^EQ message
GlideList (Next Experience) : getRelated()
Renvoie le champ de liste connexe qui associe la liste connexe au formulaire parent.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Champ qui connecte la liste au formulaire parent. |
L’exemple suivant montre comment appeler la méthode.
g_list.getRelated();
GlideList (Next Experience) : getTableName()
Renvoie le nom de la table pour la liste.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Renvoie le nom de la table pour la liste. |
L’exemple suivant montre comment afficher le nom de liste pour la vue actuelle.
var listName = g_list.getListName();
alert("The current list name is " + listName);
g_list.refresh();
Sortie dans une zone d’alerte :
The current list name is incident
GlideList (Next Experience) – getTitle()
Renvoie le titre de la liste.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Titre de la liste. |
L’exemple suivant montre comment appeler la méthode.
g_list.getTitle();
GlideList (Next Experience) – getView()
Renvoie la vue utilisée pour afficher la liste.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Nom de la vue. |
L’exemple suivant montre comment appeler la méthode.
g_list.getView();
GlideList (Next Experience) : refresh(Numéro firstRow)
Actualise la liste. La orderBy partie du filtre de liste est ignorée afin que la liste utilise son ordre naturel lors de son actualisation.
| Nom | Type | Description |
|---|---|---|
| première ligne | Numéro | Première ligne à apparaître dans la liste. Par défaut : première ligne de la vue actuelle. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment appeler la méthode.
g_list.addFilter("active=true");
g_list.refresh();
GlideList (Next Experience) : refreshWithOrderBy(Number firstRow)
Actualise la liste. La orderBy partie du filtre de liste est incluse si elle est spécifiée pour la liste.
| Nom | Type | Description |
|---|---|---|
| première ligne | Numéro | Première ligne à apparaître dans la liste. Par défaut : première ligne de la vue actuelle. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment appeler la méthode.
g_list.refreshWithOrderBy();
GlideList (Next Experience) : setFilter(filtre de chaîne)
Définit la chaîne de requête codée pour la liste, en ignorant les orderBy parties et de groupBy la chaîne de requête.
Voir aussi addFilter().
| Nom | Type | Description |
|---|---|---|
| filtre | Chaîne | Chaîne de requête codée au format Glide standard. Voir Chaînes de requête codées. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment restreindre les résultats de liste aux enregistrements actifs.
g_list.setFilter("active=true");
g_list.refresh();
GlideList (Next Experience) : setGroupBy(String groupBy)
Définit les critères de liste groupBy pour un seul champ.
| Nom | Type | Description |
|---|---|---|
| groupBy | Chaîne | Les groupBy critères de la liste. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment regrouper des enregistrements répertoriés par ID d’appelant.
g_list.setGroupBy("caller_id");
g_list.refresh();
GlideList (Next Experience) : setOrderBy(String orderBy)
Définit les orderBy critères de la liste.
Pour un champ unique Trier par, utilisez orderBy champ ou orderByDesc champ. Pour plusieurs champs, utilisez orderByField1^orderByField2^orderByField3. orderBy spécifie l’ordre croissant et orderByDesc spécifie l’ordre décroissant. Ces chaînes de préfixe sont facultatives. Si non spécifié, orderBy il s’agit de l’ordre par défaut.
| Nom | Type | Description |
|---|---|---|
| orderBy | Chaîne | Champs orderBy uniques ou multiples. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment trier la liste en fonction de la valeur du champ Priority (Priorité).
g_list.setOrderBy("priority");
g_list.refresh();
GlideList (Next Experience) : setRowsPerPage(Nombre de lignes)
Définit le nombre de lignes par page à afficher.
| Nom | Type | Description |
|---|---|---|
| lignes | Numéro | Nombre de lignes à afficher. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment limiter les résultats à 50 lignes par page.
g_list.setRowsPerPage(50);
refresh();
GlideList (Next Experience) : tri (champ de chaîne)
Trie la liste par ordre croissant et définit le champ sous la forme d’une orderBy colonne.
| Nom | Type | Description |
|---|---|---|
| Champ | Chaîne | Champ à utiliser pour trier la liste. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment trier les résultats par le champ Nombre .
g_list.sort("number");
GlideList (Next Experience) – sortDescending(champ de chaîne, montant du nombre)
Trie un champ unique de la liste par ordre décroissant et définit le champ en tant que orderByDescField colonne.
| Nom | Type | Description |
|---|---|---|
| Champ | Chaîne | Champ à utiliser pour trier la liste. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment trier les résultats par le champ Number (Nombre) dans l’ordre décroissant.
g_list.sortDescending("number");