RS02 - Webservice REST Jobs
ℹ️ Dieses Automic Tutorial ist Teil des REST-Lernpfades auf PEM und wurde am 24. Oktober 2023 veröffentlicht.
📋 Inhalt: 1 Lektion
🕒 Dauer: 10 Minuten
In diesem Beitrag zeige ich dir Schritt für Schritt, wie du REST-Clients in Automic erstellen und verwenden kannst, um Anfragen an REST-APIs zu senden.
Voraussetzungen
Bevor wir loslegen können, gibt es zwei wichtige Voraussetzungen, die du erfüllen musst:
Einen aktiven REST-Agenten: Stelle sicher, dass ein aktiver RA Webservice REST-Agent in deiner Agentenübersicht verfügbar ist. Objektvorlagen: Stelle sicher, dass die Objektvorlagen verfügbar sind, indem du ein neues Objekt erstellst und nach "REST" suchst.
Sehen wir uns die Schritte für das Verbindungsobjekt an:
Allgemeine Informationen: Definiere die URL deiner REST API. Dies ist das einzige Pflichtfeld in diesem Objekt. Authentifizierung: Definiere die Art der Authentifizierung, die deine REST-API erwartet. Automic unterstützt die gängigsten Methoden und die Anmeldedaten werden sicher in der Automic-Datenbank gespeichert. Ressourcen: Definiere die Ressourcen, die die REST-API anbietet. Dies hilft uns später bei der Formulierung der Abfragen im Job. Header und Abfrageparameter: Hier können zusätzliche Header und Abfrageparameter definiert werden, um die Abfragen zu verfeinern. Proxy-Einstellungen: Auf der Registerkarte "Proxy" kann bei Bedarf ein Proxy für die Verbindung zur REST-API eingerichtet werden.
Erstellen eines REST-Jobs
Wie bei jedem Jobtyp muss zunächst der Agent definiert werden, auf dem der Job ausgeführt werden soll. Da die Anmeldedaten im CONN-Objekt gespeichert sind, müssen keine weiteren Angaben gemacht werden.
In der Registerkarte "WebService" wählst du das zuvor erstellte CONN-Objekt aus. Hier kannst du auch die automatisch generierte URI überschreiben sowie Header und Request-Parameter hinzufügen, falls für bestimmte Request-Typen spezielle Einstellungen erforderlich sind.
Nun kannst du deine Anfrage abschicken und das Ergebnis überprüfen.
Informationen aus den Reports extrahieren
Möglicherweise möchtest du Informationen aus den Automic-Reports extrahieren. Dies ist auch in REST-Jobs möglich.
Auf der Registerkarte "Response" kannst du die Antworten analysieren. Hier legst du fest, welche Header-Einträge und Daten aus dem Body der Antwort extrahiert werden sollen. Du kannst verschiedene Parsing-Methoden auswählen und festlegen, was mit den extrahierten Daten geschehen soll.
Fazit
Zusammenfassend benötigen Webservice REST Jobs einen Webservice REST Agenten und ein CONN Objekt. Die Antwort auf die Anfrage und der HTTP-Return-Code sind immer im Report verfügbar und können im Response-Tab analysiert werden, um Informationen für die spätere Verwendung zu extrahieren.
Automic lernen mit PEM
Möchtest du mehr über Automic lernen, ohne deshalb für Workshops durchs Land reisen zu müssen? Bei PEM entscheidest du, wann und wie du dich weiterbilden möchtest! In interaktiven Kursen, Tutorials und Videos lernst du alles Wissenswerte rund um Automic. Und via Live-Sessions, Kommentarfunktion oder E-Mail sind wir jederzeit für dich da.
Hört sich das interessant an? Dann lege heute noch los mit PEM, dem Automic Training 2.0 und einer ganzjährigen Automic-Betreuung!
FAQ zum Automic Training auf PEM
PEM ist die innovativste und größte deutschsprachige Automic-Lernplattform. Sie bietet den PEM-Mitgliedern ein umfassendes Online-Schulungsangebot, auf das 24/7 und von überall aus zugegriffen werden kann. Die Plattform umfasst Hunderte Videos und interaktive Kurse und richtet sich an Einsteiger und Profis gleichermaßen.
Um verschiedene Bedürfnisse zu erfüllen, gibt es bei PEM verschiedene Arten von Inhalten: Kurse, Tutorials, Lernpfade, Labore, Tools und Live-Sessions.
- In den Kursen und Tutorials lernst du in kurzweiligen und interaktiven Videos alles über Automic.
- Die Lernpfade bieten eine vollumfängliche Ausbildung zu einem bestimmten Automic-Thema. Als Anfänger eignet sich beispielsweise der 11-teilige Operator-Lernpfad. Bist du bereits Automic-Experte? Dann lernst sicher auch du noch etwas mit dem Datenbank-SQL Lernpfad.
- Labore sind Automic-Umgebungen, die auf Knopfdruck bereitgestellt werden und in denen das Gelernte in die Praxis umgesetzt werden kann.
- Auf PEM werden regelmäßig Tools mit passender Anleitung bereitgestellt. Damit lassen sich Automic-Prozesse noch weiter automatisieren und vereinfachen.
- In regelmäßigen Abständen finden Live-Sessions statt, bei denen wir aktuelle News und bestimmte Automic-Themen besprechen, und Fragen unserer Member beantworten.
Bei normalen Automic-Schulungen steht dir der Trainer ein paar Tage zur Verfügung. Wenn du Glück hast, kannst du vielleicht schon vor der Schulung Input liefern, und wenn du besonders viel Glück hast, dann kannst du in den Wochen nach der Schulung noch 1-2 Fragen nachschießen.
Unsere Mitglieder können uns jederzeit eine E-Mail schicken. Kleine Fragen beantworten wir gleich per E-Mail, größere Fragen nehmen wir mit in die nächste Live-Session und beantworten sie dort. Bei Fragen zu bestimmten Themen steht unseren Membern außerdem die Kommentarfunktion zur Verfügung. Das nennen wir “ganzjährige Automic Betreuung”.
Für die direkte Kommunikation gibt es bei uns die Live-Sessions: 24 Live-Sessions pro Jahr. Admin-Member dürfen bei jedem teilnehmen, Designer bei jedem zweiten, und Operator vier Mal im Jahr. In den Live-Sessions sind Fragen zu jedem Automic-Thema herzlich willkommen! Member haben die Möglichkeit, ihre Fragen vorab zu stellen, damit wir uns auf die Antwort und die Diskussion vorbereiten können.
Außerdem bieten wir sogenanntes Online Consulting. Das sind exklusive Videokonferenz-Session mit unseren Automic-Experten. Das Beste daran: Member, die über ein Kontingent für Online-Consulting verfügen, haben jederzeit Zugriff auf die Kalender unserer Spezialisten, und können dort direkt ihre Sessions buchen.
Enterprise-Kunden haben automatisch ein Kontingent dabei. Alle anderen können das dazu buchen.
Die Membership schließt du immer für ein Jahr ab. Danach verlängert sie sich normalerweise automatisch.
Bis einen Monat vor Ablauf kannst du jederzeit mit einer einfachen E-Mail kündigen. Natürlich kannst du die Membership bereits bei Vertragsbeginn auf ein Jahr beschränken.