Hochgeladene Kampagnenbilder für die Prüfung in Box aufbereiten

Prüfvariante und maßgebliche Quelle festlegen

Entscheiden Sie, ob es sich beim Upload um eine bearbeitbare Masterdatei, um einen reduzierten Export oder nur um einen Kandidaten für die Prüfung handelt. Dieser Workflow erstellt ein begrenztes JPEG für eine einheitliche Vorschau und Abstimmung; er bewahrt keine Ebenen, keine Transparenz, nicht sämtliche Farbeigenschaften und nicht die Bearbeitbarkeit der Quelle. Bewahren Sie die Masterdatei in dem vom Kreativteam gewählten System auf, wenn diese Eigenschaften wichtig sind.

Erstellen Sie vor der Verarbeitung einen Prüfdatensatz für die Kampagne. Er sollte die Kampagne, die Quellversion, die hochladende Person, die vorgesehene Variantenrichtlinie, die Workflow-Version und den aktuellen Freigabestatus ausweisen. Eine in Box auftauchende Datei ist für sich genommen kein Beleg dafür, dass die richtige Kampagne sie erhalten hat oder dass eine prüfende Person sie freigegeben hat.

Template für die JPEG-zu-Box-Prüfvariante erstellen

Das Template nimmt einen einzelnen Upload von Bildmaterial entgegen, erstellt ein JPEG-Derivat, das in die gewählten Prüfabmessungen passt, und speichert nur dieses Derivat in Box. Der Parameter zoom ist false, damit eine kleine Quelle nicht vergrößert wird, und strip entfernt eingebettete Metadaten aus der Prüfkopie. Der kampagnenspezifische Pfad enthält außerdem die Eindeutigkeit der Assembly, um Kollisionen zwischen wiederholten Dateinamen zu vermeiden.

Belassen Sie allow_steps_override auf false. Lassen Sie den Browser nur die Datei und eine begrenzte campaign_id senden, die der Server bereits autorisiert hat. Der Client darf weder die Box-Zugangsdaten noch das Ordner-Root, das Freigabeverhalten, die Abmessungen oder das Format wählen. Upload-Limits im Template ergänzen die anwendungseigenen Prüfungen von Typ, Mandant, Kontingent und Kampagnenstatus.

{
  "allow_steps_override": false,
  "auth": {
    "max_number_of_files": 1,
    "max_size": 104857600
  },
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "review_jpeg": {
      "use": ":original",
      "robot": "/image/resize",
      "width": 2000,
      "height": 2000,
      "resize_strategy": "fit",
      "zoom": false,
      "format": "jpg",
      "quality": 88,
      "strip": true
    },
    "box_review": {
      "use": "review_jpeg",
      "robot": "/box/store",
      "credentials": "box-campaign-review",
      "path": "campaigns/${fields.campaign_id}/review/${assembly.id}/${file.url_name}",
      "create_sharing_link": false,
      "result": true
    }
  }
}

Box-Zugriff vor dem Produktivbetrieb vorbereiten

Box-Template-Zugangsdaten verwenden eine Platform App, die für Server Authentication mit JWT konfiguriert ist. Speichern Sie die heruntergeladene JSON-Schlüsselkonfiguration in den Zugangsdaten statt in der Versionsverwaltung, im Browser-Code oder in den Assembly Instructions. Ein Box-Administrator oder Co-Administrator muss die App autorisieren, bevor sie arbeiten kann.

Die JWT-Identität ist der Service Account der App. /box/store durchläuft den konfigurierten Pfad ausgehend vom Root dieses Kontos und legt fehlende Ordnersegmente an. Machen Sie für das Beispiel den vorgesehenen Stammordner campaigns über die Box-Zusammenarbeit für den Service Account zugänglich, prüfen Sie dessen Ordner-ID und die Identität des untergeordneten Kampagnenordners und erteilen Sie die Berechtigungen, die zum Anlegen der Prüf-Unterordner und zum Hochladen von Dateien erforderlich sind. Wenn Sie nur einen verschachtelten Kampagnenordner freigeben, lässt sich der vollständige Pfad campaigns aus dem Beispiel nicht ausgehend vom Root des Service Accounts auflösen. Ein fehlender Pfad kann statt eines Fehlers einen separaten privaten Ordnerbaum erzeugen; prüfen Sie daher das Ziel und den Zugriff der Mitwirkenden, bevor Sie die Prüfenden benachrichtigen.

