Agile Developer Hilfe-Center › Agile Render

Dynamische Felder

Dynamische Felder sind die Stellen einer Vorlage, die sich je Render ändern: der Name auf der Stellenanzeige, das Produktfoto, der Preis, die Markenfarbe.

Sie füllen diese Felder mit sogenannten Modifications: per API, aus einer Tabelle (Bulk), über ein Formular, per Render-URL oder über einen KI-Assistenten. Die Schreibweise ist überall dieselbe.

Grundregel: Der Name ist der Feldname

Jedes Element hat einen Namen, etwa „Titel“, „Foto“ oder „Preis“. Genau dieser Name ist der Schlüssel in den Modifications. Vergeben Sie deshalb eindeutige, sprechende Namen.

  • Den Namen ändern Sie im Inspektor oben im Namensfeld oder im Bereich Ebenen per Doppelklick.
  • Groß- und Kleinschreibung sowie Akzente spielen beim Vergleich keine Rolle.
  • Haben mehrere Elemente denselben Namen, ändert eine Modification alle gleichzeitig.

Ein Feld als dynamisch markieren

  1. Wählen Sie das Element im Editor aus.
  2. Schalten Sie im Inspektor (Reiter Gestalten) in der Gruppe Dynamisch den Schalter ein.
  3. Damit wird die Haupteigenschaft freigegeben: bei Text der Text, bei Bild, Video und Audio die Quelle, bei Formen die Füllfarbe, bei Gruppen der Inhalt.
  4. Optional haken Sie weitere Eigenschaften an, je nach Typ zum Beispiel Textfarbe, Hintergrund, Schrift, Schriftgröße, Einpassen, Tönung, Lautstärke, Zuschnitt oder Konturfarbe sowie immer Sichtbarkeit, Deckkraft und Dauer.

Neben jeder Eigenschaft steht der Schlüssel genau so, wie er im API-Aufruf steht, zum Beispiel Titel für den Text und Titel.fill_color für die Textfarbe. Mit Als Modifications kopieren übernehmen Sie alle Schlüssel mit den aktuellen Werten in die Zwischenablage.

Wichtig: Per API lässt sich jede Eigenschaft eines benannten Elements ändern, auch ohne Schalter. Die Markierung „Dynamisch“ bestimmt, welche Felder in Formularen, im Bulk-Assistenten und in den Codebeispielen unter Verwenden erscheinen.

So sehen Modifications aus

{
  "template_id": "IHRE-VORLAGEN-ID",
  "modifications": {
    "Titel": "Sommer-Sale: 30 % auf alles",
    "Titel.fill_color": "#ff5b24",
    "Foto": "https://ihre-firma.de/bilder/produkt.jpg",
    "Logo.opacity": "80%"
  }
}

Die wichtigsten Regeln:

| Schlüssel | Wirkung |
|---|---|
| "Titel": "Hallo" | Haupteigenschaft: Text, Quelle, Füllfarbe oder Inhalt |
| "Titel.fill_color": "#ff0000" | eine bestimmte Eigenschaft des Elements |
| "Vorname": "Erika" | füllt den Platzhalter {{Vorname}} in allen Texten |
| "Anrede.text.Vorname": "Erika" | füllt den Platzhalter nur in diesem Textelement |
| "duration": 12 | Eigenschaft der ganzen Vorlage, etwa Länge oder Ausgabeformat |
| "Logo": {} | entfernt das Element |
| "Titel": "" | behält den Wert aus der Vorlage |

Bilder, Videos und Audio können Sie als öffentliche https-Adresse oder als Asset-ID aus Ihrer Medienbibliothek angeben. Die Asset-ID kopieren Sie unter Medien in den Details einer Datei.

Platzhalter im Text

Statt einen ganzen Text zu ersetzen, können Sie Platzhalter in doppelten geschweiften Klammern verwenden:

Hallo {{Vorname}}, Ihr Termin ist am {{Datum|bald}}.
  • {{Vorname}} wird durch die Modification "Vorname" ersetzt.
  • Nach dem senkrechten Strich steht ein Standardwert: Kommt kein Wert, steht dort „bald“.
  • Enthält ein Text Platzhalter, sprechen Sie die Platzhalter an und nicht den ganzen Text. Ein Versuch, den Text komplett zu ersetzen, wird mit einer Warnung übersprungen.

Platzhalter erscheinen ebenfalls als dynamische Felder in Formularen und im Bulk-Assistenten.

Felder testen

  • Verwenden in der Kopfleiste zeigt im Reiter API alle dynamischen Felder mit Schlüssel, Typ und aktuellem Wert sowie fertige Codebeispiele in acht Sprachen.
  • Am Smartphone füllen Sie unter Inhalte Testwerte ein und sehen das Ergebnis sofort in der Vorschau. Rendern übernimmt diese Testwerte.

Tippfehler erkennen

Passt ein Schlüssel zu keinem Element, keinem Platzhalter und keiner Eigenschaft der Vorlage, meldet die API eine Warnung (modification_unmatched), rendert aber trotzdem. So bleiben bestehende Integrationen lauffähig.

Möchten Sie, dass solche Fehler den Render verhindern, senden Sie "strict": true mit. Dann wird aus jeder Warnung ein Fehler mit genauer Angabe des Schlüssels. Zum Prüfen ohne Kosten eignet sich "dry_run": true: Die API antwortet mit valid, errors, warnings und dem fertigen RenderScript, ohne zu rendern.

Mehr zu Fehlermeldungen im Artikel „Fehler beheben“, zur API im Artikel „API-Schlüssel und erste API-Anfrage“.

Fragen? Support-Chat in der App unter Hilfe oder info@agiledeveloper.de.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 19. Oktober 2026

Weitere Artikel zu Agile Render

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.