Aktivitäten

HTTP Anfrage

Beschreibung

Sendet eine HTTP-Anfrage mit den angegebenen Parametern. Der Block „Wert in Variable speichern“ wird automatisch hinzugefügt, wenn Sie die Aktivität „HTTP Anfrage“ auswählen. Er speichert den Wert automatisch in einer Variable. Die Verwendung des Blocks ist jedoch nicht zwingend erforderlich, und er kann aus dem Workflow entfernt werden.

Nachfolgend finden Sie ein Beispiel für die Konfiguration und Verwendung der Aktion, um eine Liste der Astronauten abzurufen, die sich derzeit im Orbit befinden.

GET-Anfrage: Wie viele Menschen befinden sich gerade im Weltraum?

Diese API gibt die aktuelle Anzahl der Menschen im Weltraum zurück. Sofern bekannt, gibt sie außerdem deren Namen und das Raumfahrzeug zurück, in dem sie sich befinden. Diese API benötigt keine Eingaben.

Anfrage

Antwort

{
  "people": [
    {
      "craft": [spacecraft name],
      "name": [name]
    },
    ...
  ],
	"number": [numer of people],
	"message": "success"
}

Parameter

URL

Pfad zur Webressource, an die eine Anfrage gesendet wird, zum Beispiel http://en.wikipedia.org/w/api.php.

Methode

Ermöglicht die Auswahl einer Anfragemethode: „GET“, „POST“, „PUT“, „DELETE“ oder „PATCH“.

Autorisierungs-Header

Ermöglicht es Ihnen, bei Bedarf Autorisierungsdaten hinzuzufügen.

Bearer-Token

1. Einen Wert festlegen: Ermöglicht es Ihnen, das Authentifizierungstoken manuell anzugeben.
2. Wert berechnen: Ermöglicht es Ihnen, eine spezielle Formel oder eine spezielle Methode zu verwenden, um ein Authentifizierungstoken zu definieren.
3. Speichern des vorherigen Schritts des Ergebnisses: Verwendet das Ergebnis der vorherigen Workflow-Aktivität als Authentifizierungstoken.

Zusätzliche Header

Ermöglicht es Ihnen, benutzerdefinierte HTTP-Anfrage-Header festzulegen, zum Beispiel: {"Content-Type": "application/x-www-form-urlencoded"}.

Abfrage-Parameter

Ermöglicht es Ihnen, Abfrage-Parameter als Objekt festzulegen.

1. Speichern des vorherigen Schritts des Ergebnisses: Wählt das Ergebnis der vorherigen Aktivität als Objekt mit Parametern aus.
2. Wert berechnen: Ermöglicht es Ihnen, verfügbare Eigenschaften und Methoden zu verwenden, um ein Objekt zu bilden, zum Beispiel {action: "opensearch", search: "JavaScript", format: "xml"}.

Body Parameter

Nur verfügbar, wenn die Methode „POST“, „PUT“, „DELETE“ oder „PATCH“ ausgewählt ist. Enthält die Body-Parameter als Objekt.

1. Speichern des vorherigen Schritts des Ergebnisses: Wählt das Ergebnis der vorherigen Aktivität als Objekt mit Parametern aus.
2. Wert berechnen: Ermöglicht es Ihnen, verfügbare Eigenschaften und Methoden zu verwenden, um ein Objekt zu bilden, zum Beispiel: {a:1,b:"row"}.

Datei senden

Nur verfügbar, wenn die Methode „POST“ ausgewählt ist. Mit diesem Parameter können Sie eine Datei in der Anfrage senden.

1. Einen Wert festlegen: Ermöglicht es Ihnen, den Pfad zu der zu sendenden Datei direkt einzugeben. Durch Klicken auf die Schaltfläche „Wählen“ können Sie den Pfad manuell auswählen.
2. Speichern des vorherigen Schritts des Ergebnisses: Wählt das Ergebnis der vorherigen Aktivität als Pfad aus.
3. Wert berechnen: Ermöglicht es Ihnen, verfügbare Eigenschaften und Methoden zu verwenden, um einen Pfad zu bilden.

Formularfeld für Datei

Dieser Parameter enthält den Namen des Schlüsselfelds im Anfrage-Body, das den Pfad der zu sendenden Datei enthält.

