Essential Skill

πŸ“– Navigating NetSuite Help Documentation

The most important skill for any SuiteScript developer

🎯 Why This Matters

Throughout this course, you'll see us repeatedly open the NetSuite Help documentation to look up syntax, parameters, and examples. This isn't lazinessβ€”it's exactly how professional developers work.

βœ… The Reality of Professional Development

No developer memorizes every API. The skill is knowing where to find the answer quickly. NetSuite's documentation is comprehensiveβ€”learn to navigate it, and you can solve any problem.

The documentation contains:

πŸ”— Accessing the Documentation

Primary URL

https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/

Bookmark this! You'll use it daily.

Quick Access from NetSuite

Inside NetSuite, click the Help link in the top-right corner, then search or browse to SuiteScript documentation.

πŸ’‘ Pro Tip: Use Google

Often the fastest way to find specific documentation is to Google: netsuite N/record load site:docs.oracle.com. The site filter ensures you get official docs.

πŸ—‚οΈ Documentation Structure

Understanding how the docs are organized helps you find information faster:

πŸ“ SuiteScript 2.x
    πŸ“ SuiteScript 2.x API Reference
        πŸ“ SuiteScript 2.x Modules ← Most used!
            πŸ“„ N/record Module
            πŸ“„ N/search Module
            πŸ“„ N/query Module
            πŸ“„ N/email Module
            πŸ“„ ... (50+ modules)
        πŸ“ SuiteScript 2.x Script Types
            πŸ“„ User Event Script Type
            πŸ“„ Client Script Type
            πŸ“„ Map/Reduce Script Type
    πŸ“ SuiteScript 2.x Developer Guide
    πŸ“ Records Browser ← For field IDs

πŸ” How to Look Up a Module

Step-by-Step: Finding N/record.load()

  1. Go to docs.oracle.com and search "N/record" or navigate to SuiteScript 2.x Modules
  2. Click on N/record Module
  3. Find the Methods section
  4. Click on record.load(options)
  5. You'll see:
    • Parameters: type, id, isDynamic, defaultValues
    • Returns: record.Record object
    • Governance: 10 units
    • Example code

πŸ“‹ What Each Help Page Contains

Method Documentation Pattern

Every method page follows a consistent structure:

Anatomy of a Help Page

  1. Method Signature: record.load(options)
  2. Description: What the method does
  3. Parameters Table:
    • Parameter name
    • Type (string, number, boolean, object)
    • Required or optional
    • Description of valid values
  4. Returns: What the method gives back
  5. Errors: What exceptions can be thrown
  6. Governance: Units consumed
  7. Since: Version introduced (2015.2, 2019.1, etc.)
  8. Example: Working code sample

⚠️ Pay Attention To

Required vs Optional parameters - Missing a required parameter causes errors. Governance costs - Plan your script budget. Since version - Ensure your account supports the feature.

πŸ”Ž Finding Field IDs: Records Browser

When you need to know what fields exist on a record (and their internal IDs), use the Records Browser:

Using the Records Browser

  1. In the Help docs, navigate to Records Browser
  2. Search for a record type (e.g., "Sales Order", "Customer")
  3. View all available fields with:
    • Field ID (what you use in code)
    • Field label (what users see)
    • Field type
    • Whether it's on body or sublist

πŸ’‘ Alternative: &xml=T Parameter

Add &xml=T to any NetSuite record URL to see raw field IDs. Example: /app/accounting/transactions/salesord.nl?id=123&xml=T

πŸ“š Script Type Documentation

Each script type has its own help page documenting:

πŸ“š Common Lookups

User Event entry points? β†’ Search "User Event Script Type"
Client Script entry points? β†’ Search "Client Script Type"
Map/Reduce stages? β†’ Search "Map/Reduce Script Type"

πŸƒ Quick Reference Searches

Bookmark these common searches:

When You Need... Search For...
Load/create/save recordsN/record Module
Run searchesN/search Module
Write SuiteQL queriesN/query Module
Send emailsN/email Module
Build custom formsN/ui/serverWidget Module
Check governanceN/runtime Module
Field IDs on a recordRecords Browser + record name
Script entry points[Script Type] Script Type

🎯 Key Takeaways