Skip to content

Settings reference

Every configuration key, its default, its allowed range and what it changes.

Account-wide settings live under Manage, Configuration, which only admins can open. The Configuration tab lists every setting by its key, with its current value and a note. Choose Save Changes to store your edits. Categories and Record Types have their own tabs.

The app stores each setting as an Advanced Reports Configuration record in NetSuite. Every key has a default, so the app works before any record exists. A missing or unreadable value falls back to its default.

Numeric settings show their allowed range under the field. The field refuses a value outside that range before you save, the server refuses it too, and the app pulls a stored value outside the range back into it when reading it.

Rights

KeyDefaultMeaning
rights.author_rolesnoneRoles that may create, edit and delete reports, layouts, dashboards and portlets. Equivalent to Administrator-level read of the whole account, because the refresh runs every report as Administrator.
rights.admin_rolesAdministratorRoles that may change configuration, categories and record types, and use Import / Export. Admins see every report in the catalogue.

The Administrator role holds both rights, whatever these lists say. Both lists use a role picker.

Refresh

KeyDefaultRangeMeaning
cache.policiesEvery 15 minutes, Hourly, Daily, Manual onlyThe refresh intervals the wizard offers. The wizard writes the chosen number of minutes on each report, so editing this list changes the choices offered, not existing reports.
refresh.manual_cooldown_seconds1200 to 86,400The minimum gap between manual refreshes of the same report. A click inside the gap shows "refreshed recently".
refresh.incremental_overlap_minutes600 to 10,080How far before the stored watermark a partial refresh re-reads. The refresh merges re-read rows by key, so a larger window costs query time, never accuracy.

The refresh schedule itself is the deployment HSS - Advanced Report Refresh MR (Scheduled), which runs every 15 minutes. It is a NetSuite script deployment, not a setting in the app.

Result size

KeyDefaultRangeMeaning
limits.max_rows0 (off)0 or moreAn optional safety valve. When it is set, a refresh stops at this many rows and marks the result truncated. The report then shows Limited to the first N rows by the configured row cap.
limits.max_total_bytes0 (off)0 or moreAn optional safety valve. When it is set, a refresh whose result passes this many bytes across all its files stops with a Result too large error.
limits.max_bytes9,000,000100,000 to 10,000,000The size of one result file. The app splits a result across as many files as it needs, each under this size. This is internal tuning. NetSuite refuses a File Cabinet file over 10 MB, and there is nothing to gain from changing it.

Leave both safety valves off unless a runaway query needs a ceiling. Storage has no limit of its own, and a report page downloads a large result one file at a time.

Display

KeyDefaultRangeMeaning
ui.default_page_size500 to 10,000Rows per page for reports that do not set their own. 0 shows every row on one page. Viewers can change the page size for their session.

Storage

KeyDefaultMeaning
storage.cache_folder_id0 (resolve automatically)The File Cabinet folder that holds result files. At 0, the app finds its report-cache folder by name and writes the id back. The editor is a folder picker. Change it only if HiScale asks you to.

The result folder must never be available without a login. Only the app serves result files, and only after an audience check.

Record types

The Record Types tab edits links.record_types, the list of record types a report column may link to.

FieldMeaning
TypeThe NetSuite record type id, such as customer or salesorder. A custom record uses its customrecord_ script id.
LabelThe name shown in the wizard's link picker.
URLOptional. Leave it blank to let NetSuite work out the record's address. For a type NetSuite cannot resolve, give a template containing {id}.

The default list covers customer, vendor, employee, sales order, invoice, purchase order, vendor bill, item, project, opportunity, quote, credit memo, item fulfillment, item receipt, work order, inventory count, case, subsidiary, location, department and class.

Seeding the records

The optional Bootstrap Suitelet, HSS - Advanced Reports Bootstrap SL, creates a record for every key that does not have one yet, with its default value. It never overwrites a value you changed, so it is safe to run after an upgrade to add new keys. See Installing in your account.

Related: Categories, audience and rights · Refresh and scheduling · Installing in your account · Archive, restore and housekeeping