Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Sep 17, 2025

This PR updates the FOCUS converter documentation to include the newly added fields in the FOCUS 1.2-preview specification, ensuring users have complete guidance for converting Cost Management data to the latest FOCUS format.

Key Changes

New FOCUS 1.2 Fields Added:

  • ServiceSubcategory - Added mapping with lookup to Services data file

Column Promotions and Renames:

  • Updated InvoiceId mapping notes (promoted from x_InvoiceId in FOCUS 1.0)
  • Updated PricingCurrency mapping notes (promoted from x_PricingCurrency in FOCUS 1.0)
  • Updated SkuMeter mapping notes (renamed from x_SkuMeterName in FOCUS 1.0)
  • Added SkuPriceDetails as new column that will eventually replace x_SkuDetails

Documentation Improvements:

  • Added comprehensive "Note for FOCUS 1.2 users" section explaining all changes
  • Updated document description to mention FOCUS 1.2-preview support
  • Clarified that x_SkuMeterName was renamed (not deprecated) to SkuMeter

The documentation now provides complete coverage for both FOCUS 1.0 and 1.2-preview specifications, focusing only on native FOCUS columns as intended, helping users understand the evolution of the FOCUS standard and how to properly convert their Cost Management data to the latest format.

Fixes #1817.


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

@Copilot Copilot AI changed the title [WIP] Documentation Updates for 1.2 FOCUS Update FOCUS converter documentation for 1.2-preview specification Sep 17, 2025
Comment on lines 86 to 89
_Extended columns (x_) specific to FOCUS 1.2:_

| x_AmortizationClass | Not available | Indicates how a row relates to amortization. Set to "Principal" for commitment discount purchases/refunds, "Amortized Charge" for usage, null otherwise. New in FOCUS 1.2. |
| x_ServiceModel | Not available | Indicates service model type: IaaS, PaaS, or SaaS based on what aspects of the service are managed by the provider. New in FOCUS 1.2. |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Remove these. This document is only intended to cover the native FOCUS columns. Also, these rows aren't attached to the markdown table.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed the extended columns section since this document should only cover native FOCUS columns. Changes made in commit 81e4cc9.

- `x_AmortizationClass` (new extended column)
- `x_ServiceModel` (new extended column)

The deprecated `x_SkuMeterName` column is replaced by the promoted `SkuMeter` column in FOCUS 1.2.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Say this column was renamed, not "deprecated".

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed "deprecated" to "renamed" when referring to the x_SkuMeterName column. Updated in commit 81e4cc9.

@microsoft-github-policy-service microsoft-github-policy-service bot added Needs: Attention 👋 Issue or PR needs to be reviewed by the author or it will be closed due to no activity and removed Needs: Review 👀 PR that is ready to be reviewed labels Sep 29, 2025
@microsoft-github-policy-service microsoft-github-policy-service bot added Needs: Review 👀 PR that is ready to be reviewed and removed Needs: Attention 👋 Issue or PR needs to be reviewed by the author or it will be closed due to no activity labels Sep 29, 2025
Copilot finished work on behalf of flanakin September 29, 2025 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Needs: Review 👀 PR that is ready to be reviewed Skill: DevOps GitHub setup and automation Skill: Documentation Documentation updates Tool: FinOps guide Implementing FinOps guide
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Documentation Updates for 1.2 FOCUS
4 participants