Migrieren von Advanced-Insights-Dashboards zu den neuen Parametern für zusätzliche Felder

Einführung

Advanced Insights ermöglicht Ihnen jetzt, bis zu 15 zusätzliche Benutzerfelder und bis zu 15 zusätzliche Kursfelder in jedem Dashboard zu verwenden, statt jeweils fünf. Um dies zu unterstützen, hat Docebo die bisherigen Parameter für zusätzliche Felder durch zwei neue Parameter und eine neue Methode zum Auslesen zusätzlicher Felder ersetzt. In diesem Artikel wird erläutert, was Docebo für Sie migriert, was Sie selbst migrieren müssen und wie Sie dies tun, bevor die bisherigen Felder am 26. Februar 2027 entfernt werden.

Wer Maßnahmen ergreifen muss

Was sich geändert hat

Bisher hatte jedes zusätzliche Feld einen eigenen Parameter, wodurch Sie auf fünf Felder für Benutzer und fünf Felder für Kurse beschränkt waren. Jedes Dashboard verwendete elf Parameter mit jeweils einem Wert.

Jetzt unterstützen zwei Parameter mit mehreren Werten jeweils bis zu 15 zusätzliche Felder: CustomUserAdditionalFields und CustomCourseAdditionalFields. Advanced Insights stellt Ihnen die Felder über die konsolidierten Dataset-Felder user_additional_fields und course_additional_fields bereit. Sie lesen jedes zusätzliche Feld mit einem berechneten Feld aus. Der Sprachparameter ist nicht mehr vorhanden. Docebo liest die Bezeichnungen in der Standardsprache Ihrer Plattform aus, genauso wie bei Zweigen.

Bitte beachten: Wir empfehlen, bis zu 15 zusätzliche Benutzerfelder und bis zu 15 zusätzliche Kursfelder in einem Dashboard zu verwenden. Die Verwendung von mehr zusätzlichen Feldern kann die Ladezeit des Dashboards erhöhen.

Was Docebo automatisch migriert

Docebo konvertiert die Parameter für Sie. Die Werte, die Sie im Feld Statischer Standardwert Ihrer bisherigen Parameter eingegeben haben, werden in derselben Reihenfolge in die neuen Parameter CustomUserAdditionalFields und CustomCourseAdditionalFields übernommen. Die Sprachauswahl für zusätzliche Felder wird nicht mehr angezeigt, und die Standardsprache Ihrer Plattform wird automatisch angewendet.

Was Sie selbst migrieren

Docebo kann nicht jede Stelle erkennen, an der ein Dashboard ein zusätzliches Feld verwendet. Daher müssen Sie die bisherigen Felder selbst ersetzen. Duplizieren Sie das Dashboard, bevor Sie Änderungen vornehmen.

Bitte beachten: Behalten Sie die vorhandene Auswahl der bisherigen Parameter und deren Reihenfolge unverändert bei, bis Sie das gesamte Dashboard migriert haben. Durch das Ändern oder Neuanordnen werden die von den bisherigen Feldern zurückgegebenen Werte geändert. Dies kann sich auf visuellen Elementen auswirken, die Sie noch nicht migriert haben.

Listen Sie zunächst jede Stelle auf, an der das Dashboard ein zusätzliches Feld verwendet. Überprüfen Sie visuelle Elemente sowie Filter auf Dashboard- und Visualisierungsebene, Regeln für die bedingte Formatierung und Ihre eigenen berechneten Felder, die häufig mit einem Gleichheitszeichen beginnen. Filter und bedingte Formatierungen werden leicht übersehen, da sie auf der Oberfläche des Dashboards nicht sichtbar sind. Notieren Sie die Liste, bevor Sie beginnen, mit einer Zeile für jedes Feld, Dashboard und jeden Speicherort.

Erstellen Sie anschließend für jedes von Ihnen verwendete zusätzliche Feld ein berechnetes Feld, wie im Abschnitt Erstellen eines berechneten Feldes für ein zusätzliches Feld des Artikels Verwenden von Advanced Insights beschrieben. Wenn Sie zuvor das Übersetzungsfeld verwendet haben, um die Bezeichnung des zusätzlichen Feldes abzurufen, verwenden Sie die Eigenschaft .label.

Öffnen Sie dann für jede Stelle auf Ihrer Liste das visuelle Element, den Filter oder die Regel für die bedingte Formatierung, entfernen Sie das bisherige Feld und fügen Sie an seiner Stelle das neue berechnete Feld hinzu. Wenden Sie alle Formatierungen, Sortierungen oder Aliase, die dem bisherigen Feld zugewiesen waren, erneut an und speichern Sie.

Überprüfen Sie abschließend das Dashboard. Vergewissern Sie sich, dass die Werte mit den zuvor im Dashboard angezeigten Werten übereinstimmen, testen Sie jeden Filter, der ein zusätzliches Feld verwendet, lösen Sie jede Regel für die bedingte Formatierung aus und überprüfen Sie, dass keine Visualisierung eine leere oder Null-Spalte anzeigt. Haken Sie jedes Feld auf Ihrer Liste ab, während Sie vorgehen.

Kurzübersicht

Häufige Fehler

Tipp: Vermeiden Sie diese häufigen Fehler: die Position des zusätzlichen Feldes anstelle des Index zu verwenden (das zweite Feld hat den Index 1, nicht 2); .value zu verwenden, wenn Sie .label benötigen; visuelle Elemente zu ersetzen, aber Filter und bedingte Formatierungen zu vergessen; davon auszugehen, dass „automatisch“ vollständig bedeutet, da die Parameter zwar automatisch migriert werden, die Verwendungen innerhalb der Dashboards jedoch nicht; die Reihenfolge der Liste zu ändern, da sich dadurch jeder Index nach der Änderung verschiebt.