4.9 FOCUS Column Handling
Since:
0.5
Columns within FOCUS include an ID and a display name. Column IDs are used in dataset artifacts and display names can be used in report output and other descriptive content, like documentation. Column IDs provided in a FOCUS dataset follow consistent naming conventions for FinOps practitioners who consume the data for analysis, reporting, and other use cases.
4.9.1 Requirements
Column conforming to FocusColumnHandling attribute MUST adhere to the following requirements:
- FOCUS column MUST use a Display Name consistent with the Column ID, with spaces inserted between words (e.g., Column ID
BillingAccountNameand Display NameBilling Account Name, Column IDBillingAccountIdand Display NameBilling Account ID). - FOCUS column MUST use Pascal case in the Column ID.
- FOCUS column MUST use only alphanumeric characters in the Column ID.
- FOCUS column MUST NOT include special characters in the Column ID.
- FOCUS column MUST NOT use abbreviations other than
Idin the Column ID. - FOCUS column SHOULD NOT use acronyms other than
Skuin the Column ID. - FOCUS column SHOULD NOT exceed 50 characters in the Column ID to accommodate column length restrictions of various data repositories.
- FOCUS column representing an identifier MUST include the
Idsuffix in the Column ID. - FOCUS column representing a name MUST include the
Namesuffix in the Column ID. - FOCUS column representing a product offering that incurred a charge MUST include
Skuin the Column ID. - FOCUS column that includes the
Categorysuffix in the Column ID and is not null MUST contain one of the FOCUS-defined allowed values.
4.9.4 Description
Naming conventions for FOCUS columns appearing in a FOCUS dataset.