Datei Auslesen Flow

Aus einem SharePoint-Ordnerlink wird der echte Ordnerpfad ermittelt, dann werden per SharePoint-REST-API alle Dateien im Ordner gelistet und als Auswahlliste (z. B. fuer eine Adaptive Card) an den Nutzer zurueckgegeben.

Der Trigger ist der Startpunkt des Flows. Er bestimmt, wann der Flow startet und welche Eingabedaten (z. B. ein Link) am Anfang vorliegen.

Im Flow meint man meist dasselbe: Ein Schritt (Node/Action) ist ein einzelner Baustein im Ablauf, z. B. Compose, HTTP Request, Apply to each, Append to array variable.

Eine absolute URL enthaelt Protokoll und Domain, z. B. https\://\[Tenant].sharepoint.com/sites/\[Site]/...

Eine domain-relative URL beginnt nur mit /sites/... und enthaelt keine Domain. Sie ist ohne Kontext nicht eindeutig.

Weil bei domain-relativen URLs die Domain (Host) gar nicht im String enthalten ist. Ohne feste Tenant-Info ist das nicht ableitbar.

Der Host ist die Domain zwischen https\:// und dem naechsten /, z. B. \[Tenant].sharepoint.com.

uriHost liest aus einer absoluten URL den Host (Domain) heraus, z. B. \[Tenant].sharepoint.com.

Weil uriHost eine wohlgeformte absolute URI erwartet. /sites/... ist nur ein Pfad ohne Protokoll und Host.

Sanitize bedeutet Eingaben bereinigen, z. B. HTML-Entities in echte Zeichen umwandeln, damit Parsen und Vergleiche funktionieren.

HTML-Entities sind kodierte Schreibweisen fuer Sonderzeichen. & steht fuer das Zeichen &.

Manche Systeme liefern bereits kodierte Zeichen nochmals kodiert (doppelte Kodierung). Dann muss man beide Stufen ersetzen.

replace ersetzt in einem String alle Vorkommen von alt durch neu, z. B. & zu &.

Normalisieren heisst unterschiedliche Eingabeformen auf ein einheitliches Format bringen, z. B. immer eine absolute URL erzeugen.

Wenn man URI-Funktionen wie uriHost oder uriPath nutzen will oder wenn nachfolgende Schritte zwingend eine absolute URL erwarten.

Eine Variable ist ein Speicherplatz im Flow, der Werte waehrend des Laufs haelt (String, Array, Objekt usw.).

Ein Array ist eine Liste von Elementen, z. B. eine Liste gefundener Dateien. Startwert ist oft \[] (leer).

Ein Objekt ist ein Satz aus Schluessel-Wert Paaren, z. B. {"title":"Datei.pdf","value":"[https://..."}

Damit man spaeter pro Datei einen Eintrag anhaengen kann und am Ende eine Liste aller Auswahloptionen hat.

Es haengt genau ein Element (String, Zahl oder Objekt) an ein Array an. In einer Schleife baut man so eine Ergebnisliste auf.

Weil die Adaptive Card Choices als Objekte mit title und value erwarten. Strings haben keine Felder, daher werden title/value sonst null.

Erst ein Compose bauen, das das Objekt erzeugt, dann im Append-Schritt outputs(Compose) anhaengen. Das vermeidet Editor- und Syntaxprobleme.

Eine Schleife, die fuer jedes Element in einem Array die enthaltenen Schritte ausfuehrt, z. B. fuer jede gefundene Datei.

item() ist das aktuelle Element der Schleife, also die Datei, die gerade verarbeitet wird.

Ein Pfad innerhalb von SharePoint ab der Domain, meist beginnend mit /sites/...; er beschreibt Datei oder Ordner ohne den Host.

Man kombiniert https\:// + Host + ServerRelativeUrl, also z. B. concat('https\://', Host, ServerRelativeUrl).

Viele Systeme erwarten URL-Encoding. Leerzeichen in SharePoint-Pfaden werden typischerweise als %20 kodiert und sind so stabiler.

Eine Power Automate Aktion, mit der man SharePoint REST/OData Endpoints direkt aufrufen kann, wenn Standardaktionen nicht ausreichen.

Die Aktion braucht den Kontext der SharePoint-Site (Basis-URL), in dem der REST-Aufruf ausgefuehrt wird.

Die Uri ist der REST-Pfad relativ zur Site Address, z. B. \_api/web/...; sie bestimmt, welche Ressource abgefragt wird.

Das ist die HTTP-basierte API von SharePoint, mit der man Ordner, Dateien, Listen usw. programmatisch abfragen kann.

Es adressiert einen Ordner per server-relativem Pfad und liefert die Dateien in diesem Ordner zurueck.

AllItems.aspx ist eine Ansichtsseite (UI), kein Ordner. GetFolderByServerRelativeUrl erwartet einen echten Ordnerpfad.

Bei AllItems-Links steht der Zielordner haeufig im Query-Parameter id= (URL-kodiert) und nicht im Seitenpfad der Ansicht.

Es dekodiert URL-kodierte Werte (z. B. %2F zu /), damit aus dem id-Parameter ein normaler Pfad wird.

split zerlegt den Link an Trennstellen (z. B. 'id=' oder '&'), damit man genau den Parameterwert herausziehen kann.

Weil outputs() exakt den internen Action-Namen erwartet. Schon kleine Abweichungen fuehren zu „ungültiger Verweis“.

Referenzen nicht tippen, sondern per Dynamic Content neu einfuegen oder Step so umbenennen, dass der interne Name eindeutig ist.

Ein Design-Time Validierungsfehler: Der Flow kann nicht gespeichert/aktiviert werden, weil die Definition an einer Stelle ungueltig ist (z. B. Verschachtelung, Referenzen).

Ein Response-Schritt (Antwort an Aufrufer) darf oft nicht innerhalb eines Apply to each (foreach) liegen; das macht die Flow-Struktur ungueltig.

Ein Container, der mehrere Actions gruppiert. Er wird oft genutzt fuer Struktur, Fehlerbehandlung oder als Workaround fuer Validierungsprobleme.

Ein JSON-basiertes UI-Format fuer interaktive Karten (z. B. in Teams/Copilot Studio) mit Texten, Inputs und Buttons.

Ein Button-Typ in Adaptive Cards, der beim Klicken die Eingaben (z. B. ausgewaehlte Choices) an den Bot/Flow zuruecksendet.

Zero-Width/BOM Zeichen koennen JSON-Parser stoeren. Deshalb $schema sauber ohne unsichtbare Zeichen setzen. (Ergänzung)

Zwischenschritte sichtbar machen (Compose) und Outputs pruefen: Host, FolderPfad, HTTP-Response-Array, aktuelles item, finale DateienListe. So findet man schnell, wo null oder falsche Werte entstehen.