Automatisierungen durchsuchen und installieren

Der Automatisierungen-Katalog (Automatisierungen in der Seitenleiste) ist der Ort, an dem Inhaber, Admins und Entwickler jede Automatisierung durchsuchen, die der Organisation zur Verfügung steht, und entscheiden, welche installiert sind. Diese Seite deckt den Katalog selbst ab — das Seitenpanel, das eine Karte öffnet, den Installations-Assistenten und die Aktionen Neu installieren, Deinstallieren und Aktualisieren, die danach folgen. Was jede mitgelieferte Automatisierung tatsächlich tut, steht auf Mitgelieferte Automatisierungen; das mentale Modell für die Bestandteile, die eine Automatisierung bündelt, steht auf Automatisierungskonzepte.

Installiert und Alle Automatisierungen

Der Katalog öffnet sich auf Installiert — die Standardauswahl der Tab-Leiste, und der einzige Tab, auf dem sich ein Bundle in seine eigenen Mitglieder-Karten auflöst, statt einmal als Bundle zu erscheinen. Jedes Mitglied trägt auf seinem Icon eine kleine Markierung mit dem Namen seines Bundles — etwa Teil von GitHub-Issues lösen —, damit die Zugehörigkeit sichtbar bleibt, und behält sein eigenes Neu installieren/Deinstallieren im ⋯-Menü: Ein Bundle hat schließlich keine eigene Installation, die sich als Einheit verwalten ließe (warum, steht auf Automatisierungskonzepte). Wechsle zu Alle Automatisierungen, um stattdessen den vollständigen Katalog zu durchsuchen — mitgeliefert und hochgeladen, installiert oder nicht: Hier ist das Bundle selbst die Karte, über einen Assistenten installiert, und seine versteckten Mitglieder tauchen nie für sich allein auf. Installiert verwaltet, was läuft; Alle Automatisierungen findet Neues.

Eine Automatisierung installieren

Klick auf eine Karte, und ihr Seitenpanel öffnet sich — dasselbe Klick-zur-Vorschau-Muster, das Einstellungen > Integrationen für seinen eigenen Katalog nutzt. Das Panel listet, was die Installation hinzufügt: seine Seiten, Workflows, Agents, Skills und die Integrationen, die es braucht, plus das Projekt, das es anvisiert, wenn es projektgebunden ist. Klick auf Installieren, und der Assistent öffnet sich.

Der Assistent geht nur die Schritte durch, die diese Automatisierung wirklich braucht: einen Schritt Projekt, wenn sie projektgebunden ist und du sie nicht schon von innerhalb eines Projekts geöffnet hast; einen Schritt Änderungen prüfen, wenn die Installation bereits vorhandene Dateien überschreiben würde; einen Schritt Installieren, der jede benötigte, noch nicht verbundene Integration verbindet; einen Schritt Agent-Modus für jeden Agent, der auf deinen eigenen Zugangsdaten statt denen der Plattform laufen kann; und einen Schritt Fertig. Das Projekt, das du im Schritt Projekt wählst, übernimmt eine doppelte Aufgabe: Es ist auch die Quelle, aus der jeder von der Automatisierung installierte Zeitplan seine Variable projectId erhält, sodass ein Workflow, der {{input.projectId}} liest, gegen das richtige Projekt läuft, ohne dass du sie im Trigger-Tab erneut eintippen musst.

Fertig behauptet erst dann Bereitschaft, wenn die Automatisierung es auch ist. Ist jede erforderliche Integration verbunden, steht genau das da; ist dagegen eine erforderliche Zeitplan-Variable noch leer — wonach kein Assistent-Schritt fragt, weil es vom Eingabeschema des Workflows abhängt —, nennt Fertig sie stattdessen und bietet einen Button Trigger öffnen, der direkt zum betroffenen Zeitplan springt (bei einem Bundle macht der Schritt Fertig dasselbe pro Mitglied und nennt, welche noch eine Variable brauchen). Jeder Einrichtungsschritt lässt sich trotzdem später abschließen: eine übersprungene Verbindung über die eigene Checkliste Einrichtung abschließen der Automatisierung, eine Zeitplan-Variable über ihren Trigger-Tab.

