Written for Frends version 5.6.
Frends Tasks are a cornerstone of building successful integration Processes. You can create your own custom Tasks and import them or alternatively add Tasks from a list of readymade options that cover many common use-cases.
Prerequisites
You will need the following prerequisites to follow through with this guide:
Editor rights for your Frends Tenant.
Importing a Frends Task
You can find the Task view under Administration -> Tasks.ย
The Task view lists all current Tasks that are already imported to the Tenant as well as action buttons to import and update Tasks. A Frends Task package can contain multiple Tasks.
Importing from the Frends Task feed
Find the Task package you wish to import.
Chose the version of the Task from the Version drop-down menu and press the 'Import' button.
You will now see a modal containing information about the different Tasks that are included in that Task package. New official Tasks are structured as individual packages so they only include the one Task in them but in some cases there are multiple Tasks from different frameworks.
If you only need to import the DLL:s from the NuGet package to your Frends Tenant you can decide to check the 'Skip importing the Tasks listed above, only upload the NuGet package to storage' checkbox.
Press import to add the Tasks to your Frends Tenant.
Importing from a NuGet file.
In case that you need a custom package that does not exist on the Frends Task feed you can import a NuGet file congaing your custom Tasks.
Click on the 'Import Task NuGet' button
Follow the same steps as above in Importing from the Frends Task feed
See How-to-create-task for a guide how to create a valid Frends Task package that can be imported.
Updating the Frends Task index
In some cases you know that update for Task is made and published only moments before you try to import new version to Frends. In that case you might need to make the Frends to check updated packages, with reloading the page. Frends will automatically search any updates and show a update button on the side of the Task:
Updating a Task
Updating a Task package is mostly similar to Importing a new package. The differences are in the modal window displaying the information about the Tasks inside the Task Package. The Task update modal will display if Processes using this package will be eligible to automatically be updated to using the new version of a Task.
For a Process to automatically be updated to use a new version of a Task the following need to stay the same between the old and the new version of the Task.
Name
Parameters
Return type
If a Process contains different Tasks from the same Task Package they all need to be eligible for a automatic update for the Process to automatically update.
You can choose not to update the Processes on Task update by checking the 'Skip updating Processes where the Tasks listed above are used' checkbox.
Sometimes Processes may be visible on the list of Processes that will automatically be updated but the actual update will fail. If the automatic Process update fails the Processes will need to be updated manually to use the latest version of the Task.
A new version of a Process will only be created for the Development Agent Group in case of an automatic Process update. The updated Process will need to be manually deployed to Agent Groups that should run the Process.
Deleting a Task
Tasks may be deleted from the Frends Control Panel by pressing the 'Delete' button. This will not modify existing Processes but remove the Task from the list of existing Tasks and not allow using the Task when creating new Processes.
Task deletions should be avoided if later version of that Task package will be imported to the Frends Tenant.
Add Task package source feeds
A default Frends installation has 'https://www.myget.org/F/frends/api/v2' configured as the the only Task feed. To add additional sources you can add them by clicking on the 'NuGet sources' button:
It will open up a modal where you can add more source feeds:
You can add a new source by pressing the 'Add new repository' button which will add a new input field to the bottom of the source list:
Here you can place the source feed URI and remember to save the action before closing the modal.
Another way is to modify the Frends UI web.config file.
Open the Web.config in the folder where the Frends UI is installed.
Locate the 'ExternalPackageSourcesJson' application key
Add the new feed to the list of sources. For example:<add key="ExternalPackageSourcesJson" value='["https://www.myget.org/F/frends/api/v2", "https://www.nuget.org/api/v2"]' />
Save the web.config file.
โ
Frends does not support v3 of nuget.