MANUAL CARGUE DE ESTUDIOS A SSIWEB ONLINE

MARKET TEAM S.A.

NOVIEMBRE DE 2014
 CONTENIDO

Tabla de contenido

1. OBJETIVO ............................................................................................................ 3
2. DESCRIPCION DEL PROCESO........................................................................... 3
2.1 Ingreso al Aplicativo SSIWEB 8 Local........................................................... 3
2.2 Cargue de un NUEVO ESTUDIO en el servidor SSIWEB Online .................. 5
2.3 Ingreso remoto vía FTP en el servidor SSIWEB Online ............................... 8
2.4 Actualización de los permisos de un NUEVO ESTUDIO en el servidor
SSIWEB Online ............................................................................................. 11
2.5 Detalle Estructura de los Archivos y carpetas requeridas por SSIWEB
Online ............................................................................................................ 16
2.6 Creación de la Base de Datos de cada Estudio SSIWEB Online .............. 17
2.7 Errores más comunes de ingreso al cuestionario SSIWEB Online......... 23
2.8 Actualización de estudios SSIWEB Online ............................................... 27
3. INGRESO A LA CONSOLA DE ADMINISTRACION Y CUESTIONARIO .......... 29
1. OBJETIVO

Cubrir todas las alternativas de configuración y el buen procedimiento de

instalación y preparación del aplicativo SSIWEB Online, de forma que los estudios
puedan ser cargados y puestos en producción.

2. DESCRIPCCION DEL PROCESO

A continuación se describe el procedimiento paso a paso para publicar los
estudios o encuestas en el servidor online, así como la actualización de los
mismos.

2.1. Ingreso al Aplicativo SSIWEB 8 Local

Para el ingreso abra la aplicación Sawtooth SSIWEB versión 8.3.6. Ubicada en el

escritorio…

O bien utiliza el menú de programas.

A continuación el programa se iniciará normalmente.

Abra el estudio a través de la opción abrir del programa normalmente:
A continuación el estudio se visualizará con los parámetros preestablecidos:

NOTA: Es conveniente que el estudio haya sido preparado correctamente y

que este función de manera local, antes de realizar el cargue online; SSIWEB
valida que al abrir el proyecto no tenga errores de atributos o configuración,
verifique que no genere ninguna alerta antes de continuar.

2.2. Cargue de un NUEVO ESTUDIO en el servidor SSIWEB Online

Para realizar el cargue de un estudio nuevo en un esquema online a través de un

servidor web es necesario realizar el siguiente procedimiento:

Ingrese localmente, a la opción Field
web Server Management…

A continuación selecciones la pestaña: Seft Hosting, haga clic en el Botón

“Add” e ingrese los datos de la nueva cuenta a crear así:
Account Name: (Nombre del estudio – Puede ser cualquier nombre alusivo al
proceso o estudio)
Database Name: (Nombre de la base de datos a crear – recomendado nombre
corto y alfanumerico)
Data User Name: (Nombre del usuario base de datos MySQL) – dato fijo
Database Password: (Contraseña de la base de datos MySQL) – dato fijo
Database Server: (Seleccionar MySQL) – dato fijo
Web Root URL: (dirección web del Servidor remoto), ejemplo:
http://54.208.72.220 – dato fijo
Host Name: (Nombre del Servidor remoto), ejemplo:
54.208.72.220 – dato fijo
FTP User Name (Nombre del usuario FTP) – dato fijo
FTP Password Contraseña del usuario FTP) – dato fijo

NOTA: Los usuarios y contraseñas de los diferentes accesos, son suministrados

directamente por el área de IT.
Verifique que al dar clic sobre el botón “Advance” esté seteada la dirección local
del servidor 127.0.0.1

Configure que el tipo de conexión FTP este en: “Normal”

Configure que el modo de transferencia FTP este en: “Pasive Mode”

Al terminar guarde la configuración con el botón OK

Finalmente, haga clic sobre el botón “Upload Servey to Server” y espere que el
aplicativo termine el proceso.

