Automatisierungen

Der Ingest zu scoopa kann automatisiert werden, um eine nahtlose Erfahrung vom Ersteller bis zum Empfänger zu ermöglichen. Neben unserem Web-Uploader und unserer Smartphone-App können Sie Assets auch direkt in ein S3 Bucket hochladen. Wir nennen das DCI (Direct Cloud Ingest).

Einstieg:

Sie können jederzeit Zugang zu DCI beantragen, indem Sie sich mit uns in Verbindung setzen (contact@scoopa.com).

Ein dediziertes S3-Bucket wird dann von uns erstellt und mit Ihrer gewünschten Plattform verknüpft.

Wir stellen Ihnen die erforderlichen Bescheinigungen aus.

Mögliche Anbindung an S3:

Sie haben mehrere Möglichkeiten, Ihre Assets in Ihr neu erstelltes S3-Bucket hochzuladen:

• Manuell, mit einer File-Transfer-Applikation (z.B. Cyberduck, Transmit)

  • Dies empfiehlt sich, wenn Sie große Mengen an Daten auf scoopa hochladen müssen, aber keine Automatisierungen benötigen.

  • Dies ist zuverlässiger und komfortabler als die Nutzung des Webinterfaces im Browser.

• Automatisiert, mit einem zwischengeschalteten NAS

  • Dies empfiehlt sich für die schnelle Einrichtung einer Automatisierung mit moderatem Mitteleinsatz.

  • Sie können Ordner auf Ihrem NAS (z.B. Synology) synchronisieren, um neue Dateien in Ihr S3 Bucket hochzuladen.

  • Für Synology DSM empfehlen wir die integrierte "Cloud-Sync"-App.

• Automatisiert, direkt aus Ihrem EVS-Netzwerk

  • Durch die Verwendung von C-Next kann EVS direkt in ein S3 Bucket liefern. Alternativ können Sie X-File verwenden, um auf ein lokales NAS zu pushen, Dateien umzubenennen und zu präfixieren und vieles mehr.

• Jede andere Lösung, die eine Verbindung zu S3 herstellen kann

Das ist zu beachten: 

• Nur Video-Dateien werden eingelesen (Erweiterung: mxf, mov, avi, mpg, mpeg, mp4, h264, m4v, wmv, ts)

• Sie können Ihren Dateien eine scoopa-Ordner-ID voranstellen: 12345_ddmmyy_IhrDateiname.mxf
  Die Ordner-ID finden Sie, indem Sie mit einem beliebigen Web-Browser zu Ihrem gewünschten scoopa-Ordner navigieren, die ID ist der letzte Teil der Url nach "/ordner/12345"

• Es ist auch möglich, direkt in das Archiv zu ingestieren (anders, günstigerer Preispunkt bei 0,2€/GB), indem Sie der Datei "dta__" (<- 2 Unterstriche) voranstellen.
  Eine Kombination aus dta__ordner-id_IhrDateiname.mxf funktioniert also auch.

• Wenn Sie der Datei kein Präfix voranstellen, ist das auch in Ordnung. Diese Dateien werden in die Mailbox des Admins in scoopa aufgenommen, so dass der Admins sie an die richtige Stelle verschieben kann.
  (dies ist auch der Fall, wenn eine Ordner-ID angegeben wird, aber nicht in scoopa gefunden werden kann)

• Ordnerstrukturen auf Ihrem S3-Bucket werden NICHT unterstützt. Stellen Sie sicher, dass Sie nur Dateien in die Wurzel des Buckets hochladen.

• Dateien in Ordnern werden ignoriert.

• Unvollständige Uploads (Multipart) sowie erfolgreiche Uploads werden nach 24h aus dem Bucket gelöscht. Achten Sie also darauf, dass Sie Ihre Uploads auf Ihrer Seite verfolgen. (z.B.: die eingebaute "Cloud Sync" App auf Synology NAS macht das für Sie.)

• Dateien mit der gleichen Größe und dem gleichen Dateinamen werden nicht noch einmal hochgeladen und von scoopa ignoriert, wenn sie bereits vorher hochgeladen wurden

Es ist möglich, neue Assets automatisch in FTP-Server-Ordner zu verschieben. Im Wesentlichen können Sie FTP-Server einrichten und basierend auf diesen Workflows einrichten, die scoopa-Ordner und FTP-Ordner verbinden. Sobald dieser Workflow eingerichtet ist, werden neue Dateien nicht nur wie üblich Benachrichtigungs-E-Mails auslösen, sondern auch die neue Datei an den verbundenen FTP-Ordner weiterleiten.

Beginnen Sie mit der Erstellung Ihres ersten FTP-Servers, indem Sie zu "Automationen" -> "FTP" -> "FTP-Server hinzufügen" navigieren.

Geben Sie im Popup-Fenster Ihre Server-Zugangsdaten ein: Server/IP, Benutzername und Kennwort sowie den FTP-Port (21 ist die Standardeinstellung). Als nächstes sollten Sie Ihrer neuen Verbindung einen Namen geben, um sie zu identifizieren.

Nachdem Sie auf Speichern geklickt haben, werden Sie zur FTP-Übersicht weitergeleitet, wo Sie ein Häkchen hinter Ihrem neu erstellten Server sehen sollten. Dies bedeutet, dass die Verbindung getestet wurde und gültig ist.

Der FTP-Server hinzufügen Dialog

Die FTP Übersicht

Fehlt das Häkchen, gehen Sie zur Bearbeitung Ihres FTP-Servers und überprüfen Sie Ihre Zugangsdaten. In der Bearbeitungsansicht können Sie auch eine erneute Validierung Ihrer Zugangsdaten auslösen, indem Sie auf "re-validate" drücken.