1. Einen Wert festlegen: Ermöglicht es Ihnen, den Feldnamen direkt einzugeben, zum Beispiel file.
2. Speichern des vorherigen Schritts des Ergebnisses: Wählt das Ergebnis der vorherigen Aktivität als Namen aus.
3. Wert berechnen: Ermöglicht es Ihnen, verfügbare Eigenschaften und Methoden zu verwenden, um einen Namen zu bilden.

Zertifikate

Mit diesem Parameter können Sie der Anfrage ein Client-Zertifikat anhängen, falls der Dienst dies erfordert. Aktivieren Sie dazu das Kontrollkästchen „Kunden Zertifikat hinzufügen“ und wählen Sie ein Zertifikat aus der Dropdown-Liste aus. Wenn Sie noch keine Zertifikate hinzugefügt haben, klicken Sie auf die Schaltfläche „Neues Zertifikat hinzufügen“. Daraufhin öffnet sich ein Pop-up-Fenster mit einem Formular zum Hinzufügen eines Zertifikats. Nachdem Sie das Formular ausgefüllt haben, klicken Sie auf „Hinzufügen“, und das Fenster wird geschlossen. Das hinzugefügte Zertifikat finden Sie auf der Registerkarte „Zertifikate“ in den Einstellungen von Studio Pro. Dieselbe Einstellung ist auch in Bot Runner verfügbar.

Kommentar

Enthält eine Anmerkung zur Aktivität. Der eingegebene Text wird über dem Namen der Aktivität angezeigt.

Ergebnis

Das Ergebnis der Antwort wird standardmäßig in der Variable http_response gespeichert. Das Format der Variable hängt von der in der Anfrage verwendeten Adresse ab. Wenn Sie beispielsweise die Wikipedia-API verwenden und eine Anfrage mit der Methode „GET“ und den Parametern {action: "opensearch", search: "JavaScript"} senden, wird das folgende Ergebnis zurückgegeben:

Die Antwort der Wikipedia-API:

[
  "JavaScript",
  [
    "JavaScript",
    "JavaScript syntax",
    "JavaScript engine",
    "JavaScript library",
    "JavaScript InfoVis Toolkit",
    "JavaScript Style Sheets",
    "JavaScript templating",
    "JavaScriptMVC",
    "JavaScript framework",
    "JavaScript OSA"
  ],
  [
    "JavaScript (), often abbreviated as JS, is a high-level, interpreted scripting language that conforms to the ECMAScript specification.",
    "The syntax of JavaScript is the set of rules that define a correctly structured JavaScript program.",
    "A JavaScript engine is a computer program that executes JavaScript (JS) code. The first JavaScript engines were mere interpreters, but all relevant modern engines utilize just-in-time compilation for improved performance.JavaScript engines are typically developed by web browser vendors, and every major browser has one.",
    "A JavaScript library is a library of pre-written JavaScript which allows for easier development of JavaScript-based applications, especially for AJAX and other web-centric technologies.",
    "The JavaScript InfoVis Toolkit provides tools for creating Interactive Data Visualizations for the Web.",
    "JavaScript Style Sheets (JSSS) was a stylesheet language technology proposed by Netscape Communications Corporation in 1996 to provide facilities for defining the presentation of webpages.",
    "JavaScript templating refers to the client side data binding method implemented with the JavaScript language.",
    "JavaScriptMVC is an open-source rich Internet application framework based on jQuery and OpenAjax. It extends those libraries with a model–view–controller architecture and tools for testing and deployment.",
    "A JavaScript framework is an application framework written in JavaScript. It differs from a JavaScript library in its control flow: A library offers functions to be called by its parent code, whereas a framework defines the entire application design.",
    "JavaScript OSA, (originally JavaScript for OSA, abbreviated as JSOSA), is a freeware inter-process communication scripting language for the Macintosh computer."
  ],
  [
    "https://en.wikipedia.org/wiki/JavaScript",
    "https://en.wikipedia.org/wiki/JavaScript_syntax",
    "https://en.wikipedia.org/wiki/JavaScript_engine",
    "https://en.wikipedia.org/wiki/JavaScript_library",
    "https://en.wikipedia.org/wiki/JavaScript_InfoVis_Toolkit",
    "https://en.wikipedia.org/wiki/JavaScript_Style_Sheets",
    "https://en.wikipedia.org/wiki/JavaScript_templating",
    "https://en.wikipedia.org/wiki/JavaScriptMVC",
    "https://en.wikipedia.org/wiki/JavaScript_framework",
    "https://en.wikipedia.org/wiki/JavaScript_OSA"
  ]
] 

