Maximize the benefits of integrating GitHub with Ducalis by activating back sync. This feature allows you to sync the prioritization and voting results back to GitHub.
There are two ways to create fields in YouTrack:
- Automatically (recommended). Just turn on the back sync, and fields will be created automatically in GitHub. No manual creation is needed.
- Manually. Create fields in GitHub, add them to all projects, and map them in Ducalis.
We recommend using auto-creation, but below you can find instructions for both methods.
Accessing Back Sync
1. Go to Backlog Management section.
2. Under the settings scroll down to Sync Back Fields.
1st Method – Fields Auto Creation
The tumbler is turned on for this option by default.
Tip! Your GitHub issues should be added to one of your GitHub projects, since projects have custom fields to pull data from Ducalis.
Choose Ducalis Fields to Sync
1. Before creating Ducalis custom fields in GitHub, choose the Ducalis fields with the data you would like to sync to GitHub.
You will find two default fields–the Priority {emoji} Ducalis and the Alignment {emoji} Ducalis.
2. Click Add Sync Back Field to send more custom data from Ducalis to GitHub.
3. You can delete these fields or any other field you will add and decide to delete. Just hover over the field you want to delete and click on the Remove button.
Activate Sync
1. Switch on the toggle to activate sync.
2. Custom fields will be automatically created for all the issues in the GitHub project you chose when creating Ducalis filters of which issues to import from GitHub for prioritization.
3. The emoji, used in the custom fields names, is a Ducalis Board ID. You can change it. If you do so, please turn the sync off and on again to apply the change.
After you switch on the toggle you can’t add more fields. To add more fields, you have to switch off sync first, add your fields, then switch it on again.
2nd Method – Create And Map Fields Manually
The tumbler is turned off for this option.
Create Custom Fields in GitHub
Firstly, you need to create the custom fields you need in your GitHub projects.
1. Go to Settings and choose Custom Fields.
Create custom fields you need.
3. Start to create the field.
- Enter field name.
- Choose the type. To do this, go to Ducalis.io and check the field type you intend to map. For example, if you want to map the Ducalis field ‘Evaluation Progress’ with your GitHub field ‘Evaluation Progress,’ you should check the field type in Ducalis and select it when creating the field.
4. Go to Ducalis and click Refresh.
5. The field has appeared, and you can choose it. Click Save.
Activate Sync Back
Make sure that there are no red fields (you can delete them if you don’t need them) and activate sync.
Switch on the toggle to activate sync.
Field with its data is available in GitHub.
Sync Back Schedule
The sync from Ducalis back to GitHub happens once a week or on a set schedule.
1. Choose the day and time to sync the data to GitHub. It can, for example, be a day or a few days before your sprint planning meeting. You can change the timezone if it’s not set to the one you want.
2. If you want to sync immediately, click ‘Manual Sync with GitHub’.
