OTOBO/OTRS integration

Integration with OTRS

image-1590658713409.png

The form system is very strongly integrated into OTRS.

Dynamic forms can be connected to any other system, but we provide full support for OTRS.

The order of the fields in the article

You can see the sorting functions in "Sorting of fields in the OTRS article"

Display field as article content or dynamic field

In each field there is a parameter "otrs_visible" available, with it you can define where the content of the field is to be displayed - article, dynamic field etc.

This field is mandatory and if you do not complete it, it will be set to "article" by default.

Assignment of ticket title from the form

The identifier of each field can be set to any text. But if you want to add, for example, an otrs title, you have to adapt to the appropriate structure.

SYSTEM_Ticket_[OTRS field id]

All fields for ticket description are available, e.g. title, queue, owner etc.

If you want the owner of the ticket to become "john.kowalski" just add such an ID: "OTRS_Ticket_Owner".

Migrating from IntalioDynamicForms 1.0.x to IntalioDynamicForms 1.2.x

Assigning a queue from the form

If you want to assign a queue to a ticket, simply set the ID to "OTRS_Ticket_Queue".

Migrating from IntalioDynamicForms 1.0.x to IntalioDynamicForms 1.2.x

Adding dynamic fields

Dynamic fields are subject to a different rule, in their case we do not use a defined structure. The field identifier must be identical to the dynamic field identifier in OTRS.

Migrating from IntalioDynamicForms 1.0.x to IntalioDynamicForms 1.2.x

Assigning other OTRS fields

All fields describing the ticket are available in dynamic forms. Just adjust to the structure OTRS_Ticket_[OTRS field id].

Migrating from IntalioDynamicForms 1.0.x to IntalioDynamicForms 1.2.x

 

Administration settings

In the system configuration you will find plenty of fields that will allow you to customise your Dynamic Forms system. 

To see all configuration options:

  1. Click on the Admin tab and pick System configuration
  2. Find Intalio Dynamic Forms in the Navigation bar
  3. From the dropdown menu choose Core
    image-1603104520977.png
Intalio::DynamicForms::DefaultLock

Possible values:

Specify if the ticket should be locked or unlocked when the ticket is created.

Default value: unlock


Intalio::DynamicForms::DefaultOwner

Specifies the default owner of the ticket who will be assigned to the ticket after its creation by the form system (agent login). 

You should make sure that the agent with the login provided in this configuration exists. 

Providing the login of a non-existent agent will make it impossible to send the form. 

Default value: root@localhost


Intalio::DynamicForms::DefaultPriority

Specifies the default priority of the created ticket. 

Default value: root@localhost


Intalio::DynamicForms::DefaultQueue

Specifies the default queue of the created ticket. 

You should make sure that the queue with the name you provided in this configuration exists in your system.

Providing the name of a non-existent queue will make it impossible to send the form. 

Default value: Raw


Intalio::DynamicForms::DefaultState

Specifies the default state of the created ticket. 

You should make sure that the state with the name you provided in this configuration exists in your system.

Providing the name of a non-existent state will make it impossible to send the form. 

Default value: new


Intalio::DynamicForms::DefaultQueue

Specifies the default queue of the created ticket. 

You should make sure that the queue with the name you provided in this configuration exists in your system.

Providing the name of a non-existent queue will make it impossible to send the form. 

Default value: root@localhost


Intalio::DynamicForms::DefaultType

Specifies the default type of the created ticket. 

You should make sure that the type with the name you provided in this configuration exists in your system.

Providing the name of a non-existent type will make it impossible to send the form. 

Default value: Unclassified

 

Sorting of fields in the OTRS article

Custom sort:

You can use the "order_by" and "order" params. You can find more information here: Form configuration - file structure and general configuration

If the field does not have the required parameter (e.g. "order"), it will be added at the end.

By default:

Fields are sorted by identifiers, if you want the fields to be in a certain order, you must name them accordingly.

Example:

{
  "size": "s12 m6 offset-m3",
  "type": "number",
  "id": "2_FieldID",
  "label": "Number",
  "validate": [
    ""
  ],
  "icon": "filter_1",
  "otrs_visible": "all",
  "hidden": false,
  "value": ""
},
{
  "size": "s12 m6 offset-m3",
  "type": "textarea",
  "id": "1_FieldID",
  "label": "Textarea",
  "validate": [
    ""
  ],
  "icon": "announcement",
  "otrs_visible": "all",
  "hidden": false,
  "value": ""
}

This configuration will cause the field "1_FieldID" to be displayed above "2_FieldID" in the OTRS article request.

File permissions

Script: /opt/otobo/bin/otobo.SetPermissions.pl

Directories
User:
otobo
Group: www-data

Minimum permissions: 666

Files
User:
www-data
Group: www-data

Minimum permissions: 660