Anwendungsbeispiele

Mit dieser Aktivität können Sie mit verschiedenen Webressourcen interagieren, daher ist ihr Einsatzbereich sehr breit. Ein Beispiel für die Anwendung dieser Funktion in einem robotergestützten Prozess ist ein Fall, in dem Sie eine Verbindung zu einer Web-API herstellen müssen, um Daten abzurufen oder hochzuladen.

---

OAuth Token erhalten

Beschreibung

Diese Aktivität führt eine OAuth-2.0-Autorisierung durch. Sie gibt ein Zugriffstoken zurück, das in anderen Aktivitäten verwendet werden kann.

Parameter

Autorisierungs-URL

1. Einen Wert festlegen: Ermöglicht es Ihnen, die Autorisierungs-URL manuell anzugeben.
2. Wert berechnen: Ermöglicht es Ihnen, eine spezielle Formel oder eine spezielle Methode zu verwenden, um die Autorisierungs-URL zu bestimmen.
3. Speichern des vorherigen Schritts des Ergebnisses: Verwendet das Ergebnis der vorherigen Workflow-Aktion als Autorisierungs-URL.

Zugriffstoken URL

1. Einen Wert festlegen: Ermöglicht es Ihnen, die Zugriffstoken URL manuell anzugeben.
2. Wert berechnen: Ermöglicht es Ihnen, eine spezielle Formel oder eine spezielle Methode zu verwenden, um die Zugriffstoken URL zu bestimmen.
3. Speichern des vorherigen Schritts des Ergebnisses: Verwendet das Ergebnis der vorherigen Workflow-Aktion als Zugriffstoken URL.

Kunden ID

1. Einen Wert festlegen: Ermöglicht es Ihnen, die Kunden ID manuell anzugeben.
2. Wert berechnen: Ermöglicht es Ihnen, eine spezielle Formel oder eine spezielle Methode zu verwenden, um die Kunden ID zu bestimmen.
3. Speichern des vorherigen Schritts des Ergebnisses: Verwendet das Ergebnis der vorherigen Workflow-Aktion als Kunden ID.

Kunden Geheimnis

1. Einen Wert festlegen: Ermöglicht es Ihnen, das Kunden Geheimnis manuell anzugeben.
2. Wert berechnen: Ermöglicht es Ihnen, eine spezielle Formel oder eine spezielle Methode zu verwenden, um das Kunden Geheimnis zu bestimmen.
3. Speichern des vorherigen Schritts des Ergebnisses: Verwendet das Ergebnis der vorherigen Workflow-Aktion als Kunden Geheimnis.

Scope

1. Einen Wert festlegen: Ermöglicht es Ihnen, den Scope manuell anzugeben.
2. Wert berechnen: Ermöglicht es Ihnen, eine spezielle Formel oder eine spezielle Methode zu verwenden, um den Scope zu bestimmen.
3. Speichern des vorherigen Schritts des Ergebnisses: Verwendet das Ergebnis der vorherigen Workflow-Aktion als Scope.

State

1. Einen Wert festlegen: Ermöglicht es Ihnen, den State manuell anzugeben.
2. Wert berechnen: Ermöglicht es Ihnen, eine spezielle Formel oder eine spezielle Methode zu verwenden, um den State zu bestimmen.
3. Speichern des vorherigen Schritts des Ergebnisses: Verwendet das Ergebnis der vorherigen Workflow-Aktion als State.

Verwendung

Das OAuth-2.0-Protokoll erfordert konzeptionsbedingt die Mitwirkung eines Menschen. Der Benutzer muss seine Anmeldedaten im Pop-up-Fenster eingeben und dem Roboter die Nutzung des Dienstes erlauben.

Bei den meisten Diensten haben Token eine recht lange Gültigkeitsdauer: mehr als 14 Tage. Daher ist es sinnvoll, das Token zu speichern und den Benutzer nur bei Bedarf um eine Aktion zu bitten.

Im folgenden Screenshot sehen Sie ein Beispiel für einen Workflow, der den Benutzer nur dann zur Autorisierung auffordert, wenn das alte Token nicht mehr gültig ist: