Instalar los complementos de informes, los filtros y las herramientas de Ally

Las versiones 3.3 de los complementos son compatibles con Moodle 3.2.

  1. Descargue o clone la versión necesaria de la herramienta del administrador Ally desde github.

    1. Descarga como un archivo ZIP
      1. Cambie la versión de la rama, si es necesario.
      2. Revise el archivo version.php para saber si la versión (release) y el número de versión de Moodle ("requiere" [requires]) necesarios coinciden con su versión de Moodle. Es decir, para Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La versión "3.4.3" debería funcionar con la instalación de Moodle 3.4. Si estos parámetros no coinciden con su instalación de Moodle, es posible que tenga que cambiar la rama otra vez.

        Más información sobre los números de versión y las versiones de Moodle correspondientes

      3. Descargue el repositorio mediante "Clonar o descargar > Descargar ZIP"
    2. Clonación del repositorio git
      1. Acceda a la carpeta de herramientas

        cd [moodle location]/admin/tool

      2. Clone el repositorio
        • Con SSH

          git clone [email protected]:blackboard-open-source/moodle-tool_ally ally

        • Con HTTP

          git clone https://github.com/blackboard-open-source/moodle-tool_ally.git ally

      3. Active la rama correspondiente, es decir, para Moodle 3.4, es MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        La activación de la rama se puede utilizar también para obtener actualizaciones. Por lo tanto, si actualizó su instalación de Moodle, puede solo activar la rama correspondiente. Si no se encuentra la rama, es posible que su repositorio esté desactualizado. Esto se pude solucionar con una búsqueda:

        git fetch

  2. Descargue o clone la versión necesaria del filtro de Ally desde github.

    1. Descarga como un archivo ZIP
      1. Cambie la versión de la rama, si es necesario.
      2. Revise el archivo version.php para saber si la versión (release) y el número de versión de Moodle ("requiere" [requires]) necesarios coinciden con su versión de Moodle. Es decir, para Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La versión "3.4.3" debería funcionar con la instalación de Moodle 3.4. Si estos parámetros no coinciden con su instalación de Moodle, es posible que tenga que cambiar la rama otra vez.

        Más información sobre los números de versión y las versiones de Moodle correspondientes.

      3. Descargue el repositorio mediante "Clonar o descargar > Descargar ZIP"
    2. Clonación del repositorio git
      1. Acceda a la carpeta de filtros

        cd [moodle location]/filter

      2. Clone el repositorio
        • Con SSH

          git clone [email protected]:blackboard-open-source/moodle-filter_ally ally

        • Con HTTP

          git clone https://github.com/blackboard-open-source/moodle-filter_ally.git ally

      3. Active la rama correspondiente, es decir, para Moodle 3.4, es MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        La activación de la rama se puede utilizar también para obtener actualizaciones. Por lo tanto, si actualizó su instalación de Moodle, puede solo activar la rama correspondiente. Si no se encuentra la rama, es posible que su repositorio esté desactualizado. Esto se pude solucionar con una búsqueda:

        git fetch

  3. Descargue la versión necesaria de la herramienta de LTI de informes de Ally desde github.

    1. Descarga como un archivo ZIP
      1. Cambie la versión de la rama, si es necesario.
      2. Revise el archivo version.php para saber si la versión (release) y el número de versión de Moodle ("requiere" [requires]) necesarios coinciden con su versión de Moodle. Es decir, para Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La versión "3.4.3" debería funcionar con la instalación de Moodle 3.4. Si estos parámetros no coinciden con su instalación de Moodle, es posible que tenga que cambiar la rama otra vez.

        Más información sobre los números de versión y las versiones de Moodle correspondientes.

      3. Descargue el repositorio mediante "Clonar o descargar > Descargar ZIP"
    2. Clonación del repositorio git
      1. Acceda a la carpeta de informes

        cd [moodle location]/report

      2. Clone el repositorio
        • Con SSH

          git clone [email protected]:blackboard-open-source/moodle-report_allylti ally

        • Con HTTP

          git clone https://github.com/blackboard-open-source/moodle-report_allylti.git ally

      3. Active la rama correspondiente, es decir, para Moodle 3.4, es MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        La activación de la rama se puede utilizar también para obtener actualizaciones. Por lo tanto, si actualizó su instalación de Moodle, puede solo activar la rama correspondiente. Si no se encuentra la rama, es posible que su repositorio esté desactualizado. Esto se pude solucionar con una búsqueda:

        git fetch

  4. Verifique la estructura de la carpeta.

    El directorio de herramientas del administrador debe tener el nombre ally. Su ruta debe ser la siguiente:

    [yourmoodledir]/admin/tool/ally

    El directorio de filtros debe tener el nombre ally. Su ruta debe ser la siguiente:

    [yourmoodledir]/filter/ally

    El directorio de informes debe tener el nombre allylti. Su ruta debe ser la siguiente:

    [yourmoodledir]/report/allylti

  5. Asegúrese de que su servidor web puede leer cada carpeta junto con su contenido.
  6. Inicie sesión como usuario administrador en su sitio de Moodle y abra la página del administrador. Esto debería verificar si existen complementos nuevos y presentarle una opción para Actualizar la base de datos de Moodle ahora. Seleccione este botón para instalar los complementos.
  7. Después de instalar los complementos, navegue hasta Administración del sistema > Complementos > Herramientas del administrador > Ally.
  8. Seleccione Configuración automática del servicio web de Ally.

    En la siguiente pantalla, encontrará un token de servicio web y una URL para probar el servicio web de Ally.

    Es necesario poder acceder a esta URL directamente desde Internet para que Ally pueda usarla.

    Si tiene éxito, tendrá que copiar el token de servicio web de Ally y el enlace del servicio web y proporcionárselos a su asesor técnico de Ally a través de IronBox. Ellos se encargarán de la configuración y le brindarán acceso a este a través de un enlace de correo electrónico. Se comunicarán con usted una vez realizada su parte de la configuración y le darán la "clave", el "secreto", la "URL de inicio", la "URL de actualizaciones de archivos" y el "ID de cliente".

    Si su instancia de Moodle utiliza campos obligatorios personalizados para las cuentas de los usuarios, "inicie sesión como" el usuario del servicio web de Ally creado por el complemento de configuración automática, para asegurarse de que dichos campos personalizados se completen y se guarden.


