Database Import

Specify a name for your configuration.

The URL to connect to the database.

PostgreSQL example: jdbc:postgresql://localhost:5432/jira8.5.1

The driver class to connect to the database.

Please do not forget to place JDBC driver (*.jar) to <Jira Installation Directory>/lib folder

and restart Jira after placing the driver class.

Authorized user password.

Password will be kept as encrypted.

Every time when want to edit a configuration you must enter the password again.

The selector is a SQL query. Enter the SQL query which you want to execute when connection established to the database. Data will be fetched from this execution result.

Additional columns  (not on the table)

You can add constant values to the query or database functions to add calculated values as columns. For example; you can add status and substatus static values to the query where they are not in the table.

select t.*, 'In stock' as c_status, 'Available' as c_substatus from assets.t_service_category t

Notes:

• Please try SQL queries on a database client first.
• Database scheme may be needed before table or view.

This field is very necessary when a date value imported from a char field. If you are keeping date values in char fields please specify a date format. Example: yyyy-MM-dd for 1994-01-17

Please see https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html for date and time patterns.

This field is very necessary when a date-time value imported from a char field. If you are keeping date-time values in char fields please specify a date-time format. Example: yyyy-MM-dd hh:mm:ss.s for 1994-01-17 09:00:00.0

Please see https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html for date and time patterns.

When imported value is not an option for the attribute this option provides you to define these values as a new option for attributes like Checkbox, Dropdown List, List Box, List Box - Multiple, Radio Button.

When this option is disabled synchronization will not work for this Asset Type Mapping.

Note: Asset Type Mapping can't be activated without Asset Name Field Mapping is defined.

The Column which you want to get data. Columns are fetched from the database.

Please be sure the connection with the database is successful.

It is possible to define different delimiters for different attributes.

This field available for Asset List, Asset List By Form, Checkbox, List Box - Multiple, Jira Multiple Users attributes. 

The concatenator is for the concatenate more than one query columns.

Example: 

Assume that for an Employee asset type, the asset name field needs to imported from two different columns like first_name and last_name

and concatenator is defined as "-". The asset name field will be imported as First-Name.

The identifier is to search if the imported asset is existing in the system. If asset exist, the asset will be updated.

Otherwise, new asset will be created.

Decide which way to fill asset list fields.

If Query Column selected, the asset name search will be held with the imported value.

(For Example: referenceAssets("asset.name", "imported value"))

With the given parameters if multiple assets found in search result, decide match:

      ALL: References all found assets

      FIRST: References the assets with the lowest ID

      NONE: References none of them

referenceAsset("asset.name", "${asset_name}", "Country", "Turkey", "City", "${city})
referenceAssetByType("Employee", "asset.name", "${asset_name}")

The value between "${}" must be the name of the column of the database from where you get the search parameter.

For example:

     At the first line of the Scripted Column referenceAsset() function will get the asset.name and City fields parameters from the columns asset_name and city of the database.