Skip to content

Commit f6aa3f6

Browse files
authored
Fixes #973 - Remove restrictions about MySQL (because no longer supported)
1 parent 207bd1a commit f6aa3f6

2 files changed

Lines changed: 49 additions & 57 deletions

File tree

locale/admin-docs.pot

Lines changed: 49 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Zammad Admin Documentation pre-release\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2026-03-17 10:13+0100\n"
11+
"POT-Creation-Date: 2026-03-17 10:34+0100\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -3611,7 +3611,7 @@ msgstr ""
36113611
#: ../manage/report-profiles.rst:49
36123612
#: ../manage/scheduler.rst:109
36133613
#: ../manage/slas.rst:64
3614-
#: ../system/objects/types.rst:275
3614+
#: ../system/objects/types.rst:271
36153615
msgid "Preview"
36163616
msgstr ""
36173617

@@ -5878,7 +5878,7 @@ msgstr ""
58785878
#: ../index.rst:96
58795879
#: ../index.rst:96
58805880
#: ../manage/roles/permissions.rst:291
5881-
#: ../system/objects/types.rst:283
5881+
#: ../system/objects/types.rst:279
58825882
msgid "Misc"
58835883
msgstr ""
58845884

@@ -22416,202 +22416,198 @@ msgid "Zammad just looks for the defined list and value keys, reads the content
2241622416
msgstr ""
2241722417

2241822418
#: ../system/objects/types.rst:180
22419-
msgid "The usage of a PostgreSQL database for Zammad is required. In any other case, Zammad will hide the external data source type and you are not able to use it. If you want to use this feature, consider to :docs:`migrate your database </appendix/migrate-to-postgresql.html>`."
22420-
msgstr ""
22421-
22422-
#: ../system/objects/types.rst:184
2242322419
msgid "Only ``GET`` is supported as request method."
2242422420
msgstr ""
2242522421

22426-
#: ../system/objects/types.rst:185
22422+
#: ../system/objects/types.rst:181
2242722423
msgid "The data structure must be in JSON format and provide the objects in an array."
2242822424
msgstr ""
2242922425

22430-
#: ../system/objects/types.rst:187
22426+
#: ../system/objects/types.rst:183
2243122427
msgid "The endpoint for the external data source has to support search. On Zammad side, there is no search/logic implemented; however, you can define the output key and value based on the result(s) from the response (which provides already filtered content based on the search)."
2243222428
msgstr ""
2243322429

22434-
#: ../system/objects/types.rst:191
22430+
#: ../system/objects/types.rst:187
2243522431
msgid "If you receive more results as expected, your external data source search may not work properly or the structure of the URL is not correct. You should get in touch with a responsible person from the external system."
2243622432
msgstr ""
2243722433

22438-
#: ../system/objects/types.rst:196
22434+
#: ../system/objects/types.rst:192
2243922435
msgid "Please have a look :doc:`at our example </system/objects/external-data-source-example>`, where you can find a possible configuration, using a public dummy endpoint."
2244022436
msgstr ""
2244122437

2244222438
#: ../system/objects/types.rst:None
2244322439
msgid "Available settings for external data source fields"
2244422440
msgstr ""
2244522441

22446-
#: ../system/objects/types.rst:220
22442+
#: ../system/objects/types.rst:216
2244722443
msgid "Search URL"
2244822444
msgstr ""
2244922445

22450-
#: ../system/objects/types.rst:206
22446+
#: ../system/objects/types.rst:202
2245122447
msgid "Set your endpoint where Zammad fetches the data. Please make sure to include a valid search :doc:`variable </misc/variables>` as an URL parameter. Example for a free text search at user input: ``#{search.term}``"
2245222448
msgstr ""
2245322449

22454-
#: ../system/objects/types.rst:211
22450+
#: ../system/objects/types.rst:207
2245522451
msgid "If in doubt, ask the responsible person for the external data source how they expect the structure of the URL."
2245622452
msgstr ""
2245722453

22458-
#: ../system/objects/types.rst:215
22454+
#: ../system/objects/types.rst:211
2245922455
msgid "Depending on your search variable, the preview might work or not. The reason is that the context might not be available and it is no bug."
2246022456
msgstr ""
2246122457

22462-
#: ../system/objects/types.rst:218
22458+
#: ../system/objects/types.rst:214
2246322459
msgid "Please also make sure to use a variable which is available in your object context. For example you won't be able to search for a ticket in a user object context."
2246422460
msgstr ""
2246522461

22466-
#: ../system/objects/types.rst:230
22462+
#: ../system/objects/types.rst:226
2246722463
msgid "SSL Verification"
2246822464
msgstr ""
2246922465

22470-
#: ../system/objects/types.rst:223
22466+
#: ../system/objects/types.rst:219
2247122467
msgid "Here you can switch the SSL verification to no."
2247222468
msgstr ""
2247322469

