Aufgabe mit CRM verknüpfen (nach ID)
Der Roboter „Aufgabe mit CRM verknüpfen (nach ID)" verwaltet die Verbindung einer Bitrix24 (Alaio)-Aufgabe mit CRM-Elementen: Er verknüpft, trennt oder ersetzt einen Kontakt, ein Unternehmen, einen Auftrag oder Lead anhand der Aufgaben-ID. „Ersetzen" tauscht das Element desselben Typs aus und behält Verknüpfungen anderer Typen. Er gibt Erfolgreich, ein Geändert-Flag und die resultierende Verknüpfungsliste zurück.
Der Roboter bearbeitet das Feld UF_CRM_TASK einer Aufgabe anhand ihrer ID — die Verbindung der Aufgabe mit CRM-Elementen. Eingaben: Aufgaben-ID, Elementtyp (Kontakt/Unternehmen/Auftrag/Lead), Element-ID und ein Modus. Modi: „Verknüpfen" fügt eine Verbindung hinzu, ohne andere zu berühren; „Trennen" entfernt nur die angegebene; „Ersetzen" entfernt alle Verknüpfungen desselben Typs und setzt die neue (Verknüpfungen anderer Typen bleiben). Alle Operationen sind idempotent: Wenn nichts zu ändern ist, gibt der Roboter Geändert = N zurück und überspringt den Schreibvorgang. Verwenden Sie ihn aus einem Auftrags- oder Kontakt-Geschäftsprozess, um das richtige Element mit einer zugehörigen Aufgabe zu verknüpfen. Gibt Erfolgreich (Y/N), Geändert (Y/N) und die resultierende Verknüpfungsliste als CONTACT_7, DEAL_10 zurück — die in den Aufgaben-Suchroboter eingespeist werden kann.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Aufgaben-ID | int | ja | |
| CRM-Elementtyp | select | ja | contact |
| CRM-Element-ID | int | ja | |
| Aktion | select | ja | replace |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Erfolgreich (Y/N) | string |
| Verknüpfung geändert (Y/N) | string |
| Aktuelle Verknüpfungen (CONTACT_7, DEAL_10…) | 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 (Elementtyp/ID oder Modus)
- Fehler: Aufgaben-ID nicht angegeben
- Fehler: der Roboter „aktuelle Aufgabe" muss aus der Automatisierung oder dem Geschäftsprozess der Aufgabe selbst gestartet werden
- API-Fehler
Szenario: Kontakt einer Aufgabe aus einem Auftragsprozess ersetzen
- Ein Auftrags-Geschäftsprozess erreicht den entsprechenden Schritt
- Roboter mit Modus Ersetzen, Typ Kontakt, neuer Kontakt-ID und Aufgaben-ID
- Roboter gibt Erfolgreich = Y und Verknüpfungsliste mit neuem Kontakt zurück