Zum Inhalt

Automatische Mediensynchronisierung

Der Job Business Portals - Synchronize Media aktualisiert Portalbilder und -videos automatisch aus Business Central. Das Standardintervall beträgt 60 Minuten. Eine Anmeldung auf der manuellen Medienaktualisierungsseite ist nicht erforderlich.

Die Aktualisierung verwendet die vorhandene Medienauswahl, Business Mappings und Filter. Nach erfolgreicher Verarbeitung stellt das Portal die neuen Bilder und Videos gemeinsam bereit. Schlägt die Aktualisierung vor der Veröffentlichung fehl, bleiben die zuletzt erfolgreich veröffentlichten Medien verfügbar.

Info

Für die automatische Synchronisierung sind kompatible Versionen von Business Central und Portal erforderlich. Lassen Sie beide Komponenten vor Aktivierung des Jobs aktualisieren. NAV-Installationen verwenden weiterhin die manuelle Medienaktualisierung.

Voraussetzungen

Der Administrator oder Hostingpartner muss sicherstellen, dass Business Central die Portaladresse erreichen kann (bei Business Central Online muss sie öffentlich erreichbar sein), das Portal Medien speichern kann und genügend Speicherplatz hat, derselbe Media Sync key in Business Central und Portal hinterlegt und die Medienauswahl konfiguriert ist.

Der Media Sync key ist unabhängig vom App-Registrierungsclientgeheimnis und unterstützt auch selbst gehostete Portale sowie andere Business-Central-Authentifizierungsmethoden. Siehe Fehlerbehebung bei der Mediensynchronisierung.

Aktualisierte Portale auswählen

