Skip to content

MetricMinder developer reference

PreviewMetric is the next inspection boundary, with contributing rows and explicit cap/status information. Preserve exactValue where supplied rather than rounding via binary floating point. Do not update calculated buckets directly.

Checks a definition without activating a metric. Actual warnings depend on environment metadata and timezone configuration; do not assume the illustrative empty warnings array.

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.

Inner Request — illustrative
{
"definition": "{\"v\":1,\"kind\":\"aggregate\",\"source\":{\"table\":\"task\"},\"value\":{\"aggregate\":\"count\"},\"date\":{\"column\":\"createdon\",\"grains\":[\"month\",\"allTime\"]},\"subjects\":[{\"kind\":\"path\",\"path\":[\"regardingobjectid\"],\"tables\":[\"account\"]}]}"
}

definition: required JSON string, not a nested object. ok reports validation success; errors and warnings are string arrays.

Inner Response — illustrative
{
"ok": true,
"errors": [],
"warnings": []
}

The schema requires Write privilege on pfx_Metric. 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.

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
MetricMinder: guard metric activation on create Create · pfx_metric PreOperation / Sync
MetricMinder: guard metric activation on update Update · pfx_metric PreOperation / Sync
MetricMinder: guard metric authoring on create Create · pfx_metric 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.

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.

Administrator guide · Extension boundaries