Einrichten von Funktionen

Wie kann ich ...

• Funktionen einrichten
• Eine Funktion über REST-APIs aufrufen
• Funktionen in Workflow-Regeln bereitstellen
• Siehe Fehlercodes
  • HTTP-Statuscodes
  • Benutzerdefinierte Fehler
• Beispiele für häufig verwendete Funktionen
  [Verwandte Themen]

Funktionen einrichten

Sie können Funktionen an 5 Stellen einrichten:

• Erstellen einer eigenständigen Funktion.
• Zuordnen der Funktion zu einer Workflow-Regel.
• Spätere Verwendung von Funktionen, indem Sie sie in Planungen aufnehmen.
• Einrichten der Funktion, sodass sie durch Anklicken einer benutzerdefinierten Schaltfläche ausgeführt wird.
• Zuordnen einer Funktion zu einer verwandten Liste.

So erstellen Sie eine Funktion

1. Navigieren Sie zu Setup > Entwicklerbereich > Funktionen.
2. Klicken Sie auf der Seite Funktionen auf + Neue Funktion erstellen.
3. Wählen Sie die Stelle, an der die Funktion hinzugefügt werden soll.
   
4. Klicken Sie auf Weiter.
5. Gehen Sie auf der Seite Funktion erstellen wie folgt vor:
   • Geben Sie einen Namen und eine Beschreibung (optional) für die Funktion an.
   • Klicken Sie auf Argumente bearbeiten.
   • Legen Sie die Argumente fest, die im Skript verwendet werden sollen – mit Feldname oder benutzerdefiniertem Wert im CRM-Modul.
     

   • Schreiben Sie Ihre gewünschte Funktion im Deluge-Skripteditor.

     
   • Klicken Sie auf Skript speichern & ausführen, um Ihren Code zu validieren.
   • Klicken Sie auf Speichern.
6. Klicken Sie auf Speichern.
   Die Funktion wird in der Listenansicht der Seite Funktionen aufgelistet.
   Beachten Sie, dass Funktionen nur an der Stelle verwendet werden können, für die sie programmiert wurden. Beispiel: Eine für Workflow-Regeln konfigurierte Funktion kann nicht in der Planung verwendet werden.

Aufruf von Funktionen über REST-APIs

Eine Funktion erweitert Ihr CRM um zusätzliche Funktionalitäten oder Merkmale neben den herkömmlichen Funktionen. Funktionen benötigen Auslöser, um sie aufzurufen. Der Auslöser kann ein Workflow, ein Bauplan, eine zugehörige Liste oder ein Klick auf eine Schaltfläche sein.

Wenn die Funktion ohne diese Methoden oder aus externen Quellen ausgelöst werden muss, können Sie eigenständige Funktionen anlegen und als API-Aufrufe zur Verfügung stellen. Das Auslösen von Funktionen über REST-APIs ermöglicht es Ihnen, sie flexibel von überall in Zoho CRM oder von Drittanwendungen aus auszulösen.

Beispielfunktion als API-Aufruf:

Ein Formular, das automatisch einen Lead anhand der im Formular angegebenen Daten in Ihrem CRM erzeugt.

Schritt 1:

Erstellen Sie eine eigenständige Funktion mit dem folgenden Code.

Schritt 2:

So stellen Sie die Funktion als API zur Verfügung

1. Navigieren Sie zu Setup > Entwicklerbereich > Funktionen.
2. Klicken Sie auf das Symbol Einstellungen für die entsprechende Funktion, die eine API erhalten soll.
3. Klicken Sie auf REST-API.
   
4. Legen Sie den API-Namen für die benutzerdefinierte Funktion fest.
5. Aktivieren Sie OAuth2.0 und die Schieberegler des API-Schlüssels.
6. Klicken Sie auf Speichern.
   

Schritt 3:

Das Beispiel hier ist als Formular dargestellt, das mit Zoho Creator erstellt wurde. Erstellen Sie das Formular so, dass es die Felder "Vorname", "Nachname", "Firma" und "Mobil" enthält. Sie können die Funktion so programmieren, dass sie durch Anklicken der Schaltfläche Senden ausgeführt wird.

Ergebnis:

Sobald Sie auf die Schaltfläche Senden klicken, wird die Funktion ausgeführt und der Lead in Ihrem CRM angelegt. Der Lead enthält die im Formular angegebenen Details.

Funktionen in Postman:

Funktionen, die als API-Aufrufe angegeben werden, können mit der POSTMAN-Anwendung getestet werden. Sie müssen jedoch einige Dinge beachten, wenn Sie eine Funktion in dieser App ausführen.

• Die derzeit unterstützten Methoden zur Verwendung einer Funktion als API sind GET und POST.
• Wählen Sie in einer POST-Anfrage unter dem Abschnitt Textkörper die Option Formulardaten.
• Erstellen Sie einen Schlüssel mit dem Namen arguments und dem Wert als JSON-Eingabeobjekt.
• Die Argumente können auch in der URL als arguments={encoded_arguments} angegeben werden.
• POST-Anfrage – Argumente (Grenzwert)
  • In Anfrage-URL – 5.000 Zeilen
  • Im Textkörper – 95.000 Zeilen (als JSON-Objekt)

Beispielargumente in "Textkörper":

Funktionen in Workflow-Regeln bereitstellen

So ordnen Sie einer Workflow-Regel eine Funktion zu

1. Navigieren Sie zu Setup > Automatisierung > Workflow-Automatisierung > Regeln.
2. Klicken Sie auf der Seite Workflow-Regeln auf die Schaltfläche Regel erstellen.
3. Geben Sie auf der Registerkarte Neue Regel erstellen die Parameter der Workflow-Regel an.
4. Wählen Sie unter Sofortige Aktionen die Option Funktion.
   
5. Wählen Sie auf der Seite Funktion konfigurieren eine Funktion aus der Galerie, Funktionen (von Benutzern in Ihrem Unternehmen erstellt), oder schreiben Sie Ihre eigene mit dem Deluge-Skript.
6. Klicken Sie auf Funktionen (von Benutzern in Ihrem Unternehmen erstellt).
   
7. Wählen Sie die auszulösende Funktion aus, und klicken Sie auf Konfigurieren.
   
8. Führen Sie auf der Seite Benutzerdefinierte Funktion konfigurieren die folgenden Schritte aus:
   • Wählen Sie das zu verknüpfende Modul aus.
   • Weisen Sie im Abschnitt Argumentzuweisung das Argument mit dem Feldnamen im CRM-Modul zu.
     
   • Klicken Sie auf Speichern und verknüpfen.
     Nun können Sie die benutzerdefinierte Galeriefunktion mit der Workflow-Regel verknüpfen.
9. Klicken Sie auf der Seite Workflow-Regel auf Speichern.
   Nun ist Ihre angepasste Funktion mit der Workflow-Regel verknüpft. Wenn die Workflow-Regel ausgelöst wird, wird die benutzerdefinierte Funktion automatisch ausgeführt.