Seit Version 1418 besitzt VIA eine native d3-Integration. Diese lässt sich in den Einstellungen unter “S3 & DMS” aktivieren und verwalten.

Einstellungen

Allgemeine Einstellungen

dms_url Die Basis-Url hinter der sich die d3-Endpunkte befinden,

landkreis.d-velop.cloud/dms/r

dms_credentials Der Bearer-Token zum Authentifizieren. Wird in d3 generiert.

dlLxb2YsiHFREQB9APxq7Uo????????????????????????????LZ1D80OvaMOJF4aYMYcu5R0B/o38V8T+npicaPy1Pods=&_z_A0V5ayCRN7F_yM6sFHXLHAfdnZnZZraHLDsj5bUv47MLz6JvWiQyu1ksM7_EsfVnqoDB4kpcpFM93vZRAmElfQGQYgO-e

sourceCategory veraltet

repositoryId Auf einem d3-Server können mehrere Repositories existieren. Dieser Wert bestimmt in Welches die Akten geschrieben werden.

tz647bf3-????-????-????-3ab80d61e809

Akten beim ersten Öffnen automatisch anlegen Wenn aktiviert, wird VIA die Akten in d3 automatisch anlegen, sobald die Schüler*innen-Akte angelegt wurde. Aktuell ist es noch erforderlich, dass die Schüler*innen dazu geöffnet werden. In einem Update wird das Anlagen im Hintergrund noch nachgereicht.

Akten beim Speichern automatisch aktualisieren Wenn aktiviert, wird VIA bei jedem Speichervorgang die Daten der Akte an d3 zum Aktualisieren schicken.

Die Akten-Typen

Abfrage der Eigenschaft Der Query pro Akten-Typ, der die Daten bereitstellt, die in die Akte übergeben werden sollen.

D3-Key für [Entität]-ID Der Key, der den Einzigartigen Schlüssel pro Akte bereitstellt. Dieser wird verwendet, um Akten zu öffnen.

Json-Objekt Der Payload, der an d3 übergeben wird. Die Werte aus der jeweiligen Abfrage, so wie die allgemeinen Einstellungen, lassen sich als [Textmarken] verwenden.

AVIAP Schüler*innen
select 
s.id as id,
s.snr as student_number,
s.nachname as last_name,
s.vorname as first_name,
s.gb_date as birth_date,
(select wi_dms_get_schueler_archiv_date('[ID]')) as archiv_date

from tbl_schueler s WHERE ID = '[ID]';
{
	"sourceCategory": "AVIAP",
	"sourceId": "/dms/r/[repositoryId]/source",
	"sourceProperties": {
        "properties": [
            {
                "key": "204",
                "values": [
                    "[id]"
                ]
            },
            {
                "key": "188",
                "values": [
                    "[student_number]"
                ]
            },
            {
                "key": "19",
                "values": [
                    "[last_name]"
                ]
            },
            {
                "key": "21",
                "values": [
                    "[first_name]"
                ]
            },
            {
                "key": "189",
                "values": [
                    "[birth_date]"
                ]
            },
            {
                "key": "190",
                "values": [
                    "[archiv_date]"
                ]
            }
        ]
    }
}
AVIAA Anträge unterhalb AVIAA
SELECT 
schueler_id,
id,
addr_straße as street,
addr_hnr as house_nr,
addr_plz as postcode,
addr_ort as city,
coalesce(addr_ortsteil,'') as district,
date_format(lastChanged, "%Y-%m-%d") as last_changed_date_sql,
(SELECT schuljahr_system FROM kalender_schuljahr WHERE id = sj_id) as schuljahr,
(select kürzel from schulen where id = schule_id_besucht) as shortform

