Versions Compared

Version Old Version 133 New Version 134
Changes made by

Rolf Ammermann

Rolf Ammermann

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Include Page
Einleitung
Einleitung

Inhaltsverzeichnis Integrationsleitfaden

Table of Contents
minLevel1
maxLevel7
stylenone

...

4.1.1. HTML-Code Beispiel Einbindung “at-erwerbstaetigkeit” mit Attributen und Kategorisierung von Codeteilen

...

Panel
bgColor#E6FCFF

Zur Übersicht des Integrationsleitfadens

Info

Nachfolgend finden Sie eine Vorlage für einen vollumfänglich konfigurierten HTML-Code sowie eine Detaillierung der Anpassungsoptionen am Beispiel der dezentralen Antragsstrecke “Aufenthaltstitel zur Erwerbstätigkeit“.

Wir empfehlen die Web Component Einbindung durch die Ansprechpersonen vornehmen zu lassen, die bei Ihnen im Haus für die Pflege der Webseite zuständig sind.

Kategorien zur Anpassung des Codes

Farbe

Bedeutung

Rot

Code muss für die korrekte Funktionsweise der Web Component 1:1 übernommen werden.

Gelb

Code muss aus fachlichen Gründen übernommen werden, kann aber textuell (nicht die HTML-Attribute) angepasst werden.

Grün

Code ist optional und die Einbindung der Web Component. Es wird jedoch auf Grund von Nutzerfreundlichkeit und einer einheitlichen Darstellung der Web Component empfohlen diesen zu verwenden.

Türkis

Code muss dienstspezifisch angepasst werden.

Grau

Code muss mandantenspezifisch angepasst werden.

Violett

Attribute, welche zusätzliche Funktionen für die Antragsstrecke bereitstellen. Diese können bei Bedarf hinzugefügt werden, um z.B. das Nutzerkonto anzubieten.

HTML-Code Beispiel Aufenthaltstitel zur Erwerbstätigkeit mit Attributen

<html lang="de">       

        <head>

            <meta charset="UTF-8">

            <meta name="viewport" content="width=device-width, initial-scale=1.0">

            <title>Antrag für einen Aufenthaltstitel zur Erwerbstätigkeit</title>

            <link rel="stylesheet" href="https://api.service-digitale-verwaltung.de/embed/themes/tf-blue.css">

            <script src="https://api.service-digitale-verwaltung.de/embed/polyfill/polyfill.js"></script>

        </head>

        <body style="margin-top: 4rem;">

            <noscript>

                Für die Verwendung dieses Dienstes ist JavaScript erforderlich.

                Bitte aktivieren Sie diese Funktion in Ihren Browsereinstellungen oder verwenden Sie einen anderen Web-Browser mit aktiviertem JavaScript.

            </noscript>

                <at-erwerbstaetigkeit ags="12345678" language-selection hide-login="false" plz-check hide-page-nav="false" page-nav-position="left" excluded-languages="ru" page-nav-position =“left“></at-erwerbstaetigkeit>               

                <script src="https://api.service-digitale-verwaltung.de/embed/ at-erwerbstaetigkeit/at-erwerbstaetigkeit.js" charset="UTF-8"></script>

                                  

        </body>

    </html>

4.2. Einbindung Nutzerkonto

...

Panel
bgColor#E6FCFF

Zur Übersicht des Integrationsleitfadens

  •  Bei Bedarf Sprachauswahl zum Antragsbeginn aktivieren.
Panel
panelIconId1f4cb
panelIcon:clipboard:
panelIconText📋
bgColor#ABF5D1

Anleitung:

Die Sprachauswahl kann zum Antragsbeginn gemäß dertechnischen Anleitung aktiviert oder deaktiviert werden. Zu verwenden ist das Attribut „language-selection“. Weitere Informationen zu der Spracheinstellung finden Sie hier.

⚠️ Über das Attribut “excluded-languages” kann die angezeigte Sprachauswahl in den Antragsstrecken eingeschränkt werden und somit einzelne Übersetzungen der Antragsoberfläche deaktiviert werden. Folgendes Beispiel veranschaulicht die Entfernung der Übersetzungen in die russische und türkische Sprache für die Antragsstrecke „Aufenthaltstitel zur Erwerbstätigkeit“:

<at-erwerbstaetigkeit excluded-languages="ru, tr" />

Die in den Anführungszeichen des Codes genannten Sprachkürzel lauten wie folgt:

  • de = Deutsch

  • en = Englisch

  • ru = Russisch

  • tr = Türkisch

  • sr = Serbokroatisch

  • uk = Ukrainisch (nur für Antragsstrecke „at-germany4ukraine“ vorhanden)

Diese Codezeile kann entweder zentral in der Bündelungskomponente oder je Antragsstrecke im HTML-Code der Web-Component eingebaut werden.

Das Deaktivieren von einzelnen Sprachen kann lediglich über das Attribut “excluded-languages” im HTML-Code gesteuert werden. Auch wenn Sie die angezeigten Übersetzungen der einzelnen Texte im OZG Service Management löschen, erscheinen die jeweiligen Übersetzungen in dem Online-Dienst mit der entsprechenden Sprachauswahl.

...

Panel
panelIconIdatlassian-light_bulb_on
panelIcon:light_bulb_on:
panelIconText:light_bulb_on:
bgColor#FFBDAD

Hinweis: Die zur Verfügung stehenden Antragsstrecken sind in deutscher Sprache und auf Grundlage des lateinischen Alphabets entwickelt worden. Die in den Antragsstrecken bereitgestellten Beschreibungs- und Hilfetexte in deutscher und verschiedenen weiteren Sprachen basieren hierbei, trotz Übersetzung und der Verwendung des kyrillischen Alphabets, weiterhin auf der deutschen Antragsstrecke unter Verwendung des lateinischen Alphabets.
Die Anträge gehen, trotz der beliebigen Sprachauswahl der Antragsstellenden für die Beschreibungs- und Hilfetexte der Antragsstrecke, in deutscher Sprache und der Verwendung des lateinischen Alphabets in den zu befüllenden Feldern im Fachverfahren ein. Dies gilt für alle Antragsstrecken.

...