Custom Extensions
Custom Extensions
Course content:
- Learn how to create customizable extensions with ITM Platform
- Create functionality
- Alter standard behavior
- Connect ITM Platform with other applications
Task Statuses: Customization and Implementation
Task Statuses: Customization and Implementation
On ITM Platform, tasks of all project types can have different statuses. All statuses are based on five basic statuses: Backlog, Pending, In Progress, Completed, and Archive. Three of them (Pending, In Progress, and Completed) are operational, and only on them is it possible to create customizable statuses.
Customizable Task Statuses:
ITM Platform offers three operational states as standard, which are based on the Pending, In Progress, and Completed base states. You can change these or create new ones so that task states reflect your processes.
Task statuses can be created and customized for both waterfall and agile projects. In the following sections, we explain how.
Non-customizable Task Statuses:
There are two complementary task statuses: Backlog and Archive. You cannot create statuses based on Backlog and Archive.
They are also present in Agile and Waterfall projects.
Implementation of Task Statuses in Waterfall Projects:
For predictive (Waterfall or Gantt) projects, task statuses are defined at the organization level and always based on the operational baseline statuses (Pending, In Progress, and Completed). To create new statuses or alter existing ones, you will need a Full Access license. Go to SETTINGS > PARAMETERS > Task parameters > Task status.
Backlog and Archive task statuses are always visible in the project Gantt so that summary tasks and calculated Progress are not affected.
Implementation of Task Statuses in Agile Projects:
In agile projects, task states are defined at the project level (by columns). As in waterfall projects, task statuses are based on operational statuses.
To add or change columns, go to the agile project dashboard and select “Edit board layout”:
Note that tasks whose statuses are Backlog or Archive will not appear in the Dashboard but will be visible from the task list if desired.
Bulk status change from the task list:
To change the status of one or more tasks to Backlog or Archive from the task list:
- Select the tasks
- Click on Update status
- Choose the new task status
Note that the Backlog and Archive task statuses appear first and last in the list of task statuses, while in the middle will appear the base task statuses and those task statuses created from them.
Standard and Custom Extensions
Standard and Custom Extensions
Extensions enhance the standard functionality of ITM Platform.
Standard Extensions
The standard extensions available in your environment are developed by ITM Platform or a certified partner.
To access them, go to CONFIGURATION > CUSTOMIZATION > Extensions Panel.
Your ITM Platform’s environment already has standard extensions that you can install, configure, and use. Your panel may show new extensions over time.
To install an extension, click on its icon and click on the “Install” button. Once installed, click on “Configure.”
The configuration will vary depending on the information needs of the extension. Once configured, you will need to activate the extension in all cases.
The panel will display a green verification icon on installed extensions.
You can also disable or uninstall extensions. Note that you will lose any settings you had if you uninstall them.
Custom Extensions
With the help of custom extensions, you can create additional functions, alter standard behavior, and connect ITM Platform with other applications.
The same extensions panel will show you the extensions that your organization has created.
They allow you to respond to events, such as updating tasks and purchase amounts or changes in project status, and responding with actions like sending an email or requesting more information from users.
You can also program recurring actions using the scheduler and synchronize ITM Platform with your ERP, CRM, or any other application used in your organization.
To learn how to create extensions, you have the documentation and the GitHub repository where the code for the extension examples resides:
- Example 1: When a project is updated, send a message to a static email address.
- Example 2: When the actual value of a purchase is updated, send an email to a static address if the amount exceeds the purchase quote.
- Example 3: Send a daily email to the project manager of a specific project containing all tasks whose completion date is later than today.
- Example 4: Synchronize ITM Platform customers with Hubspot companies: only those that have Hubspot ownership sync_itm_platform set to true.
- Example 5: Allow users to enter the actual amount of revenue if < = Projected amount.
Related documentation:
Mass updating purchases
Mass updating purchases
ITM Platform allows you to perform operations on a group of project purchases by navigating to the purchases section and selecting the purchases you require. The selection is made by ticking the tick box to the left of each purchase.
As soon as you start making your selection, you can see the number of purchases you selected at the bottom of the list, and three options are enabled.
- Copy: Copies the selected purchases to another project, as explained in more detail in the section on copying purchases. Apart from copying purchases, you can choose to include the tasks related to the purchases you are copying.
- Edit: It allows editing several fields of the selected purchases in a mass update process, as explained in the next section.
- Delete: Deletes all selected purchases. Before deleting the purchases, ITM Platform will ask for your confirmation.
Update purchases
Clicking the option “Edit” opens a pop-up showing how many purchases you are editing.
Clicking on the option “see which,” you get a list of the selected purchases.
The pop-up allows setting several options applied to the selected purchases.
- Status: Select the status you want to apply to all selected purchases or select “Keep Current” if you want to keep the status unchanged.
- Type: Select the type you want to apply to all selected purchases or select “Keep Current” if you want to keep the status unchanged.
- Purchase Budget: Select the purchase budget you want to apply to all selected purchases or select “Keep Current” if you want to keep the purchase budget unchanged.
- Provider: Select the provider you want to apply to all selected purchases or select “Keep Current” if you want to keep the provider unchanged.
- Projected amount: When mass updating the projected amount of purchases, you can choose from three options from the dropdown menu.
- Keep Current: Leaves the projected amount of each purchase unchanged
- Fixed amount: Choose this option to apply a fixed amount to all purchases. All edited purchases will have the same projected amount.
- Percentage: Choose this option to multiply the projected amount of each purchase with a percentage. The edited purchases can have distinct projected amounts.
- Actual amount: When mass updating the actual amount of purchases, you can choose from three options from the dropdown menu. Please note that the changes will only apply to purchases with a status that allows for an actual amount.
- Keep Current: Leaves the actual amount of each purchase unchanged.
- Fixed amount: Choose this option to apply a fixed amount to all purchases. All edited purchases will have the same actual amount.
- Percentage: Choose this option to multiply the projected amount of each purchase with a percentage. The edited purchases can have distinct actual amounts.
- Due Date: Select the due date you want to apply to all selected purchases or select “Keep Current” if you want to keep the due date unchanged. Please note that the due date will remain unchanged for purchases that depend on a task.
Once you are satisfied with the changes, click Next to apply them. Once you confirm, the changes may take up to a minute to appear on the purchases.
Mass copying purchases
Mass copying purchases
ITM Platform allows you to perform operations on a group of project purchases by navigating to the purchases section and selecting the purchases you require. The selection is made by ticking the tick box to the left of each purchase.
As soon as you start making your selection, you can see the number of purchases you selected at the bottom of the list, and three options are enabled.
- Copy: Copies the selected purchases to another project, as explained in more detail in the section on copying purchases. Apart from copying purchases, you can choose to include the tasks related to the purchases you are copying.
- Edit: It allows editing several fields of the selected purchases in a mass update process, as explained in the next section.
- Delete: Deletes all selected purchases. Before deleting the purchases, ITM Platform will ask for your confirmation.
Copying purchases
Clicking the option “Copy” opens a pop-up showing how many purchases will be copied.
Clicking on the option “see which,” you get a list of the selected purchases.
The pop-up allows setting several options that will be applied when copying the list of selected purchases.
- Destination Project: Select the project you want to copy the selected purchases from a dropdown list of all available projects. By writing in the field, you can filter the list.
- Dates: The due dates of all purchases will automatically be adapted based on the difference in start dates between the origin and destination project.
- Status: Select the status you want to apply to the purchases copied to the destination project or select “Keep Current” if you want to keep the status unchanged.
- Include descriptions: Select this option to include the descriptions in the copied purchases.
- Include documents: Select this option if you want to include the documents of the copied purchases.
- Include custom field values: Select this option if you want to include the custom field values of the copied purchases.
- Include provider: Select this option if you want to include the provider in the copied purchases.
- Include projected amount: Select this option if you want to include the projected amount of the copied purchases. Leave the field on the right empty if you want to copy the amounts of the origin project or set a percentage to multiply the projected amounts with.
- Include purchase number: Select this option to include the purchase number of the copied purchases.
Include actual amount: Select this option to include the actual amount of the copied purchases. Leave the field on the right empty if you want to copy the amounts of the origin project or set a percentage to multiply the actual amounts with. - Include related tasks: Select this option if you want to include the tasks related to the selected purchases, as explained in more detail in the “Include related tasks” section below.
Click ” Next ” to proceed once you are happy with the selected options. Before copying the purchases, ITM Platform gives you a summary of the purchases to be copied and a list of warnings, if applicable.
When you receive warnings on the summary screen, you can either choose to cancel and include additional purchases in the selection to fix these issues or choose to proceed. Once you confirm, the copied purchases may take up to a minute to appear in the destination project.
Include related tasks purchases
Select this option to include the purchases that depend on the tasks to be copied. When you select the option, a section with additional options is opened.
- Dates: The dates of all tasks will automatically be adapted based on the difference in start dates between the origin and destination project.
- Status: Select the status you want to apply to all tasks copied to the destination project or select “Keep Current” if you want to keep the status unchanged.
- Priority: Select the priority you want to apply to all tasks copied to the destination project or select “Keep Current” if you want to keep the priority unchanged.
- Type: Select the type you want to apply to all tasks copied to the destination project or select “Keep Current” if you want to keep the type unchanged.
- Include descriptions: Select this option to include the task descriptions in the copied tasks.
- Include documents: Select this option if you want to include the documents of the copied tasks.
- Include custom field values: Select this option if you want to include the custom field values of the copied tasks.
- Include dependencies: Select this option to include the relations between predecessor and copied tasks. Relations between predecessor tasks and copied tasks can only be copied if the predecessor task and the dependent task are included in the list of selected tasks.
- Include task members: Select this option to include the assigned task members on the tasks to be copied. A section with an additional option is opened when you select the option.
- Assign team members to the destination project. If you select this option, team members are automatically added to the destination project if they are task members on one or more copied tasks. If the option is unselected, any task member that is not a team member on the destination project will not be included.