Serverlose Funktionen
Die serverlose Architektur, auch bekannt als "Function-as-a-Service" (Faas), bietet Entwicklern eine Plattform, um ihre eigenen Codes als Reaktion auf verschiedene Geschäftsereignisse auszuführen. In Zoho CRM können alle diese Codes mit Deluge-Skripts geschrieben und ohne Bereitstellung oder Verwaltung von Servern ausgeführt werden. Diese einmal geschriebenen Codes können von anderen Diensten Dritter ausgelöst oder direkt von jeder Web- oder mobilen Anwendung aus aufgerufen werden.
Obwohl die Architektur "serverlos" genannt wird, benötigt sie Server zum Ausführen von Code. Das Wort "serverlos" sagt nur aus, dass die Entwickler oder Unternehmen keine Server kaufen, bereitstellen oder mieten müssen, um ihren Code auszuführen.
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.
Sie können Funktionen auf zwei Arten als API aufrufen:
Neben der Verwendung von Funktionen als APIs können Sie Funktionen auch innerhalb anderer Funktionen verwenden. Dies wird ermöglicht, da die gesamte Funktion auf eine einzige Codezeile reduziert wird.
Es gibt jedoch einige Vorsichtsmaßnahmen, die Sie beim Aufruf einer Funktion in einer anderen Funktion beachten müssen. Im Folgenden sehen Sie einen Code-Ausschnitt, der eine Funktion bezeichnet, die innerhalb einer anderen Funktion aufgerufen wird.
Funktion innerhalb einer Funktion (über APIs):
URL=<REST-API-Funktions-URL>;
param = Map();
param.put(<argument-name>, <argument-value>);
param.put(<argument-name>, <argument-value>);
param.put(<argument-name>, <argument-value>);
argument = Map();
argument.put("arguments", param);
response = invokeurl
[
url: URL
type: GET | POST
parameters: argument
headers: {}
];
return response;
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.
URL:
https://crm.zoho.com/crm/v2/functions/{api_name_of_function}/actions/execute?auth_type=oauth{or}apikey
Argument:
arguments=
{
"emailAddress":"abc@gmail.com",
"extraDetails":{
"name":"Abc",
"signature":"XYZ"
}
}
Hinweis:
- Vermeiden Sie den Namen "arguments" als Argument innerhalb der Funktion. Grund dafür ist, dass alle in JSON übergebenen Argumente den einzelnen "Argumenten" zugewiesen werden und die anderen leer bleiben.
1. Innerhalb der Anforderungs-URL:
HTTP-Methoden:
- GET
- POST
Die unten angegebenen Argumente sind codiert.
Sie können die Argumente nicht als JSON-Objekt innerhalb der Anforderungs-URL übergeben. Codieren Sie die Argumente, falls sie in der Anfrage-URL angegeben werden sollen.
arguments=%7B%0D%0A%09%22emailAddress%22%3A%22abc%40gmail.com%22%2C%0D%0A%09%22extraDetails
%22%3A%7B%0D%0A%09%09%22name%22%3A%22Abc%22%2C%0D%0A%09%09%22signature%22%3A%22XYZ%22%0D%0A%09%7D%0D%0A%7D%0D%0A
Sie können die Argumente als Überschrift in der API aufrufen. Zum Beispiel wäre die URL "{Rest API URL}?age=15&name=Robert", wobei "age" und "name" Argumente in der Funktion sind.
Zusätzlich wird für alle weiteren Argumente, die nicht in der Funktion definiert, sondern in der API verwendet werden, normalerweise ein Fehler ausgegeben. Sie können jedoch vorbeugend ein zusätzliches Argument in der Funktion unter dem Namen "CRM API Request" hinzufügen. Dieses Argument würde alle zusätzlichen Argumente enthalten oder aufnehmen, die Sie innerhalb des API-Aufrufs übergeben.
2. Im Textkörper:
Erstellen Sie im Abschnitt Textkörper > Formulardaten einen Schlüssel mit dem Namen "arguments".
arguments={"emailAddress":"abc@gmail.com","extraDetails":{"name":"Abc","signature":"XYZ"}}
Hinweis:
- POST-Anfrage – Argumente (Grenzwert)
- In Anfrage-URL – 5.000 Zeilen.
- Im Textkörper – 95.000 Zeilen (als JSON-Objekt).
Aufruf einer Funktion innerhalb einer anderen Funktion
Oftmals gibt es Anforderungen, bei denen Funktionen innerhalb anderer Funktionen aufgerufen werden müssen. So wie Sie eine Funktion innerhalb von Workflows aufrufen, können Sie sie auch innerhalb anderer Funktionen aufrufen. Betrachten wir zwei Funktionen, A und B.
Um die Argumente (Parameter) von Funktion A an B zu übergeben, müssten sie entweder in der Abfrage-URL-Zeichenfolge oder in Formulardaten übergeben werden. Um dies zu erreichen, nutzen Sie bitte den unten stehenden Ausschnitt in Ihrer Funktion.
Der obige Code-Ausschnitt zeigt ein Beispiel, in dem die Argumente der Funktion A als Parameter in der Datei aufgerufen werden. Sie müssen eine Liste mit dem Namen file erstellen und entscheiden, wie die Parameter der Funktion A in Funktion B verwendet werden.
Die Überschriften der Funktion sind Formulardaten, und die "Datei" muss aufgerufen werden.
Sie können den unten stehenden Code-Ausschnitt direkt in Ihre Funktion kopieren:
param = Map();
param.put("{key}","{value}");
param.put("{key}","{value}");
param.put("{key}","{value}");
files = list();
for each key in param.keys()
{
stringpart = Map();
stringpart.put("stringPart","true");
stringpart.put("content","" + param.get(key));
stringpart.put("paramName",key);
files.add(stringpart);
}
response = invokeurl
[
url :"{Function_API_URL}"
type :POST
headers:{"Content-Type":"multipart/form-data"}
files:files
];