ESTA OPCION GENERA UNA NUEVA CARPETA EN LA MISMA RUTA DEL

DIRECTORIO DEL ESTUDIO LLAMADA “Auto Web Upload” con los parámetros
necesarios para cargar el estudio al servidor remoto.
Se recomienda que si se requiere hacer modificaciones luego de ser
generada por primera vez, sea borrada en cada proceso de generación para
garantizar que se procesan los datos actualizados.
NOTA: Si se trabajan los archivos en red podrían presentarse inconvenientes
luego de borrada la carpeta, si esto pasa trabaje los estudios de forma local
en una ruta del mismo equipo.

2.3. Ingreso remoto vía FTP en el servidor SSIWEB Online

Ingreso remoto a través de FTP: A continuación ingrese a través un cliente FTP

FileZilla o WinSCP, al Servidor Web remoto
NOTA: Previamente el Cliente FTP debe haber sido configurado para el ingreso
con su respectiva dirección, usuario y contraseña.
Para configurar el Cliente FTP con una conexión, realice la siguiente configuración
en el inicio del programa WinSCP:

En Archivo de clave privada haga clic en el botón y seleccione el archivo lave.

Abra el programa FileZilla o WinSCP, ubique la carpeta en SSIWEB del Estudio
y copie toda la carpeta del proyecto, en el sitio que se detalla a continuación en
el servidor remoto:

Ubique la carpeta Web, en la ruta remota /var/www, allí deben dejarse todos los
estudios que se vayan a manejar online para que sean publicados en el servidor

Seguidamente cree una carpeta para almacenar los archivos del estudio o bien
copie la totalidad de la carpeta local con su nombre original. (Se recomienda que
el nombre sea lo más corto posible y sin caracteres especiales)

Copia de los archivos a través de FTP: Confirme que las propiedades de la

copia estén configuradas como MODO BINARIO para no tener inconvenientes de
modificación de las propiedades de los archivos y que posiblemente el programa
no interprete correctamente la información:

A través de WinSCP, realice la copia de la siguiente forma:

Arrastre la carpeta hasta el destino o bien de clic derecho y elija la opción subir:
En opciones de transferencia confirme que esté seleccionada la opción
Binario, y a continuación de clic en el botón “Copiar”

A través de FileZilla, realice la copia de la siguiente forma:

Utilice la opción Propiedades para conformar el tipo de copia.

Seleccione la opción Binary, y de clic en Copiar (confirme previamente que el
destino de los archivos es el correcto):
A continuación el proceso de copia se realizará, este demorará de acuerdo al
tamaño de los archivos y a la velocidad de la conexión.

2.4. Actualización de los permisos de un NUEVO ESTUDIO en el servidor

SSIWEB Online

Actualización de Permisos: Es necesario actualizar manualmente en el servidor,

ingrese a través una consola de línea de comando Linux con el usuario root o
bien utilice el mismo cliente FTP FIleZilla o WinSCP

NOTA: Los usuarios y contraseñas de los diferentes accesos, son suministrados

directamente por el área de IT.

Actualización vía FTP: La forma más sencilla de hacerlo es a través de filezilla o

winscp así:
Confirme la configuración correcta de la estructura de los archivos y carpetas, y
compárelos vs los actuales en sistema en el servidor remoto…

Ejemplo: Carpeta admin

Requiere el código de permisos 703 o rwx---wx
De clic derecho a las carpetas que requiere verificar o cambiar los permisos
(admin) y seleccione los check de la sección Permisos para dar los atributos
requeridos

“DEBE REPETIR EL PROCEDIMIENTO PARA CADA UNA DE LAS CARPETAS

Y ARCHIVOS QUE DE DETALLAN EN LA ESTRUCTITA DE ARCHIVOS
SSIWEB”

NOTA: Para detalle de los permisos revise el numeral 2.5 Estructura de

archivos requerida por SSIWEB
Actualización vía Consola línea de Comando LINUX: Si los permisos no
permiten a la encuesta hacer los cambios necesarios para poder actualizarse, se
deben hacer los siguientes ajustes desde línea de comando del sistema Operativo
Linux.