Configuración del complemento de Moodle

El asesor técnico de Ally creará el cliente de Ally utilizando el token de servicio web de Moodle que se generó en la sección anterior y le brindará los detalles para la configuración del complemento de Ally.

  1. Inicie sesión como administrador de Moodle.
  2. En Administración del sitio, seleccione Complementos y Herramientas del administrador. Haga clic en Configuración de Ally.
  3. Escriba los siguientes detalles
    • Autores del contenido: los roles de usuario que son autores del contenido. Debe ser alguno de los siguientes: Gerente, Creador del curso, Profesor (los predeterminados).

      Normalmente, esto no debería tener que cambiarse. No lo haga sin consultar antes con el asesor técnico de Ally.

    • Clave: la clave de LTI que proporcionó el asesor técnico de Ally.
    • Secreto: el secreto de LTI que proporcionó el asesor técnico de Ally.
    • URL de inicio: la URL de inicio de LTI que proporcionó el asesor técnico de Ally.
    • URL de actualización de archivos: la URL de actualización de archivos que proporcionó el asesor técnico de Ally. https://[AllyEnvironment].ally.ac/api/v1/events
    • ID de cliente: el ID de cliente que proporcionó el asesor técnico de Ally.
  4. Guarde los cambios.

Informe de la institución de Ally

Una vez configurado el complemento de Ally, podrá acceder al Informe de la institución de Ally.

No se presentarán datos en el informe hasta que se haya producido la sincronización del curso de Ally y se haya generado el informe inicial.

Para acceder al Informe de la institución de Ally, vaya a Administración del sitio y seleccione Informes. Seleccione Accesibilidad.

Más información sobre el Informe institucional de Ally


Filtro de Ally

Cuando esté listo para que se active la disponibilidad de la opción de descarga de la versión alternativa accesible y los indicadores de calificación de accesibilidad de Ally dentro de Moodle, tendrá que activar el filtro de Ally.

Habilitar el filtro de Ally

  1. En Administración del sitio, seleccione Complementos y Descripción general de los complementos.
  2. Baje hasta la sección Filtros de texto y habilite el filtro de Ally.
  3. Traslade el filtro de Ally a la parte superior de la lista Filtros.

Acceder a la UI de la Configuración de Ally

Le brindamos las instrucciones sobre cómo acceder a la Configuración de Ally durante este proceso. Si no tiene acceso, envíe una solicitud en Behind the Blackboard.

Configuración de Ally: cursos


Configuración de cursos

Diríjase a la página Configuración de Ally y active Ally para todos los cursos o elija uno por uno. Depende de usted.

  1. Vea cuántos de sus cursos usan Ally.
  2. Active o desactive Ally en todos los cursos actuales. Decida con anticipación si desea tenerlo habilitado para todos los cursos futuros.
  3. Busque cursos individuales o filtre todos los cursos por habilitado, deshabilitado y período.
  4. Active o desactive Ally en cursos individuales.

Active o desactive Ally en un único curso

Cuando Ally está activado, los profesores y estudiantes se benefician con las calificaciones de accesibilidad, los comentarios para el profesor y los formatos alternativos que ofrece.

El informe institucional está disponible para todos los cursos. No importa si Ally está activado en un curso o no. El curso aparece en el informe institucional.

En Configuración de Ally, busque el curso que desea actualizar. Use el campo Buscar y los filtros para buscar por título, identificador o código del curso.