FROM tbl_antraege WHERE id = '[ID]';
{
	"sourceCategory": "AVIAA",
	"sourceId": "/dms/r/[repositoryId]/source",
	"sourceProperties": {
        "properties": [
            {
                "key": "204",
                "values": [
                    "[id]"
                ]
            },
            {
                "key": "205",
                "values": [
                    "[id]"
                ]
            },
            {
                "key": "191",
                "values": [
                    "[street] [house_nr], [postcode] [city] [district]"
                ]
            },
            {
                "key": "192",
                "values": [
                    "[last_changed_date_sql]"
                ]
            },
            {
                "key": "193",
                "values": [
                    "[schuljahr]"
                ]
            },
            {
                "key": "194",
                "values": [
                    "[shortform]"
                ]
            }
        ]
    }
}
AVIAS Schulen
SELECT 
id as id,
kürzel as shortform,
name as name,
straße as street,
hnr as house_nr,
plz as postcode,
ort as city,
ortsteil as district


FROM schulen 
WHERE id = '[ID]';
{
	"sourceCategory": "AVIAS",
	"sourceId": "/dms/r/[repositoryId]/source",
	"sourceProperties": {
        "properties": [
            {
                "key": "211",
                "values": [
                    "[shortform]"
                ]
            },
            {
                "key": "200",
                "values": [
                    "[id]"
                ]
            },
            {
                "key": "206",
                "values": [
                    "[name]"
                ]
            },
            {
                "key": "191",
                "values": [
                    "[street] [house_nr], [postcode] [city] [district]"
                ]
            }
        ]
    }
}
AVIAU Unternehmen
SELECT
id as id,
kurzform as short_name,
langname as name,
straße as street,
hnr as house_nr,
plz as postcode,
ort as city,
ortsteil as district
FROM unternehmen
WHERE id = "[ID]";
{
	"sourceCategory": "AVIAU",
	"sourceId": "/dms/r/[repositoryId]/source",
	"sourceProperties": {
        "properties": [
            {
                "key": "206",
                "values": [
                    "[short_name]"
                ]
            },
            {
                "key": "201",
                "values": [
                    "[name]"
                ]
            },
            {
                "key": "191",
                "values": [
                    "[street] [house_nr], [postcode] [city] [district]"
                ]
            }
        ]
    }
}
AVIAV Verträge
SELECT 

tour as shortform,
id as id,
tour as name
FROM touren
WHERE id = '[ID]';
{
	"sourceCategory": "AVIAV",
	"sourceId": "/dms/r/[repositoryId]/source",
	"sourceProperties": {
        "properties": [
            {
                "key": "206",
                "values": [
                    "[shortform]"
                ]
            },
            {
                "key": "207",
                "values": [
                    "[id]"
                ]
            },
            {
                "key": "201",
                "values": [
                    "[name]"
                ]
            }
        ]
    }
}

Nutzung

Ist das DMS in den Einstellungen aktiviert, auf “D3” eingestellt und richtig konfiguriert, wird jetzt in folgenden Masken ein Button mit der Aufschrift “DMS” angezeigt:

  • Schüler*innen

  • Schüler*innen→Antrag, wenn Anträge ausgewählt

  • Unternehmen, wenn Unternehmen ausgewählt

  • Schulen, wenn Schule ausgewählt

  • Touren

Anlegen von Akten

  • Wenn in den Einstellungen Akten beim ersten Öffnen automatisch anlegen aktiviert ist, wird die Akte beim Öffnen der Schüler*innen angelegt.

  • Sonst kann die Akte manuell angelegt werden:

    • Button [DMS] klicken

    • Button “Akte erstellen” klicken.

    • Ist bereits eine Akte angelegt, ist dieser Button nicht mehr verfügbar.

Aktualisieren von Akten

  • Wenn in den Einstellungen Akten beim Speichern automatisch aktualisieren aktiviert ist, wird VIA die Akte immer nach dem eigenen Speichervorgang aktualisieren.

  • Sonst kann die Akte manuell aktualisieren:

    • Button [DMS] klicken

    • Button “Akte aktualisieren” klicken.

    • Ist noch keine Akte angelegt, ist dieser Button noch nicht verfügbar.

Öffnen von Akten

  • Button [DMS] klicken

  • Button “Akte öffnen” klicken

Löschen von Akten

Aktuell noch nicht implementiert.