Znuny & OTRS REST API – Search for DynamicField Content

Learn in this article how to use REST API of OTRS & Znuny to search for Tickets with specific DynamicField_NameXY content.

In the previous article Access Znuny & OTRS API via REST, we guide you thru the essential configuration steps of REST API in the role of the service provider. If you followed the steps your system is now accessible via new REST API Routes and is providing data in response to REST API requests. The default configuration of the TicketSearch route does not allow you to leverage the full power of the REST API.

Modification of the Default REST API Configuration

The default configuration of the REST API TicketSearch interface is expecting GET method at the following URL

http://{{znunyHostName}}/otrs/nph-genericinterface.pl/Webservice/{{webservice name}}/Ticket

The GET method allows you to specify simple request options, which does not allow you to leverage from all search capabilities deployed in TicketSearch method as documented in OTRS 6.0 API Reference Perl > Perl Modules > Kernel::GenericInterface::Operation::Ticket::TicketSearch.

The fix is simple, open the webservice Network Transport configuration:


and change two options:

  1. Rename the TicketSearch route
  2. Change the expected method from GET to GET and POST

integratION with Znuny REST API?

You require a integration of another system/application to share data between Znuny and your system.
You struggle to get started, as the implementation of the API is not that straight forward as you thought?
You are not alone, we have many customers with the same issue!

Get started with a hand crafted set of REST Call in Postman and Bruno

Searching for Tickets with DynamicField_NameXYZ = something

Now we can use search OTRS & Znuny using REST API leveraging from all search filters documented in OTRS 6.0 API Reference Perl > Perl Modules > Kernel::GenericInterface::Operation::Ticket::TicketSearch.

The following cURL example will search for all Tickets which have DynamicField_IsRedmineLinked value like ‘Yes*’ where asteriks is a wildcard.

curl --location --request POST 'http://localhost/otrs/nph-genericinterface.pl/Webservice/Ticket REST API/TicketSearch?SessionID=8HdMDh9iBc1fpBXqq53JCPzVLQIhIpC0&AllArticles=1&DynamicFields=1' \
--header 'Content-Type: application/json' \
--data-raw '{
   "DynamicField_IsRedmineLinked":{
       "Like":"Yes*"
   }
}'

Related articles

Access Znuny & OTRS API via REST
Authenticate to Znuny / OTRS REST API
Examples Calling REST API of Znuny & OTRS with cURL

You want to integrate with Znuny REST API?

You require a integration of another system/application to share data between Znuny and your system.
You struggle to get started, as the implementation of the API is not that straight forward as you thought?
You are not alone, we have many customers with the same issue!

After spending lots of time in supporting our customer, we have created the most common API accesses in Postman and Bruno.
So that your business analysts or developers can test the API and may define or integrate your needs.
Just for completeness, we offer also such development support and we can assign you the corresponding experts.

Do you require experts with real expertise since 2006 on Znuny and OTRS?
Do you require help on solving your issues?

We have experts who can help you on:

Integrating Issue trackers
like

  • Jira
  • Redmine
  • Azure DevOps, / Team Foundation Server
  • IBM Rational ClearQuest
  • IBM Engineering Workflow Management / Rational Team Concert / Jazz
  • Siemens Polarion
  • Adobe Workfront / AtTask
  • Trello
  • GitHub
  • GitLab
  • Asana
  • and many more

Integrating CRM systems
like

  • Salesforce
  • Microsoft Dynamics 365
  • Oracle CRM
  • SAP CRM
  • Adobe Experience Cloud / Marketo Engage, Workfront
  • HubSpot CRM
  • Zoho CRM
  • SugarCRM / SuiteCRM / Vtiger CRM & OSS
  • Pipedrive
  • Zendesk Sell
  • and many more

Integrating ERP systems
like

  • SAP S/4HANA
  • Oracle ERP Cloud
  • Microsoft Dynamics 365
  • Finance & Operations
  • Sage X3
  • Compiere / ADempiere / iDempiere
  • Apache OFBiz
  • Openbravo
  • Odoo
  • ERPNext
  • Dolibarr
  • and many more

Beside of the above named solutions we can help you to integrate into more business and branch specific solutions:

Integrating artificial intelligence / AI
like

  • AI Chatbots to aid your support agents
  • integrate private data chatbots, with exclusive access to your data without sharing to OpenAI, Microsoft or any other AI companies
  • create and integrate AI models based on your data to get a unique business model for your team
  • and many more

Integrating accounting systems
like

  • DATEV Rechnungswesen, DATEV Unternehmen Online, sevDesk, Lexware (DE)
  • BMD Business Software, RZL, DIAMANT (AT)
  • Abacus (CH)
  • Forvis Mazars, Swiss21, Banana Accounting (CH)
  • Cegid XRP Flex, Captivea, EBP (FR)
  • QuickBooks, Freshbooks
  • and many more

Integrating branch specific systems
like

  • Sage Handwerk, TopKontor  Smart-Handwerk,
    STREIT Handwerkersoftware, CENDAS, OfficeOn,
    openHandwerk, ToolTime, Plancraft, HERO,
    Das Programm, Craftboxx, Taifun, M‑Soft, extragroup, PraKom
  • and many more

Do you need help with Znuny / OTRS?​

Do you require experts with real expertise since 2006 on Znuny and OTRS?
Do you require help on solving your issues?

We have experts who can help you on:
– giving you hands-on support
– implementing  custom solutions inside your OTRS/Znuny
– Integration existing Solutions into your Znuny
– Integrating artificial intelligence into your Znuny7OTRS and proce3sses

Get in touch with us and we will check if and how we can help you.​

Leave a Reply