NOTA: Los usuarios y contraseñas de los diferentes accesos, son suministrados

directamente por el área de IT.

Para el ingreso a través de Linux, realice la conexión de la siguiente forma:

Ejecute el programa Putty.exe

Y configure la dirección IP del servidor.

Seguidamente seleccione la opción: “SSH” y dentro de esta la opción: “Auth”

Haga clic en el Botón Open y a continuación se presentará la siguiente pantalla en

color Negro:

Escriba el nombre del usuario que para este caso es root y de enter
COMANDOS LUNIX PARA ACTUALIZACION DE PERMISOS DE ARCHIVOS Y
CARPETAS:

chmod 644 nombre_archivo (para actualizar archivos)

chmod -R 703 nombre_carpeta/ (para actualizar carpetas)

Ejemplo: permisos para la carpeta admin

• la carpeta admin no deja a otros usuarios el acceso de escribir. (Para dejar

todo claro: el "w" significa "write" en inglés. El "x" significa "execute" en
inglés, o ejecutar. Y el "r" significa "read".)

Cambiar los permisos de esta carpeta para otros acceso de escribir.

Después de esto, entrar en el admin module y la encuesta se actualizó.

o Los permisos recomendados para la carpeta admin son:
 rwx|___|_wx
o Entonces se deben cambiar a:

Y así, la encuesta funcionara.

NOTA: Si decide cambiar otra pregunta, o actualizar otra cosa en la encuesta, no es
necesario siempre usar otra carpeta. Puede subir los archivos a la misma carpeta (y así
evitar cambiando los permisos cada vez) y actualizar la encuesta otra vez al entrar en
el admin module.

2.5. Detalle Estructura de los Archivos y carpetas requeridas por SSIWEB

Online

A continuación la descripción técnica y configuración de todos los permisos

requeridos por el programa para la correcta ejecución de los estudios online:

Estructura de archivos requerida por SSIWEB

File / Directory Description Unix Permissions*

Login page. Entry point for
login.html 644 r w _ |r _ _ | r _ _
respondents.
Admin Module login page.
admin.html Entry point for study 644 r w _ |r _ _ | r _ _
administrators.
Admin Folder or directory. 703 rwx|___|_wx
STUDYNAME_qst.cgi Main web questionnaire file. 644 r w _ |r _ _ | r _ _
Contains server path
STUDYNAME_path.cgi 644 r w _ |r _ _ | r _ _
information.
STUDYNAME_config.cgi Contains Admin Module
644 r w _ |r _ _ | r _ _
(see security section below) passwords.
Design file for CBC/Web
** STUDYNAME_CBC[exerciseID]_[designID].cgi 644 r w _ |r _ _ | r _ _
studies.
Design file for MaxDiff/Web
*** STUDYNAME_MXD[exerciseID]_[designID].cgi 644 r w _ |r _ _ | r _ _
studies.
Folder containing database
db_setup 707 rwx|___|rwx
setup files.
Main web questionnaire file
STUDYNAME_questionnaire.cgi 644 r w _ |r _ _ | r _ _
used for setup.
Contains all data fields. Used to
STUDYNAME_layout.cgi 644 r w _ |r _ _ | r _ _
set up data base data tables.
Respondent password file used
STUDYNAME_pwds.cgi to set up the database 644 r w _ |r _ _ | r _ _
password table.
Folder or directory that contains
cgi-bin 701 xxx|___|__x
all of the Perl files.
ciwweb.pl 755 rwx|r_x|r_x
admin.pl 755 rwx|r_x|r_x
ciwlibXXX.pl 644 r w _ |r _ _ | r _ _
authlibXXX.pl 644 r w _ |r _ _ | r _ _
 File / Directory Description Unix Permissions*
