|
8 | 8 | msgstr "" |
9 | 9 | "Project-Id-Version: Zammad Admin Documentation pre-release\n" |
10 | 10 | "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" |
12 | 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" |
13 | 13 | "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" |
14 | 14 | "Language-Team: LANGUAGE <LL@li.org>\n" |
@@ -3611,7 +3611,7 @@ msgstr "" |
3611 | 3611 | #: ../manage/report-profiles.rst:49 |
3612 | 3612 | #: ../manage/scheduler.rst:109 |
3613 | 3613 | #: ../manage/slas.rst:64 |
3614 | | -#: ../system/objects/types.rst:275 |
| 3614 | +#: ../system/objects/types.rst:271 |
3615 | 3615 | msgid "Preview" |
3616 | 3616 | msgstr "" |
3617 | 3617 |
|
@@ -5878,7 +5878,7 @@ msgstr "" |
5878 | 5878 | #: ../index.rst:96 |
5879 | 5879 | #: ../index.rst:96 |
5880 | 5880 | #: ../manage/roles/permissions.rst:291 |
5881 | | -#: ../system/objects/types.rst:283 |
| 5881 | +#: ../system/objects/types.rst:279 |
5882 | 5882 | msgid "Misc" |
5883 | 5883 | msgstr "" |
5884 | 5884 |
|
@@ -22416,202 +22416,198 @@ msgid "Zammad just looks for the defined list and value keys, reads the content |
22416 | 22416 | msgstr "" |
22417 | 22417 |
|
22418 | 22418 | #: ../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 |
22423 | 22419 | msgid "Only ``GET`` is supported as request method." |
22424 | 22420 | msgstr "" |
22425 | 22421 |
|
22426 | | -#: ../system/objects/types.rst:185 |
| 22422 | +#: ../system/objects/types.rst:181 |
22427 | 22423 | msgid "The data structure must be in JSON format and provide the objects in an array." |
22428 | 22424 | msgstr "" |
22429 | 22425 |
|
22430 | | -#: ../system/objects/types.rst:187 |
| 22426 | +#: ../system/objects/types.rst:183 |
22431 | 22427 | 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)." |
22432 | 22428 | msgstr "" |
22433 | 22429 |
|
22434 | | -#: ../system/objects/types.rst:191 |
| 22430 | +#: ../system/objects/types.rst:187 |
22435 | 22431 | 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." |
22436 | 22432 | msgstr "" |
22437 | 22433 |
|
22438 | | -#: ../system/objects/types.rst:196 |
| 22434 | +#: ../system/objects/types.rst:192 |
22439 | 22435 | 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." |
22440 | 22436 | msgstr "" |
22441 | 22437 |
|
22442 | 22438 | #: ../system/objects/types.rst:None |
22443 | 22439 | msgid "Available settings for external data source fields" |
22444 | 22440 | msgstr "" |
22445 | 22441 |
|
22446 | | -#: ../system/objects/types.rst:220 |
| 22442 | +#: ../system/objects/types.rst:216 |
22447 | 22443 | msgid "Search URL" |
22448 | 22444 | msgstr "" |
22449 | 22445 |
|
22450 | | -#: ../system/objects/types.rst:206 |
| 22446 | +#: ../system/objects/types.rst:202 |
22451 | 22447 | 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}``" |
22452 | 22448 | msgstr "" |
22453 | 22449 |
|
22454 | | -#: ../system/objects/types.rst:211 |
| 22450 | +#: ../system/objects/types.rst:207 |
22455 | 22451 | msgid "If in doubt, ask the responsible person for the external data source how they expect the structure of the URL." |
22456 | 22452 | msgstr "" |
22457 | 22453 |
|
22458 | | -#: ../system/objects/types.rst:215 |
| 22454 | +#: ../system/objects/types.rst:211 |
22459 | 22455 | 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." |
22460 | 22456 | msgstr "" |
22461 | 22457 |
|
22462 | | -#: ../system/objects/types.rst:218 |
| 22458 | +#: ../system/objects/types.rst:214 |
22463 | 22459 | 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." |
22464 | 22460 | msgstr "" |
22465 | 22461 |
|
22466 | | -#: ../system/objects/types.rst:230 |
| 22462 | +#: ../system/objects/types.rst:226 |
22467 | 22463 | msgid "SSL Verification" |
22468 | 22464 | msgstr "" |
22469 | 22465 |
|
22470 | | -#: ../system/objects/types.rst:223 |
| 22466 | +#: ../system/objects/types.rst:219 |
22471 | 22467 | msgid "Here you can switch the SSL verification to no." |
22472 | 22468 | msgstr "" |
22473 | 22469 |
|
22474 | | -#: ../system/objects/types.rst:227 |
| 22470 | +#: ../system/objects/types.rst:223 |
22475 | 22471 | 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." |
22476 | 22472 | msgstr "" |
22477 | 22473 |
|
22478 | | -#: ../system/objects/types.rst:236 |
| 22474 | +#: ../system/objects/types.rst:232 |
22479 | 22475 | msgid "HTTP Authentication" |
22480 | 22476 | msgstr "" |
22481 | 22477 |
|
22482 | | -#: ../system/objects/types.rst:233 |
| 22478 | +#: ../system/objects/types.rst:229 |
22483 | 22479 | 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)." |
22484 | 22480 | msgstr "" |
22485 | 22481 |
|
22486 | | -#: ../system/objects/types.rst:243 |
| 22482 | +#: ../system/objects/types.rst:239 |
22487 | 22483 | msgid "Search result list key" |
22488 | 22484 | msgstr "" |
22489 | 22485 |
|
22490 | | -#: ../system/objects/types.rst:239 |
| 22486 | +#: ../system/objects/types.rst:235 |
22491 | 22487 | 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``." |
22492 | 22488 | msgstr "" |
22493 | 22489 |
|
22494 | | -#: ../system/objects/types.rst:249 |
| 22490 | +#: ../system/objects/types.rst:245 |
22495 | 22491 | msgid "Search result value key" |
22496 | 22492 | msgstr "" |
22497 | 22493 |
|
22498 | | -#: ../system/objects/types.rst:246 |
| 22494 | +#: ../system/objects/types.rst:242 |
22499 | 22495 | 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``." |
22500 | 22496 | msgstr "" |
22501 | 22497 |
|
22502 | | -#: ../system/objects/types.rst:255 |
| 22498 | +#: ../system/objects/types.rst:251 |
22503 | 22499 | msgid "Search result label key" |
22504 | 22500 | msgstr "" |
22505 | 22501 |
|
22506 | | -#: ../system/objects/types.rst:252 |
| 22502 | +#: ../system/objects/types.rst:248 |
22507 | 22503 | 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``." |
22508 | 22504 | msgstr "" |
22509 | 22505 |
|
22510 | | -#: ../system/objects/types.rst:258 |
| 22506 | +#: ../system/objects/types.rst:254 |
22511 | 22507 | msgid "In the preview area, you can find the following items (depending on your configuration above):" |
22512 | 22508 | msgstr "" |
22513 | 22509 |
|
22514 | | -#: ../system/objects/types.rst:261 |
| 22510 | +#: ../system/objects/types.rst:257 |
22515 | 22511 | 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." |
22516 | 22512 | msgstr "" |
22517 | 22513 |
|
22518 | | -#: ../system/objects/types.rst:264 |
| 22514 | +#: ../system/objects/types.rst:260 |
22519 | 22515 | 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." |
22520 | 22516 | msgstr "" |
22521 | 22517 |
|
22522 | | -#: ../system/objects/types.rst:266 |
| 22518 | +#: ../system/objects/types.rst:262 |
22523 | 22519 | 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." |
22524 | 22520 | msgstr "" |
22525 | 22521 |
|
22526 | | -#: ../system/objects/types.rst:269 |
| 22522 | +#: ../system/objects/types.rst:265 |
22527 | 22523 | msgid "**Search result list** (only if *search result list key* is properly set): output of the structure under the configured *search result list key*." |
22528 | 22524 | msgstr "" |
22529 | 22525 |
|
22530 | | -#: ../system/objects/types.rst:272 |
| 22526 | +#: ../system/objects/types.rst:268 |
22531 | 22527 | 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." |
22532 | 22528 | msgstr "" |
22533 | 22529 |
|
22534 | | -#: ../system/objects/types.rst:277 |
| 22530 | +#: ../system/objects/types.rst:273 |
22535 | 22531 | msgid "An example of a configured external data source field from agent perspective:" |
22536 | 22532 | msgstr "" |
22537 | 22533 |
|
22538 | 22534 | #: ../system/objects/types.rst:None |
22539 | 22535 | msgid "Screencast showing the search for a product in a ticket" |
22540 | 22536 | msgstr "" |
22541 | 22537 |
|
22542 | | -#: ../system/objects/types.rst:288 |
| 22538 | +#: ../system/objects/types.rst:284 |
22543 | 22539 | msgid "Link-Template" |
22544 | 22540 | msgstr "" |
22545 | 22541 |
|
22546 | | -#: ../system/objects/types.rst:290 |
| 22542 | +#: ../system/objects/types.rst:286 |
22547 | 22543 | 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." |
22548 | 22544 | msgstr "" |
22549 | 22545 |
|
22550 | | -#: ../system/objects/types.rst:296 |
| 22546 | +#: ../system/objects/types.rst:292 |
22551 | 22547 | msgid "Example for a search query URL:" |
22552 | 22548 | msgstr "" |
22553 | 22549 |
|
22554 | | -#: ../system/objects/types.rst:298 |
| 22550 | +#: ../system/objects/types.rst:294 |
22555 | 22551 | msgid "Ticket attribute type: **Text Field**" |
22556 | 22552 | msgstr "" |
22557 | 22553 |
|
22558 | | -#: ../system/objects/types.rst:299 |
| 22554 | +#: ../system/objects/types.rst:295 |
22559 | 22555 | msgid "Text field type: **Text**" |
22560 | 22556 | msgstr "" |
22561 | 22557 |
|
22562 | | -#: ../system/objects/types.rst:300 |
| 22558 | +#: ../system/objects/types.rst:296 |
22563 | 22559 | msgid "Ticket attribute name: ``my_attribute``" |
22564 | 22560 | msgstr "" |
22565 | 22561 |
|
22566 | | -#: ../system/objects/types.rst:301 |
| 22562 | +#: ../system/objects/types.rst:297 |
22567 | 22563 | msgid "Link template content: ``https://www.duckduckgo.com/&q=#{ticket.my_attribute}``" |
22568 | 22564 | msgstr "" |
22569 | 22565 |
|
22570 | | -#: ../system/objects/types.rst:302 |
| 22566 | +#: ../system/objects/types.rst:298 |
22571 | 22567 | msgid "Added field content: ``zammad``" |
22572 | 22568 | msgstr "" |
22573 | 22569 |
|
22574 | | -#: ../system/objects/types.rst:303 |
| 22570 | +#: ../system/objects/types.rst:299 |
22575 | 22571 | msgid "Resulting URL: ``https://www.duckduckgo.com/&q=zammad``" |
22576 | 22572 | msgstr "" |
22577 | 22573 |
|
22578 | | -#: ../system/objects/types.rst:307 |
| 22574 | +#: ../system/objects/types.rst:303 |
22579 | 22575 | msgid "You can use any :doc:`Zammad variable </misc/variables>` as long as it's available in the moment you need it." |
22580 | 22576 | msgstr "" |
22581 | 22577 |
|
22582 | | -#: ../system/objects/types.rst:310 |
| 22578 | +#: ../system/objects/types.rst:306 |
22583 | 22579 | msgid "Available for the field types *Text* (type: text), *Single Selection*, *Multiple Selection* and *External Data Source*." |
22584 | 22580 | msgstr "" |
22585 | 22581 |
|
22586 | | -#: ../system/objects/types.rst:315 |
| 22582 | +#: ../system/objects/types.rst:311 |
22587 | 22583 | msgid "Another great way of communicating with another system may be Zammad's :doc:`Webhooks </manage/webhook>`." |
22588 | 22584 | msgstr "" |
22589 | 22585 |
|
22590 | | -#: ../system/objects/types.rst:319 |
| 22586 | +#: ../system/objects/types.rst:315 |
22591 | 22587 | msgid "Translate Field Contents" |
22592 | 22588 | msgstr "" |
22593 | 22589 |
|
22594 | | -#: ../system/objects/types.rst:321 |
| 22590 | +#: ../system/objects/types.rst:317 |
22595 | 22591 | 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:" |
22596 | 22592 | msgstr "" |
22597 | 22593 |
|
22598 | | -#: ../system/objects/types.rst:328 |
| 22594 | +#: ../system/objects/types.rst:324 |
22599 | 22595 | msgid "Boolean field" |
22600 | 22596 | msgstr "" |
22601 | 22597 |
|
22602 | | -#: ../system/objects/types.rst:329 |
| 22598 | +#: ../system/objects/types.rst:325 |
22603 | 22599 | msgid "Single selection field" |
22604 | 22600 | msgstr "" |
22605 | 22601 |
|
22606 | | -#: ../system/objects/types.rst:330 |
| 22602 | +#: ../system/objects/types.rst:326 |
22607 | 22603 | msgid "Multiple selection field" |
22608 | 22604 | msgstr "" |
22609 | 22605 |
|
22610 | | -#: ../system/objects/types.rst:331 |
| 22606 | +#: ../system/objects/types.rst:327 |
22611 | 22607 | msgid "Single tree selection field" |
22612 | 22608 | msgstr "" |
22613 | 22609 |
|
22614 | | -#: ../system/objects/types.rst:332 |
| 22610 | +#: ../system/objects/types.rst:328 |
22615 | 22611 | msgid "Multiple tree selection field" |
22616 | 22612 | msgstr "" |
22617 | 22613 |
|
|
0 commit comments