Cartographer developer reference
Integration boundary
Section titled “Integration boundary”Search and WhereUsed are useful investigation boundaries. Review confidence, unreadable and pending indicators. The planned usage-provider design is not yet a published third-party implementation SDK.
pfx_CartographerSearch
Section titled “pfx_CartographerSearch”Reads catalogue search results. An empty result does not prove the environment has no matching component; check scan scope and freshness.
Transport: unbound Dataverse action; JSON string Request in, JSON string Response out. pfx_ is a prefix token, not a literal deployment name. Read the calling conventions first.
Request
Section titled “Request”{ "query": "account", "kinds": [ "table" ], "top": 20}query: search text. kinds: optional kind filter. top: requested result limit. Each result has kind, key and title, with optional context. truncated signals incomplete results.
Response
Section titled “Response”{ "results": [], "truncated": false}Permissions and failures
Section titled “Permissions and failures”The schema requires Read privilege on pfx_CatalogTable. Prefix tokens in table names resolve with the installed publisher. Record access, module role checks and input validation can further restrict the call. Do not interpret a missing execute privilege as anonymous or unrestricted access.
Handle a Dataverse fault separately from validation findings in the response. Test invalid input and the intended non-administrator role. Do not treat an empty result as a grant of access or a guarantee that no configuration exists.
Plugin steps and customizations
Section titled “Plugin steps and customizations”Selected schema-declared registrations are shown for troubleshooting context. This is not a complete installed registration inventory. Preserve module-owned registrations; do not duplicate or disable them.
| Owned registration | Message / table | Declared stage / mode |
|---|---|---|
| Cartographer: protect table create | Create · pfx_catalogtable |
PreOperation / Sync |
| Cartographer: protect table update | Update · pfx_catalogtable |
PreOperation / Sync |
| Cartographer: protect table delete | Delete · pfx_catalogtable |
PreOperation / Sync |
The full execution path may also include dynamically maintained registrations. Inspect the installed solution for exact stage, mode, filters and images before investigating interactions with your own plugins.
Before building against this preview
Section titled “Before building against this preview”Confirm the installed operation name and permissions. Test representative data, empty results and denied access. Keep your integration in its own solution, and review contract changes before upgrading.