pverlibXXX.pl 644 r w _ |r _ _ |r__
grdlibXXX.pl 644 r w _ |r _ _ |r__
enterlibXXX.pl 644 r w _ |r _ _ |r__
acalibXXX.pl 644 r w _ |r _ _ |r__
cbclibXXX.pl 644 r w _ |r _ _ |r__
cvalibXXX.pl 644 r w _ |r _ _ |r__
maxdifflibXXX.pl 644 r w _ |r _ _ |r__
acbclibXXX.pl 644 r w _ |r _ _ |r__
Folder or directory that contains
Graphics 707 rwx|___|rwx
all the graphics in your study.
Folder containing supporting
System 707 rwx|___|rwx
files.
ssi_javascriptX_X_X.js SSI Web Javascript library 644 r w _ |r _ _ |r__
ssi_styleX_X_X.css Base style sheet 644 r w _ |r _ _ |r__
ssi_admin_styleX_X_X.css Style sheet for Admin Module 644 r w _ |r _ _ |r__
jquery-X.X.X.min.js Javascript library 644 r w _ |r _ _ |r__

* Unix Permission Notation - The notation consists of three sets of the letters r, w, and
x. The letter "r" stands for "read", "w" for "Write" and "x" for "Execute." The first set of
letters is for the Unix group "Owner", the second for "Group", and the third for "Other."
So the full permissions of r w x | r w x | r w x or 777 give "read", "write", and
"execute" permissions to "Owner", "Group", and "Other."

Set Up Database
After the files have been uploaded it is critical that you now log into the Admin
Module through admin.html. SSI Web will create the necessary database tables the
first time you log into the Admin Module. Your survey should now be working. Go to
login.html on your web site and test your survey making sure the study behaves as
expected and that it is saving data. Remember to return to the Admin Module through
admin.html to see your results and download your data. If you need to make changes
re-upload the study files (usually just the contents of the db_setup folder). Then make
sure to log into the Admin Module and click "Apply Changes" so that your changes will
be applied to the database.

2.6. Creación de la Base de Datos de cada Estudio SSIWEB Online

Creación Manual de la Base de datos MySQL: Es necesario crear la base de

datos manualmente luego de cargados los archivos; es posible que al ejecutar el
script admin.html se presente un mensaje como el siguiente:
NOTA: Los usuarios y contraseñas de los diferentes accesos, son suministrados
directamente por el área de IT.

Para el ingreso a través de Linux, realice la conexión de la siguiente forma:

Ejecute el programa Putty.exe

Y configure la dirección IP del servidor.

Seguidamente seleccione la opción: “SSH” y dentro de esta la opción: “Auth”

Haga clic en el Botón Open y a continuación se presentará la siguiente pantalla en

color Negro:

Escriba el nombre del usuario que para este caso es root y de enter
Ahora hay que verificar si el nombre que espera usar está presente en MySQL así:

1. Otra vez, entrar a la línea de comandos, y entra a mysql:

o mysql -u root -p
2. Al entrar a mysql, entra lo siguiente:
o show databases;
3. Así puede ver las bases de datos que existen en esa instalación de MySQL.
Si alguna base de las que aparecen es el que quiere usar, puede cambiar la
configuración. Si quiere crear la base de datos "nombre_estudio", puede
crearlo:
o CREATE DATABASE nombre_estudio;
4. A continuación, asegúrese de iniciar sesión en el módulo de administración
y haga clic en "Aplicar cambios" ("Apply Changes") para que los cambios
se aplican a la base de datos.
5. Diríjase al link de la encuesta para iniciar con el diligenciamiento de la
encuesta

NOTA: Los usuarios y contraseñas de los diferentes accesos, son suministrados

directamente por el área de IT.

Ejemplo: Creación base de datos “ponques_snaks”

Conectado a la Consola Linux es necesario ingresar a MySql, para esto de digita
el comando:

mysql -u root -p

Seguidamente se digita el código para confirmar que bases existen:

show databases

Se muestran 7 Bases, detallemos que no existe ponques_snacks

A continuación se digita el comando para crear la Base deseada, en este caso
ponques_snacks:

Create database pnques_snacks;

Y el sistema crea la base en Mysql

