• Comunicación con JavaScript desde una escena Descartes a la API de una plataforma educativa vía paquete Scorm

    Elena Álvarez nos enseñaba en un post (elaboración Scorm con Reload) el modo de usar las funciones de comunicación de Descartes que, mediante la inclusión de un iFrame (véase este artículo) en una escena de descartes, nos permitía elaborar un paquete Scorm funcional y capaz de pasar parámetros (la nota, por ejemplo) a una plataforma educativa (por ejemplo Moodle).

    En un anterior post mío indicaba el modo de comunicar mediante instrucciones de JavaScript una escena de descartes con una página web totalmente independiente. En el ejemplo que exponía pasábamos 6 parámetros a una página independiente o, incluso, podíamos pasar parámetros a Google Maps con JavaScript. Véase post explicativo

    Tenemos otro modo de comunicar una escena de Descartes-JS con la API de la plataforma educativa (Mooddle, por ejemplo) usando directamente JavaScript.  He realizado un paquete scorm con una actividad (con test) desde un punto de vista diferente al realizado por la compañera Elena Álvarez.

    En este caso, la escena de descartes (descartes.html) es la que está embebida (como un iframe) en la página padre (index.html) y se envía la información a través de dos botones incluidos en la escena de Descartes (comunicación entre una escena descartes y una página web) que en este caso se denominan «validar nota» y «finalizar».

    En este caso, no necesitamos ningún fichero.js ni librería adicional ya que los scripts necesarios para la comunicación con el API de la plataforma educativa se encuentran en la página index.html, en la que podemos añadir otras funcionalidades.

    Por otra parte, podemos enviar otro tipo de información adicional (bien desde la propia escena.html descartes, o bien desde la página index.html, según convenga) como el tiempo que duró la realización del test o la visualización de la escena, número de tentativas realizadas…

    En la escena debemos incluir una variable llamada nota4  y otra llamada Score (el nombre de estas variables, lógicamente, los podemos cambiar) que será el resultado del cálculo de la nota final de la escena en un algoritmo de descartes:

    nota4=’getElementById(cogenota).value = Score’

    Aspecto del algoritmo

    Lo que hace el algoritmo es depositar el resultado (Score) en el elemento de la página index.html identificado como «cogenota» (que está oculto).

    Si descomprimimos el paquete scorm que adjunto, podemos simplificar mucho su elaboración, ya que simplemente deberíamos sustituir la página escena.html por otra con el mismo nombre adicionando estos dos botones:
    id=’n37′ tipo=’numérico’ interfaz=’botón’ región=’interior’ espacio=’E5′ nombre=’Validar respuestas’ expresión='(160,150,140,30)’ fijo=’sí’ visible=’sí’ color=’blanco’ color-int=’rojo’ negrita=’sí’ subrayada=’sí’ fuente puntos=’14’ acción=’abrir URL’ parámetro=’javascript:void(parent.document.getElementById(&squot;cogenota&squot;).innerHTML=[Score]);’

    Botón «Validar respuestas». El código se inserta en «Abrir URL» de la escena de Descartes

    La función parent.document.getElementById(«cogenota»).innerHTML=[Score] toma la nota de la página index.html.

    y

    id=’n47′ tipo=’numérico’ interfaz=’botón’ región=’interior’ espacio=’E5′ nombre=’Finalizar’ expresión='(300,150,80,30)’ fijo=’sí’ visible=’sí’ color=’blanco’ color-int=’azul’ negrita=’sí’ subrayada=’sí’ fuente puntos=’14’ acción=’abrir URL’ parámetro=’javascript:void(window.parent.SetScormScore());’ pos_mensajes=’centro’

    Botón «Finalizar». El código lo colocamos en «Abrir URL» de Descartes

    La función window.parent.SetScormScore(),  envía la nota al core de Moodle (por ejemplo) .
    Para finalizar, metemos la escena.html en el scorm (arrastrar y soltar) y, si es necesario, modificamos las dimensiones del iframe en index.html para que se adapte a las dimensiones de la simulación.
    La escena.html se puede abrir perfectamente en el editor de Descartes (la he abierto muchas veces y no se perdió información).
    Adjunto el scorm para que se pruebe (lo podéis descomprimir y cambiar la escena), se hicieron pruebas en Moodle 2.6++ y 3.0.1 y funcionó bien.

    Podéis bajar el Scorm en: Bajada del scorm
    También podéis añadir el paquete scorm como «paquete bajado»  en las definiciones de Moodle desde la dirección anterior en:

    https://www.reddescartes.org/repositorio/pasovariableswebindep-JS/scorm_descartes.zip

     

  • Paso de parámetros desde una escena Descartes a una web independiente

    Paso de parámetros desde una escena de Descartes a otra página web totalmente independiente (no iframe)

    En muchas páginas web se pasan parámetros a otra página independiente, lo que hacemos cuando buscamos en google es precisamente eso, indicamos una palabra (o más) en el buscador y esa palabra es pasada como parámetro a la página que mostrará los resultados de la búsqueda. Por ejemplo si en el buscador introducimos «descartes», veremos en la barra de direcciones lo siguiente:

    https://www.google.es/#q=descartes

    Es decir la variable q de búsqueda toma el valor de «descartes»
    Descartes tiene la opción de abrir una URL desde un botón y esta opción la podemos aprovechar para pasar parámetros a otras páginas web independientes preparadas para recibirlos.
    En javaScript existe la opción de usar href (la referencia a una página web) para ejecutar código en javaScript. Escribe este código y comprueba sus resultados:

    <!DOCTYPE html><html><head><title>Paso de parámetro</title><meta http-equiv=»Content-Type» content=»text/html; charset=iso-8859-1″ /><script type=»text/javascript»>function mostrarMensaje() {alert(‘Somos cartesianos. Lo que parecía un link en realidad es código en JavaScript’);} 

    </script>

    </head>

    <body>

    <h2>Cursosdescartes.com</h2>

    <h3>Ejemplo JavaScript</h3>

    <a href=»javascript:mostrarMensaje();»> Pulsa aquí por favor </a>

    </body></html>

    Pruébala aquí

    El operador void()

    Podemos usar el operador void para especificar una expresión como si fuera un enlace de hipertexto. Prueba este código:

     

    <!DOCTYPE html><html><head><title>Paso de parámetros</title><meta http-equiv=»Content-Type» content=»text/html; charset=iso-8859-1″ /><script type=»text/javascript»>function mostrarMensaje() {alert(‘Somos cartesianos. Lo que parecía un link en realidad es código en JavaScript’); 

    }

    </script>

    </head>

    <body><h2>Cursosdescartes.com</h2>

    <h3>Ejemplo JavaScript</h3>

    <a href=»javascript:void(mostrarMensaje())»>Pulsa otra vez aquí, por favor </a>

    </body>

    </html>

    Puébalo aquí

    En la escena descartes

    Ahora, probemos esto en descartes. Desde el editor vamos a hacer un botón que al abrirse nos muestre este mensaje. El botón tendrá la acción de abrir una URL e introduciremos el siguiente código en JavaScript:

    javascript:void(alert(‘Somos cartesianos. Lo que parecía un link en realidad es código en JavaScript’));

    Aspecto del editor de descartes

    Pruébalo aquí

    Podemos, por tanto, a través de este sistema pasar parámetros a otras páginas (preparadas) desde una escena de descartes.

    Dejo aquí una escena para que veáis las posibilidades:

    Aquí os dejo un fichero comprimido con los archivos preparados para que lo investiguéis.

    Archivos comprimidos

  • Botones

    En el panel Botones se encuentran los campos para la configuración general de la escena, que son cuatro selectores para indicar si los botones de créditos, config, inicio y limpiar deben ser visibles o no, y cuatro campos de texto para controlar el tamaño de las cuatro regiones que rodean la escena, mismas en donde puede haber controles numéricos. Los dos primeros son para determinar el número mínimo de filas de controles numéricos que tendrán las regiones norte y sur, y los otros dos son para determinar la anchura en pixeles de las regiones oeste y este.

    panel_botones

    A continuación se detalla el significado de estos estos campos:

    créditos
    Determina si el botón «créditos» aparece en la escena.
    El botón «créditos» abre una ventana que tiene vínculos a la página principal de Descartes y muestra los nombres delos autores del applet.
    Por defecto está seleccionado.
    config
    Determina si el botón «config» aparece en la escena.
    El botón «config» abre la ventana de edición en la que se puede modificar la configuración de la escena.
    Por defecto está seleccionado.
    inicio
    Determina si el botón «inicio» aparece en la escena.
    El botón «inicio» devuelve la escena a su estado inicial reiniciando los valores de los controles auxiliares. Si hay animación automática, ésta comienza de nuevo.
    Por defecto está seleccionado.
    limpiar
    Determina si el botón «limpiar» aparece en la escena.
    El boton «limpiar» borra los rastros dejados por las gráficas que tienen la opción «rastro» activada.
    Por defecto está seleccionado.
    filas_norte
    filas_sur
     
    Número de filas que ocuparán los controles numéricos colocados en la región Norte/Sur.
    Si el valor es cero entonces (de haberse creado un control al norte/sur) habrá por lo menos una fila, si no, no habrá ninguna.
    El valor por defecto es cero.
    ancho_oeste
    ancho_este
    Ancho en pixeles de la región Oeste/Este para controles numéricos.
    El valor por defecto es 150, lo que quiere decir que si hay al menos un control numérico en la región Oeste/Este, entonces se adopta por defecto un valor de 150.
    alto
    Altura en pixeles de los controles numéricos en las regiones norte y sur. El valor predeterminado es 40.
    editor
    Activa (o desactiva) la edición por parte del usuario. Por defecto está activado.
    audio
    Activa la posibilidad de usar sonido en una escena.
    álgebra
    Activa la posibilidad de usar espacios algebraicos, aunque en la actualidad DescartesJS no contempla este tipo de espacios.
    RAD
    Activa el Registro de Actividades de Descartes para esta escena. Actualmente no contemplado para DescartesJS.
    infoind
    Área de texto para definir un texto con expresiones numéricas que describan el desempeño de un alumno en esta escena. No contemplado para DescartesJS.
    infoest
    Área de texto para definir un texto con expresiones que indiquen el comportamiento estadístico de la escena ante un grupo de alumnos. Ncontemplado para DescartesJS.
    signo decimal
    Permite elegir el signo decimal, es decir el símbolo que separa los enteros de los decimales en una expresión decimal, para su representación en un texto o en un campo de texto. Internamente, en el código de la escena, ha de usarse siempre el punto decimal como separador decimal.
    En España la RAE establece el uso de la coma, aunque se permite el punto utilizado en otros países.
    antialias
    Selector que activa (o desactiva) la propiedad de que los gráficos se dibujen suavemente. Por defecto está activado.