22474-
#: ../system/objects/types.rst:227
22470+
#: ../system/objects/types.rst:223
2247522471
msgid "If your external data source system is using self signed certificates, please have a look :doc:`here </settings/security/ssl-certificates>` for further information about how to handle them in Zammad, so you can keep the SSL verification activated."
2247622472
msgstr ""
2247722473

22478-
#: ../system/objects/types.rst:236
22474+
#: ../system/objects/types.rst:232
2247922475
msgid "HTTP Authentication"
2248022476
msgstr ""
2248122477

22482-
#: ../system/objects/types.rst:233
22478+
#: ../system/objects/types.rst:229
2248322479
msgid "If your external data source requires an authentication, you can set it here. You can leave it empty or choose between *Basic Authentication* or *Authentication Token* (selecting one of the two methods leads to additional fields where you can enter your credentials/token)."
2248422480
msgstr ""
2248522481

22486-
#: ../system/objects/types.rst:243
22482+
#: ../system/objects/types.rst:239
2248722483
msgid "Search result list key"
2248822484
msgstr ""
2248922485

22490-
#: ../system/objects/types.rst:239
22486+
#: ../system/objects/types.rst:235
2249122487
msgid "Defines the level in the JSON structure which provides the list with search results. You can leave it empty, if the data is already provided as an array. If you have to go deeper in the structure, you can provide a path with ``.`` as separators, e.g. ``key.subkey.sub-sub-key``."
2249222488
msgstr ""
2249322489

22494-
#: ../system/objects/types.rst:249
22490+
#: ../system/objects/types.rst:245
2249522491
msgid "Search result value key"
2249622492
msgstr ""
2249722493

22498-
#: ../system/objects/types.rst:246
22494+
#: ../system/objects/types.rst:242
2249922495
msgid "Defines the attribute in the structure in which your external data source provides the *value* for your data. An example would be a product *number*. If you have to go deeper in the structure, you can provide a path with ``.`` as separators, e.g. ``key.subkey.sub-sub-key``."
2250022496
msgstr ""
2250122497

22502-
#: ../system/objects/types.rst:255
22498+
#: ../system/objects/types.rst:251
2250322499
msgid "Search result label key"
2250422500
msgstr ""
2250522501

22506-
#: ../system/objects/types.rst:252
22502+
#: ../system/objects/types.rst:248
2250722503
msgid "Defines the attribute in the structure in which your external data source provides the *label* for your data. An example would be a product *name*. If you have to go deeper in the structure, you can provide a path with ``.`` as separators, e.g. ``key.subkey.sub-sub-key``."
2250822504
msgstr ""
2250922505

22510-
#: ../system/objects/types.rst:258
22506+
#: ../system/objects/types.rst:254
2251122507
msgid "In the preview area, you can find the following items (depending on your configuration above):"
2251222508
msgstr ""
2251322509

22514-
#: ../system/objects/types.rst:261
22510+
#: ../system/objects/types.rst:257
2251522511
msgid "**Error/hint message** (only if configuration is not complete): Zammad tells you, if there is a problem and what you should change in your configuration."
2251622512
msgstr ""
2251722513

22518-
#: ../system/objects/types.rst:264
22514+
#: ../system/objects/types.rst:260
2251922515
msgid "**Search field**: search for an existing attribute in the data source to get a preview. This is required for the fields below to show up."
2252022516
msgstr ""
2252122517

22522-
#: ../system/objects/types.rst:266
22518+
#: ../system/objects/types.rst:262
2252322519
msgid "**Search result response** (only if configuration is not complete): here you can find a syntax highlighted JSON preview of the response, based on the search term you entered."
2252422520
msgstr ""
2252522521

22526-
#: ../system/objects/types.rst:269
22522+
#: ../system/objects/types.rst:265
2252722523
msgid "**Search result list** (only if *search result list key* is properly set): output of the structure under the configured *search result list key*."
2252822524
msgstr ""
2252922525

22530-
#: ../system/objects/types.rst:272
22526+
#: ../system/objects/types.rst:268
2253122527
msgid "**Preview table** (when fully configured): Zammad shows you a table which includes the found items based on the search string (value, label and optional link). You can use this preview if you don't have the complete data structure of the external system in mind."
2253222528
msgstr ""
2253322529

22534-
#: ../system/objects/types.rst:277
22530+
#: ../system/objects/types.rst:273
2253522531
msgid "An example of a configured external data source field from agent perspective:"
2253622532
msgstr ""
2253722533

2253822534
#: ../system/objects/types.rst:None
2253922535
msgid "Screencast showing the search for a product in a ticket"
2254022536
msgstr ""
2254122537

22542-
#: ../system/objects/types.rst:288
22538+
#: ../system/objects/types.rst:284
2254322539
msgid "Link-Template"
2254422540
msgstr ""
2254522541

