Troubleshoot export and navigation | Mingcedar Studio

<section id="common-questions" class="docs-block docs-block-intro docs-block-current"> <span class="section-kicker">Tips</span> <h2>Troubleshoot export and navigation</h2> <p>Check page names, resources, template values, and behavior targets before publishing; troubleshoot runtime results in Mingcedar.</p> <div class="docs-detail-list"> <article id="common-questions-item-1" class="docs-detail-row"> <strong>Missing runtime asset</strong> <p>If a required runtime asset is missing, confirm the full screen package was published and the menu points to its HTML entry. Ask the Mingcedar administrator to check shared runtime resources if the issue remains.</p> </article><article id="common-questions-item-2" class="docs-detail-row"> <strong>404 after navigation</strong> <p>Check whether the target is a PowerPoint page, exported file, relative path, Mingcedar screen, or external website. The target type and path must match the exported files.</p> </article><article id="common-questions-item-3" class="docs-detail-row"> <strong>Only one click works</strong> <p>Check the button&#39;s Condition and saved behavior, then inspect runtime errors. Export and publish the latest package before testing again.</p> </article><article id="common-questions-item-4" class="docs-detail-row"> <strong>Template content not visible</strong> <p>Confirm exported template assets, placeholder values, popup scope, and menu entry are present in Mingcedar.</p> </article><article id="common-questions-item-5" class="docs-detail-row"> <strong>Use this order before a formal export</strong> <p>Save pages and templates, clean up as needed, choose the export scope and directory, then check the exported main, popup and interaction pages.</p> <ul> <li>Save the presentation and templates.</li><li>Run Batch Replace within the intended scope.</li><li>Choose Export HTML or This Page according to impact.</li><li>Test key pages after export.</li> </ul> </article><article id="common-questions-item-6" class="docs-detail-row"> <strong>One PPT is one screen package</strong> <p>Treat one presentation as one complete screen package in Mingcedar. Keep page HTML, SVG, page scripts, images, and manifests together. Do not maintain the package as unrelated loose files.</p> <ul> <li>Same-package navigation: hqVisuDesigner.openPage(...).</li><li>Cross-package navigation: hqVisuDesigner.openScreen(screenCode).</li><li>Keep the exported directory structure intact.</li><li>Use a full package for formal delivery and version archives.</li> </ul> </article><article id="common-questions-item-7" class="docs-detail-row"> <strong>Choose full-package or current-page export</strong> <p>Use Export HTML for first release, formal delivery, shared files, page additions or removals, page renames, and navigation changes. Use This Page only for a clearly isolated page change whose Page Code and package structure remain unchanged.</p> <ul> <li>Formal delivery: full package.</li><li>Local page-only update: This Page.</li><li>Any change crossing the current page boundary: full package.</li><li>Decide whether this run is a preview or a release before choosing the folder.</li> </ul> </article><article id="common-questions-item-8" class="docs-detail-row"> <strong>What Batch Replace can change</strong> <p>Batch Replace scans the current selection or page across Bindings &amp; tags, Animations &amp; behaviors, Scripts, Targets &amp; links, Page &amp; shape text, and Colors. It builds a read-only preview first; the document changes only after Replace. Find is exact and case-sensitive, with surrounding spaces ignored.</p> <ul> <li>Scope: Selected content or Current page.</li><li>Variables: detected template variables in the active scope.</li><li>Categories: choose allowed types and click Apply filter.</li><li>Preview: Type, Object, Replace in, Current value, Replacement preview.</li><li>Find next or F3: move to the next exact match.</li><li>Blank Replace with: remove each exact match.</li> </ul> </article><article id="common-questions-item-9" class="docs-detail-row"> <strong>Run Batch Replace from filter to replacement</strong> <p>Select the intended objects, or leave the selection empty for the current page. Open Batch Replace, verify Scope, choose Categories, and click Apply filter. Enter Find and Replace with, review every replacement preview, use Find next to locate uncertain rows in PowerPoint, then click Replace.</p> <ul> <li>A few objects only: select them before opening the window.</li><li>Current page: confirm Scope says Current page.</li><li>Color changes: use the color buttons and enable Colors.</li><li>Unexpected preview rows: remove that category and apply the filter again.</li><li>After Replace, inspect text, tags, scripts, links, and colors on the slide.</li> </ul> </article><article id="common-questions-item-10" class="docs-detail-row"> <strong>Separate template variables from display text</strong> <p>Template-variable matches identify instance parameters such as &lt;PLC&gt; or &lt;RUN_TAG&gt;. Page text, Default Text, and Language Key belong to display configuration. Review Type and Replace in before replacing so an instance parameter is not mistaken for visible copy.</p> </article><article id="common-questions-item-11" class="docs-detail-row"> <strong>Plan export folders and versions</strong> <p>Use separate locations for previews and formal releases, and include a clear release identifier in the parent directory name. Export History remembers paths only; it does not classify a release or preserve package versions.</p> </article><article id="common-questions-item-12" class="docs-detail-row"> <strong>Export History is not version control</strong> <p>Export History remembers recent paths; clearing entries does not delete directories. Keep release directories or version archives for rollback.</p> </article><article id="common-questions-item-13" class="docs-detail-row"> <strong>Publish and acceptance check</strong> <p>Upload the complete export result to Mingcedar, configure the menu entry, and open the package. Test page navigation, popups, tag reads, tag writes, language text, template inputs, charts, and browser-console errors before handoff.</p> <ul> <li>The expected entry page opens.</li><li>Every same-package and cross-package link reaches the correct target.</li><li>Writes show the expected permission, confirmation, reason, and result.</li><li>Images, templates, scripts, and charts load without missing resources.</li><li>The package can be traced to the source PPT and release folder.</li> </ul> </article> </div> <div class="docs-note-grid"> <figure id="common-questions-image-1" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/current-20261021/batch-replace.png" alt="Mingcedar Batch Replace dialog" loading="lazy" decoding="async"> <figcaption> <strong>Batch Replace</strong> <p>Check Scope, Categories, and the preview table first. This example lists searchable items; the document changes only after Replace.</p> </figcaption> </figure><figure id="common-questions-image-2" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/current/maintenance/export-folder.png" alt="Mingcedar Export HTML dialog" loading="lazy" decoding="async"> <figcaption> <strong>Export HTML</strong> <p>Choose the export folder and recent locations before exporting runtime HTML, SVG, CSS, JS, and image assets.</p> </figcaption> </figure><figure id="common-questions-image-3" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/current/maintenance/export-history.png" alt="Mingcedar recent export locations" loading="lazy" decoding="async"> <figcaption> <strong>Export history</strong> <p>Export history remembers recent folders, but it is not a version manager or rollback tool.</p> </figcaption> </figure><figure id="common-questions-image-4" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/current/maintenance/export-progress.png" alt="Mingcedar export progress and log" loading="lazy" decoding="async"> <figcaption> <strong>Export progress</strong> <p>The window shows export status, a progress bar, and execution logs; keep the PowerPoint file and export folder available when troubleshooting.</p> </figcaption> </figure> </div> </section>