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.

Ally Configure Courses


Configure courses

Go to your Ally Configuration page and turn Ally on for all courses or decide course-by-course. It's up to you.

  1. View how many of your courses use Ally.
  2. Turn Ally on or off for all existing courses. Decide ahead of time if you want it enabled for all future courses as well.
  3. Search for individual courses or filter all course by enabled, disabled, and term.
  4. Turn Ally on or off for individual courses.

Turn Ally on or off for a single course

When Ally is on, instructors and students benefit from the accessibility scores, instructor feedback and alternative formats that Ally provides.

The Institutional report is available for all courses. It doesn't matter if Ally is on or off in a course. The course appears in the Institutional report.

From Ally Configuration, find the course you want to update. Use the Search field and filters to search by course title, course ID and course code.

Select Enable or Disable under the Enabled column to turn Ally on or off.

  • Ally is off: Select Enable course UI integration to turn on
  • Ally is on: Select Disable course UI integration to turn off

Turn Ally on or off for all courses

Not sure if all courses are using Ally or not? At the top of the Ally Configuration page, see how many of your courses are currently using Ally.

When Ally is on, instructors and students benefit from the accessibility scores, instructor feedback and alternative formats that Ally provides.

The Institutional report is available for all courses. It doesn't matter if Ally is on or off in a course. The course appears in the Institutional report.

You can turn Ally on or off in every existing course from the Ally Configuration page. Select Disable/enable all courses and select Disable or Enable.

Select Enable in future courses if you want Ally automatically on in all new courses.

If you don't select this, new courses will not have Ally enabled. If you want Ally on at a later date, turn Ally on for single courses.

After you choose to disable or enable in all courses, you need to confirm your choice. Select Enable or Disable, depending on your choice. Select Cancel if you changed your mind and don't want to change anything.


Turn Ally on for all new courses only

When Ally is on, instructors and students benefit from the accessibility scores, instructor feedback and alternative formats that Ally provides.

The Institutional report is available for all courses. It doesn't matter if Ally is on or off in a course. The course appears in the Institutional report.

Select Enable in future courses if you want Ally automatically on in all new courses.

If you don't select this, new courses will not have Ally enabled. If you want Ally on at a later date, turn Ally on for single courses.

Ally Configure Help Settings


Configure Ally user help settings

Configure custom help messages that display in the Alternative formats and Instructor feedback modals. The custom help messages can be used to point students and instructors to existing institutional documentation, share contact information, and so on. The custom help content can be configured in the Ally Configuration UI, and uses the Markdown format to help provide a structured (and accessible) message.

When no custom message has been configured, the Help links point to these pages in Blackboard help:

  • Alternative formats: This page explains how and when the different alternative formats can be used
  • Instructor help: Everything instructors need to know about Ally in their courses
  1. Go to your Ally Configuration and select Help settings.
  2. Choose the default or custom help option for both the Instructor feedback help and Alternative formats help.
  3. If you choose the custom option, edit the Custom message.

    Use the Markdown format to help provide a structured (and accessible) message.

  4. Select Save changes.

Configure expert help

Give your instructors and students easy access to your team of accessibility experts. Enable expert help to add a way for your users to request more help directly from in the alternative formats and instructor feedback panels.

When a request is made, an email containing the help request and details about the current course, content item and user is sent to the email address you configure.

  1. Go to your Ally Configuration and select Help settings.
  2. Choose Provide custom help for both the Instructor feedback help and Alternative formats help.
  3. Select Enable expert help.
  4. Type the email address for your team of accessibility experts.
  5. Select Save changes.

The Ally API user for the Blackboard Learn integration needs to be given the "Administrator Panel (Users) > Users" or "system.user.view" permission to allow Ally to include the student name and email address in the help request email. The Ally API user for the Moodle integration needs to be given the “moodle/user:viewalldetails” permission to allow Ally to include the student name and email address in the help request email.

Request alternative formats help

Request instructor feedback help