Exercise - Work with Azure Boards
This exercise is written to use the Cronus sample company from the US version of Business Central. You might need to make adjustments to the steps if you use the sample company from your country or region.
Scenario
You are a developer working for CRONUS International Ltd. You need to work on a new feature, and therefore want to use Azure Boards to track the different tasks for the development of the feature.
Tasks
Add a new Issue in the Work Items list.
Create a new Iteration
Add the Issue to the iteration
Create tasks for the issue
Implement tasks in Code
Link issue to the code changes
Steps
Open your Azure DevOps environment and select the Hello Business Central project. (You can also use another project to follow along with the exercise if you don't have this project.)
Go the Boards section and select Work Items. Create a New Work Item using the drop-down button and select Issue.
Use Add LinkedIn field to Customer Pages as the title for the Issue. Assign the task to yourself.
Enter the following text in the Description field: Add the LinkedIn field to the Customer Card and Customers List pages.
Save the work item. Write down the number of the issue.
Select Backlogs in the left menu. On the right side of the window, you should see a Planning pane. If this isn't visible, then you need to select the fourth icon View Options from the right of the window (a configuration mixer icon). Select Planning in the drop-down menu.
You should see an iteration Sprint 1 or Iteration 1. Drag the newly created feature from the middle of the window to this first iteration.
Select link Set dates. Select this link to set the dates of your sprint. Typically, this will take two weeks.
Select the Taskboard tab in this Iteration window. Your Issue should be visible. In the To Do column, next to the Issue, select the + icon to add a new task.
Create a task with the name Add LinkedIn to Customer Card.
Create another task with the name Add LinkedIn to Customers List.
Assign both tasks to yourself and drag the first task to the column Doing. Write down the ID of the task.
Select Branches in the Repos section in the left menu and select the blue New branch button on top of the page. Give the new branch the name feature-{number_of_your_issue}. Select master as the branch Based on and select Create. Replace number_of_your_issue with the number you wrote down earlier.
Open Visual Studio Code, and open your Hello Business Central project. Press F1 to open the command palette. Type: Git: Fetch and select the command. This will retrieve changes from the remote repository.
Select the master branch button in the left bottom corner. This will open a list where you can select your branch. You'll see your remote branch origin/feature-{number_of_your_issue}. Select that branch to create a local branch linked to the new remote branch.
Add a new page extension for the Customer Card. Add the LinkedIn field to the layout. Use the AddAfter section. You can use AddAfter(Email).
Open the Source Control view and add the newly created file to the staging area.
Add a commit message Added LinkedIn to Card #{id_of_your_task} and commit your changes to your local repository. Replace id_of_your_task with the ID you wrote down earlier.
Use the sync button to synchronize your changes with the remote repository.
Open Azure DevOps, go to branches. You should see a box indicating that your branch contains changes. Select the create pull request button.
Your pull request should merge from feature-{number_of_your_issue} to the master branch.
Add yourself as reviewer and optionally other persons in the organization.
Select the Create button to save your changes.
In the pull request window, select the approve button, and select the blue complete button.
In the complete window, select delete the branch after merging. Also select to complete the associated work items. This will set your task to Done.
The pull request should now be completed, and your changes merged into the master branch.