Merge branch 'DEV' into 4234

7 files changed, 169 insertions, 125 deletions

diff --git a/docs/CeibalEncuesta_tutorial_para_Encuestadores.odt b/docs/CeibalEncuesta_tutorial_para_Encuestadores.odt
new file mode 100644
index 0000000..aa087b2
--- /dev/null
+++ b/docs/CeibalEncuesta_tutorial_para_Encuestadores.odt
diff --git a/docs/CeibalEncuesta_tutorial_para_Encuestadores.pdf b/docs/CeibalEncuesta_tutorial_para_Encuestadores.pdf
new file mode 100644
index 0000000..7ad8d9c
--- /dev/null
+++ b/docs/CeibalEncuesta_tutorial_para_Encuestadores.pdf
diff --git a/webapp/polls/models.py b/webapp/polls/models.py
index 840b50c..561a607 100644
--- a/webapp/polls/models.py
+++ b/webapp/polls/models.py
@@ -859,10 +859,12 @@ class Field(AbstractObject, ComponentStructure):
                 self.errors += [msg]
                 self.dependence['values'] = dependence.values
 
-        # TODO: Test
         if not self.name:
             msg = "Necesita ingresar una pregunta"
             self.errors.append(msg)
+        elif ";" in self.name:
+            msg = "Las preguntas no pueden contener ';'"
+            self.errors.append(msg)
 
         if self.uploaded_file:
             try:
diff --git a/webapp/polls/tests/field_tests.py b/webapp/polls/tests/field_tests.py
index 8609357..aea616a 100644
--- a/webapp/polls/tests/field_tests.py
+++ b/webapp/polls/tests/field_tests.py
@@ -168,6 +168,15 @@ class FieldTests(MongoTestCase):
         self.assertEqual('field_0', self.field.name)
         self.assertEqual(Field.TextInput, self.field.widget_type)
 
