Migración de los paneles de Advanced Insights a los nuevos parámetros de campos adicionales

Presentación

Advanced Insights ahora permite usar hasta 15 campos adicionales de usuarios y hasta 15 campos adicionales de cursos en cada panel, en lugar de cinco de cada tipo. Para admitir esto, Docebo ha reemplazado los parámetros de campos adicionales heredados por dos parámetros nuevos y una nueva forma de leer los campos adicionales. En este artículo se explica qué migra Docebo por usted, qué debe migrar usted mismo y cómo hacerlo antes de que los campos heredados se eliminen el 26 de febrero de 2027.

Quién debe realizar acciones

Qué ha cambiado

Anteriormente, cada campo adicional tenía su propio parámetro específico, lo que limitaba a cinco los campos para usuarios y a cinco los campos para cursos. Cada panel utilizaba once parámetros de un solo valor.

Ahora, dos parámetros multivalor admiten hasta 15 campos adicionales cada uno: CustomUserAdditionalFields y CustomCourseAdditionalFields. Advanced Insights proporciona los campos mediante los campos de los conjuntos de datos consolidados user_additional_fields y course_additional_fields, y cada campo adicional se lee mediante un campo calculado. El parámetro de idioma ya no existe. Docebo lee las etiquetas en el idioma predeterminado de su plataforma, de la misma manera que lo hace para las ramas.

A tener en cuenta: Recomendamos usar hasta 15 campos adicionales de usuarios y 15 campos adicionales de cursos en un panel. Usar más campos adicionales puede aumentar el tiempo de carga del panel.

Qué migra Docebo automáticamente

Docebo convierte los parámetros por usted. Los valores introducidos en el campo Valor predeterminado estático de sus parámetros heredados se trasladan, en el mismo orden, a los nuevos parámetros CustomUserAdditionalFields y CustomCourseAdditionalFields. El selector de idioma de los campos adicionales ya no aparece y el idioma predeterminado de su plataforma se aplica automáticamente.

Qué debe migrar usted mismo

Docebo no puede detectar todos los lugares en los que un panel utiliza un campo adicional, por lo que debe reemplazar los campos heredados usted mismo. Duplique el panel antes de realizar cualquier cambio.

A tener en cuenta: Mantenga sin cambios las selecciones existentes de los parámetros heredados y su orden hasta que haya migrado todo el panel. Cambiarlos de orden o reorganizarlos modifica los valores que devuelven los campos heredados y puede afectar a elementos visuales que aún no haya migrado.

Como primer paso, haga una lista de todos los lugares en los que el panel utiliza un campo adicional. Compruebe los elementos visuales, los filtros a nivel de panel y de elemento visual, las reglas de formato condicional y sus propios campos calculados, que a menudo comienzan con un signo de igual a. Es fácil no detectar los filtros y el formato condicional porque no son visibles en la superficie del panel. Anote la lista antes de comenzar, con una fila para cada campo, panel y ubicación.

A continuación, cree un campo calculado para cada campo adicional que utilice, tal como se describe en la sección Crear un campo calculado para un campo adicional del artículo Uso de Advanced Insights. Si anteriormente utilizaba el campo de traducción para obtener la etiqueta del campo adicional, use la propiedad .label.

Después, para cada lugar de la lista, abra el elemento visual, el filtro o la regla de formato condicional, elimine el campo heredado y añada en su lugar el nuevo campo calculado. Vuelva a aplicar cualquier formato, orden o alias asociado al campo heredado y guarde.

Por último, compruebe el panel. Confirme que los valores coincidan con los valores que mostraba el panel anteriormente, pruebe cada filtro que utilice un campo adicional, active cada regla de formato condicional y compruebe que ningún elemento visual muestre una columna en blanco o nula. Marque cada campo de la lista a medida que avance.

Referencia rápida

Errores comunes

Consejo: Evite estos errores comunes. Usar la posición del campo adicional en lugar del índice (el segundo campo tiene el índice 1, no 2). Usar .value cuando necesita .label. Reemplazar los elementos visuales, pero olvidar los filtros y el formato condicional. Suponer que automático significa completo, ya que los parámetros se migran automáticamente, pero los usos dentro de los paneles no. Cambiar el orden de la lista, porque todos los índices posteriores al cambio se desplazan.