NOTA: Utilice un nombre corto, sin caracteres especiales o espacios y

ALFABETICO ó ALFANUMERICO

Finalmente salimos del sistema con el comando exit:

Ctrl + C y a continuación:
Exit
enter

Ahora diríjase a link del “admin module” para confirmar que todo ha sido
configurado correctamente:

LINK A CONSOLA DE ADMINSTRACION:

http://54.208.72.220/nombre_estudio/Auto%20Web%20Upload/admin.html

y deberá ver que la base de datos esta creada y lista para su uso, haga clic para
aceptar la configuración en el botón “Main Menu”
La consola de Administración en este momento, quedará lista para consulta:

Diríjase ahora al cuestionario de la siguiente forma:

LINK A CUESTIONARIO DEL ESTUDIO

http://54.208.72.220/nombre_estudio/Auto%20Web%20Upload/login.html
El link del cuestionario este momento, quedará lista para ser diligenciado:

2.7. Errores más comunes de ingreso al cuestionario SSIWEB Online

Es posible que al intentar ingresar a los cuestionarios luego de realizar la

configuración completa se presenten errores, para lo cual siga las siguientes
instrucciones de acuerdo a cada caso:

Mensaje encuesta se encuentra cerrada: Es posible que de alguna manera la

encuesta se presenta como cerrada al inicio del proceso, se debe ajustar los
parámetros en el módulo administrativo. Es una función del Admin Module que
puede cerrar una encuesta para prevenir más registros, pero es una medida no
permanente.
Para cerrar o abrir una encuesta:

• Entrar en el Admin Module con privilegios de leer/escribir

• Buscar y dar clic en "Close Survey"
• El estado de la encuesta se dirá en esta página.
o Si está cerrado, verá:
 The survey is now CLOSED. Respondents are NOT able to
enter the survey.
 o Si está abierto verá:
 The survey is now OPEN. Respondents are able to
enter the survey.
• Para abrir lo:
o dar click en "Open Survey to Respondents"
• Para cerrar lo:
o dar click en "Close Survey and Show Message"
• El estado de la encuesta se actualizará de inmediato, y vera el nuevo
mensaje diciendo que está abierto.

Mensaje de error al guardar la encuesta: Es posible que se presente en algún

momento, el siguiente mensaje de error para lo cual se debe configurar el
cuestionario de la siguiente forma:

msj:
Oops! Google Chrome could not connect to
127.0.0.1:61500

La encuesta no está cerrada en el ordenador local, sino que el link en la pregunta

FinCalifica, les está dirigiendo a la encuesta que está en el web. La manera
correcta de poner un link a la primera página de la encuesta, usar "../login.html".

Desde el "Help" de SSI Web (accesible oprimiendo F1 en el teclado desde

cualquier parte de SSI Web):

En la sección para CAPI Interviewing:

________________________

CAPI Interviewing with "SSI Web CAPI"

Interview "Recycle"

When running in CAPI mode, you may want the questionnaire to automatically recycle from the last page of
the survey back to the first, so that it doesn't drop to the main SSI Web CAPI menu each time.

The easiest way to do this is to add a Terminate/Link question at the end of your survey (on its own page), that
(on the Settings tab) specifies a Web Address (URL) of "../login.html".
Y para estar completamente claro, así aparecerá en SSI Web al cambiar el link
(véase imagen).

Mensaje de error FAILED Database Connnectivity: Es ocasionado porque aún

no se ha creada la base de datos correspondiente:
Para este caso siga la instrucciones del numeral 2.6. Creación de la Base de
Datos de cada Estudio SSIWEB Online.

Consola de admin no habilitada para consulta: En la consola de administración

se presenta un mensaje “Survey Updated!” pero no permite accionar ninguna
opción del menú; es ocasionado porque los permisos no están correctamente
configurados.

En este caso siga las instrucciones del numeral 2.4. Actualización de los
permisos de un NUEVO ESTUDIO en el servidor SSIWEB Online

Mensaje de error Sawtooth Error #150: Es ocasionado porque los archivos no

