OTOBO/OTRS integration

Integration with OTRS
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: 

 
 Click on the Admin tab and pick System configuration 
 

 Find Intalio Dynamic Forms in the Navigation bar 
 

 From the dropdown menu choose Core 
 

 
 Intalio::DynamicForms::DefaultLock 

 Possible values: 

 
 lock 

 unlock 

 
 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