Gibt die URL einer bestimmten Datei aus einem Datensatz zurück

Mit dieser Funktion lässt sich gezielt eine Datei (z. B. ein Bild oder ein Anhang) aus einem Datensatz verlinken – etwa für die Verwendung in PDFs, E-Mails oder externen Apps. Im Gegensatz zu shareFile() eignet sich fileUrl() auch für den Einsatz in Formel-Feldern und erzeugt dauerhaft gültige Links, die auch außerhalb der Datenbank funktionieren.

fileUrl() kann nicht in Triggern oder in do as server, do as transaction oder do as deferred verwendet werden.

Die URL enthält Informationen über den aktuell angemeldeten Benutzer – diese sind nur im Client verfügbar. Serverseitige Blöcke haben keinen Zugriff auf diese Benutzerdaten, daher funktioniert fileUrl() dort nicht.

Syntax

file(nid, string)

Rückgabewert

link

Beispiele

In der URL steht {API-KEY} als Platzhalter für den echten API-Key, der aus Sicherheitsgründen im Ergebnis entfernt wurde.

Um die URL einer Datei (z. B. eines hochgeladenen Bildes mit dem Namen „Cave Entrance Waterfall.jpg”) zu erzeugen, muss der Dateiname aus dem Pfad extrahiert werden. Das gelingt mit einem regulären Ausdruck:

Beispiel 1: Direkt im Funktionsaufruf

fileUrl(this, extractx(text(Bild), ".+/(.+)", "$1"))

Hier wird mithilfe eines regulären Ausdrucks der letzte Teil des Pfades – also der Dateiname – aus dem Text extrahiert.

Der Ausdruck .+/(.+) sucht nach dem letzten Schrägstrich / und gibt nur den Teil danach zurück: den Dateinamen.

Ergebnis: https://dbde0149.ninox.com/t3gDkNhdoqf2sTmAR/dd0usv6i6cet/files/get/O2/Cave%20Entrance%20Waterfall.jpg?T=1742980446305&XT=USER-{API-KEY}

Beispiel 2: Lesbarer mit Zwischenschritt

let dateiname := extractx(text(Bild), "[^/]+$");
fileUrl(this, dateiname)

Diese Variante ist besonders leserfreundlich:

Zunächst wird mit extractx(text(Bild), "[^/]+$") der letzte Abschnitt nach dem letzten Slash extrahiert – also der Dateiname.

Der Ausdruck [^/]+$ bedeutet: „Suche alle Zeichen, die nicht / sind – und zwar am Ende des Textes.“

Ergebnis: https://dbde0149.ninox.com/t3gDkNhdoqf2sTmAR/dd0usv6i6cet/files/get/O2/Cave%20Entrance%20Waterfall.jpg?T=1742980446305&XT=USER-{API-KEY}

Siehe auch

extractx extrahiert aus einem String einen bestimmten Teil mithilfe eines regulären Ausdrucks.

shareFile gibt die URL einer bestimmten Datei zurück.