Seleccione Habilitar o Deshabilitar en la columna Habilitado para activar o desactivar Ally.

  • Ally está desactivado: Seleccione Habilitar integración con UI del curso para activarlo.
  • Ally está activado: Seleccione Deshabilitar integración con UI del curso para desactivarlo.

Active o desactive Ally en todos los cursos

¿No sabe con certeza si todos los cursos usan Ally o no? Al principio de la página de configuración de Ally, puede ver cuántos cursos usan Ally en ese momento.

Cuando Ally está activado, los profesores y estudiantes se benefician con las calificaciones de accesibilidad, los comentarios para el profesor y los formatos alternativos que ofrece.

El informe institucional está disponible para todos los cursos. No importa si Ally está activado en un curso o no. El curso aparece en el informe institucional.

Puede activar o desactivar Ally en cada uno de los cursos actuales desde la página de configuración de Ally. Seleccione Deshabilitar/habilitar todos los cursos y seleccione Deshabilitar o Habilitar.

Seleccione Habilitar en cursos futuros si desea que Ally se active automáticamente en todos los cursos nuevos.

Si no selecciona esta opción, no se habilitará Ally en los cursos nuevos. Si desea que Ally se active más adelante, active Ally en cursos individuales.

Después de elegir deshabilitar o habilitar Ally en todos los cursos, debe confirmar la acción. Seleccione Habilitar o Deshabilitar, según lo que desee. Seleccione Cancelar si cambió de idea y no quiere modificar nada.


Active Ally únicamente en todos los cursos nuevos

Cuando Ally está activado, los profesores y estudiantes se benefician con las calificaciones de accesibilidad, los comentarios para el profesor y los formatos alternativos que ofrece.

El informe institucional está disponible para todos los cursos. No importa si Ally está activado en un curso o no. El curso aparece en el informe institucional.

Seleccione Habilitar en cursos futuros si desea que Ally se active automáticamente en todos los cursos nuevos.

Si no selecciona esta opción, no se habilitará Ally en los cursos nuevos. Si desea que Ally se active más adelante, active Ally en cursos individuales.

Configuración de Ally: ajustes de la ayuda


Establezca los ajustes de la ayuda para los usuarios de Ally

Configure los mensajes de ayuda personalizados que se muestran en las modalidades Formatos alternativos y Comentarios para el profesor. Los mensajes de ayuda personalizados se pueden usar para dirigir a los estudiantes y los profesores a la documentación institucional existente, compartir información de contacto, entre otras cosas. Se puede configurar el contenido de ayuda personalizado en la interfaz de usuario Configuración de Ally y utilizar el formato Markdown para transmitir un mensaje estructurado (y accesible).

En los casos en los que no se ha configurado un mensaje personalizado, los enlaces de Ayuda dirigen a estas páginas en la ayuda de Blackboard:

  1. Vaya a Configuración de Ally y haga clic enAjustes de la Ayuda.
  2. Elija la opción de ayuda personalizada o predeterminada tanto para la ayuda de Formatos alternativos como para la ayuda de Comentarios para el profesor.
  3. Si selecciona la opción personalizada, edite el Mensaje personalizado.

    Use el formato Markdown para ayudar a transmitir un mensaje estructurado (y accesible).

  4. Seleccione Guardar cambios.

Realice una configuración para obtener ayuda de expertos

Ofrezca a sus profesores y estudiantes acceso fácil a su equipo de expertos en accesibilidad. Habilite la ayuda de expertos para que los usuarios soliciten más ayuda directamente desde los paneles de formatos alternativos y comentarios para el profesor.

Cuando se realiza una solicitud, se envía un correo electrónico con la solicitud de ayuda y los detalles sobre el curso actual, el elemento de contenido y el usuario a la dirección de correo electrónico que estableció.

  1. Vaya a Configuración de Ally y haga clic en Ajustes de la Ayuda.
  2. Elija la opción Proporcionar ayuda personalizada tanto para la ayuda de formatos alternativos como para la de comentarios para el profesor.
  3. Seleccione Habilitar la ayuda de expertos.
  4. Escriba la dirección de correo electrónico de su equipo de expertos en accesibilidad.
  5. Seleccione Guardar cambios.

El usuario de la API de Ally para la integración de Blackboard Learn debe obtener el permiso "Administrator Panel (Users) > Users" o "system.user.view" para que Ally incluya el nombre del estudiante y la dirección de correo electrónico en el correo electrónico de solicitud de ayuda. El usuario de la API de Ally para la integración de Moodle debe obtener el permiso "moodle/user:viewalldetails" para que Ally incluya el nombre del estudiante y la dirección de correo electrónico en el correo electrónico de solicitud de ayuda.


Configurar el informe de accesibilidad del curso en Blackboard Open LMS

Esta función solo se encuentra disponible para Blackboard Open LMS en este momento. Para que el informe de accesibilidad del curso esté disponible en Moodle, se requiere una actualización de los complementos Moodle de Ally. Esta actualización estará disponible en las próximas semanas, y se enviará un anuncio de lanzamiento diferente.