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 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 |
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