El Paquete de expansión del componente Página de inicio ofrece una variedad de componentes del sistema de la página de inicio para proporcionar una experiencia de aprendizaje más personalizada en sus páginas de inicio.
Importante: El paquete de expansión de componentes de la página de inicio personalizada se retirará en septiembre de 2024/20.24.9. Los clientes podrán seguir usando las versiones alojadas del componente hasta esa fecha; sin embargo, ya no serán compatibles con D2L. Los clientes que usen las versiones personalizadas de componentes alojados deben realizar una actualización a los nuevos componentes del sistema Brightspace.
Entre los componentes alojados personalizados que se reemplazarán con componentes del sistema, se incluyen los siguientes:
- Componente Tabla de contenido visual
- Componente de la ventana de bienvenida
- Componente Pancarta de fotos
- Componente Premios del estudiante
- Componente Noticias cortas
- Componente Perfil de tarjeta única
- Componente Navegador de contenido
Entre los componentes alojados personalizados que ya no serán compatibles, se incluyen los siguientes:
- Calendario de K12
- Pie de página de K12
Nota: El componente para varios perfiles forma parte del paquete de expansión de componentes de la página de inicio y seguirá funcionando normalmente como un componente del sistema.
Si actualmente tiene un componente alojado personalizado disponible en su instancia de Brightspace, se agregará a su instancia una nueva versión del componente del sistema del mismo componente.
Verifique si se deben reemplazar los componentes
Si tiene el permiso Crear/editar página de inicio, se muestra un mensaje de advertencia en todos los componentes alojados personalizados activos en la página de inicio en el siguiente formato: “Acción necesaria: Actualización del componente: El soporte de este componente está finalizando. Para obtener soporte automatizado a fin de reemplazar este componente, visite el Servicio de soporte de fin de vida útil de HWEP”.
Figura: Utilice el servicio de mensajes dentro del componente (por ejemplo, en el componente Tabla de contenido visual) para navegar al Servicio de soporte de fin de vida útil de HWEP.
Nota: También aparece una advertencia similar en la página de la Herramienta Administración de páginas de inicio si hay versiones alojadas personalizadas de componentes activos en el entorno. Haga clic en esta advertencia para navegar a la página Servicio de reemplazo automatizado del componente personalizado.
En la página Servicio de reemplazo automatizado del componente personalizado, puede hacer lo siguiente:
- Verificar una lista de todos los componentes alojados personalizados y la cantidad de páginas de inicio en las que está activo el componente.
- Buscar las ubicaciones exactas en las que cada componente está activo si hace clic en un número en la fila correspondiente de la columna Páginas de inicio que usan componentes heredados.
Figura: Utilice la página Servicio de reemplazo automatizado de componentes personalizados para localizar, reemplazar o eliminar componentes alojados personalizados.
Para obtener más información sobre cómo identificar qué componentes heredados se están usando y planificar la retirada del paquete de expansión del componente Página de inicio en su entorno, consulte Actualización de los componentes alojados.
Nota: La funcionalidad de reemplazo automatizado se agregará en una fecha posterior.
Utilizar el Servicio de reemplazo de componentes alojados personalizados
El Servicio de reemplazo de componentes alojados personalizados es una parte de la página Componente alojado personalizado (Soporte de EOL de componentes alojados personalizados). El servicio de reemplazo le permite:
- Reemplazar por lote todas las instancias del componente alojado personalizado con la versión del sistema (las configuraciones se migran automáticamente).
- Eliminar de forma masiva todas las instancias del componente personalizado alojado.
Preparar el sitio
Para admitir un reemplazo fluido de componentes alojados personalizados, considere lo siguiente:
-
Asegúrese de que nadie pueda agregar componentes alojados personalizados a las páginas de inicio mientras el servicio esté activo: anuncie al equipo que los componentes alojados personalizados ya no están permitidos o cambie temporalmente los permisos de edición de las páginas de inicio para los roles relevantes.
-
Asegúrese de que para cada componente alojado personalizado, el componente del sistema correspondiente esté habilitado para su instancia y la herramienta de componente del sistema esté activada para su organización. D2L ha proporcionado automáticamente derechos para los equivalentes de componentes del sistema a todos los clientes que utilizan componentes HWEP alojados personalizados.
-
Planee ejecutar sus reemplazos de componentes durante un período de uso fuera de pico. Los Componente alojados personalizados y de Sistema tienen variaciones menores que pueden distraer a los usuarios si se cambian repentinamente.
Advertencia: Al programar períodos de bloqueo, tenga en cuenta que los componentes tienen una duración de caché de dos minutos. Una vez finalizada la migración, es posible que los componentes no aparezcan inmediatamente como migrados hasta que haya transcurrido este período de dos minutos.
Ejecutar el Servicio de reemplazo de componentes alojados personalizados
Advertencia: Los reemplazos automatizados no se pueden revertir automáticamente. El único método para revertir las acciones realizadas por el servicio de reemplazo es deshacer manualmente los cambios.
Para ejecutar el Servicio de reemplazo de componentes alojados personalizados
- Diríjase a la página Componente alojado personalizado.
- Seleccione el componente que quiera reemplazar. El servicio solo se puede aplicar a un componente alojado personalizado a la vez, y este componente debe estar en su etapa final de vida. Esto incluye todos los componentes HWEP excepto el Componente de perfiles múltiples.
Nota: El servicio de reemplazo no se puede ejecutar contra componentes alojados personalizados que no tengan un análogo de componente del sistema. Esto incluye el Calendario K12 y el Pie de página K12.
- Haga clic en Reemplazar junto al componente.
Figura: haga clic en Reemplazar para ejecutar el Servicio de reemplazo de componentes alojados personalizados.
El servicio de reemplazo se ejecuta como una tarea en segundo plano en el sitio Brightspace.
Nota: Si intenta ejecutar el servicio de reemplazo en un componente mientras ya está en curso para ese mismo componente, no se realizará el último intento.
Puede navegar fuera de la página de Componentes alojados personalizados sin interrumpir el servicio de reemplazo.
Después de finalizar, el servicio de reemplazo envía una notificación a la sección Alertas de actualización (representada por el ícono de campana) de la barra de navegación principal de Brightspace. Si el servicio de reemplazo detecta un problema, la notificación incluye un código de error. Haga clic en la notificación para navegar a la página Componentes alojados personalizados para obtener detalles sobre el código de error.
Consulte la lista de códigos de error que se proporciona a continuación para obtener más información.
| Código |
Definición |
Solución |
|---|
| x001 |
El componente personalizado que está intentando reemplazar no tiene un componente de sistema equivalente. |
Envíe una solicitud de soporte. |
| x002 |
Los archivos de configuración asociados con este componente no se pudieron migrar. |
Envíe una solicitud de soporte. |
| x003 |
Hubo un problema al migrar la definición de rol del componente personalizado instalado más recientemente a nivel de organización. |
Envíe una solicitud de soporte. |
| x004 |
Un usuario agregó este componente a una página de inicio mientras se estaba ejecutando el servicio de reemplazo. |
Vuelva a ejecutar el servicio de reemplazo para este componente personalizado. |
| x005 |
Este componente no se pudo ser reemplazar. |
Envíe una solicitud de soporte. |
| x006 |
Hubo un problema. El componente del sistema analógico para este componente personalizado no tiene derecho. |
Envíe una solicitud de soporte. |
| x007 |
Otro usuario está ejecutando actualmente el proceso de reemplazo de este componente. |
Vuelva a ejecutar el servicio una vez finalizada la ejecución actual (si es necesario). |
| x008 |
Los títulos personalizados asociados con este componente no se pudieron migrar. |
Envíe una solicitud de soporte. |
Descripción general de las acciones y consideraciones para el servicio de reemplazo
Confirmar derecho y estado de herramienta
El servicio de reemplazo verifica que la versión del sistema del componente esté habilitada para la instancia y comprueba si el componente del sistema está activado en Herramientas de la organización:
- Si el servicio de reemplazo encuentra que el componente del sistema no está habilitado a nivel de instancia, se cierra y notifica al usuario.
- Si el servicio de reemplazo descubre que el componentet del sistema no está habilitado en Herramientas de la organización, activa el componente a nivel de organización y continúa.
- Si el componente no está activo en ninguna unidad de organización secundaria, el servicio de reemplazo procede como si el componente estuviera activo para esa unidad de organización y reemplaza al componente. El componente reemplazado aparece inactivo en la página de inicio hasta que el propietario de la página de inicio activa el componente para esa unidad de organización.
Registro de todas las páginas de inicio y cursos afectados
El servicio de reemplazo escanea el sitio para todas las instancias del componente en las páginas de inicio e identifica todos los cursos que usan las páginas de inicio con este componente. En ciertos sitios, el componente puede haber sido instalado varias veces por error. En estos casos, el servicio selecciona la instalación del componente a nivel de organización con la fecha de instalación más reciente como la versión canónica. En la mayoría de los casos, las instalaciones secundarias son idénticas a la instalación de la organización original, lo que hace que esta estrategia sea inofensiva. Sin embargo, hay casos especiales, identificados por consultas de bases de datos, en los que las instalaciones secundarias se han personalizado de alguna manera. Estas instalaciones secundarias personalizadas deben administrarse manualmente antes de ejecutar el servicio de reemplazo. D2L se ha puesto en contacto directamente con dichos clientes.
Migrar archivos de configuración
Los componentes alojados personalizados tienen un config.txt predeterminado a nivel de organización. El servicio de reemplazo verifica si esta config.txt de organización ya se ha migrado a Datos del componente para la organización y lleva a cabo la migración si aún no se ha realizado.
Los componentes alojados personalizados utilizan una combinación de archivos config.txt almacenados localmente y Datos de componentes almacenados de forma remota para guardar configuraciones para cada ocurrencia de curso de un componente. Este enfoque permite que un componente sea único en cada curso.
Los componente del sistema utilizan exclusivamente Datos del componente para el almacenamiento de datos. Para que la migración tenga éxito, el servicio debe transferir datos de archivos config.txt a Datos del componente. Utilizando su registro de cursos afectados, el servicio de reemplazo lee los datos del archivo config.txt de cada curso y los copia en Datos del componente específico de ese curso.
Los siguientes casos son posibles:
- Si el config.txt local es idéntico a los datos ya almacenados en Datos del componente de la organización, la configuración local se considera redundante y no se migra. Las configuraciones personalizadas se pueden agregar en el futuro según sea necesario. Los archivos config.txt heredados no se eliminan del sistema de archivos; se conservan en el sitio como copia de seguridad en caso de que el servicio de reemplazo falle.
- Si falta el archivo config.txt a nivel de organización, se migran las configuraciones de todos los niveles de curso.
- Si un curso tiene una configuración presente tanto en Datos del componente como en un archivo config.txt, el servicio de reemplazo mantiene la versión en Datos del componente y descarta los datos config.txt. Aunque este escenario es poco probable, podría ocurrir si en un curso se utiliza tanto la versión del sistema como la personalizada de un componente. Si el JSON dentro del archivo config.txt no se puede leer o el archivo en sí es ilegible, la configuración no se migra. Si esto sucede en el caso de una configuración a nivel de curso, el componente heredará la configuración almacenada en la organización.
Nota: Las configuraciones para cursos reciclados no se migran.
Migrar configuraciones de rol
Los componentes Premios de estudiantes, Noticias cortas y Ventana de bienvenida tienen definiciones de roles. Las definiciones de roles son un esquema entre los roles disponibles en el componente, como el alumno o moderador y los roles definidos en Brightspace. Para los componentes alojados personalizados, estas definiciones se almacenan como una variable JavaScript dentro del campo de contenido del componente personalizado. Para los componentes del sistema, las definiciones de roles se almacenan en una variable de configuración específica para cada componente.
Nota: Para los componentes alojados personalizados, las definiciones de rol solo se pueden definir por instalación de componente, no por unidad de organización.
A continuación, se muestra un ejemplo de definiciones de roles:
Var roleDefinitions = {
"administrator": [
"D2LAdmin"
],
"moderator": [
"D2LAdmin",
"Superadministrador",
"Instructor"
],
"instructor": [],
"learner": []
};
El servicio de reemplazo escanea el campo de contenido del componente, extrae la definición de rol y lo guarda en la variable de configuración de organización correspondiente para ese componente.
Si el objeto JavaScript que define la definición de rol no es válido, la definición de rol correspondiente no se migra.
En los casos en que un componente se ha instalado varias veces en un sitio, el servicio de reemplazo utiliza las definiciones de rol de la instalación del componente a nivel de organización con la fecha de instalación más reciente como las definiciones de rol canónicas para el sitio. Se realizó una búsqueda en la base de datos de todas las configuraciones de roles para asegurarse de que no hay sitios con definiciones de roles divergentes en múltiples instalaciones.
Migrar el título del componente y los títulos personalizados
El servicio de reemplazo intenta migrar nombres personalizados asociados con el componente alojado personalizado, incluido el nombre del componente personalizado, la anulación del nombre del componente personalizado y la anulación del nombre del componente de la página de inicio:
| Tipo de título |
UI de Brightspace |
Ubicación |
Funcionamiento |
|---|
| Campo de nombre del componente personalizado |
 Figura: Campo Nombre.
