netsuite
Utilisation du navigateur NetSuite Records

Utilisation du navigateur NetSuite Records

Le navigateur d'enregistrements définit le schéma pour tous les types d'enregistrement scriptables. c'est un outil de référence extrêmement critique pour chaque développeur SuiteScript. Lorsque vous avez besoin de savoir comment référencer un champ particulier sur un type d'enregistrement spécifique dans votre script, le navigateur d'enregistrements est votre guide.

Lien direct

Autre schéma

Vous pouvez également remarquer des onglets en haut du navigateur d'enregistrements pour le navigateur de schémas et le navigateur de connexions . Celles-ci sont très similaires au navigateur d'enregistrements , mais pour différentes API NetSuite.

Le navigateur de schéma fournit le schéma de l'API de services Web SOAP, tandis que le navigateur de connexion fournit le schéma du connecteur ODBC.

Navigation dans le navigateur de notices

Vous parcourez d'abord le navigateur d'enregistrements par type d'enregistrement, à savoir "commande client", "facture", "employé". Il n'y a pas de fonction de recherche dans le navigateur d'enregistrements , de sorte que toute la navigation est effectuée manuellement. Les types d'enregistrement sont classés par ordre alphabétique. Vous devez donc d'abord cliquer sur la première lettre du type d'enregistrement qui vous intéresse, puis sélectionner le type d'enregistrement lui-même à gauche.

Par exemple, si vous voulez voir le schéma du type d'enregistrement Subisidary , vous devez d'abord cliquer sur S en haut, puis sur Subsidiary sur la gauche.

Lecture du schéma

Chaque schéma vous fournit une quantité considérable d'informations sur chaque type d'enregistrement. Il est important de savoir comment décomposer toutes ces informations.

En haut du schéma se trouve le nom du type d'enregistrement suivi de l'ID interne du type d'enregistrement; cet ID interne est la référence de programmation pour le type d'enregistrement. Le schéma est ensuite divisé en plusieurs sections:

• Champs : la section Champs répertorie les détails de tous les champs de corps de l'enregistrement. Les champs décrits ici peuvent être utilisés lorsque vous travaillez avec l'enregistrement actuellement en contexte ou avec une référence directe à un objet d'enregistrement.
• Sublistes : la section Sublistes affiche toutes les sous-listes de l'enregistrement et toutes les colonnes scriptables de chaque sous-liste. Les champs de cette section s'appliquent à nouveau lorsque vous travaillez avec l'enregistrement actuellement en contexte ou avec une référence directe à un objet d'enregistrement.
• Onglets : la section Onglets décrit tous les sous-onglets natifs du type d'enregistrement.
• Jointures de recherche : la section Rechercher des jointures décrit tous les enregistrements associés à travers lesquels vous pouvez créer des jointures dans vos recherches de ce type d'enregistrement.
• Filtres de recherche : la section Filtres de recherche décrit tous les champs disponibles en tant que filtre de recherche pour ce type d'enregistrement. L'ID interne lorsque vous utilisez un champ spécifique en tant que filtre de recherche ne correspond pas toujours à son ID interne en tant que zone de corps.
• Colonnes de recherche : la section Colonnes de recherche décrit tous les champs disponibles en tant que colonne de recherche pour ce type d'enregistrement. L'ID interne lorsque vous utilisez un champ spécifique en tant que colonne de recherche ne correspond pas toujours à son ID interne en tant que zone de corps.
• Types de transformation : la section Types de transformation décrit tous les types d'enregistrement que celui-ci peut être transformé en utilisant l'API de transformation d'enregistrement.

Trouver un champ

Comme indiqué précédemment, aucune fonctionnalité de recherche n’est intégrée au navigateur d’enregistrements . Une fois que vous avez accédé au type d'enregistrement approprié, si vous ne connaissez pas déjà l'ID interne d'un champ particulier, la façon la plus simple de le trouver consiste à utiliser la fonction de recherche de votre navigateur (généralement CTRL+F ). dans l'interface utilisateur.

Champs obligatoires

La colonne Obligatoire du schéma indique si ce champ est requis pour enregistrer l'enregistrement. Si cette colonne indique true , vous devrez alors fournir une valeur pour ce champ lorsque vous enregistrez un enregistrement de ce type.

nlapiSubmitField et édition en ligne

La colonne nlapiSubmitField est un élément essentiel à comprendre. Cette colonne indique si le champ est disponible pour l'édition en ligne. Si nlapiSubmitField est true , le champ peut être modifié en ligne. Cela a un impact considérable sur la gestion de ce champ lors de la tentative d'utilisation des fonctions nlapiSubmitField ou record.submitFields dans vos scripts.

Lorsque cette colonne est true , vous pouvez utiliser en toute sécurité les API de champs de soumission pour mettre à jour ce champ en ligne. Quand il est false , vous pouvez toujours utiliser ces fonctions pour mettre à jour le champ , mais ce qui se passe réellement en coulisse change de manière significative.

Lorsque nlapiSubmitField est nlapiSubmitField false pour un champ particulier et que vous utilisez l'une des API de champs de soumission, le moteur de script en arrière-plan effectue un chargement complet de l'enregistrement, met à jour le champ et renvoie la modification à la base de données. Le résultat final est le même, mais comme l'intégralité de l'enregistrement est chargée et enregistrée, votre script utilisera beaucoup plus de gouvernance que prévu et son exécution prendra plus de temps.

Pour plus d'informations à ce sujet, consultez la page d'aide intitulée "Conséquences de l'utilisation de nlapiSubmitField sur des champs modifiables non intégrés".