Merge main into my branch

.github/scripts/createDocsRoutes.ts

@@ -12,6 +12,7 @@ type Section = {
     href: string;
     title: string;
     articles?: Article[];
+    sections?: Section[];
 };
 
 type Hub = {
@@ -60,16 +61,14 @@ function toTitleCase(str: string): string {
 }
 
 /**
- * @param filename - The name of the file (path used for href)
+ * @param filename - The name of the file
  * @param order - Optional order from front matter
- * @param titleOverride - Optional display title (e.g. subfolder name: "Export-Errors" -> "Export Errors")
  */
-function getArticleObj(filename: string, order?: number, titleOverride?: string): Article {
+function getArticleObj(filename: string, order?: number): Article {
     const href = filename.replace('.md', '');
-    const title = titleOverride ? toTitleCase(titleOverride.replaceAll('-', ' ')) : toTitleCase(href.replaceAll('-', ' '));
     return {
         href,
-        title,
+        title: toTitleCase(href.replaceAll('-', ' ')),
         order,
     };
 }
@@ -97,76 +96,87 @@ function pushOrCreateEntry<TKey extends HubEntriesKey>(hubs: Hub[], hub: string,
 }
 
 function getOrderFromArticleFrontMatter(path: string): number | undefined {
-    const frontmatter = fs.readFileSync(path, 'utf8').split('---').at(1);
-    if (!frontmatter) {
-        return;
+    try {
+        const frontmatter = fs.readFileSync(path, 'utf8').split('---').at(1);
+        if (!frontmatter) {
+            return undefined;
+        }
+        const frontmatterObject = yaml.load(frontmatter) as Record<string, unknown>;
+        return frontmatterObject.order as number | undefined;
+    } catch {
+        return undefined;
     }
-    const frontmatterObject = yaml.load(frontmatter) as Record<string, unknown>;
-    return frontmatterObject.order as number | undefined;
+}
+
+/**
+ * Build a section from a directory path, with optional parent path for nested href
+ */
+function buildSection(platformName: string, hub: string, sectionPath: string, parentHref: string): Section {
+    const sectionName = sectionPath.split('/').pop() ?? sectionPath;
+    const fullPath = `${docsDir}/articles/${platformName}/${hub}/${sectionPath}`;
+    const articles: Article[] = [];
+    const childSections: Section[] = [];
+    const href = parentHref ? `${parentHref}/${sectionName}` : sectionName;
+
+    for (const entry of fs.readdirSync(fullPath)) {
+        const entryPath = `${fullPath}/${entry}`;
+        if (entry.endsWith('.md')) {
+            const order = getOrderFromArticleFrontMatter(entryPath);
+            articles.push(getArticleObj(entry, order));
+        } else if (fs.statSync(entryPath).isDirectory()) {
+            childSections.push(buildSection(platformName, hub, `${sectionPath}/${entry}`, href));
+        }
+    }
+
+    const section: Section = {
+        href,
+        title: toTitleCase(sectionName.replaceAll('-', ' ')),
+        ...(articles.length > 0 && {articles}),
+        ...(childSections.length > 0 && {sections: childSections}),
+    };
+    return section;
+}
+
+/**
+ * Flatten sections for lookup by full path (e.g. netsuite/troubleshooting/connection-errors)
+ */
+function flattenSections(sections: Section[]): Section[] {
+    const result: Section[] = [];
+    for (const s of sections) {
+        result.push(s);
+        if (s.sections?.length) {
+            result.push(...flattenSections(s.sections));
+        }
+    }
+    return result;
 }
 
 /**
  * Add articles and sections to hubs
  * @param hubs - The hubs inside docs/articles/ for a platform
  * @param platformName - Expensify Classic or New Expensify
- * @param routeHubs - The hubs insude docs/data/_routes.yml for a platform
+ * @param routeHubs - The hubs inside docs/data/_routes.yml for a platform
  */
 function createHubsWithArticles(hubs: string[], platformName: ValueOf<typeof platformNames>, routeHubs: Hub[]) {
     for (const hub of hubs) {
-        // Iterate through each directory in articles
-        for (const fileOrFolder of fs.readdirSync(`${docsDir}/articles/${platformName}/${hub}`)) {
-            // If the directory content is a markdown file, then it is an article
+        const basePath = `${docsDir}/articles/${platformName}/${hub}`;
+
+        for (const fileOrFolder of fs.readdirSync(basePath)) {
             if (fileOrFolder.endsWith('.md')) {
                 const articleObj = getArticleObj(fileOrFolder);
                 pushOrCreateEntry(routeHubs, hub, 'articles', articleObj);
                 continue;
             }
 
-            // For readability, we will use the term section to refer to subfolders
-            const section = fileOrFolder;
-            const articles: Article[] = [];
-
-            // Section can contain .md files directly and/or subfolders (and nested subfolders) that contain .md files
-            const sectionPath = `${docsDir}/articles/${platformName}/${hub}/${section}`;
-            for (const entry of fs.readdirSync(sectionPath)) {
-                const entryPath = `${sectionPath}/${entry}`;
-                if (entry.endsWith('.md') && fs.statSync(entryPath).isFile()) {
-                    const order = getOrderFromArticleFrontMatter(entryPath);
-                    articles.push(getArticleObj(entry, order));
-                    continue;
-                }
-                if (fs.statSync(entryPath).isDirectory()) {
-                    // One level: section/SubFolder/file.md -> href "SubFolder/file", display title = "Troubleshoot SubFolder"
-                    for (const file of fs.readdirSync(entryPath)) {
-                        const filePath = `${entryPath}/${file}`;
-                        if (file.endsWith('.md') && fs.statSync(filePath).isFile()) {
-                            const order = getOrderFromArticleFrontMatter(filePath);
-                            articles.push(getArticleObj(`${entry}/${file}`, order, `Troubleshoot ${entry}`));
-                            continue;
-                        }
-                        if (fs.statSync(filePath).isDirectory()) {
-                            // Two levels: section/SubFolder/NestedFolder/file.md -> href "SubFolder/NestedFolder/file", display title = "Troubleshoot NestedFolder" (e.g. "Troubleshoot Export Errors")
-                            for (const nestedFile of fs.readdirSync(filePath)) {
-                                if (!nestedFile.endsWith('.md')) {
-                                    continue;
-                                }
-                                const nestedPath = `${filePath}/${nestedFile}`;
-                                if (!fs.statSync(nestedPath).isFile()) {
-                                    continue;
-                                }
-                                const order = getOrderFromArticleFrontMatter(nestedPath);
-                                articles.push(getArticleObj(`${entry}/${file}/${nestedFile}`, order, `Troubleshoot ${file}`));
-                            }
-                        }
-                    }
-                }
-            }
+            const sectionPath = fileOrFolder;
+            const section = buildSection(platformName, hub, sectionPath, '');
+            pushOrCreateEntry(routeHubs, hub, 'sections', section);
+        }
 
-            pushOrCreateEntry(routeHubs, hub, 'sections', {
-                href: section,
-                title: toTitleCase(section.replaceAll('-', ' ')),
-                articles,
-            });
+        // Add flat section list for nested section page lookup
+        const hubObj = routeHubs.find((obj) => obj.href === hub);
+        if (hubObj?.sections?.length) {
+            (hubObj as Hub & {flatSections?: Section[]}).flatSections = flattenSections(hubObj.sections);
         }
     }
 }

docs/_includes/section.html

@@ -1,120 +1,30 @@
-{% assign urlArray = page.url | replace: '/', ' ' | split: " " %}
-
-{% assign activePlatform = urlArray[0] %}
+{% assign urlParts = page.url | split: '/' %}
+{% assign activePlatform = urlParts[1] %}
 {% assign platform = site.data.routes.platforms | where: "href", activePlatform | first %}
 
-{% assign activeHub = urlArray[2] %}
+{% assign activeHub = urlParts[3] %}
 {% assign hub = platform.hubs | where: "href", activeHub | first %}
 
-{% assign activeSection = urlArray[3] | remove: ".html" %}
-{% assign section = hub.sections | where: "href", activeSection | first %}
+{% assign hubPrefix = "/" | append: activePlatform | append: "/hubs/" | append: activeHub | append: "/" %}
+{% assign activeSectionPath = page.url | replace: ".html", "" | replace: hubPrefix, "" %}
+
+{% assign section = hub.flatSections | where: "href", activeSectionPath | first %}
 
 <h1 class="title">
     {{ section.title }}
 </h1>
 
 <section>
-    {% assign sortedArticles = section.articles | sort: 'order', 'last' | default: 999 %}
-
-    {% comment %} Render direct articles (no nested path) {% endcomment %}
     <div class="cards-group">
+        {% if section.sections %}
+            {% for subsection in section.sections %}
+                {% include section-card.html platform=activePlatform hub=hub.href section=subsection.href title=subsection.title %}
+            {% endfor %}
+        {% endif %}
+        {% assign sortedArticles = section.articles | default: empty %}
         {% for article in sortedArticles %}
-            {% unless article.href contains '/' %}
-                {% assign article_href = section.href | append: '/' | append: article.href %}
-                {% include article-card.html hub=hub.href href=article_href title=article.title platform=activePlatform %}
-            {% endunless %}
+            {% assign article_href = section.href | append: '/' | append: article.href %}
+            {% include article-card.html hub=hub.href href=article_href title=article.title platform=activePlatform %}
         {% endfor %}
     </div>
-
-    {% comment %} Collect unique subfolder names from nested articles {% endcomment %}
-    {% assign subfolders = "" %}
-    {% for article in sortedArticles %}
-        {% if article.href contains '/' %}
-            {% assign parts = article.href | split: '/' %}
-            {% assign subfolder = parts[0] %}
-            {% assign alreadyAdded = false %}
-            {% if subfolders != "" %}
-                {% assign existingSubfolders = subfolders | split: '|' %}
-                {% for existing in existingSubfolders %}
-                    {% if existing == subfolder %}
-                        {% assign alreadyAdded = true %}
-                    {% endif %}
-                {% endfor %}
-            {% endif %}
-            {% unless alreadyAdded %}
-                {% if subfolders == "" %}
-                    {% assign subfolders = subfolder %}
-                {% else %}
-                    {% assign subfolders = subfolders | append: '|' | append: subfolder %}
-                {% endif %}
-            {% endunless %}
-        {% endif %}
-    {% endfor %}
-
-    {% comment %} Render nested articles grouped under subfolder headings {% endcomment %}
-    {% if subfolders != "" %}
-        {% assign subfolderArray = subfolders | split: '|' %}
-        {% for subfolder in subfolderArray %}
-            <h3 class="title">{{ subfolder | replace: '-', ' ' }}</h3>
-
-            {% comment %} Render articles directly under this subfolder (2-segment paths like Troubleshooting/Overview) {% endcomment %}
-            <div class="cards-group">
-                {% for article in sortedArticles %}
-                    {% if article.href contains '/' %}
-                        {% assign parts = article.href | split: '/' %}
-                        {% if parts[0] == subfolder and parts.size == 2 %}
-                            {% assign article_href = section.href | append: '/' | append: article.href %}
-                            {% include article-card.html hub=hub.href href=article_href title=article.title platform=activePlatform %}
-                        {% endif %}
-                    {% endif %}
-                {% endfor %}
-            </div>
-
-            {% comment %} Collect unique sub-subfolders for 3-segment paths (e.g., Troubleshooting/Export-Errors/Overview) {% endcomment %}
-            {% assign subSubfolders = "" %}
-            {% for article in sortedArticles %}
-                {% if article.href contains '/' %}
-                    {% assign parts = article.href | split: '/' %}
-                    {% if parts[0] == subfolder and parts.size >= 3 %}
-                        {% assign subSubfolder = parts[1] %}
-                        {% assign ssAlreadyAdded = false %}
-                        {% if subSubfolders != "" %}
-                            {% assign ssExisting = subSubfolders | split: '|' %}
-                            {% for existing in ssExisting %}
-                                {% if existing == subSubfolder %}
-                                    {% assign ssAlreadyAdded = true %}
-                                {% endif %}
-                            {% endfor %}
-                        {% endif %}
-                        {% unless ssAlreadyAdded %}
-                            {% if subSubfolders == "" %}
-                                {% assign subSubfolders = subSubfolder %}
-                            {% else %}
-                                {% assign subSubfolders = subSubfolders | append: '|' | append: subSubfolder %}
-                            {% endif %}
-                        {% endunless %}
-                    {% endif %}
-                {% endif %}
-            {% endfor %}
-
-            {% comment %} Render sub-subfolder groups {% endcomment %}
-            {% if subSubfolders != "" %}
-                {% assign subSubfolderArray = subSubfolders | split: '|' %}
-                {% for subSubfolder in subSubfolderArray %}
-                    <h4 class="title">{{ subSubfolder | replace: '-', ' ' }}</h4>
-                    <div class="cards-group">
-                        {% for article in sortedArticles %}
-                            {% if article.href contains '/' %}
-                                {% assign parts = article.href | split: '/' %}
-                                {% if parts[0] == subfolder and parts[1] == subSubfolder %}
-                                    {% assign article_href = section.href | append: '/' | append: article.href %}
-                                    {% include article-card.html hub=hub.href href=article_href title=article.title platform=activePlatform %}
-                                {% endif %}
-                            {% endif %}
-                        {% endfor %}
-                    </div>
-                {% endfor %}
-            {% endif %}
-        {% endfor %}
-    {% endif %}
 </section>

docs/articles/new-expensify/connections/netsuite/Troubleshooting/Authentication-and-Login-errors/NS0029-Export-Error.md

@@ -0,0 +1,76 @@
+---
+title: NS0029 Export Error in NetSuite Integration
+description: Learn what the NS0029 export error means when exporting reports to NetSuite and what to do to resolve the connection issue.
+keywords: NS0029, NetSuite export error, unable to export report NetSuite, NetSuite connection issue, Expensify NetSuite integration, report export failed NetSuite, Workspace Admin
+internalScope: Audience is Workspace Admins using the NetSuite integration. Covers resolving the NS0029 export error caused by NetSuite connection issues. Does not cover general NetSuite integration setup or configuration.
+---
+
+# NS0029 Export Error in NetSuite Integration
+
+If you see the error:
+
+NS0029 Export Error: Unable to export this report due to an error.
+
+This means there is a connection issue between the Workspace and NetSuite.
+
+The error appears when you attempt to export a report to NetSuite and the export fails.
+
+---
+
+## Why the NS0029 Export Error Happens in NetSuite
+
+The NS0029 error typically indicates that Expensify is unable to successfully communicate with NetSuite at the time of export.
+
+Common causes include:
+
+- An expired or disconnected NetSuite integration.
+- Authentication issues between Expensify and NetSuite.
+- Permission changes in NetSuite.
+- Temporary connectivity issues.
+- A change to the NetSuite role or token used for the integration.
+
+Because this error is tied to the NetSuite connection, it cannot be resolved directly from the report itself.
+
+This is a connection or authentication issue, not a report data issue.
+
+---
+
+## How to Fix the NS0029 Export Error
+
+Follow the steps below to resolve the issue.
+
+### Retry the Export
+
+1. Open the report.
+2. Retry exporting to NetSuite.
+
+If the issue was temporary, the export may complete successfully.
+
+### Contact Concierge for Assistance
+
+If the error persists:
+
+1. Do not delete the report.
+2. Reach out to **Concierge**.
+3. Include:
+   - The report ID.
+   - Confirmation that you’re seeing the **NS0029 Export Error**.
+   - The approximate time the export was attempted.
+
+Concierge will review the NetSuite connection, check authentication and permission settings, and help restore the integration so you can export the report successfully.
+
+---
+
+# FAQ
+
+## Can I Retry the Export After Seeing the NS0029 Export Error?
+
+Yes. If the issue was temporary, retrying the export may resolve it. If it continues to fail, the integration likely needs review.
+
+## Does the NS0029 Export Error Affect Other Reports?
+
+Yes. If the issue is related to your NetSuite connection or authentication, other report exports may also fail until the connection is fixed.
+
+## Should I Reconnect NetSuite Myself?
+
+Do not disconnect the NetSuite integration unless directed by Concierge. Reconnecting without guidance may require reconfiguration.