Functions

Registra en un archivo de texto cada usuario que accede al cuestionario.

accessRegister($formName) : 

Guarda la session_id, hora de acceso y un identificador de referencia (si está incluido en la url).

Parameters

$formName

El cuestionario para el que se registra el acceso

Exceptions

\Exception

Returns

Si el id de referencia indica que es un acceso de prueba.

Convierte un array en una cadena.

arrayToString(array $results, string $resultsString) : string

Parameters

$results

array

$resultsString

string

Returns

string

checkPermissions()

checkPermissions($dir) 

Parameters

$dir

Crea una nueva tabla en la base de datos MySQL con los campos del cuestionario como columnas.

createMySQLTable(string $tableName, array $fields) 

Parameters

$tableName

string

$fields

array

Los campos del cuestionario

Guarda el registro de error en el log de errores.

errorRegister(string $error) 

Parameters

$error

string

Comprueba si existe el archivo de resultados.

existsResultsFile(string $savingName) : boolean

Parameters

$savingName

string

Returns

booleantrue|false

Lee el archivo de resultados y devuelve un array con los campos de la cabecera del archivo de resultados.

getResultsFileHeader(resource $file) : array

Parameters

$file

resource

Returns

array

isReadable()

isReadable($dir) 

Parameters

$dir

Crea un nuevo archivo de texto de resultados y escribe la cabecera de campos.

newResultsFile(\type $savingName, \type $fields) : resource

Parameters

$savingName

\type

$fields

\type

Todos los campos que componen el cuestionario

Returns

resource$file

Abre el archivo de resultados y devuelve un puntero al mismo.

openResultsFile(string $fileName, string $mode) : resource

Parameters

$fileName

string

$mode

string

Modo de apertura

Exceptions

\Exception No se pudo abrir el archivo de resultados

Returns

resource

Convierte un array en una cadena.

resultsArrayToString(array $results, string $resultsString) : string

Parameters

$results

array

$resultsString

string

Returns

string

saveRawResults()

saveRawResults($savingName, $results) 

Parameters

$savingName

$results

Guarda los resultados del cuestionario en un archivo de texto separado por comas (csv).

saveResultsToFileText(string $savingName, array $results, $fields) 

Si los campos del cuestionario han sido modificados, guarda una copia del archivo de resultados existente y crea uno nuevo con los campos recibidos en $fields.

Parameters

$savingName

string

Nombre del archivo a guardar

$results

array

Los resultados del cuestionario enviados por el participante

$fields

Guarda los resultados en la colección $collectionName de la base de datos MongoDB.

saveResultsToMongoDb(array $results, string $collectionName) 

Parameters

$results

array

$collectionName

string

Recibe los resultados del cuestionario enviados por el participante y los guarda en una base de datos MySQL.

saveResultsToMySQL(string $tableName, array $results, array $formFields) 

Comprueba si existe una tabla donde guardarlos y, en caso afirmativo, si sus campos se corresponden con los del cuestionario ($formFields). Si los campos de la tabla son diferentes a los campos del cuestionario, se guarda una copia de la tabla y se crea una nueva que incluya todos los campos del cuestionario.

Parameters

$tableName

string

$results

array

Los resultados del cuestionario enviados por el participante

$formFields

array

Todos los campos que componen el cuestionario

Envía un correo con el mensaje de error de la excepción e información recogida de las cabeceras http.

sendErrorToMail($error) 

Parameters

$error

Envía los resultados a una dirección de correo electrónico.

sendResultsToMail(array $results) 

Parameters

$results

array

Exceptions

\Exception

Parses YAML to array.

spyc_load(string $string) : array

Parameters

$string

string

YAML string.

Returns

array

Parses YAML to array.

spyc_load_file(string $file) : array

Parameters

$file

string

Path to YAML file.

Returns

array

Escribe la cabecera de campos en el archivo de resultados.

writeResultsFileHeader(\type $file, \type $fieldNames) 

La cabecera establece las columnas del archivo.

Parameters

$file

\type

$fieldNames

\type

Todos los campos que componen el cuestionario

Classes and interfaces

Etiquetas

Clase que crea las etiquetas de un conjunto de ítems.

« More »

EtiquetasDefault

Clase que crea etiquetas por defecto (numeradas y/o con valores mínimo y máximo) a partir de la información recibida de un archivo de cuestionario.

« More »

Form

La clase principal.

