Web AppBuilder Migration Assistant

Automated preparation and manual review

Automated preparation produces an intermediate candidate, diagnostics and a manual-work list. The illustration shows the local Web AppBuilder path; the separate Story Map Series path adds a section and asset inventory. Both retain the source web-map connection. A generated candidate does not establish replacement behavior.

Local preparation makes no online writes. The optional online command adds explicit authentication and private-draft checks; it does not publish the app, clone its maps or layers, or establish that the intended audience can access them. Live sign-in and private-draft creation remain unverified.

What the adapters translate

These are configuration capabilities with explicit boundaries; their presence does not establish complete source-to-target behavior equivalence.

• Source inspection: automatic source-family detection, eligible widget or story resources, an accessible web map, and an inventory of unresolved settings.
• Classic Story Map Series: eligible published sections sharing one 2D web map become Advanced Bookmarks with sanitized narratives, embedded recovered PNG/JPEG images, valid saved extents, and known layer visibility. Unsupported sections and content remain recorded for manual rebuilding.
• Search: supported explicit feature-layer and locator sources, field bindings, labels, and compatible result limits.
• Filter: supported structured predicates, map-layer bindings, and selected activation and prompt settings.
• Query: supported tasks, predicates, result fields, output data sources, and Map display and zoom actions.
• Attribute Table: explicit layer and column choices, supported selection and extent settings, and export-menu controls.

Designed to fail visibly

• Versioned adapters: the target template and supported configuration structures are pinned, and conversion rules validate their inputs and target references before applying changes.
• Relationships, not just widgets: filter bindings resolve the actual map-layer identity, and Query tasks receive their own output data sources and the references needed for map interactions.
• Reviewable rejections: unsupported settings block the affected transformation and produce diagnostics, and source, map, metadata, and template fingerprints detect plans whose inputs have changed.
• Story recovery with limits: section visibility combines saved web-map defaults with explicit overrides. External or missing images, unsupported actions, retired-runtime state inheritance, synchronization, and exact accordion styling remain manual checks.
• Explicit table behavior: generated columns are read-only and actions that could create extra table sheets are disabled, with the limitations reported. Service permissions are not changed.
• Integrity is not behavior: checksums detect changed package files, while browser observations establish only the interactions that were exercised.

Private-draft workflow: implemented, tested offline

Version 0.8 adds an explicit online command with browser OAuth, a named saved profile, or explicitly selected ArcGIS Pro authentication. Package hashes, the configuration graph, and resources are checked before sign-in; the destination organization is checked before creating an item.

The adapter requests a private unpublished Web Experience with automatic remapping disabled, then checks the returned owner, Draft status, absence of published item data, and stored configuration. A receipt rechecks an existing item on resume. An uncertain upload without an item ID blocks automatic retry to avoid creating duplicates.

These contracts passed offline tests with simulated SDK responses. No live sign-in or item creation was attempted in the recorded v0.8 validation, and Builder edit/save/reload has not been verified.

Recorded validation, September 27 and October 1, 2026

These are separate recorded tests, not a migration success rate. The latest offline record is v0.8; the story preview was observed in v0.7, and the Query and Table observations belong to v0.6. The public story’s underlying study is dated May 8, 2019, so its charts are historical evidence rather than current statistics.

The story preview exercised all six section titles, three charts, rental and non-rental layer states, a heatmap, and return navigation. Theme-loading and local-preview service-worker warnings were recorded. This did not establish full equivalence to the retired source runtime. A separate real-source WAB Table case remained blocked by an unsupported subtype layer.