Skip to content

Commit 9ff5df2

Browse files
authored
Work item types for deliverables and workshops (#605)
1 parent 7b4f76b commit 9ff5df2

12 files changed

Lines changed: 3102 additions & 42 deletions

guidance/TOC.yml

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -369,10 +369,16 @@ items:
369369
href: business-processes/about-import-catalog-devops.md
370370
- name: Work item types in Azure DevOps
371371
href: business-processes/about-import-catalog-devops-process-work-item-types.md
372-
- name: Manage updates to the catalog in Azure DevOps
373-
href: business-processes/about-import-catalog-devops-updates.md
372+
- name: Deliverables work item types in Azure DevOps
373+
href: business-processes/about-devops-work-items-deliverables.md
374374
- name: Other work items types in the template
375375
href: business-processes/about-devops-work-items-other.md
376+
- name: Workshop work item type in Azure DevOps
377+
href: business-processes/about-import-catalog-devops-workshop-work-item-type.md
378+
- name: Manage updates to the catalog in Azure DevOps
379+
href: business-processes/about-import-catalog-devops-updates.md
380+
- name: Reference for fields on work items
381+
href: business-processes/about-devops-work-items-deliverables-fields.md
376382
- name: Import the catalog to Mavim
377383
items:
378384
- name: Import the catalog to Mavim overview
@@ -397,6 +403,8 @@ items:
397403
href: implementation-guide/process-focused-solution-define-requirements.md
398404
- name: Learn about process maturity
399405
href: business-processes/process-maturity-introduction.md
406+
- name: Use the catalog to drive workshops
407+
href: business-processes/about-workshops.md
400408
- name: Standardize business processes during an implementation
401409
href: business-processes/standardize-business-processes.md
402410
- name: Map departments and business processes

guidance/business-processes/about-catalog-levels.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Dive into the structured hierarchy of the business process catalog,
44
author: edupont04
55
ms.author: edupont
66
ms.reviewer: edupont
7-
ms.date: 12/10/2025
7+
ms.date: 01/12/2026
88
ms.topic: concept-article
99
---
1010

@@ -32,13 +32,13 @@ The following list provides a few examples of this level of the business process
3232

3333
The following table outlines key properties of an end-to-end process.
3434

35-
|Property|Description |
36-
|---------|---------|
37-
|Comprehensive |An end-to-end process covers the entire lifecycle of a business operation.|
38-
|Cross-functional |An end-to-end process involves multiple departments or functions.|
39-
|Outcome-oriented |An end-to-end process focuses on delivering a specific business outcome.|
35+
| Property | Description |
36+
| --------- | --------- |
37+
| Comprehensive | An end-to-end process covers the entire lifecycle of a business operation. |
38+
| Cross-functional | An end-to-end process involves multiple departments or functions. |
39+
| Outcome-oriented | An end-to-end process focuses on delivering a specific business outcome. |
4040

41-
## What an end-to-end process isn't
41+
### What an end-to-end process isn't
4242

4343
The following list outlines what an end-to-end process isn't.
4444

guidance/business-processes/about-devops-work-items-deliverables-fields.md

Lines changed: 202 additions & 0 deletions
Large diffs are not rendered by default.

guidance/business-processes/about-devops-work-items-deliverables.md

Lines changed: 654 additions & 0 deletions
Large diffs are not rendered by default.

guidance/business-processes/about-devops-work-items-other.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Discover how the Azure DevOps template supports structured project
44
author: edupont04
55
ms.author: edupont
66
ms.reviewer: edupont
7-
ms.date: 12/19/2025
7+
ms.date: 01/07/2026
88
ms.topic: concept-article
99
---
1010

@@ -423,16 +423,16 @@ Here's an example of a status report: *Steering committee status report*
423423

424424
The following fields are recommended for the **Status Report** work item type and included by default in the Azure DevOps template for the business process catalog:
425425

426-
|Name |Description |
427-
|---------|---------|
428-
|Title| Display name of the status report, such as *Week 47 Status Report*.|
429-
|Reporting Period|Start and end dates.|
430-
|Summary| Narrative of progress and outlook.|
431-
|KPIs| Quantitative indicators (% completion, defect counts).|
432-
|Risks / Issues / Decisions|Highlights by category.|
433-
|Next Steps| Planned actions for upcoming period.|
434-
|Status| Current state (Draft, Published, Archived).|
435-
|Tags| Labels for capability, phase, priority classification.|
426+
| Name | Description |
427+
| -- | -- |
428+
| Title | Display name of the status report, such as *Week 47 Status Report*. |
429+
| Reporting Period | Start and end dates. |
430+
| Summary | Narrative of progress and outlook. |
431+
| KPIs | Quantitative indicators (% completion, defect counts). |
432+
| Risks / Issues / Decisions | Highlights by category. |
433+
| Next Steps | Planned actions for upcoming period. |
434+
| Status | Current state (Draft, Published, Archived). |
435+
| Tags | Labels for capability, phase, priority classification. |
436436

437437
When users create new work items based on this work item type, recommend that they also take the following steps:
438438

guidance/business-processes/about-import-catalog-devops-process-work-item-types.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Track your implementation of business process scenarios in your Dyn
44
author: edupont04
55
ms.author: edupont
66
ms.topic: concept-article
7-
ms.date: 12/10/2025
7+
ms.date: 01/12/2026
88
ms.custom:
99
- ai-gen-docs-bap
1010
- ai-gen-description
@@ -27,23 +27,23 @@ Learn more at [Overview of the business process catalog levels](about-catalog-le
2727

2828
The tree is organized into six levels with increasing granularity:
2929

30-
- **Level 1 – end-to-end processes:** Broad business capabilities such as [Order to Cash](order-to-cash-overview.md) or [Source to Pay](source-to-pay-overview.md).
30+
- **Level 1 – end-to-end processes**: Broad business capabilities such as [Order to Cash](order-to-cash-overview.md) or [Source to Pay](source-to-pay-overview.md).
3131

32-
- **Level 2 – process areas:** Logical groupings within an end-to-end process, such as*Manage Sales Orders*.
32+
- **Level 2 – process areas**: Logical groupings within an end-to-end process, such as [Manage accounts payable](source-to-pay-manage-accounts-payable-overview.md).
3333

34-
- **Level 3 – business processes:** Specific functions that describe what the business does, system-agnostic and reusable across industries.
34+
- **Level 3 – business processes**: Specific functions that describe what the business does, system-agnostic and reusable across industries, such as [Process supplier rebates and incentives](source-to-pay-process-vendor-rebates-incentives-overview.md).
3535

36-
- **Level 4 – scenarios or patterns:** Variations of processes for different industries or solution approaches.
36+
- **Level 4 – scenarios or patterns**: Variations of processes for different industries or solution approaches, such as *Manage supplier prepayments in Dynamics 365 Finance* or *Create a prepayment on a purchase order in Dynamics 365 Business Central*.
3737

38-
- **Level 5 – system processes:** Detailed steps tied to specific forms or pages in Dynamics 365.
38+
- **Level 5 – system processes**: Detailed steps tied to specific forms or pages in Dynamics 365, such as *Create vendor prepayment using payment journal* for the steps in Dynamics 365 Finance or *Create prepayment invoices* for the steps in Dynamics 365 Business Central.
3939

40-
- **Level 6 – test cases:** Actions for validating functionality during testing phases.
40+
- **Level 6 – test cases**: Actions for validating functionality during testing phases.
4141

4242
This layered structure ensures that projects can start at a high level and drill down to detailed, actionable items as needed. Learn more at [Overview of the business process catalog levels](about-catalog-levels.md).
4343

4444
## Using the tree in Azure DevOps
4545

46-
In Azure DevOps, you implement the catalog tree through custom work item types that mirror these levels. Each level corresponds to a work item type, such as **end-to-end**, **Process Area**, **Business Process**, and **Scenario**, and links hierarchically to maintain traceability. This structure enables teams to manage scope, track progress, and align deliverables with business objectives. By importing the catalog into Azure DevOps, your organization gains a standardized framework for planning, fit/gap analysis, and execution. It also supports integration with testing tools like RSAT, ensuring that processes documented in the tree flow seamlessly into test cases and quality assurance activities.
46+
In Azure DevOps, you implement the catalog tree through custom work item types that mirror these levels. Each level corresponds to a work item type, such as **End to end**, **Process Area**, **Business Process**, and **Scenario**, and links hierarchically to maintain traceability. This structure enables teams to manage scope, track progress, and align deliverables with business objectives. By importing the catalog into Azure DevOps, your organization gains a standardized framework for planning, fit/gap analysis, and execution. It also supports integration with testing tools like RSAT, ensuring that processes documented in the tree flow seamlessly into test cases and quality assurance activities.
4747

4848
One of the primary functions of this tree is to define project scope. By mapping all business processes and their variations into a structured hierarchy, the catalog provides a clear view of what is in scope for the implementation. This view helps stakeholders agree on boundaries early in the project, reduces ambiguity, and ensures that any gaps or enhancements are identified and managed systematically. Scope definition at this level also supports governance and change control, as you can trace any additions or modifications back to specific processes and their related work items.
4949

guidance/business-processes/about-import-catalog-devops-workshop-work-item-type.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Track the work needed for workshops in your Dynamics 365 implementa
44
author: edupont04
55
ms.author: edupont
66
ms.topic: concept-article
7-
ms.date: 06/11/2025
7+
ms.date: 01/07/2026
88
ms.custom:
99
- ai-gen-docs-bap
1010
- ai-gen-description
@@ -61,4 +61,5 @@ Find the related articles here:
6161

6262
- [Use the business process catalog as a template in Azure DevOps Services](about-import-catalog-devops.md)
6363
- [Custom work item type for processes in the Dynamics 365 business process catalog](about-import-catalog-devops-process-work-item-types.md)
64-
- [Custom work item type for configuration deliverables in the Dynamics 365 business process catalog](about-import-catalog-devops-configuration-deliverable-work-item-type.md)
64+
- [Custom work item type for configuration deliverables in the Dynamics 365 business process catalog](about-import-catalog-devops-configuration-deliverable-work-item-type.md)
65+
- [Workshop preparation for Dynamics 365 implementation projects](about-workshops.md)

guidance/business-processes/about-whats-new-2025-december.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: What's new or changed in the December 2025 version of the business
44
author: edupont04
55
ms.author: edupont
66
ms.reviewer: edupont
7-
ms.date: 12/09/2025
7+
ms.date: 01/07/2026
88
ms.topic: concept-article
99
---
1010

@@ -131,12 +131,14 @@ This release adds a dedicated **Jobs** work item type to the Deliverables tree,
131131
> [!NOTE]
132132
> These entries represent jobs in finance and operations apps, such as [batch jobs](/dynamics365/fin-ops-core/dev-itpro/sysadmin/batch-processing-overview) or [scheduled tasks](/dynamics365/supply-chain/production-control/job-scheduling). They don't represent jobs in Dynamics 365 Business Central that are now [projects](/dynamics365/business-central/projects-manage-projects).
133133
134-
135134
## Updated Business Central scenarios
136135

137136
We removed erroneous descriptions for 35 Business Central scenarios in *Project to Profit*. We also updated five Business Central-related scenarios that had mismatched values in the **Process Sequence ID** field. Thank you, Marcin, for submitting these issues and collaborating to ensure the catalog is accurate.
138137

139138
## Related information
140139

140+
- [Overview of the business process catalog levels](about-catalog-levels.md)
141+
- [Other work item types in the business process catalog](about-devops-work-items-other.md)
142+
- [Workshop preparation for Dynamics 365 implementation projects](about-workshops.md)
141143
- [What's new or changed in the business process catalog](about-whats-new.md)
142144
- [About the business process catalog for Dynamics 365 apps and services](about.md)

0 commit comments

Comments
 (0)