« More »

FormInfoLoader

Clase que recupera los parámetros generales del cuestionario (título, estado, descripción, etc.) de un archivo de texto.

« More »

Item

Cada uno de los ítems que componen el cuestionario.

« More »

ItemExtendedLoader

Recibe información extraida de un archivo de cuestionario y crea un objeto Item con propiedades adicionales.

« More »

ItemLoader

Recibe información extraida de un fichero de texto e instancia un objeto Item.

« More »

ItemsGroup

Clase que crea objetos formados por conjuntos de ítems.

« More »

ItemsGroupLoader

Recibe información extraida del archivo de cuestionario, crea un objeto ItemsGroup y añade todos los items que lo forman.

« More »

ItemsSubGroupLoader

Carga subconjuntos de ítems que se añaden al conjunto padre.

« More »

Respuestas

Las opciones respuestas de un ítem.

« More »

RespuestasDb

Clase que carga las opciones de respuesta de un ítem almacenadas en una base de datos.

« More »

RespuestasDefault

Clase que crea una secuencia de opciones de respuesta numéricas comprendida entre un valor mínimo y máximo.

« More »

Spyc

The Simple PHP YAML Class.

« More »

UserInfo

Clase que permite obtener información de las cabeceras HTTP.

« More »

dbException

« More »

dbTable

« More »

dbTableException

« More »

field

Un campo de la tabla.

« More »

fieldException

« More »

fieldSet

Un conjunto de campos de una tabla de la base de datos.

« More »

fieldValidate

« More »

find

Recibe un array con condiciones para realizar una consulta en la base de datos y genera una cadena de texto adaptada a MySQL.

« More »

generateItemCodes

Genera todos los identificadores codificados de los ítems del cuestionario.

« More »

loadForm

Clase que facilita métodos para la carga de un cuestionario.

« More »

loadFormCache

Clase que facilita métodos para la carga de una copia guardada del cuestionario en HTML.

« More »

logger

« More »

query

« More »

queryException

« More »

rowSet

Un conjunto de registros devueltos de una consulta en la base de datos.

« More »

sqlException

« More »

sqlResult

Gestiona la manipulación de registros devueltos tras una consulta.

« More »

tableRow

« More »

Constants

 

CACHE_CREATION_FAIL

CACHE_CREATION_FAIL 
 

CACHE_CREATION_FAIL

CACHE_CREATION_FAIL 
 

CACHE_DIR

CACHE_DIR 
 

CACHE_DIR

CACHE_DIR 
 

CSV_COLUMN_DELIMITER

CSV_COLUMN_DELIMITER 
 

CSV_COLUMN_DELIMITER

CSV_COLUMN_DELIMITER 
 

CUESTIONARIO_GET_VAR

CUESTIONARIO_GET_VAR 
 

CUESTIONARIO_GET_VAR

CUESTIONARIO_GET_VAR 
 

DATABASE_SYSTEM

DATABASE_SYSTEM 
 

DATABASE_SYSTEM

DATABASE_SYSTEM 
 

DEFAULT_FILE_EXTENSION

DEFAULT_FILE_EXTENSION 
 

DEFAULT_FILE_EXTENSION

DEFAULT_FILE_EXTENSION 
 

ERROR_LOG_FILENAME

ERROR_LOG_FILENAME 
 

ERROR_LOG_FILENAME

ERROR_LOG_FILENAME 
 

ERROR_REPORTING_LEVEL

ERROR_REPORTING_LEVEL 
 

ERROR_REPORTING_LEVEL

ERROR_REPORTING_LEVEL 
 

ESTADO_DESARROLLO

ESTADO_DESARROLLO 
 

ESTADO_DESARROLLO

ESTADO_DESARROLLO 
 

FORM_DIR

FORM_DIR 
 

FORM_DIR

FORM_DIR 
 

FORM_NOT_FOUND

FORM_NOT_FOUND 
 

FORM_NOT_FOUND

FORM_NOT_FOUND 
 

HTML_DIR

HTML_DIR 
 

HTML_DIR

HTML_DIR 
 

IMAGE_DIR

IMAGE_DIR 
 

IMAGE_DIR

IMAGE_DIR 
 

MAIL_RECEIVER

MAIL_RECEIVER 
 

MAIL_RECEIVER

MAIL_RECEIVER 
 

MAIL_SENDING

MAIL_SENDING 
 