+    def test_valid_field_name(self):
+        field = self.field
+
+        field.name = ""
+        self.assertRaises(Field.ValidationError, field.validate)
+
+        field.name = ";"
+        self.assertRaises(Field.ValidationError, field.validate)
+
     def test_invalid_widget_type(self):
         field_factory = lambda: Field({
             'name': "field_0",
diff --git a/webapp/polls/tests/structure_tests.py b/webapp/polls/tests/structure_tests.py
index cd10d56..4f28dd5 100644
--- a/webapp/polls/tests/structure_tests.py
+++ b/webapp/polls/tests/structure_tests.py
@@ -129,6 +129,25 @@ class StructureTests(MongoTestCase):
 
         self.assertEqual(2, len(group_1.errors))
 
+    def test_not_valid_question_name(self):
+        data = {
+            'groups': {
+                '0': {
+                    'name': 'group_0',
+                    'fields': {
+                        '0': {
+                            'widget_type': 'TextInput',
+                            'name': ';'
+                        },
+                    }
+                }
+            }
+        }
+
+        structure = Structure(data=data, poll=self.poll)
+
+        self.assertFalse(structure.is_valid())
+
     def test_invalid_structure(self):
         data = {}
 
diff --git a/webapp/webapp/settings.py b/webapp/webapp/settings.py
index 40584b3..865817b 100644
--- a/webapp/webapp/settings.py
+++ b/webapp/webapp/settings.py
@@ -72,7 +72,7 @@ STATICFILES_DIRS = (
     # Put strings here, like "/home/html/static" or "C:/www/django/static".
     # Always use forward slashes, even on Windows.
     # Don't forget to use absolute paths, not relative paths.
-    '/home/code/activity_central/polls/webapp/webapp/static',
+    os.path.join(PROJECT_ROOT, 'static'),
 )
 
 # List of finder classes that know how to find static files in
diff --git a/webapp/webapp/static/tutorial/index.html b/webapp/webapp/static/tutorial/index.html
index 1e7b3cf..42b1740 100644
--- a/webapp/webapp/static/tutorial/index.html
+++ b/webapp/webapp/static/tutorial/index.html
@@ -137,22 +137,40 @@
               <ul class="nav">
                 <li class="divider-vertical"></li>
                 <li class="dropdown">
-                  <a href="#" class="dropdown-toggle" data-toggle="dropdown"><i class="icon-white icon-check"></i>&nbsp;Procedimientos&nbsp;<b class="caret"></b></a>
-                  <ul class="dropdown-menu">
+                  <a href="#" class="dropdown-toggle" data-toggle="dropdown"><i class="icon-white icon-check"></i>&nbsp;Tareas de Administrador&nbsp;<b class="caret"></b></a>
+		  <ul class="dropdown-menu">
+                    
                     <li class="">
-                      <a href="#instalacion-de-la-aplicacion"><i class="icon-check"></i>&nbsp;Instalación de la aplicación CeibalEncuesta</a>
-                    </li>
-                    <li class="">
-                      <a href="#inicio-de-la-aplicacion"><i class="icon-check"></i>&nbsp;Inicio de la aplicacion CeibalEncuesta</a>
+                      <a href="#creacion-de-usuarios"><i class="icon-check"></i>&nbsp;Creacion de usuarios</a>
                     </li>
                     <li class="">
-                      <a href="#cambio-de-alumno"><i class="icon-check"></i>&nbsp;Cambio de Alumno o Grupo</a>
+                      <a href="#eliminacion-de-encuesta"><i class="icon-check"></i>&nbsp;Eliminación de Encuesta</a>
                     </li>
-                    <li class="">
-                      <a href="#creacion-de-usuarios"><i class="icon-check"></i>&nbsp;Creacion de usuarios</a>
+                  </ul>
+		</li>
+		
+
+		<li class="dropdown">
+		  <a href="#" class="dropdown-toggle" data-toggle="dropdown"><i class="icon-white icon-check"></i>&nbsp;Tareas de Investigador&nbsp;<b class="caret"></b></a>
+		   <ul class="dropdown-menu">
+		      <li class="">
+			<a href="#creacion-de-encuestas"><i class="icon-check"></i>&nbsp;Creacion de Encuestas</a>
+                      </li>
+		      <li class="">
+			 <a href="#visualizacion-de-resultados"><i class="icon-check"></i>&nbsp;Visualización de resultados</a>
+                      </li>
+		   </ul>
+		</li>
+
+
+		<li class="dropdown">
+		  <a href="#" class="dropdown-toggle" data-toggle="dropdown"><i class="icon-white icon-check"></i>&nbsp;Tareas de Encuestador&nbsp;<b class="caret"></b></a>
+		  <ul class="dropdown-menu">
+		    <li class="">
+                      <a href="#instalacion-de-la-aplicacion"><i class="icon-check"></i>&nbsp;Instalación de la aplicación CeibalEncuesta</a>
                     </li>
                     <li class="">
-                      <a href="#creacion-de-encuestas"><i class="icon-check"></i>&nbsp;Creacion de Encuestas</a>
+                      <a href="#inicio-de-la-aplicacion"><i class="icon-check"></i>&nbsp;Inicio de la aplicacion CeibalEncuesta</a>
                     </li>
                     <li class="">
                       <a href="#descarga-de-encuestas"><i class="icon-check"></i>&nbsp;Descarga de Encuestas</a>
@@ -163,16 +181,16 @@
                     <li class="">
                       <a href="#completado-de-encuestas"><i class="icon-check"></i>&nbsp;Completado de Encuestas</a>
                     </li>
-                    <li class="">
-                      <a href="#visualizacion-de-resultados"><i class="icon-check"></i>&nbsp;Visualización de resultados</a>
+		    <li class="">
+                      <a href="#cambio-de-alumno"><i class="icon-check"></i>&nbsp;Cambio de Alumno o Grupo</a>
                     </li>
-                    <li class="">
+		     <li class="">
                       <a href="#continuar-una-encuesta"><i class="icon-check"></i>&nbsp;Continuar una encuesta inconclusa</a>
                     </li>
-                    <li class="">
-                      <a href="#eliminacion-de-encuesta"><i class="icon-check"></i>&nbsp;Eliminación de Encuesta</a>
-                    </li>
-                  </ul>
+		   </ul>
+		</li>
+		  
+                  
                 </li>
               </ul>
             </div>
@@ -234,88 +252,103 @@
           </div>
         </div>
         <div id="procedimientos">
-          <h2>Procedimientos</h2>
+          <h2>Tareas de Admnistrador</h2>
+	  <h3 class="anchor" id="creacion-de-usuarios"> Creación de usuarios</h3>
+          <ol>
+            <li>Ingresa a: http://encuesta.ceibal.edu.uy, usuario = admin, contraseña = xxxx</li>
+            <li>Crea uno/varios usuarios con el rol de "Investigador"</li>
+            <li>Crea uno/varios usuarios con el rol "Encuestadores"</li>
+	  </ol>
+
+	  <h3 class="anchor" id="eliminacion-de-encuesta">Eliminación de encuesta, limpieza de archivos de la XO.</h3>
+          <p>
+            <strong>Nota</strong>
+          </p>
+          <p>
+          Para poder completar una nueva encuesta en una XO que se uso previamente es necesario eliminar el archivo de encuesta en la XO.
+          Este archivo se guarda como medida de precaución para evitar perder los datos completados por los niños en el caso de que pendrive se dañe y se pierda el archivo de resultados.
+          </p>
+
+          <ol>
+            <li>Asegurese de que ya se subieron los resultados a la web de la encuesta existente en la XO.</li>
+            <li>Abra el Journal (Diario).</li>
+            <li>Abra la carpeta "Documentos", haciendo click en el icono de la barra inferior a la derecha.</li>
+            <li>Borre el archivo con nombre parecido a: *1372189919113.encuesta*</li>
+	  </ol>
+
+
+	  <h2>Tareas de Investigador</h2>
+	  <h3 class="anchor" id="creacion-de-encuestas">Creación de encuestas</h3>
+        
+          <ol>
+            <li>Ingresa a: http://encuesta.ceibal.edu.uy</li>
+            <li>Pone en el campo usuario/contraseña, los datos de un usuario con rol  de "Investigador".</li>
+            <li>Genera nueva encuesta.</li>
+            <li>Asocia la encuesta creada a los "Encuestadores" correspondientes</li>
+            <li>Una vez finalizada, le cambia el estado a cerrada.</li>
+          </ol>
+
+	  <h3 class="anchor" id="visualizacion-de-resultados">Visualizacion de Resultados</h3>
+
+          <ol>
+            <li>Ingresa a: http://encuesta.ceibal.edy.uy</li>
+            <li>Pone en el campo usuario/contraseña, los datos de un rol  de "Sociologo".</li>
+            <li>Va a "Listado de encuestas".</li>
+            <li>Elije la encuesta deseada y hacer click en el boton "Resultados".</li>
+            <li>A continuación podrá ver los resultados en la web, desplegando cada una de las filas "Encuesta #", que contienen los datos completados por un estudiante.</li>
+            <li>Puede Visualizar preguntas haciendo click en el boton con ese nombre.</li>
+            <li>Puede exportar los resultados en formato CSV para ser visualizados en una planilla de calculo.</li>
+          </ol>
+
+	  <h2>Tareas de Encuestador</h2>
 
           <h3 class="anchor" id="instalacion-de-la-aplicacion">Instalación de la Aplicacion CeibalEncuesta</h3>
           <ol>
            <li><p>Insertar el pendrive con la aplicación en alguno de los puertos USB de la XO.</p></li>
            <li><p>Apretar el botón de “marco” para poder abrir el pendrive.</p>
                  <img class="screenshots" src="img/screenshots/inst-fig1.png">
-                 </li>
-
-           <li><p>En el pendrive habrá tres archivos con diferentes extensiones</p>
+           </li>
+	   <li><p>En el pendrive habrá tres archivos con diferentes extensiones</p>
              <img class="screenshots" src="img/screenshots/inst-fig2.png">
              <ul>
                <li><p>“.XO” es el instalador de la actividad. Una vez que queda instalado en la laptop no es necesario volver a hacerlo.</p></li>
                <li><p>“.json” es el modelo de la encuesta, que contiene las preguntas y opciones.</p></li>
                <li><p>“.csv” existe un archivo con esta extensión distinto para cada centro educativo. En este se incluyen los grupos a encuestar, identificando cuáles son originales o sustitutos.</p>
                </li>
-                   </ul>
+             </ul>
            </li>
            <li><p>Para instalar la aplicación se hace click sobre el archivo con el nombre “CeibalEncuesta-xx.xo”</p></li>
            <li><p>
                Luego volvemos a la vista del “hogar” y vamos a ver la aplicación ya instalada en la laptop (ver figura).
              </p>
-               <img class="screenshots" src="img/screenshots/inst-fig3.png">
+             <img class="screenshots" src="img/screenshots/inst-fig3.png">
            </li>
-          </ol>
+	  </ol>
 
 
           <h3 class="anchor" id="inicio-de-la-aplicacion">Inicio de la Aplicación CeibalEncuesta</h3>
-
-          <ol>
-           <li>
-             <p>Para comenzar a utilizar la aplicación se clickea en el ícono de “Ceibal Encuestas” y se abre la ventana que se detalla en la figura
-             </p>
-             <img class="screenshots" src="img/screenshots/inst-fig4.png">
-           </li>
-           <li><p>Se procede a abrir el archivo que está ubicado en el pendrive con la extensión “.json” en la opción de “modelo de encuesta”. Para la opción de “lista de encuesta” se selecciona el archivo con extensión “.csv”</p></li>
+	  <ol>
+            <li>
+              <p>Para comenzar a utilizar la aplicación se clickea en el ícono de “Ceibal Encuestas” y se abre la ventana que se detalla en la figura</p>
+              <img class="screenshots" src="img/screenshots/inst-fig4.png">
+            </li>
+            <li><p>Se procede a abrir el archivo que está ubicado en el pendrive con la extensión “.json” en la opción de “modelo de encuesta”. Para la opción de “lista de encuesta” se selecciona el archivo con extensión “.csv”</p>
+	    </li>
           </ol>
+	  
+	  <h3 class="anchor" id="descarga-de-encuestas">Descarga de encuestas</h3>
+        
 
-          <h3 class="anchor" id="cambio-de-alumno">Cambio de Alumno o Grupo</h3>
           <ol>
-           <li><p>Presionar “escape” que en el teclado de la XO es el botón con una “cruz” arriba a la izquierda.</p></li>
-           <li><p>Se desplegará un cuadro solicitando un password. La clave es “123” (ver figura)</p>
-           <img class="screenshots" src="img/screenshots/inst-fig5.png">
-           </li>
-           <li><p>Aparecerá una columna a la izquierda en la cual se puede cambiar de grupo y/o de alumno</p></li>
-           <li><p>En el caso de que se desee cambiar de grupo, se cambia la seleccion del grupo y se presiona "Sieguiente Alumno" </p></li>
-           <li><p>En el caso de que se desee encuestar otro alumno del mismo grupo, solemente se presiona "Siguiente Alumno"</p></li>
-           <li><p>En caso de no querer realizar ningún cambio se selecciona la opción “Continuar” para seguir respondiendo la encuesta</p></li>
-               </ol>
-        <h3 class="anchor" id="creacion-de-usuarios"> Creación de usuarios</h3>
-        <p><i>Un usuario con el rol de administrador ...</i></p>
-        <ol>
-          <li>Ingresa a: http://encuesta.ceibal.edu.uy, usuario = admin, contraseña = admin</li>
-          <li>Crea uno/varios usuarios con el rol de "Investigador"</li>
-          <li>Crea uno/varios usuarios con el rol "Encuestadores"</li>
-              </ol>
-
-        <h3 class="anchor" id="creacion-de-encuestas">Creación de encuestas</h3>
-        <p><i>Un usuario con el rol Investigador ....</i></p>
-        <ol>
-          <li>Ingresa a: http://encuesta.ceibal.edu.uy</li>
-          <li>Pone en el campo usuario/contraseña, los datos de un usuario con rol  de "Investigador".</li>
-          <li>Genera nueva encuesta.</li>
-          <li>Asocia la encuesta creada a los "Encuestadores" correspondientes</li>
-          <li>Una vez finalizada, le cambia el estado a cerrada.</li>
-        </ol>
-
-
-        <h3 class="anchor" id="descarga-de-encuestas">Descarga de encuestas</h3>
-        <p><i>Un usuario con el rol de Encuestador ...</i></p>
-
-        <ol>
-          <li>Para este procedimiento <strong>NO USAR EL NAVEGADOR DESDE SUGAR</strong>.</li>
-          <li>Ingresa a: http://encuesta.ceibal.edu.uy</li>
-          <li>Pone en el campo usuario/contraseña los datos de un rol "Encuestador"</li>
-          <li>Va a "Encuestas cerradas" y descarga la encuesta.</li>
-          <li>Copia el archivo .json en un pendrive.</li>
-        </ol>
-
+            <li>Para este procedimiento <strong>NO USAR EL NAVEGADOR DESDE SUGAR</strong>.</li>
+            <li>Ingresa a: http://encuesta.ceibal.edu.uy</li>
+            <li>Pone en el campo usuario/contraseña los datos de un rol "Encuestador"</li>
+            <li>Va a "Encuestas cerradas" y descarga la encuesta.</li>
+            <li>Copia el archivo .json en un pendrive.</li>
+          </ol>       
 
         <h3 class="anchor" id="subida-de-resultados"> Subida de Resultados</h3>
-        <p><i>Un usuario con el rol de Encuestador ...</i></p>
+        
 
         <ol>
           <li>Ingresa a: http://encuesta.ceibal.edu.uy</li>
@@ -326,40 +359,39 @@
         </ol>
 
         <h3 class="anchor" id="completado-de-encuestas">Completado de Encuestas</h3>
-        <p><i>Un usuario con el rol de Encuestador ... </i></p>
-        <p><strong>IMPORTANTE:</strong>  Formatear el pendrive en FAT32 antes usarlo, para asegurarse del formato y dejarlo "limpio".</p>
-        <ol>
-          <li><a href="#descarga-de-encuesta">Descarga una encuesta</a> y la copia en un pendrive</li>
-          <li>Obtiene la lista de grupos y la copia en un pendrive.</li>
-          <li><a href="#eliminacion-de-encuesta">Elimina la encuesta anterior</a></li>
-          <li>Inserta el pendrive en el XO</li>
-          <li>Abre la aplicacion CeibalEncuesta</li>
-          <li>Desde la aplicacion, selecciona la encuesta que esta en el pendribe <strong>(archivo .json)</strong></li>
-          <li>Desde la aplicacion, seleccion la lista de grupo <strong>(archivo .csv)</strong></li>
-          <li>Click en proceder</li>
-          <li>Presiona ESC, luego ingresa 123 en el cuadro, para cambiarse a la vista de "encuestador".</li>
-          <li>En vista encuestador selecciona el grupo.</li>
-          <li>En vista encuesta, el niño completa la encuesta, hasta llegar a la pantalla que dice "Encuesta finalizada"</li>
-          <li>Vuelve al paso 8, hasta completar todos los grupos.</li>
-          <li>Una vez finalizada la encuesta, se pasa  ala vista *encuestador* (ESC y 123) y elije exportar resultados.</li>
-          <li><strong>Elije el directorio para salvar resultados en el *PENDRIVE*</strong></li>
-          <li><a href="#subida-de-resultados">Sube resultados</a></li>
-        </ol>
+        
+          <p><strong>IMPORTANTE:</strong>  Formatear el pendrive en FAT32 antes usarlo, para asegurarse del formato y dejarlo "limpio".</p>
+          <ol>
+            <li><a href="#descarga-de-encuesta">Descarga una encuesta</a> y la copia en un pendrive</li>
+            <li>Obtiene la lista de grupos y la copia en un pendrive.</li>
+            <li><a href="#eliminacion-de-encuesta">Elimina la encuesta anterior</a></li>
+            <li>Inserta el pendrive en el XO</li>
+            <li>Abre la aplicacion CeibalEncuesta</li>
+            <li>Desde la aplicacion, selecciona la encuesta que esta en el pendribe <strong>(archivo .json)</strong></li>
+            <li>Desde la aplicacion, seleccion la lista de grupo <strong>(archivo .csv)</strong></li>
+            <li>Click en proceder</li>
+            <li>Presiona ESC, luego ingresa 123 en el cuadro, para cambiarse a la vista de "encuestador".</li>
+            <li>En vista encuestador selecciona el grupo.</li>
+            <li>En vista encuesta, el niño completa la encuesta, hasta llegar a la pantalla que dice "Encuesta finalizada"</li>
+            <li>Vuelve al paso 8, hasta completar todos los grupos.</li>
+            <li>Una vez finalizada la encuesta, se pasa  ala vista *encuestador* (ESC y 123) y elije exportar resultados.</li>
+            <li><strong>Elije el directorio para salvar resultados en el *PENDRIVE*</strong></li>
+            <li><a href="#subida-de-resultados">Sube resultados</a></li>
+          </ol>
 
-        <h3 class="anchor" id="visualizacion-de-resultados">Visualizacion de Resultados</h3>
-        <p><i>Un usuario con el rol Investigador/Sociólogo ....</i></p>
-        <ol>
-          <li>Ingresa a: http://encuesta.ceibal.edy.uy</li>
-          <li>Pone en el campo usuario/contraseña, los datos de un rol  de "Sociologo".</li>
-          <li>Va a "Listado de encuestas".</li>
-          <li>Elije la encuesta deseada y hacer click en el boton "Resultados".</li>
-          <li>A continuación podrá ver los resultados en la web, desplegando cada una de las filas "Encuesta #", que contienen los datos completados por un estudiante.</li>
-          <li>Puede Visualizar preguntas haciendo click en el boton con ese nombre.</li>
-          <li>Puede exportar los resultados en formato CSV para ser visualizados en una planilla de calculo.</li>
-        </ol>
+          <h3 class="anchor" id="cambio-de-alumno">Cambio de Alumno o Grupo</h3>
+          <ol>
+           <li><p>Presionar “escape” que en el teclado de la XO es el botón con una “cruz” arriba a la izquierda.</p></li>
+           <li><p>Se desplegará un cuadro solicitando un password. La clave es “123” (ver figura)</p>
+           <img class="screenshots" src="img/screenshots/inst-fig5.png">
+           </li>
+           <li><p>Aparecerá una columna a la izquierda en la cual se puede cambiar de grupo y/o de alumno</p></li>
+           <li><p>En el caso de que se desee cambiar de grupo, se cambia la seleccion del grupo y se presiona "Sieguiente Alumno" </p></li>
+           <li><p>En el caso de que se desee encuestar otro alumno del mismo grupo, solemente se presiona "Siguiente Alumno"</p></li>
+           <li><p>En caso de no querer realizar ningún cambio se selecciona la opción “Continuar” para seguir respondiendo la encuesta</p></li>
+          </ol>
 
         <h3 class="anchor" id="continuar-encuesta">Continuar una encuesta inconclusa</h3>
-        <p><i>Un usuario con el rol Encuestador ...</i></p>
         <ol>
           <li>Abre la aplicacion CebialEncuesta en una XO.</li>
           <li><p>En dialogo Asistente se Elije la opcion: "Encuestas inconclusas"</p>
@@ -368,7 +400,7 @@
           <li>Se abre la aplicacion, se podrán ver los datos ingresados anteriormente y continuar respondiendo.</li>
         </ol>
         <p>
-          <strong>Notas</strong>
+	  <strong>Notas</strong>
           <ul>
             <li>Todos los datos ingresados en un encuesta por los niños, se van salvando en un archivo cuyo nombre es del tipo: *1372189919113.encuesta*</li>
             <li>Las posibles ubicaciones de este archivo son:
@@ -382,27 +414,9 @@
               Se debe eliminar el archivo (como se explica "en:"http://sugardextrose.org/projects/polls/wiki/Flujo_de_Trabajo#Eliminación-de-encuestas-limpieza-de-archivos-de-la-XO) *1372189919113.encuesta* y comenzar una nueva.</li>
           </ul>
         </p>
-
-        <h3 class="anchor" id="eliminacion-de-encuesta">Eliminación de encuesta, limpieza de archivos de la XO.</h3>
-        <p>
-          <strong>Nota</strong>
-        </p>
-        <p>
-          Para poder completar una nueva encuesta en una XO que se uso previamente es necesario eliminar el archivo de encuesta en la XO.
-          Este archivo se guarda como medida de precaución para evitar perder los datos completados por los niños en el caso de que pendrive se dañe y se pierda el archivo de resultados.
-        </p>
-
-        <ol>
-          <li>Asegurese de que ya se subieron los resultados a la web de la encuesta existente en la XO.</li>
-          <li>Abra el Journal (Diario).</li>
-          <li>Abra la carpeta "Documentos", haciendo click en el icono de la barra inferior a la derecha.</li>
-          <li>Borre el archivo con nombre parecido a: *1372189919113.encuesta*</li>
-          </ol>
         </div>
       </div>
-
     </div>
-
   </body>
 </html>