Datei-Uploads

Mit NueForms Datei-Upload-Fragetyp können Befragte Dateien an ihre Formularübermittlungen anhängen. Diese Anleitung zeigt, wie du Datei-Uploads einrichtest, Beschränkungen konfigurierst und auf hochgeladene Dateien zugreifst.

Datei-Upload-Frage einrichten

1. Öffne dein Formular im NueForm-Builder.
2. Klicke auf den +-Button, um eine neue Frage hinzuzufügen.
3. Wähle File Upload aus der Liste der Fragetypen.
4. Konfiguriere den Fragetitel (z. B. „Lade deinen Lebenslauf hoch" oder „Hänge unterstützende Dokumente an").
5. Markiere die Frage als Pflichtfeld, wenn eine Datei zwingend nötig ist.

Unterstützte Dateitypen

NueForm akzeptiert eine breite Palette an Dateitypen. Standardmäßig sind alle gängigen Dateitypen erlaubt. In den Frageeigenschaften kannst du die akzeptierten Typen einschränken.

Gängige Dateitypen

Dateigrößenlimits

Die maximale Dateigröße pro Upload hängt von deinem NueForm-Tarif ab:

Speicherkontingente

Jedes NueForm-Konto hat ein Gesamtspeicherkontingent, das alle hochgeladenen Dateien über alle Formulare hinweg umfasst. Dazu gehören:

• Dateien, die Befragte über Datei-Upload-Fragen hochladen.
• Mediendateien, die du im Formular-Builder hochlädst (Bilder, Videos für Fragemedien).

Speichernutzung prüfen

Deine aktuelle Speichernutzung wird in deinen Kontoeinstellungen erfasst. NueForm speichert die Gesamtzahl der Bytes über alle deine Uploads hinweg.

Was passiert, wenn das Limit erreicht ist

Wenn dein Speicherkontingent erreicht ist:

• Neue Datei-Uploads von Befragten schlagen mit einer Fehlermeldung fehl.
• Formularübermittlungen mit Datei-Uploads werden abgelehnt.
• Andere Fragetypen (Text, Auswahl, Bewertung usw.) sind nicht betroffen.
• Du kannst Platz freigeben, indem du alte Responses mit Dateianhängen löschst.

So funktioniert die Dateispeicherung

NueForm speichert hochgeladene Dateien im Vercel Blob Storage:

1. Wählt eine befragte Person eine Datei aus, wird diese direkt in NueForms Speicher hochgeladen.
2. Jede Datei erhält einen eindeutigen UUID-basierten Dateinamen (z. B. a1b2c3d4.pdf), um Namenskonflikte zu vermeiden.
3. Der ursprüngliche Dateiname bleibt in den Metadaten der gespeicherten Datei erhalten.
4. Die URL der Datei wird als Antwortwert in der Response gespeichert.

Der gespeicherte Dateieintrag enthält:

Auf hochgeladene Dateien zugreifen

Im Antworten-Dashboard

Beim Ansehen einer Response im NueForm-Dashboard zeigen Datei-Upload-Antworten:

• Den ursprünglichen Dateinamen.
• Einen Download-Link zur Datei.
• Die Dateigröße.

Über die API

Wenn du eine Response über die Responses-API abrufst, enthalten Datei-Upload-Antworten die Speicher-URL der Datei:

{
  "questionId": "507f1f77bcf86cd799439033",
  "value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
}

Du kannst die Datei per GET-Anfrage an diese URL herunterladen.

Über Webhooks

Webhook-Payloads enthalten die Datei-URL als Antwortwert:

{
  "event": "form.submitted",
  "formId": "...",
  "responseId": "...",
  "answers": [
    {
      "questionId": "507f1f77bcf86cd799439033",
      "value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
    }
  ]
}

Die vollständige Payload-Referenz findest du unter Webhook-Payloads.

In CSV-Exporten

Beim Export von Responses als CSV erscheinen Datei-Upload-Antworten als URLs in den CSV-Zellen. Über diese URLs kannst du die Dateien herunterladen.

Datei-Upload-Eigenschaften konfigurieren

Im Eigenschaften-Panel der Frage kannst du Folgendes konfigurieren:

Mehrere Datei-Uploads

Wenn Befragte mehrere Dateien hochladen sollen, füge deinem Formular mehrere Datei-Upload-Fragen hinzu. Jede Frage nimmt eine Datei entgegen — so bleibt die Übermittlung strukturiert und übersichtlich.

Zum Beispiel:

• Frage 1: „Lade deinen Lebenslauf hoch (PDF)"
• Frage 2: „Lade dein Anschreiben hoch (PDF)"
• Frage 3: „Lade dein Portfolio hoch (PDF oder ZIP)"

Best Practices

1. Sag präzise, was hochgeladen werden soll. Nutze Fragetitel und Beschreibung, um Befragten genau zu sagen, welche Datei du in welchem Format brauchst. Zum Beispiel: „Lade deinen Lebenslauf als PDF hoch (max. 10 MB)."

2. Markiere Fragen bei Bedarf als Pflicht. Ist die Datei essenziell (z. B. der Lebenslauf einer Bewerbung), markiere die Frage als Pflichtfeld. Ist sie optional (z. B. ergänzende Unterlagen), lass sie optional.

3. Überwache die Speichernutzung. Prüfe dein Speicherkontingent regelmäßig, besonders bei Formularen mit hohem Übermittlungsvolumen. Upgrade deinen Tarif, wenn du dich dem Limit näherst.

4. Verarbeite Dateien zeitnah. Wenn du Datei-URLs per Webhook erhältst, lade die Dateien herunter und verarbeite sie auf deiner Seite. Verlasse dich für die Langzeitarchivierung nicht allein auf NueForms Speicher.

5. Denke an Dateibenennung in den Anweisungen. Bitte Befragte, ihre Dateien vor dem Hochladen aussagekräftig zu benennen (z. B. „Vorname-Nachname-Lebenslauf.pdf"), da NueForm die Originalnamen in den Metadaten aufbewahrt.

Fehlersuche

Verwandte Themen

• Fragetypen: Medien --- Überblick über medienbezogene Fragetypen
• Webhook-Payloads --- So erscheinen Datei-URLs in Webhook-Daten
• API-Referenz: Responses --- Zugriff auf hochgeladene Dateien über die API