MAIL_SENDING

MAIL_SENDING 
 

MAIL_SEND_ERROR

MAIL_SEND_ERROR 
 

MAIL_SEND_ERROR

MAIL_SEND_ERROR 
 

MAIL_SUBJECT

MAIL_SUBJECT 
 

MAIL_SUBJECT

MAIL_SUBJECT 
 

MONGODB

MONGODB 
 

MONGODB

MONGODB 
 

MONGODB_RESPUESTAS_DB_NAME

MONGODB_RESPUESTAS_DB_NAME 
 

MONGODB_RESPUESTAS_DB_NAME

MONGODB_RESPUESTAS_DB_NAME 
 

MONGO_RESULTS_DB

MONGO_RESULTS_DB 
 

MONGO_RESULTS_DB

MONGO_RESULTS_DB 
 

MYSQL

MYSQL 
 

MYSQL

MYSQL 
 

MYSQL_HOST

MYSQL_HOST 
 

MYSQL_HOST

MYSQL_HOST 
 

MYSQL_PASS

MYSQL_PASS 
 

MYSQL_PASS

MYSQL_PASS 
 

MYSQL_RESPUESTAS_DB_NAME

MYSQL_RESPUESTAS_DB_NAME 
 

MYSQL_RESPUESTAS_DB_NAME

MYSQL_RESPUESTAS_DB_NAME 
 

MYSQL_RESULTS_DB

MYSQL_RESULTS_DB 
 

MYSQL_RESULTS_DB

MYSQL_RESULTS_DB 
 

MYSQL_USER

MYSQL_USER 
 

MYSQL_USER

MYSQL_USER 
 

NO_READABLE_FORM_DIR

NO_READABLE_FORM_DIR 
 

NO_READABLE_FORM_DIR

NO_READABLE_FORM_DIR 
 

NO_WRITABLE_CACHE_DIR

NO_WRITABLE_CACHE_DIR 
 

NO_WRITABLE_CACHE_DIR

NO_WRITABLE_CACHE_DIR 
 

NO_WRITABLE_RESULTS_DIR

NO_WRITABLE_RESULTS_DIR 
 

NO_WRITABLE_RESULTS_DIR

NO_WRITABLE_RESULTS_DIR 
 

RAW_TEXT_RESULTS_EXTENSION

RAW_TEXT_RESULTS_EXTENSION 
 

RAW_TEXT_RESULTS_EXTENSION

RAW_TEXT_RESULTS_EXTENSION 
 

RESULTS_DIR_PATH

RESULTS_DIR_PATH 
 

RESULTS_DIR_PATH

RESULTS_DIR_PATH 
 

RESULTS_TEXT_FILE_ERROR

RESULTS_TEXT_FILE_ERROR 
 

RESULTS_TEXT_FILE_ERROR

RESULTS_TEXT_FILE_ERROR 
 

SAVE_TEXT_FILE

SAVE_TEXT_FILE 
 

SAVE_TEXT_FILE

SAVE_TEXT_FILE 
 

SPYC_FROM_COMMAND_LINE

SPYC_FROM_COMMAND_LINE 
 

TEXT_ID_CHAR_LIMIT

TEXT_ID_CHAR_LIMIT 
 

TEXT_ID_CHAR_LIMIT

TEXT_ID_CHAR_LIMIT 
 

TEXT_RESULTS_EXTENSION

TEXT_RESULTS_EXTENSION 
 

TEXT_RESULTS_EXTENSION

TEXT_RESULTS_EXTENSION 
 

TXT_DEFAULT_NEXT_PAGE

TXT_DEFAULT_NEXT_PAGE 
 

TXT_DEFAULT_NEXT_PAGE

TXT_DEFAULT_NEXT_PAGE 
 

TXT_DEFAULT_SELECT_OPTION

TXT_DEFAULT_SELECT_OPTION 
 

TXT_DEFAULT_SELECT_OPTION

TXT_DEFAULT_SELECT_OPTION 
 

TXT_SEND_FORM

TXT_SEND_FORM 
 

TXT_SEND_FORM

TXT_SEND_FORM 
 

TXT_START_FORM

TXT_START_FORM 
 

TXT_START_FORM

TXT_START_FORM 
 

TXT_VALIDATION_ERRORS

TXT_VALIDATION_ERRORS 
 

TXT_VALIDATION_ERRORS

TXT_VALIDATION_ERRORS