FTP-Server bearbeiten

Sie können auch bestehende FTP-Server löschen, indem Sie in der Übersicht auf das Löschsymbol klicken. Wie bei allen Löschvorgängen muss dies bestätigt werden.

Nachdem Sie Ihren ersten FTP-Server erstellt haben, können Sie damit beginnen, Workflows zu erstellen, die auf diesem Server basieren. Gehen Sie zu: "Automatisierungen" -> "FTP" -> "Workflow hinzufügen".

FTP-Workflow Beispiel

Sie sollten zunächst einen passenden Namen für den Workflow eingeben, der den Workflow in wenigen Worten beschreibt.

Als nächstes können Sie den Zielordner auf dem FTP-Server auswählen, indem Sie im Abschnitt "Zielauswahl" durch den entfernten Server navigieren.

Danach können Sie auswählen, welche Ordner in scoopa als Quellordner für diesen Workflow dienen sollen. Wählen Sie einen oder mehrere Ordner im Abschnitt "Quellenauswahl".

Sie können jetzt Ihren Workflow speichern. Er ist von nun an gültig.

Es ist auch möglich, den Workflow zu bearbeiten, indem Sie auf das Bearbeitungssymbol in der FTP-Übersicht klicken. Neben der Änderung der oben genannten Einstellungen können Sie den Workflow auch deaktivieren.

Sie können Workflows auch löschen, indem Sie in der FTP-Übersicht auf das Löschsymbol klicken.

Sie können alle laufenden und verarbeiteten ftp-Übertragungen im Bereich "Übertragungsprotokolle" überwachen.

Beispiel von FTP Transfer-Logs

Neben dem Gesamtstatus der Übertragung, der Quelldatei und dem Ziel-ftp+Ordner können Sie auch das Datum, den Fortschritt und die Geschwindigkeit der Übertragung sehen. Falls ein Fehler auftritt, sehen Sie hier auch die Fehlermeldung sowie die Anzahl der Versuche, die scoopa unternommen hat, um die Datei auf den FTP-Server zu übertragen.

Webhooks sind automatische Nachrichten, die von Ihrer scoopa-Plattform generiert werden, um einen externen Dienst über die Verfügbarkeit einer neuen Datei zu informieren.

Sie können mehrere Webhooks für mehrere Ordner definieren und haben so die Möglichkeit, Dienste von Drittanbietern in Ihre scoopa-Workflows zu integrieren.

Webhooks werden als HTTP POST-Anfrage an die von Ihnen angegebene URL gesendet. Die Anfrage enthält Informationen über die neue Datei, wie z. B. den Dateinamen, die Größe und die Download-URL.
Integratoren von Drittanbietern können diese Informationen nutzen, um neue Dateien direkt aus unserem Speicher in ihr System herunterzuladen.

Beginnen Sie mit der Erstellung Ihres ersten Webhooks, indem Sie zu "Automationen" -> "Webhooks" -> "Add Webhook" navigieren.

Geben Sie im Popup-Fenster einen Namen ein, um Ihren neuen Webhook zu identifizieren, sowie die von Ihrem externen Anbieter bereitgestellte URL.

Bei Bedarf können Sie weitere Request-Header hinzufügen, die Ihr externer Anbieter möglicherweise benötigt. Zum Beispiel: Anmeldeinformationen, die für die Authentifizierung des scoopa-webhook gegenüber Ihrem externen Anbieter erforderlich sind.

Nachdem Sie auf "Speichern" geklickt haben, werden Sie zur Webhook-Übersicht weitergeleitet, wo Sie ein Häkchen hinter Ihrem neuen Webhook sehen sollten. Dies bedeutet, dass die Verbindung getestet wurde und gültig ist. (Das bedeutet, dass die angegebene URL einen 200 HTTP-Code zurückgegeben hat).

Klicken Sie auf den neu erstellten Webhook, um den Webhook zu bearbeiten und Ordner zuzuweisen, auf die der Webhook reagieren soll.

Für jede neue Datei in den ausgewählten Ordnern wird der Webhook aufgerufen. (siehe unten für eine Dummy-Payload der übertragenen Daten).

In der Bearbeitungsansicht können Sie auch eine erneute Validierung Ihres Webhooks auslösen, indem Sie auf "Re-Validate Webhook" klicken.

Sie können bestehende Webhooks auch löschen, indem Sie in der Übersicht auf das Löschsymbol klicken. Wie bei allen Löschvorgängen muss dies bestätigt werden.

Sie können alle laufenden und verarbeiteten Webhook-Aufrufe im Bereich "Webhook-Call-Logs" überwachen.

Neben dem Gesamtstatus der Aufrufe, der Quelldatei und der Ziel-URL können Sie auch das Datum des Aufrufs sehen. Wenn ein Fehler auftritt, können Sie hier auch die Fehlermeldung sehen.

Webhooks von scoopa sind immer POST-Aufrufe und enthalten einen JSON-Body mit den folgenden Daten:

{
  "origin": "scoopa",
  "platform": „test | mediapool",
  "file_id": 535986,
  "file_name": "server_push.svg",
  "file_size_in_bytes": 5007,
  "folder_id": 62251,
  "folder_name": "Test Webhook",
  "download_url": "https://....."
}

Die download_url ist 24 Stunden lang gültig.

{
  "origin": "scoopa - endpoint validation test",
  "platform": „test | mediapool",
  "file_id": "12345",
  "file_name": "test.mov",
  "file_size_in_bytes": "1048576",
  "folder_id": "67890",
  "folder_name": "test-folder",
  "download_url": "https://....."
}