Pflichtdokumente in Power Apps: Flexibler Umgang mit SharePoint-Dokumenten

power apps dokumente mit sharepoint synchronisation hintergrund

Veröffentlicht:

Autor: Andrea Furrer

Dokumente gehören in vielen Geschäftsanwendungen zum Alltag. Bei Anträgen stellt sich dabei nicht nur die Frage, wo die Dateien abgelegt werden, sondern auch, welche Unterlagen für den jeweiligen Antrag erforderlich sind und wie sichergestellt werden kann, dass alle Pflichtdokumente vorhanden sind.

In einer Power-Apps-Anwendung wurde dafür eine Lösung umgesetzt, die SharePoint als Dokumentenspeicher nutzt und die Dokumentenverwaltung direkt in eine Canvas App integriert. Dabei stand eine Anforderung besonders im Fokus: Neue Pflichtdokumente sollen für neue Anträge gelten, bestehende Anträge jedoch nicht nachträglich ungültig machen.

Die Herausforderung: Pflichtdokumente sind nicht in Stein gemeisselt

Je nach Antragstyp werden unterschiedliche Dokumente benötigt. Einige Unterlagen sind obligatorisch, andere können freiwillig eingereicht werden. Zudem können sich diese Anforderungen im Laufe der Zeit ändern.

Eine einfache Lösung wäre, bei jedem Aufruf die aktuell definierten Pflichtdokumente zu überprüfen. Das führt jedoch zu einem Problem: Wird ein neues Pflichtdokument definiert, fehlt dieses bei allen bereits bestehenden Anträgen, die vor der Änderung erstellt wurden. Im ungünstigsten Fall gelten diese Anträge plötzlich als unvollständig, obwohl sie zum Zeitpunkt ihrer Erstellung alle erforderlichen Unterlagen enthalten haben.

Die Lösung muss deshalb zwei Anforderungen erfüllen:

  • Die Dokumentenanforderungen sollen zentral gepflegt und bei neuen Anträgen automatisch übernommen werden.
  • Bestehende Anträge sollen anhand der Anforderungen beurteilt werden, die zum Zeitpunkt ihrer Erstellung gültig waren.

Dokumentenverwaltung direkt in der App

Für jeden neu erstellten Antrag wird automatisch ein eigener Dokumentenordner in SharePoint angelegt. Sowohl der Antrag als auch der zugehörige Ordner erhalten individuelle Berechtigungen.

In der App steht eine separate Dokumentenansicht zur Verfügung, in der die Dokumente nach Kategorien gruppiert dargestellt werden. Pro Kategorie können Dateien direkt hochgeladen werden. Die erforderlichen Metadaten werden dabei ebenfalls ergänzt, sodass die Dokumente nicht nachträglich in SharePoint klassifiziert werden müssen.

image
Dokumente nach Kategorien

Pflichtdokumente und freiwillige Unterlagen sind klar voneinander getrennt. Kategorien, in denen noch ein Pflichtdokument fehlt, werden rot hervorgehoben. Dadurch ist auf einen Blick erkennbar, welche Unterlagen noch eingereicht werden müssen.

Das Ergebnis: Die Benutzerinnen und Benutzer können ihre Dokumente direkt beim jeweiligen Antrag verwalten und erkennen sofort, wo noch Handlungsbedarf besteht.

Technische Umsetzung: Dokumentenanforderungen zum Erstellungszeitpunkt festhalten

Die Grundlage bildet eine separate SharePoint-Liste, in der die Dokumentenanforderungen pro Antragstyp zentral gepflegt werden. Dort wird festgelegt, welche Dokumente obligatorisch sind und welche freiwillig eingereicht werden können.

Beim Erstellen eines Antrags werden die zu diesem Zeitpunkt gültigen Anforderungen aus der Konfigurationsliste ausgelesen und direkt im Antrag gespeichert. Dafür werden zwei mehrzeilige Textfelder verwendet:

  • Pflichtdokumente: Enthält die für den jeweiligen Antrag erforderlichen Pflichtdokumente.
  • Weitere Dokumente: Enthält die Unterlagen, die freiwillig eingereicht werden können.
image
Pflichtdokumente und weitere Dokumente

Die beiden Felder bilden somit eine Momentaufnahme der Dokumentenanforderungen zum Zeitpunkt der Antragserstellung. Werden die zentralen Vorgaben später angepasst, bleiben die Anforderungen bereits bestehender Anträge unverändert.