fueron copiados o actualizados completamente o correctamente en el servidor
remoto.
En medio de la navegación de la encuesta se muestra el siguiente mensaje de
error:
Y el log detallado muestra la siguiente información:

Error #150 - The size of the CBC Design file (/var/www/8634_Ponque/Auto Web
Upload/admin/Ponque_CBC1_1414911779.cgi) does not match the size expected by
the QST file. Try uploading the file again in binary mode.
Sun Nov 2 21:46:17 2014
SSIWebVersion= 8_3_6 params= sys_next_hop=>48,
hid_s=>BgAAAAMAAAAJAAAAqLhDci1teNgC_d8p_ZbCMVdHvI3Skocn_QIg1gJpPQHfzzQFWhoP7jHK7x3PpvEJdWWer_CwpQXfI
AL0IKX6CQIS6diHx9JyqFePRpPnt1Q, hid_javascript=>1, PQ=>43543, hid_studyname=>Ponque, hid_q_PQ=>PQ,
hid_pagenum=>19, hid_pagetime=>1414964774, hid_respnum=>21, hid_checksum=>637042038, hid_previous=>0,
hid_backup=>Ponque,21,637042038,18,1, hid_prev_PQ=>46,PQ,18,5d74c54ef32b4e7aaea10cfab0e41e87, IP= 190.0.21.170 ,
client= Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; WOW64; Trident/6.0)

Para este caso siga las instrucciones del numeral 2.3. Ingreso remoto vía FTP
en el servidor SSIWEB Online - Copia de los archivos a través de FTP

2.8. Actualización de estudios SSIWEB Online

Actualización de un estudio existente o ya cargado: Luego de que un estudio

ya está en funcionamiento, es posible que se requiera hacer cualquier tipo de
modificaciones los cuestionarios o estructura, para esto se hace necesario
actualizar la información de manera local y luego cargar los archivos.

Para esta actualización solo es necesario copiar el contenido de la carpeta “Auto

Web Upload” al servidor remoto a través de un cliente FTP filezilla o WinSCP
así:
NOTA: No olvide verificar las propiedades de la copia, estén configuradas como
“Binary”

Después de entrar y actualizar la encuesta con la contraseña con permisos de

leer/escribir (la contraseña con sólo los permisos de leer puede ver los registros
ingresados en la encuesta).
Dependiendo de la manera en que se subió la encuesta, hay dos maneras para
ver esta contraseña. Primero si está usando Auto Upload

• Dale clic en Field en el menú

• Dale clic en Web Server Management
• Busca la pestaña de Admin Module, y usa la segunda contraseña.

De misma manera, si usa el Manual Upload:

• Dale clic en Field en el menú

• Dale clic en Prepare for Manual Upload
• Busca la pestaña de Admin Module, y usa la segunda contraseña.

A continuación, asegúrese de iniciar sesión en el módulo de administración y haga

clic en "Aplicar cambios" ("Apply Changes") para que los cambios se aplican a la
base de datos.
Diríjase al link de la encuesta para iniciar con el diligenciamiento de la encuesta
3. INGRESO A LA CONSOLA DE ADMINISTRACION Y CUESTIONARIO DEL
ESTUDIO

Para el ingreso tanto a la consola de administración como al link del cuestionario

Online, es necesario accesar de la siguiente forma:

CONSOLA DE ADMINISTRACION (ADMIN MODULE)

Ingrese a la opción Field
Admin Module

Se debe setear la ruta: dirección del servidor – carpeta del estudio – carpeta Auto
Web Upload – admin.html

O bien ingresar manaulmente en el navegador:

Ejemplo:
http://54.208.72.220/8487-Mamas/Auto%20Web%20Upload/admin.html

LINK A CUESTIONARIO DEL ESTUDIO

Para cargar el link del cuestionario ingrese directamente a través del navegador
así:
http://direcciondelservidor/carpetadelestudio/Auto web Upload/ login.html

Ejemplo:
http://54.208.72.220/8487-Mamas/Auto%20Web%20Upload/login.html