Configuration
The configuration dialog provided by The Connector allows for customization of a number of different parameters. You access these settings from the toolbar option "Configure".
JIRA Connectivity
This screen allows configuration of the endpoint to connect to JIRA. It can be an IP address or a domain address, depending on how you have configured your installation of JIRA.
The Connector does support communications over SSL. Simply provide the prefix of "https://" in the JIRA address field.
JIRA Communication Settings
Use custom date format mapping - This option will allow you to map a date format string to a custom format. Use this function if you are running different languages between Microsoft Windows and Atlassian JIRA.
Example: If you are running a non-English version of Microsoft Windows and an English version of JIRA, the date formats do not translate correctly. Using this function will allow you to correct the translation.
Use optimized issue and project browsing - Using this option will replace the standard web service calls provided by JIRA with the custom calls developed for The Connector. Using these calls will increase the speed of the service calls to JIRA, especially in the cases where you have large numbers of projects and/or users in JIRA.
NOTE: This option requires the installation of Ecliptic Technologies extended web services for JIRA. See the section The Connector Extended Web Service Installation for instructions.
Use extended worklog services to calculate percentage complete - This function will use the extended web services to calculate the percentage complete of a Microsoft Project tasks based on the worklogs. With this option disabled, The Connector will use the mappings configured under the "Mappings" tab of the configuration dialog.
NOTE: This option requires the installation of Ecliptic Technologies extended web services for JIRA. See the section The Connector Extended Web Service Installation for instructions.
Settings
The "Settings" tab of the configuration dialog allows you to set up some general configuration settings for The Connector.
Remember Last Login - This option will remember the username you specify between logins so you will not have to retype it.
Populate Microsoft Project Task Hyperlink field with the JIRA issue link - This option will put a link in the task hyperlink field. This allows a quick, single-click link into JIRA to view the issue.
Cache the project list in memory for faster project browsing - After the first request to JIRA to retrieve the project list is made, it is cached in memory by The Connector as used for subsequent requests. This greatly increases the speed at which the project list is displayed.
NOTE: If your project lists change frequently, you may not want to use this function.
Use JIRA Components and Versions - If this option is enabled, you will see the "Components / Versions" tab on the Issue Editor and the import and sync functionality of The Connector will include these values.
Use JIRA Environment Field - If this option is enabled, you will see the "Environment" tab on the issue editor and the import and sync functionality of The Connector will include these values.
Resource Mappings - Resource mappings will allow you to use a mapping of your resource name to the JIRA username. You can store the JIRA username in a custom field of the resource. This allows you to have different resource names between JIRA and Microsoft Project.
When Automatically Creating Resources - This option will control how The Connector creates new resources when you import issues into Microsoft Project.
Options
The "Options" tab of the configuration dialog allows you to configure the default settings for the custom fields where The Connector stores its JIRA information.
These values can be overridden on a per project basis, but The Connector will use these values as defaults when you initialize a new project plan.
Mappings
The "Mappings" tab is used when running The Connector in standard mode. The mappings allow you to configure the Microsoft Project task percentage complete with each JIRA status. When you sync the project file with JIRA, it will update the percentage complete of the project plan based on the status.
Example: If the JIRA issue is marked "In Progress", the Microsoft Project task will show as 50% complete.
When using The Connector in extended mode, these mappings are not used and the work logs provided in JIRA are used to calculate a more accurate percentage complete.
JIRA Defaults
The "JIRA Defaults" tab allows you to configure the default issue type, priority, and status when new JIRA issues are created. You can configure the defaults to "Warn and require manual entry"; however if you do this, you will be required to manually pick these settings from the JIRA Issue Info dialog before the task will be used to create a new JIRA issue.
The drop-down boxes provide a list of all the current configured settings in JIRA. If you add a custom issue type to JIRA, this issue type will be available for selection in the drop-down.
Sync
The "Sync" tab of the Configuration dialog allows you to setup default values for the Send To JIRA, Update From JIRA, and Sync All functions.
About
The "About" tab on the Configuration dialog will show information about the version of The Connector that is being run. It provides links to support requests and The Connector website.