Das hat einen entscheidenden Vorteil: Die Konfiguration kann weiterhin zentral verwaltet und angepasst werden, während jeder Antrag seine ursprünglichen Anforderungen behält. Änderungen an der Konfiguration gelten somit für neu erstellte Anträge, ohne bestehende Anträge unbeabsichtigt zu beeinflussen.

Pflichtdokumente automatisch überprüfen

Damit die Vollständigkeit eines Antrags auch technisch ausgewertet werden kann, gibt es ein zusätzliches Feld namens «PflichtdokumenteVorhanden».

Dieses Feld ist als Choice-Spalte mit den Werten «Ja» und «Nein» umgesetzt. Jedes Mal, wenn die Dokumentenansicht verlassen wird, prüft die App, ob sämtliche Pflichtdokumente des betreffenden Antrags vorhanden sind.

Sind alle erforderlichen Dokumente hochgeladen, wird das Feld auf «Ja» gesetzt. Fehlt mindestens ein Pflichtdokument, wird der Wert auf «Nein» aktualisiert.

image
Pflichtdokument fehlt: Wert auf «Nein»

Die Verwendung eines Choice-Feldes hat einen pragmatischen Hintergrund: Die bestehende Lösung ist bereits im Einsatz, das Feld «PflichtdokumenteVorhanden» wurde jedoch neu ergänzt.

Ursprünglich war dafür ein Boolean-Feld vorgesehen. Dieser Feldtyp kennt grundsätzlich nur zwei Werte: «true» oder «false». In der App kann jedoch zusätzlich ein nicht gesetzter Wert («null») auftreten. Dadurch ergeben sich technisch drei mögliche Zustände, obwohl die SharePoint-Oberfläche nur zwei davon abbildet.

Mit einem Choice-Feld, das die Werte «Ja», «Nein» oder einen leeren Wert («Blank») zulässt, lässt sich der tatsächliche Status eindeutig erkennen. Eine zusätzliche Unterscheidung zwischen «false» und einem nicht gesetzten Boolean-Wert ist somit nicht erforderlich.

Anhand des gespeicherten Status lässt sich anschliessend beim Button «Genehmigung starten» prüfen, ob der Antrag alle erforderlichen Unterlagen enthält.

Was bringt dieser Ansatz?

Die Lösung verbindet eine flexible Konfiguration mit einer nachvollziehbaren Vollständigkeitsprüfung.

Die wichtigsten Vorteile im Überblick:

  • Zentrale Pflege: Die Dokumentenanforderungen werden pro Antragstyp an einer Stelle verwaltet.
  • Historisch stabile Anforderungen: Bestehende Anträge behalten die Pflichtdokumente, die zum Zeitpunkt ihrer Erstellung galten.
  • Direkte Dokumentenverwaltung: Dateien können innerhalb der App hochgeladen und mit Metadaten versehen werden.
  • Transparenz für die Benutzenden: Fehlende Pflichtdokumente sind in der Benutzeroberfläche sofort erkennbar.
  • Weiterverwendbarer Status: Die Vollständigkeit wird in einem eigenen Feld gespeichert und kann für weitere Prüfungen und Prozesse genutzt werden.

Fazit

Bei der Dokumentenverwaltung in Power Apps geht es nicht nur darum, Dateien in SharePoint abzulegen. Entscheidend ist auch, wie sich verändernde Anforderungen auf bestehende Anträge auswirken.

Indem die Dokumentenanforderungen beim Erstellen eines Antrags übernommen und direkt im Antrag gespeichert werden, lassen sich eine zentrale Konfiguration und die Prüfung anhand der ursprünglich gültigen Anforderungen miteinander verbinden. Die ergänzende Vollständigkeitsprüfung macht den Status zudem direkt in der Anwendung nutzbar.

So entsteht eine Dokumentenverwaltung, die nicht nur das Hochladen von Dateien vereinfacht, sondern auch sicherstellt, dass Änderungen an den Anforderungen kontrolliert und nachvollziehbar bleiben.

Beitrag teilen
Geschrieben von

Andrea Furrer

Content Services Developer

Profil anzeigen

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

IOZ_LOGO_weiss

Profis für M365-Intranets & digitale Arbeitsplätze, Power Apps, Power Automate Workflows, sowie Managementsysteme.

Angebote

Angebotsübersicht

   
Nach oben scrollen