Wenn sich die App-Konfiguration oder die Scopes ändern, stimmen Sie die erneute Autorisierung ab und testen Sie einen bekannten Ordner, bevor Sie den unbeaufsichtigten Betrieb fortsetzen. Ein gültiges JWT garantiert keinen Zugriff auf jeden Ordner des Unternehmens.

Export, Zusammenarbeit und Veröffentlichung getrennt halten

Setzen Sie create_sharing_link auf false. Die Mitgliedschaft in der Box-Zusammenarbeit, die Unternehmensrichtlinie und die Autorisierung durch die Anwendung sollten bestimmen, wer die Datei prüft. Wenn Sie das Flag aktivieren, fordert /box/store ausdrücklich einen offenen geteilten Link an, der für alle gedacht ist, die über die URL verfügen, vorbehaltlich der Box-Richtlinie. Der Robot ersetzt die Ergebnis-URL durch diesen Link; er fordert keinen Link an, der ausschließlich für Mitwirkende gilt.

Wenn eine Kampagne später einen geteilten Link benötigt, erstellen Sie ihn als separate autorisierte Aktion mit ausdrücklich festgelegter Zugriffsebene, Zielgruppe, Ablaufzeit und verantwortlicher Stelle für den Widerruf. Prüfen Sie den tatsächlichen Zugriff gemäß der Box-Richtlinie des Unternehmens, bevor Sie den Link verteilen.

Wiedergabetreue und Identität vor der Freigabe prüfen

Testen Sie transparente PNGs, CMYK-Bilder oder Bilder mit Farbprofil, textlastiges Bildmaterial, Verläufe, feine Linien, Ausrichtungsmetadaten, sehr große Abmessungen und ungewöhnlich kleine Quellen. Vergleichen Sie das JPEG bei realistischen Prüfgrößen mit der Quelle. Eine technisch gültige Konvertierung kann dennoch inakzeptable Änderungen an Farbe, Transparenz oder Komprimierung mit sich bringen.

Speichern Sie nach dem Export die Assembly-ID und den erwarteten Zielpfad dauerhaft zusammen mit dem Prüfdatensatz der Kampagne. /box/store gibt die Box-Datei-ID der hochgeladenen Datei nicht zurück; bei create_sharing_link false behält das Ergebnis die Transloadit-Identität und die zugehörige URL der Eingabedatei. Ermitteln Sie die Zielordner und den exakten Dateinamen über den folder-items-Endpunkt der Box-API und folgen Sie dabei der Paginierung; speichern Sie anschließend die zugehörige Box-Datei-ID separat. Behandeln Sie die Transloadit-Ergebnis-ID oder die zugehörige Ergebnis-URL nicht als Box-Identität oder als Prüflink. Ordnernamen und Dateinamen können sich ändern; führen Sie deshalb vor Verschiebungen oder Umbenennungen einen Abgleich durch und verwenden Sie für spätere Vorgänge die ermittelte Box-ID. Benachrichtigen Sie Mitwirkende erst, nachdem Sie die vorgesehene Kampagne und die Quellversion bestätigt haben.

Betrieb nach Kollisionen und Teilausfällen wiederherstellen

Testen Sie eine nicht autorisierte App, das Anlegen fehlender Ordner, ein Ziel, an dem der Service Account keine Berechtigung zum Anlegen hat, doppelte Namen hochgeladener Dateien, einen Verarbeitungsfehler sowie eine erfolgreiche Größenänderung mit anschließendem Box-Fehler. Ein fehlender Ordner wird in der Regel angelegt und nicht als eindeutiger Fehler gemeldet; prüfen Sie deshalb sowohl auf einen unbeabsichtigten privaten Ordnerbaum als auch auf explizite Exportfehler. Box verlangt, dass Namen innerhalb eines übergeordneten Ordners eindeutig sind; die Assembly-Eindeutigkeit im Beispielpfad verhindert, dass eine nicht zugehörige vorhandene Datei zum Ziel eines versehentlichen Überschreibens wird.

Ein verpasster Webhook oder ein Client-Timeout belegt kein Fehlschlagen des Exports. Gleichen Sie die vorhandene Assembly ab, bevor Sie es erneut versuchen. Falls eine neue Variante erforderlich ist, erfassen Sie sie als neue Kampagnenquelle oder Workflow-Version, statt stillschweigend die Datei zu ersetzen, über die die Prüfenden bereits gesprochen haben. Entfernen Sie abgelehnte und ersetzte Prüfkopien über einen bewussten Aufbewahrungsprozess.