Summary

There is an inconsistency in the naming of the username format organization variable across Rewst platform workflows and documentation. This inconsistency causes confusion during implementation and can lead to workflows failing silently when the wrong variable name is referenced.

Current Situation

The official Rewst documentation (Microsoft User Onboarding Crate v2) defines the variable as user_name_format, while the [Rewst Master v2] - Username Format Options workflow references username_format (without the underscore between "user" and "name"). These are two distinct variable names, meaning a workflow checking for one will not find the other, even if the correct value has been configured by the MSP.

Impact

MSPs configuring user onboarding workflows may set either user_name_format or username_format depending on which source they reference — the documentation or the existing platform workflow. This results in option generator workflows returning no value or falling back to a default format, producing incorrect usernames without any clear error message indicating why.

Proposed Solution

Standardize the variable name to user_name_format across all platform workflows, crates, and documentation, as this is the name defined in the official documentation. Specifically, the [Rewst Master v2] - Username Format Options workflow should be updated to reference ORG.VARIABLES.user_name_format instead of ORG.VARIABLES.username_format. All related crate workflows and documentation should be audited to ensure consistent use of the standardized name.

Workaround

Until this is resolved, workflows can handle both variable names by using: {%- set format = ORG.VARIABLES.user_name_format | default(ORG.VARIABLES.username_format) | default('first_last', true) | lower | trim -%}