ANS-1806 · DéVELOPPEMENT SUITESCRIPT

Comment rediriger les utilisateurs vers les pages de recherche NetSuite à l’aide de SuiteScript ?

Découvrez comment rediriger par programmation les utilisateurs soit vers une page de définition de recherche, soit directement vers les résultats de recherche au sein de NetSuite.

Solution courte

NetSuite propose les éléments `setRedirectURLToSearch` et `setRedirectURLToSearchResults` au sein de l’objet `nlobjSearch` afin de rediriger les utilisateurs par programmation. Ces fonctions permettent d’accéder à une définition de recherche ou à ses résultats, et prennent en charge les recherches existantes, ad hoc ou modifiées. Elles sont principalement utilisées dans des scripts côté serveur, tels que les événements utilisateur afterSubmit et les Suitelets.

Scénario

Les utilisateurs ont souvent besoin d’une redirection dynamique vers des pages de recherche NetSuite spécifiques, soit vers une définition de recherche préremplie pour affiner davantage la recherche, soit directement vers les résultats d’une recherche particulière. Cette fonctionnalité est essentielle pour rationaliser les flux de travail et guider les utilisateurs vers les données pertinentes en fonction de la logique du script.

Solution

NetSuite fournit deux fonctions API au sein de l’objet nlobjSearch afin de faciliter la redirection des utilisateurs vers les pages de recherche. Bien que ces méthodes fassent partie de SuiteScript 1.0, qui reste opérationnel, l’approche actuellement recommandée par NetSuite pour les nouveaux développements est SuiteScript 2.x.

Les fonctions disponibles sont les suivantes :

  • setRedirectURLToSearch : cette fonction fonctionne de manière similaire à GA_KEEP_0003, mais redirige spécifiquement les utilisateurs finaux vers une page de définition de recherche préremplie. Elle peut être utilisée avec tout type de recherche contenue dans l’objet nlobjSearch.
  • setRedirectURLToSearchResults : cette fonction fonctionne également comme GA_KEEP_0006, mais redirige directement les utilisateurs finaux vers une page de résultats de recherche. Elle s’applique à toute recherche contenue dans l’objet nlobjSearch.

Les fonctions setRedirectURLToSearch et setRedirectURLToSearchResults peuvent toutes deux être utilisées dans les scénarios suivants :

  • Avec une recherche enregistrée existante, chargée à l’aide de nlapiLoadSearch.
  • Avec une recherche ad hoc en cours de création dans SuiteScript.
  • Avec une recherche qui a été chargée puis modifiée à l’aide de méthodes telles que addFilter, setFilters, addFilters, addColumn, addColumns ou setColumns, sans avoir été enregistrée.

Ces méthodes sont principalement conçues pour une exécution côté serveur et sont prises en charge dans les scripts d’événements utilisateur afterSubmit et les Suitelets. Bien que les scripts côté client puissent déclencher des redirections, l’exécution directe de ces méthodes nlobjSearch s’effectue côté serveur.

Support expert NetSuite

Besoin d’aide pour cet enjeu NetSuite ?

Accompagnement-conseil et configuration pour Développement SuiteScript

Parler à un consultant