{{:icon-owl-96.png?nolink|}} ====== Knowledgebase ► BeeCollect Media 2 ► Metadaten-Synchronisation mit NetX ====== [[:start|{{ ::icon-home-64.png?nolink|Startseite}}]] [[bcpro:de:knowledgebase|{{ ::icon-owl-64.png?nolink|Zurück zur Knowledgebase}}]] [[bcpro:de:knowledgebase:bc-media:bc-media-2|{{ ::icon-arrow-left-64.png?nolink|Zurück zur Übersicht BC Media 2.0}}]] ===== Allgemeines ===== Die Metadaten-Synchronisation mit NetX wird über das Profil //NetX: Meta synchronisation// im BeeCollect Media Client bzw. nach Verfügbarkeit im Modul //Profile und Jobs// in BeeCollect Professional konfiguriert. Die Synchronisation kann dabei in zwei Richtungen erfolgen: == NetX -> BeeCollect Professional == In dieser Richtung werden die Inhalte von ausgewählten Attributen aus NetX in den jeweils verknüpften Mediendatensatz in BeeCollect Professional übertragen. == BeeCollect Professional -> NetX == In dieser Richtung werden die Inhalte von ausgewählten Datenfeldern aus dem Modul Sammlung sowie dem verknüpften Mediendatensatz in Attribute in NetX übertragen. Zu beachten ist, dass diese Synchronisationsrichtung nur für Mediendatensätze verfügbar ist, die mit dem Modul Sammlung verknüpft sind. Beide Synchronisationsrichtungen können als vollständige oder inkrementelle Synchronisation konfiguriert werden. Bei einer inkrementellen Synchronisation werden nur die Datensätze bzw. Assets verarbeitet, die eine relevante Änderung seit der letzten Synchronisation erfahren haben. Eine relevante Änderung bedeutet dabei, dass ein Datenfeld oder ein Attribut geändert wurde, welches Bestandteil des für die jeweilige Synchronisationsrichtung wirksamen Mappings ist. ===== Funktionsprinzip ===== Die Synchronisation basiert zunächst darauf, dass sowohl im NetX-Asset der Datensatzschlüssel (GUID) des verknüpften Mediendatensatzes, als auch im Mediendatensatz die Datensatznummer des Assets (Asset-ID) gespeichert ist. Nur wenn beide Angaben zueinander passen, also Asset und Mediendatensatz aufeinander verweisen, ist eine Metadatensynchronisation möglich. Nach jeder Synchronisation wird durch das BeeCollect-Media-Profil gespeichert, welches das jüngste Änderungsdatum jeweils aller verarbeiteten Assets und Mediendatensätze (bzw. der damit verknüpften Sammlungsobjekte) war. Bei einer inkrementellen Synchronisation können dann beim nächsten Profillauf alle Datensätze und Assets abgerufen werden, deren Änderungsdatum jünger ist. So ist sichergestellt, dass jede Änderung auf beiden Seiten korrekt verarbeitet wird. Jeder Synchronisation liegen jeweils zwei Mappings zugrunde, eines für jede Synchronisationsrichtung. Sie enthalten die Information, welche Attribute in welche Felder im Mediendatensatz und welche Datenfelder aus Sammlungsobjekt oder Mediendatensatz in welches Attribut geschrieben werden. Für jedes Asset und jeden Mediendatensatz wird dabei basierend auf diesem Mapping bei jeder festgestellten Änderung ein Fingerabdruck, also eine Prüfsumme über alle im Mapping enthaltenen Datenfelder bzw. Attribute errechnet. Diese Prüfsumme wird mit der aus der jeweils letzten Synchronisation gespeicherten Prüfsumme verglichten. Unterscheiden sich beide Prüfsummen, bedeutet dies, dass in einem der gemappten Felder bzw. Attribute eine Änderung seit der letzten Synchronisation vorgenommen wurde. Dann - und nur dann - wird der Datensatz bzw. das Asset tatsächlich synchronisiert. Auf diese Weise werden unnötige Schreibzugriffe sowohl bei BeeCollect Professional als auch bei NetX vermieden. ===== Profil-Einstellungen ===== {{:bcpro:de:knowledgebase:bc-media:profile_metasync_netx_01.png?nolink|}} == Profilname == Bezeichnung des Profils. == Aktiv == Profil aktivieren / deaktivieren. Nur aktive Profile werden ausgeführt. === Ziel-Einstellungen === == Medienkatalog == Konfigurierter NetX-Medienkatalog. Bitte die Hinweise zum Konfigurieren des Medienkatalog beachten. == Container == Container, aus denen Datensätze verarbeitet werden. Es werden in beiden Richtungen nur Synchronisierungen mit Datensätzen vorgenommen, die den ausgewählten Containern zugeordnet sind. Wichtig ist dabei nicht die Containerzuordnung des Mediendatensatzes, sondern die Containerzuordnung des verknüpften Objektes. Sind keine Container ausgewählt, werden alle verknüpften Assets synchronisiert. === Mapping-Einstellungen === == Mapping NetX -> BC == Mapping für die Synchronisierungsrichtung NetX -> BeeCollect Professional. Bitte die Hinweise zum Konfigurieren des Mappings beachten. == Mapping BC -> NetX == Mapping für die Synchronisierungsrichtung BeeCollect -> NetX . Bitte die Hinweise zum Konfigurieren des Mappings beachten. === Protokoll-Einstellungen === == Protokoll-Ebene == Steuerung der Ausführlichkeit der Protokollaktivität. Mögliche Werte sind hier: * Verbose: Alle Schritte werden protokolliert * Standard: Nur wichtige Schritte sowie alle Warnungen und Fehler werden protokolliert * Warnings: Nur Warnungen und Fehler werden protokolliert * Errors: Nur Fehler werden protokolliert Hinweis: Die Einstellung //Verbose// sollte nur für Testzwecke aktiviert werden, da die resultierenden Protokolldateien sehr groß werden können. == Protokoll in Datei schreiben == Schreiben des Protokolls in eine Datei aktivieren. == Ordner für Protokolle == Ordner zur Ablage der Protokoll-Dateien. Hinweis: BeeCollect Media legt für jeden Tag eine neue Protokolldatei an. Das Verzeichnis muss bei Bedarf manuell von nicht mehr benötigten Protokollen bereinigt werden. === Zeitsteuerung === == Ausführungsintervall (Run profile every hours:minutes) == Hier wird das Ausführungsintervall in Stunden / Minuten festgelegt. Nach Ablauf des Intervalls wird ein Startversuch des Profils unternommen. Läuft das Profil vom vorherigen Startversuch noch, wird das Profil nicht erneut gestartet - es läuft also garantiert immer nur eine Instanz des Profils. Der Ausführungsintervall beginnt mit der konfigurierten Startzeit (siehe unten). == Startzeit == Dieser Parameter definiert die Startzeit des Profils. Von dieser ausgehend wird mit Hilfe des Ausführungsintervall der jeweils nächste Ausführungszeitpunkt des Profils ermittelt. == Profil-Pause == Hier kann ein Zeitfenster definiert werden, innerhalb dessen die Profilausführung ausgesetzt wird (zum Beispiel, um Wartungsarbeiten oder Datensicherungen zu ermöglichen). Es ist zu beachten, dass bereits laufende Profile bei erreichen der Pausenzeit nicht gestoppt werden. ===== Mindestvoraussetzungen ===== Damit das Profil erfolgreich initialisiert werden kann, findet eine Prüfung folgender Voraussetzungen statt: * das Ausführungsintervall muss größer 0 sein * die Verbindung zum Netx-Katalog muss erfolgreich aufgebaut werden können Ist die Prüfung nicht erfolgreich, wird das Profil nicht initialisiert und gestartet.