Die Prüfung vor der Installation

Eine Automatisierung neu zu installieren oder erneut hochzuladen, wenn sie bereits einige ihrer Dateien geändert hat, löst vor jeder Änderung einen Schritt Änderungen prüfen aus. Für eine einzelne Automatisierung listet der Schritt jede Datei, die die Installation überschreiben würde, und bittet dich, das Ersetzen aller durch die Versionen der Automatisierung in einem Schritt zu bestätigen — ein Auswählen einzelner Dateien gibt es nicht. Die Installation eines Bundles prüft dagegen pro Mitglied-Automatisierung: Jedes Mitglied bekommt seinen eigenen einklappbaren Abschnitt und seine eigene Bestätigung, sodass du genau siehst, welche der mehreren Automatisierungen des Bundles Dateien berühren, die du geändert hast. So oder so: Die eigenen Schritte eines Workflows sind von dieser Prüfung ausgenommen — mehr dazu im nächsten Abschnitt.

Neu installieren, deinstallieren und aktualisieren

Jede installierte Karte trägt ein ⋯-Menü mit Neu installieren und Deinstallieren; das Menü einer noch nicht installierten Karte bietet stattdessen Installieren, plus Löschen für einen privaten Upload, den du noch nicht installiert hast. Neu installieren durchläuft dieselbe Vorprüfung wie eine frische Installation und behält deine Umgebungsvariablen und Secrets. Deinstallieren entfernt die Automatisierung und alles, was sie installiert hat — ihre Agents, Workflows, Seiten sowie deren Umgebungsvariablen und Secrets —, während jede Integration, die sie genutzt hat, für alles andere verbunden bleibt, das sie braucht.

Ein Neuinstallieren rührt den Workflow der Automatisierung nie an: Workflow-Schritte sind von der Aktualisierung ausgenommen, sodass alles, was du im Editor bearbeitet hast, jedes Neuinstallieren und jede Katalog-Aktualisierung übersteht. Um die neueste mitgelieferte Version eines Workflows zu holen, deinstallierst du die Automatisierung und installierst sie erneut — Tale wiederholt diesen Hinweis sowohl auf der Neuinstallations-Bestätigung als auch auf dem eigenen Tab Konfiguration der Automatisierung.

Mitgelieferte Automatisierungen aktualisieren, im selben Menü Automatisierung hinzufügen wie Paket hochladen, ist eine andere Aktion als die beiden vorigen: Sie gleicht jede mitgelieferte Automatisierung der Organisation in einem Durchgang gegen den mitgelieferten Katalog ab — auch die, die du bearbeitet hast —, statt eine Karte nach der anderen. Sie trägt dieselbe Workflow-Ausnahme und behält Secrets; die vorherige Version von allem, was sie ändert, landet im Verlauf der jeweiligen Automatisierung.

Eine private Automatisierung hochladen

Paket hochladen im selben Menü fügt eine Automatisierung hinzu, die der Katalog nicht mitliefert — leg ein .zip ab, oder wähl einen Ordner mit einer automation.json in seinem Stammverzeichnis; der Ordner- oder Dateiname wird zum Slug der Automatisierung. Das Hochladen fügt sie nur dem privaten Katalog der Organisation hinzu; installiere sie danach wie jede andere Karte. Erneutes Hochladen über einen bereits vorhandenen Slug bittet dich, das Ersetzen zu bestätigen, bevor es das vorhandene Paket überschreibt.

Wo das hineinpasst

Der Katalog ist die Eingangstür zu jeder Automatisierung, die die Organisation ausführen kann: Das Seitenpanel zeigt vorab, was eine Installation hinzufügt, der Assistent verbindet, was sie braucht, und Neuinstallieren, Deinstallieren und Aktualisieren halten sie aktuell, ohne einen Workflow anzurühren, an dem du gerade arbeitest. Mitgelieferte Automatisierungen ist die nächste Lektüre dafür, was jede mitgelieferte Automatisierung und das Bundle GitHub-Issues lösen tatsächlich tun; Automatisierungskonzepte ist das mentale Modell, falls du es noch nicht gelesen hast.