22546-
#: ../system/objects/types.rst:290
22542+
#: ../system/objects/types.rst:286
2254722543
msgid "Link templates allow you to generate dynamic URLs based on the content of the attribute. This way you can define a base URL and add a variable for the field's content, for example in a search query or as a product ID. After adding content to a link-template field, a URL icon appears on its right side. Clicking the icon opens a new browser tab with the generated URL."
2254822544
msgstr ""
2254922545

22550-
#: ../system/objects/types.rst:296
22546+
#: ../system/objects/types.rst:292
2255122547
msgid "Example for a search query URL:"
2255222548
msgstr ""
2255322549

22554-
#: ../system/objects/types.rst:298
22550+
#: ../system/objects/types.rst:294
2255522551
msgid "Ticket attribute type: **Text Field**"
2255622552
msgstr ""
2255722553

22558-
#: ../system/objects/types.rst:299
22554+
#: ../system/objects/types.rst:295
2255922555
msgid "Text field type: **Text**"
2256022556
msgstr ""
2256122557

22562-
#: ../system/objects/types.rst:300
22558+
#: ../system/objects/types.rst:296
2256322559
msgid "Ticket attribute name: ``my_attribute``"
2256422560
msgstr ""
2256522561

22566-
#: ../system/objects/types.rst:301
22562+
#: ../system/objects/types.rst:297
2256722563
msgid "Link template content: ``https://www.duckduckgo.com/&q=#{ticket.my_attribute}``"
2256822564
msgstr ""
2256922565

22570-
#: ../system/objects/types.rst:302
22566+
#: ../system/objects/types.rst:298
2257122567
msgid "Added field content: ``zammad``"
2257222568
msgstr ""
2257322569

22574-
#: ../system/objects/types.rst:303
22570+
#: ../system/objects/types.rst:299
2257522571
msgid "Resulting URL: ``https://www.duckduckgo.com/&q=zammad``"
2257622572
msgstr ""
2257722573

22578-
#: ../system/objects/types.rst:307
22574+
#: ../system/objects/types.rst:303
2257922575
msgid "You can use any :doc:`Zammad variable </misc/variables>` as long as it's available in the moment you need it."
2258022576
msgstr ""
2258122577

22582-
#: ../system/objects/types.rst:310
22578+
#: ../system/objects/types.rst:306
2258322579
msgid "Available for the field types *Text* (type: text), *Single Selection*, *Multiple Selection* and *External Data Source*."
2258422580
msgstr ""
2258522581

22586-
#: ../system/objects/types.rst:315
22582+
#: ../system/objects/types.rst:311
2258722583
msgid "Another great way of communicating with another system may be Zammad's :doc:`Webhooks </manage/webhook>`."
2258822584
msgstr ""
2258922585

22590-
#: ../system/objects/types.rst:319
22586+
#: ../system/objects/types.rst:315
2259122587
msgid "Translate Field Contents"
2259222588
msgstr ""
2259322589

22594-
#: ../system/objects/types.rst:321
22590+
#: ../system/objects/types.rst:317
2259522591
msgid "For some attribute types, you can decide if their values should be translatable or not. If they are configured as translatable, they appear in the :doc:`translation interface </system/translations>` as other strings in Zammad. This works only for fields with selectable options because the possible choices are known and limited. You can set the translatable flag for these types:"
2259622592
msgstr ""
2259722593

22598-
#: ../system/objects/types.rst:328
22594+
#: ../system/objects/types.rst:324
2259922595
msgid "Boolean field"
2260022596
msgstr ""
2260122597

22602-
#: ../system/objects/types.rst:329
22598+
#: ../system/objects/types.rst:325
2260322599
msgid "Single selection field"
2260422600
msgstr ""
2260522601

22606-
#: ../system/objects/types.rst:330
22602+
#: ../system/objects/types.rst:326
2260722603
msgid "Multiple selection field"
2260822604
msgstr ""
2260922605

22610-
#: ../system/objects/types.rst:331
22606+
#: ../system/objects/types.rst:327
2261122607
msgid "Single tree selection field"
2261222608
msgstr ""
2261322609

22614-
#: ../system/objects/types.rst:332
22610+
#: ../system/objects/types.rst:328
2261522611
msgid "Multiple tree selection field"
2261622612
msgstr ""
2261722613

system/objects/types.rst

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -177,10 +177,6 @@ both data sources. It works like this:
177177
and displays the value to the user. There is no search on Zammad side.
178178

179179
.. warning::
180-
* The usage of a PostgreSQL database for Zammad is required. In any other
181-
case, Zammad will hide the external data source type and you are not
182-
able to use it. If you want to use this feature, consider to
183-
:docs:`migrate your database </appendix/migrate-to-postgresql.html>`.
184180
* Only ``GET`` is supported as request method.
185181
* The data structure must be in JSON format and provide the objects in an
186182
array.

0 commit comments

Comments
 (0)