Datei-Link aus der Karte abrufen
Der Roboter „Datei-Link aus der Karte abrufen“ liest ein Dateifeld eines Deals, Kontakts, Unternehmens oder Leads in Bitrix24 (Alaio) und gibt eine direkte Download-URL, den Dateinamen und die Größe in Bytes zurück. Über den Index wählt er die passende Datei aus dem Feld (0 = erste, -1 = letzte) und gibt zusätzlich ein Y/N-Kennzeichen zurück, ob eine Datei gefunden wurde.
Der Roboter holt eine Datei aus dem Dateifeld einer CRM-Entität und übergibt sie dem Geschäftsprozess als fertigen Download-Link. Als Eingabe nimmt er den Entitätstyp (deal, contact, company, lead), deren ID, den Code des Dateifelds und den Datei-Index im Feld (0 = erste, -1 = letzte, Standard 0). Zurückgegeben werden die Download-URL, der Dateiname, die Größe in Bytes und ein found-Kennzeichen (Y/N). Einsatz, wenn Sie einen Anhang aus einer Karte an einen externen Dienst weiterleiten, einen Dokument-Link in eine E-Mail oder Benachrichtigung einfügen, die Datei an eine HTTP-Anfrage übergeben oder einfach prüfen möchten, ob ein Dokument angehängt ist. Wird die Entität nicht gefunden, ist das Feld leer oder gibt es keine Dateien, liefert der Roboter found=N und leere Werte — nutzen Sie dieses Kennzeichen in der Bedingung des nächsten Schritts.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Entitätstyp: deal / contact / company / lead | string | ja | |
| Entitäts-ID | int | ja | |
| Code des Dateifelds | string | ja | |
| Datei-Index (0 = erste, -1 = letzte; Standard 0) | int | — |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Download-URL | string |
| Dateiname | string |
| Größe in Bytes | int |
| Datei gefunden (Y/N) | string |
Welche Fehler kann der Roboter zurückgeben?
Diese Meldungen schreibt der Roboter ins Protokoll des Geschäftsprozesses, wenn er einen Schritt nicht ausführen kann. Der Text zeigt, was in den Einstellungen oder Daten zu korrigieren ist.
- Fehler: ungültige Parameter
- Entität nicht gefunden
- Feld ist leer
- Keine Dateien gefunden
Szenario: Versand eines Vertrags aus einem Deal
- Ein Deal wechselt in die Phase „Dokumente bereit“
- Der Roboter liest das Dateifeld des Deals und gibt Link, Name und Dateigröße zurück
- Der nächste Schritt fügt den Link in eine E-Mail an den Kunden ein