# FogBugz

## Prerequisites

### User privileges

* Create one user of FogBugz of type 'Normal' and set User Time Zone, dedicated to <code class="expression">space.vars.SITENAME</code>. User should do any operations from FogBugz's user interface.
* For adding user and setting time zone in FogBugz, refer [Add User](#add-user) section in appendix.
* Ensure the user's time zone is set to UTC (also known as Coordinated Universal Time). Refer [Set User Time Zone](#set-user-time-zone) for details.
* If you are not using SAAS instance of FogBugz, you might need to import SSL certificate to the server. To know how to import certificate, refer [Import HTTPS Certificate To Server](https://docs.opshub.com/v7.215/getting-started/installation/ssl-certificate-configuration) page.

## System Configuration

Before you continue to the integration, you must first configure FogBugz. Click [System Configuration](https://docs.opshub.com/v7.215/integrate/configure-integrations/system-configuration) to learn the step-by-step process to configure a system.\
Refer the screenshot given below for reference.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-6c1119fea277de86b4cbb379e1ddd172a9b2d3fb%2FFB_Image_9a.png?alt=media" alt="" width="2000"></div>

For checking version and api\_key, refer [How to get API URL and Version?](#how-to-get-api-url-and-version) section in appendix.

If the system is deployed on HTTPS and a self-signed certificate is used, then you will have to import the SSL Certificate to be able to access the system from <code class="expression">space.vars.SITENAME</code>. Click [Import SSL Certificates](https://docs.opshub.com/v7.215/getting-started/installation/ssl-certificate-configuration) to learn how to import SSL certificate.

## Mapping Configuration

Map the fields between FogBugz and the other system to be integrated to ensure that the data between both the systems synchronizes correctly.\
Click [Mapping Configuration](https://docs.opshub.com/v7.215/integrate/configure-integrations/mapping-configuration) to learn the step-by-step process to configure mapping between the systems.

### Integration Configuration

In this step, set a time to synchronize data between FogBugz and the other system to be integrated. Also, define parameters and conditions, if any, for integration.\
Click [Integration Configuration](https://docs.opshub.com/v7.215/integrate/configure-integrations/integration-configuration) to learn the step-by-step process to configure integration between two systems.

### Criteria Configuration

**For System Fields**:

* Refer <http://fogbugz.stackexchange.com/questions/4399/and> and navigate to 'Axes for searching cases'. Now, find the name of the field on which you want to configure the criteria.
* Put the name of the field, then put a colon (:) and the value of that field, for example `Status:Active`.

**For Custom Fields**:

* Refer <http://help.fogcreek.com/7747/custom-fields-track-your-own-case-attributes> and navigate to 'Searching Custom Fields'.
* For Custom Field and CustomValue, query should start with the custom field's name followed by a colon and the custom value, for example `CustomxField: "CustomValue"`.

Click [Create Custom Fields](#create-custom-fields) to learn how to create custom fields.

## Appendix

### Add user

* Login to FogBugz server.
* Click on **Admin** on the right top corner and select **Users**.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-dbe5fcf558cab4f55ae549ad8288013f3e1b2597%2FFB_Image_1.png?alt=media" alt="" width="800"></div>

* Click on **Add New User Account**.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-e8c0b8210505ed157132bdbc646b6a5b9008e259%2FFB_Image_2.png?alt=media" alt="" width="800"></div>

* Click on **Add New User Account.**

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-4a955a1ceece2f68af06da1c23c7ad38f7121c34%2FFB_Image_3.png?alt=media" alt="" width="800"></div>

### Set User Time Zone

* Log into **FogBugz** server.
* Click **Admin** tab on the top-right corner and select **Users**.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-dbe5fcf558cab4f55ae549ad8288013f3e1b2597%2FFB_Image_1.png?alt=media" alt="" width="800"></div>

* Select the user from the user list. Click **Edit**.
* Set Time Zone to: **(UTC) Coordinated Universal Time**.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-4adfd5ba146b754b2441d2586731790aad71084a%2FFB_Image_4.png?alt=media" alt="" width="800"></div>

### Create Custom Fields

* Login to FogBugz server.
* Click on **Admin** menu.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-7244366945db0271b34a1dc21a1395884a0052fa%2FFB_Image_5.png?alt=media" alt="" width="400"></div>

* Select **Plugins** from menu.
* Check if Custom Fields is enabled, if it is enabled, click on 'edit' symbol.
* Click **Add New Custom Field**.

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-4bb1c07edef4e8cbd340d1afac8dc42422bc75ae%2FFB_Image_6b.png?alt=media" alt="" width="1000"></div>

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-06f60f740d0bbf35f9c90f206020fae02aa57fa7%2FFB_Image_7.png?alt=media" alt="" width="1000"></div>

<div align="center"><img src="https://818964384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5eA7qMDBFu0HHHMDehi%2Fuploads%2Fgit-blob-58372dfd66c1b47d4b4e64a38c7a6e5e6e9f1ec0%2FFB_Image_8.png?alt=media" alt=""></div>

### How to get API URL and Version?

Go to <http://fogbugz.stackexchange.com/fogbugz-xml-api> and see **Checking the API version and location**.