How to use the Bulk Edit Function for Board Tasks

Modified on Mon, 17 Oct 2022 at 11:11 PM

You are now able to update board data to your Fluid instance offline and in bulk, through the use of the Fluid Bulk Edit function. 


In this article, we will cover the steps on how to go about updating your board data via the Bulk Edit function. 



Step 1. Access the Bulk Edit function


  • To access the Bulk Edit functionality, navigate to the board that you wish to update. Select Tools underneath your profile avatar, (top right of the page) and when the dropdown menu appears, select Bulk Edit.



Step 2. Download the data file


  • If you want to download the excel file with existing data from the board, ensure that Include existing data is ticked. To extract a blank file, untick the box. 


  • Click on Download.



Step 3. Access the downloaded file and edit the data


  • Locate and open the bulk edit excel file that you just downloaded. Add or edit all of the required changes and save the file.


See the table at the bottom of this page for a full description of each column.


Step 4. Upload the data file

 

  • When you are happy with your changes, navigate back to the open Bulk Edit dialogue in Fluid, and select Upload. Select the file that you just worked on and upload it.


NOTE: If you are uploading items to a different board, first navigate to the board that you wish to upload to, and open the bulk edit dialogue from there.


The progress bar will indicate when the upload process is completed, and if any errors have occurred during the upload process, they will be listed below the progress bar. 



DATA FILE COLUMN DESCRIPTION



Remember when populating the excel:
  • changes will only be applied if you have the right permissions to the board to make the data changes.
  • make sure to populate the SprintName column value with the name of the board you want the tasks to be uploaded to. If left blank, all tasks will be saved in the backlog. See below for more details.



Column & Title

Description

What happens if this field is left blank?
A. IdThe task unique Id of the task. This value is set by the system when a new task is created and is used to uniquely identify the record. This field should, therefore, be left blank when creating a new task.When updating existing tasks on a board, this is the ID that will be used to match the record in the excel to a task on the board.

If this field is blank then the upload will check the Guid (column P). If this is also missing the upload will not match to an existing task and a new task will be created.
B. ShortIdThe task unique identifier within the board. This value is set by the system and cannot be updated.Information purposes only. It is not necessary to populate this column on upload. 
C. TitleThe task title.This is the only mandatory field to complete in order to add or update a task.
D. DescriptionThe task description. This is a detailed explanation of the task.No description will be set.
E. AssignedToThe task assignees. Tasks can be assigned to: 
  • People
  • Projects
  • Workhubs
It is not necessary to populate this column on upload. 

Full names for assignees, project name and workhub name, are just display text and are included in extracts to help you better identify who is assigned to an item. The User ID (column F) is the actual identifier that is used to match the assignee to an account/project/workhub in Fluid.
F. AssignedToIdIf the assignee is a person, then the value should be the assignee's username. If the assignee is a project or workhub, then the value should be the unique Fluid ID for the project or workmen entity.This is the unique identifier Fluid will use to set the assignees - if this field is left blank, no assignees will be added to the item.
G. StatusThe task status. Status values will vary depending on the customised columns of the board.

If the board is configured to include Project Pipeline, the status will be used to automatically create the project on the board task. 
  • the task will be dropped into the first column on the board, if the SprintName value is set to a board; OR
  • the task will be set to backlog if the SprintName value is blank, Backlog or _backlog
H. SprintNameThe name of the board which the task will be added to.

To add a task to backlog, you can:
  • leave the value blank
  • set the value to Backlog or _backlog


To add a task to the board, you need to set the value to the board name you want to add the task to.

If left blank the task will be dropped into the BACKLOG of the board.
I. TaskTypeThe task type.The type will default to Task.
J. PointsThe points of effort that it will take to complete the task.Points will default to 1 point.
K. ImpactThe impact that the task will have on the business overall.Impact will default to 1 point.
L. PriorityThe priority of the task – High, Medium or Low.Priority will default to Medium.
M. DueDateThe date that the task is due.No due date will be added.
N. ThemeThe task's theme.No theme will be selected.
O. ImpedimentThe factor that may slow the progress of the task down. Set as "No" by default in Fluid.Impediment flag will default to FALSE / NO.
P. GuidThe unique string identifier for the task.When updating existing tasks on a board, the Guid is used to match the record in the excel to a task on the board.

If this field is blank then the upload will check the ID (column A). If this is also missing, the upload will not match to an existing task and a new task will be created.
Q. DeleteRecordIf you want to delete a task altogether, type in Yes. Remember, deleting a task this way is irreversible.The task will not be deleted.

 





Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article