|
Haga clic en el ícono de edición junto al nombre del componente > Propiedades del componente personalizado > Nombre. |
La anulación se aplica en la unidad de organización donde está instalado el componente, siempre que no haya una anulación del nombre del componente personalizado existente para el componente del sistema. El servicio de reemplazo adopta el nombre del componente creado más recientemente. |
| Anulación del nombre de componente personalizado |
 Figura: las casillas de selección de Configuración del componente y los botones de opción de Nombre del componente.
|
Haga clic en el ícono de personalizar junto al nombre del componente > Configuraciones del componente > Nombre del componente > Seleccione Personalizar. |
Si está presente, se aplica como una anulación adicional en la unidad de organización donde está instalado el componente. El componente adopta el nombre de la anulación creada más recientemente. |
| Anulación del nombre del componente de la página de inicio |
Figura: las casillas de selección de Configuración del componente y los botones de opción de Nombre del componente.
|
Haga clic en Agregar estilo a este componente desde cualquier página de inicio > Configuraciones del componente > Nombre del componente > Seleccione Personalizar. |
Si está presente, esta anulación se aplica también a la página de inicio. El componente toma el nombre de la anulación creada más recientemente.
Nota: El componente prioriza la adopción de la Anulación del nombre del componente de la página de iniciosobre cualquier otro nombre.
|
Reemplar el componente alojado personalizado
Todos los componentes del sistema y todos los componentes personalizados tienen ID únicos. Los componentes se agregan a las páginas de inicio haciendo referencia a estos ID. Para reemplazar un componente personalizado en una página de inicio, el servicio de reemplazo actualiza el registro de la página de inicio para usar el ID del componente del sistema correspondiente. Esta acción elimina el viejo componente personalizado y agrega el componente del sistema. El componente del sistema recién agregado funciona de manera idéntica al viejo componente personalizado, ya que su configuración y roles se han migrado con anterioridad.
Los cursos no se modifican directamente. Los cursos individuales solo se ven afectados si se actualiza una página de inicio que se está utilizando.
Desinstalar elcomponente alojado personalizado
En la etapa final, el componente se desinstala del sitio para evitar su uso futuro en las páginas de inicio. Dentro de la base de datos, el componente se elimina de la lista de componentes personalizados, eliminando todo el contenido personalizado previamente almacenado en el campo de contenido del componente. Esto equivale a usar la función Eliminar en el panel Componentes personalizados de la página Administrar componentes.
Advertencia: si un usuario agregó un componente a una página de inicio mientras se ejecutaba el servicio de reemplazo, el servicio completa su operación, pero no desinstala el componente. En su lugar, se envía una notificación al usuario. En este caso, el servicio de reemplazo debe volver a ejecutarse para eliminar el componente agregado recientemente. Consulte Ejecutar el Servicio de reemplazo de componentes alojados personalizados.
Una vez que el componente se desinstala del sitio, no está disponible para su uso en las páginas de inicio. Dado que el servicio de reemplazo actualiza las páginas de inicio pero no los cursos, esto significa que los cursos reciclados, eliminados e inactivos también se ven afectados, aunque no estén disponibles para los usuarios.