Publishing a Mockup

Publishing the Mockup

Publishing a mock-up  is a simple yet critical step in the project workflow. This guide will walk you through the process step-by-step to ensure you do it like a pro. Follow the steps below to seamlessly publish your mock-up.

 You have two options to publish your mockup:

1. Publish the Mockup to an Existing Work Item 

2. Publish the Mockup to a New Work Item 

Note: Once a work item has been published, it can only be republished to the original work item to which it was first published. During republishing, the "Publish to New Work Item" option will be disabled. Only the "Publish to Existing Work Item" option will be available, with the originally published work item pre-selected and locked to prevent modification by the user.

However, during the initial publishing process, both options—"Publish to New Work Item" and "Publish to Existing Work Item"—will be enabled, allowing the user to select either.

To an Existing Work Item 

1. Once your mock-up is ready for publishing, the first thing you need to do is click the Publish button. This action triggers the process of publishing your mock-up to a work item.

2. After clicking the Publish button, a menu will appear with options for publishing. Select the Existing Work Item option from this menu to proceed. This will direct you to the next steps for assigning your mock-up to an existing work item.

3. A pop-up window will appear titled Publish to Existing Work Item. The first mandatory thing you need to do is selecting the Work Item to which you wish to publish your mock-up.

4. Search for the existing work item via ID or Title. Select the Work Item that best aligns with your mock-up.

5. Next, you need to select the Work Item Field where your mock-up will be published. Choose a field that best fits the type of content you are attaching.

6. The Link to workitem field is preselected with the workitem you choose as a reference.

7. Now the user has to select the link type for the Link type drop down menu.

Mandatory Fields Scenario

• Mandatory fields for a work item appear within a light gray box labeled Mandatory Fields.

Note: Mandatory fields only appear when the user configures specific fields as mandatory. If no mandatory fields are configured, the mandatory fields option does not display. When mandatory fields are configured and the user does not provide values for them, the 'Publish' button remains disabled until the user enters the mandatory information. If no mandatory fields are configured by the user, the button remains enabled by default.

• Mandatory fields for a work item appear within a light gray box labeled Mandatory Fields.

• A red icon marks required fields, clearly showing that they must be filled in.

• Add the required field info in the fields mentioned in the ‘Mandatory Field' box.

• Once you enter information in the field, the red label beside it is removed.

• The Publish button becomes enabled only after you complete all required fields for the work item type selected in the Create Work Item window.

8. Below the Link Type selection, you'll see a Check Box labeled Add Mock-Up File(s) in Attachment. If you want your mockup files to be attached, check the box to enable the attachment functionality.

Note: When the work item has been updated, the added attachments will be visible in ADO. 

9. At the bottom of the pop-up window, there will be another check box labeled "Replace selected information in the field". This option allows you to replace the existing information in the chosen field with your new mock-up.

Note: If you want to update the field with the new mock-up, check this box. If you do not wish to replace the existing content, leave the box unchecked.

10. Once you have completed all the necessary fields and options, review your selections carefully. When you are satisfied with your inputs click the Publish button. This will push your mock-up to the selected work item and field, updating it accordingly.

11. Once done, the updated work item can be seen by the user below the prompt area along with a notification that the Mockup has been published to an existing work item successfully. 

12. Along with the updated existing work item that is shown below, you will see a Copilot4DevOps icon. With this option you can open the work item in any other feature of Copilot4DevOps. 

To a New Work Item

1. Once your mock-up is ready, the first thing you need to do is click the Publish button. This will open the options for publishing your mock-up.

2. After clicking the Publish button, a menu will appear with two options: Existing Work Item and New Work Item. Select the New Work Item option to proceed with creating a new work item and publishing the mock-up.

3. A pop-up window will appear with several mandatory fields to complete.

4. The first field you'll need to fill in is the Work Item Title. This is where you define the title of the new work item. Enter a unique title for the new work item that clearly describes its purpose.

5. Once you've defined the work item title, the next step is to choose the Work Item Type. This field will allow you to categorize the new work item.
Click the drop-down menu and select the appropriate Work Item Type.

6. Next, you will need to select the Work Item Field where your mock-up will be published. Choose the field in which the mock-up's details will be stored.

7. Below the field selection, you'll see a Check Box labeled Add MockUp File(s) in Attachments. If you want the mockup file to be attached check the box to enable file attachment.

Note: When the new work item has been created, the added attachments will be visible in ADO. 

8. After filling out the necessary fields and making your selections, Click Publish. 

9. Once done, the new work item can be seen by the user below the prompt area along with a notification at the top.

10. Along with the New Work Item  you will see a Copilot4DevOps icon. With this option you can open the new work item in any other feature of Copilot4DevOps.