Jeder Lauf verarbeitet Portale mit einer URL in Business Portals - Portals sowie die URL des unter General ausgewählten Endpoint in Business Portals - Module Setup, sofern vorhanden. Für ein selbst gehostetes Portal wählen oder erstellen Sie dort einen Endpoint mit der Basisadresse (z. B. https://portal.example.com, ohne Seitennamen, Abfragezeichenfolge oder #!-Fragment). Eine zusätzliche Portalreferenz ist nicht erforderlich. Identische normalisierte Adressen werden nur einmal verarbeitet; Fehler bei einem Portal verhindern die Verarbeitung anderer Portale nicht.

Media Sync key einrichten

  1. Öffnen Sie Business Portals - Module Setup in Business Central.
  2. Prüfen Sie unter Media Synchronization den Status Media Sync Key Configured.
  3. Falls kein Schlüssel konfiguriert ist, wählen Sie Generate Media Sync Key.
  4. Kopieren Sie den verschlüsselten Wert aus der Meldung und bewahren Sie ihn sicher auf. Er beginnt mit ENC:v1: und wird nur bei der Erstellung angezeigt.
  5. Bei verwalteten Portalen mit App Registration versucht die Aktion, die Portalkonfiguration automatisch zu aktualisieren. Prüfen Sie die Ergebnismeldung.
  6. Übermitteln Sie den Wert für selbst gehostete Portale sicher an die zuständige Person, die ihn gemäß technischer Anleitung einrichtet.

Warning

Ein neuer Schlüssel ersetzt den bisherigen. Alle Portale müssen den Ersatzschlüssel erhalten, bevor die Synchronisierung wieder funktioniert. Behandeln Sie den Wert als Geheimnis und fügen Sie ihn weder Supportanfragen noch Screenshots hinzu.

Bei fehlgeschlagener automatischer Aktualisierung beheben Sie Verbindung oder Veröffentlichungsberechtigungen und wählen Update Media Sync Key on Portals. Erstellen Sie zum erneuten Übermitteln keinen neuen Schlüssel. Module Setup und Schlüssel gelten unternehmensübergreifend; eine Änderung wirkt sich daher auch auf Jobs anderer Unternehmen aus.

Jobwarteschlangeneintrag erstellen

  1. Öffnen Sie im gewünschten Unternehmen das Rollencenter Business Portals Administrator.
  2. Öffnen Sie im Bereich Job Queue Entries die Aktionen und wählen Sie Create Default Entries.
  3. Öffnen Sie Business Portals - Synchronize Media, prüfen Sie Zeitplan und Status und wählen Sie Set Status to Ready, um die Verarbeitung zu starten.
Einstellung Standardwert
Description Business Portals - Synchronize Media
Object Type to Run Codeunit
Object ID to Run 5492810
Parameter String SYNC_MEDIA
Number of Minutes Between Runs 60

Create Default Entries erstellt fehlende Einträge im aktuellen Unternehmen und erhält bestehende Einträge samt Einstellungen. Unternehmen können eigene Jobs besitzen, die dieselben Portale aktualisieren; stimmen Sie Zeitpläne ab. Allgemeine Hinweise: Business Portals Job Queue.

Ersten Lauf prüfen

Führen Sie den Job einmal aus oder warten Sie den nächsten Lauf ab. Öffnen Sie Business Portals - Log im ausführenden Unternehmen, filtern Sie nach Source = Portal media synchronization und prüfen Sie Einzelresultate und Zusammenfassung, z. B. 1 updated, 0 unsupported, 0 failed. Kontrollieren Sie repräsentative Bilder und Videos im Portal; bei Bedarf aktualisieren Sie den Browser.

Ergebnis Bedeutung
Updated Das Portal hat eine vollständige Aktualisierung angenommen.
Unsupported Der Synchronisierungsendpunkt fehlt; Hostingpartner soll die installierte Version prüfen.
Failed Die Aktualisierung war aus Sicht von Business Central nicht erfolgreich; prüfen Sie die Meldung.

Info

Success im Jobwarteschlangenverlauf bedeutet nicht, dass jedes Portal aktualisiert wurde. Fehler stehen separat in Business Portals - Log; der wiederkehrende Job kann weiterlaufen. Siehe Arbeiten mit dem Log.

Änderungen, Löschungen und manuelle Aktualisierungen

Jeder erfolgreiche Lauf veröffentlicht die vollständige Medienauswahl, auch wenn sie unverändert ist. Nicht mehr ausgewählte Medien verschwinden nach erfolgreicher Aktualisierung aus dem aktuellen Cache; eine gültige leere Auswahl veröffentlicht leere Medienordner. Bei Fehlern bleiben bisherige Medien verfügbar, auch wenn sie in Business Central geändert oder gelöscht wurden. Der nächste Lauf versucht erneut eine vollständige Aktualisierung. Browsercache kann ältere Bilder vorübergehend anzeigen.

Die manuelle Seite UpdateImages.aspx bleibt für Business-Central- und NAV-Portale verfügbar. Beide Verfahren verwenden denselben Veröffentlichungsmechanismus. Bei Überschneidungen muss eine Aktualisierung möglicherweise wiederholt werden; prüfen Sie zuerst die Logs.

Speicher und Bereinigung

Nach einem Portalupgrade bleiben vorhandene Dateien in ihren ursprünglichen Ordnern verfügbar, bis die erste erfolgreiche Aktualisierung erfolgt. Das Portal behält die aktuelle und eine vorherige Mediengeneration. Ältere Generationen können 15 Minuten nach Ablösung, ursprüngliche Medienordner 15 Minuten nach der ersten erfolgreichen Veröffentlichung und inaktive Upload-Zwischenstände nach zwei Stunden bereinigt werden.

Die Bereinigung erfolgt bei späteren Synchronisierungsanfragen oder manuellen Aktualisierungen, höchstens einmal pro Minute; es gibt keinen unabhängigen Hintergrundtimer. Häufige manuelle Läufe können vorübergehend mehrere Generationen auf dem Datenträger belassen. Es gibt kein festes Speicherlimit; lassen Sie den freien Speicherplatz überwachen. Siehe technische Speicherhinweise.

HTTP-Verbindungen

HTTPS ist standardmäßig erforderlich. Lassen Sie Allow HTTP Media Sync im Normalbetrieb deaktiviert. Administratoren können die Option für genehmigte HTTP-Verbindungen oder Entwicklungstunnel aktivieren; HTTPS-Adressen verwenden weiterhin HTTPS. Business Central und Portal müssen die Option unterstützen.

Warning

HTTP verschlüsselt die übertragenen Medien nicht. Aktivieren Sie die Option nur nach Freigabe durch die Netzwerkverantwortlichen und deaktivieren Sie sie nach der Fehlersuche wieder.