..  include:: /Includes.rst.txt


..  _extensionSettings:

==================
Extension Settings
==================

After the installation you need to configure the extension settings. Login
to TYPO3 backend as an administrator or system maintainer and chose
`Settings` from the left main menu. Click `Configure Extensions` from the
first panel and chose `service_bw2` from the extension list.

..  figure:: ../../Images/Configuration/OpenExtensionConfiguration.png
    :alt: Open Extension Settings

..  figure:: ../../Images/Configuration/LocateServiceBw2Settings.png
    :alt: Locate Extension Settings for service_bw2

Tab: Basic
==========

Mandant
-------

Default: <empty>

The mandant number of the city.

Bearer Accesstoken for Service BW API
-------------------------------------

Default: <empty>

The Bearer Access Token to get access to Service BW API endpoint. You can
retrieve one from here: https://sgw.service-bw.de/rest-v2/documentation/
Scoll down to "Authentifizierung: Token", click on "Try it out" and enter your
credentials and click on "Execute". You will find the Bearer Token below in "Response Body". Copy over the full string incl. the "Bearer" word.

Base URL
--------

Default: `https://sgw.service-bw.de:443/`

The URL where we can access the API of Service BW. In most cases there is no
need to change that value.

It's just `[scheme:domain:port]`. Do not enter a path to a specific API version,
as `service_bw2` does that for you automatically in `ServiceBwClient`
class. `service_bw2` will use the API V2 endpoint internally.

Allowed languages
-----------------

Default: `de=0;en=0;fr=0`

This is important if your website is multi language.

Format: [2 letters language ISO code]=[sys_language_uid].

Assign multiple languages with ";".

Example: de=2;en=5.

First value will be used as default language.

AGS
---

Default: <empty>

German description of Service BW API:

..  code-block::code

    Die amtlichen Gemeindeschlüssel, in deren Kontext man diese Operation
    ausführen möchte.

Optional parameter for API requests. Leave empty to not use this filter option.

Gebiet ID
---------

Default: <empty>

German description of Service BW API:

..  code-block::code

    Die IDs der Gebiete, in deren Kontext man diese Operation ausführen möchte.

Optional parameter for API requests. Leave empty to not use this filter option.