QuestionnairesComponent.php

<?php
/**
 * Questionnaires Component
 *
 * @author Noriko Arai <arai@nii.ac.jp>
 * @author Allcreator <info@allcreator.net>
 * @link http://www.netcommons.org NetCommons Project
 * @license http://www.netcommons.org/license.txt NetCommons License
 * @copyright Copyright 2014, NetCommons Project
 */

App::uses('Component', 'Controller');

/**
 * QuestionnairesComponent
 *
 * @author Allcreator <info@allcreator.net>
 * @package NetCommons\Questionnaires\Controller
 */
class QuestionnairesComponent extends Component {

/**
 * バリデートタイプ
 * ウィザード画面で形成中の判定をしてほしいときに使う
 */
	const	QUESTIONNAIRE_VALIDATE_TYPE = 'duringSetup';

/**
 * answer max length
 *
 * @var int
 */
	const	QUESTIONNAIRE_MAX_ANSWER_LENGTH = 60000;

/**
 * default display questionnaire item count
 *
 * @var int
 */
	const	QUESTIONNAIRE_DEFAULT_DISPLAY_NUM_PER_PAGE = 10;

/**
 * questionnaire create options
 *
 * @var string
 */
	const QUESTIONNAIRE_CREATE_OPT_NEW = 'create';
	const QUESTIONNAIRE_CREATE_OPT_REUSE = 'reuse';
	const QUESTIONNAIRE_CREATE_OPT_TEMPLATE = 'template';

/**
 * questionnaire view filter
 *
 * @var string
 */
	const QUESTIONNAIRE_ANSWER_VIEW_ALL = 'viewall';
	const QUESTIONNAIRE_ANSWER_UNANSWERED = 'unanswered';
	const QUESTIONNAIRE_ANSWER_ANSWERED = 'answered';
	const QUESTIONNAIRE_ANSWER_TEST = 'test';

/**
 * status questionnaire status started
 *
 * @var string
 */
	const STATUS_STARTED = '0';

/**
 * status questionnaire status not start
 *
 * @var string
 */
	const STATUS_NOT_START = '1';

/**
 * status questionnaire status stopped
 *
 * @var string
 */
	const STATUS_STOPPED = '2';

/**
 * permission. not permit
 *
 * @var string
 */
	const PERMISSION_NOT_PERMIT = '0';

/**
 * permission. permit
 *
 * @var string
 */
	const PERMISSION_PERMIT = '1';

/**
 * uses. not use
 *
 * @var string
 */
	const USES_NOT_USE = '0';

/**
 * uses. use
 *
 * @var string
 */
	const USES_USE = '1';

/**
 * expression. not show
 *
 * @var string
 */
	const EXPRESSION_NOT_SHOW = '0';

/**
 * expression. show
 *
 * @var string
 */
	const EXPRESSION_SHOW = '1';

/**
 * action. not act
 *
 * @var string
 */
	const ACTION_NOT_ACT = '0';
	const ACTION_BEFORE_ACT = '1';
	const ACTION_ACT = '2';

/**
 * question, choice max count
 *
 * @var integer
 */
	const MAX_QUESTION_COUNT = 50;
	const MAX_CHOICE_COUNT = 50;

/**
 * type. question
 *
 * @var string
 */
	const TYPE_SELECTION = '1';
	const TYPE_MULTIPLE_SELECTION = '2';
	const TYPE_TEXT = '3';
	const TYPE_TEXT_AREA = '4';
	const TYPE_MATRIX_SELECTION_LIST = '5';
	const TYPE_MATRIX_MULTIPLE = '6';
	const TYPE_DATE_AND_TIME = '7';
	const TYPE_SINGLE_SELECT_BOX = '8';

/**
 * types list
 *
 * @var array
 */
	static public $typesList = array(
		self::TYPE_SELECTION,
		self::TYPE_MULTIPLE_SELECTION,
		self::TYPE_TEXT,
		self::TYPE_TEXT_AREA,
		self::TYPE_MATRIX_SELECTION_LIST,
		self::TYPE_MATRIX_MULTIPLE,
		self::TYPE_DATE_AND_TIME,
		self::TYPE_SINGLE_SELECT_BOX
	);

/**
 * requires. not require
 *
 * @var string
 */
	const REQUIRES_NOT_REQUIRE = '0';

/**
 * requires. require
 *
 * @var string
 */
	const REQUIRES_REQUIRE = '1';

/**
 * type option. numeric value
 *
 * @var string
 */
	const TYPE_OPTION_NUMERIC = '1';

/**
 * type option. date
 *
 * @var string
 */
	const TYPE_OPTION_DATE = '2';

/**
 * type option. time
 *
 * @var string
 */
	const TYPE_OPTION_TIME = '3';

/**
 * type option. email
 *
 * @var string
 */
	const TYPE_OPTION_EMAIL = '4';

/**
 * type option. url
 *
 * @var string
 */
	const TYPE_OPTION_URL = '5';

/**
 * type option. phone number
 *
 * @var string
 */
	const TYPE_OPTION_PHONE_NUMBER = '6';

/**
 * type option. time
 *
 * @var string
 */
	const TYPE_OPTION_DATE_TIME = '7';

/**
 * type options list
 *
 * @var array
 */
	static public $typeOptionsList = array(
		self::TYPE_OPTION_NUMERIC,
		self::TYPE_OPTION_DATE,
		self::TYPE_OPTION_TIME,
		self::TYPE_OPTION_EMAIL,
		self::TYPE_OPTION_URL,
		self::TYPE_OPTION_PHONE_NUMBER
	);

/**
 * result display type. bar chart
 *
 * @var string
 */
	const RESULT_DISPLAY_TYPE_BAR_CHART = '0';

/**
 * result display type. pie chart
 *
 * @var string
 */
	const RESULT_DISPLAY_TYPE_PIE_CHART = '1';

/**
 * result display type. table
 *
 * @var string
 */
	const RESULT_DISPLAY_TYPE_TABLE = '2';

/**
 * result display type list
 *
 * @var array
 */
	static public $resultDispTypesList = array(
		self::RESULT_DISPLAY_TYPE_BAR_CHART,
		self::RESULT_DISPLAY_TYPE_PIE_CHART,
		self::RESULT_DISPLAY_TYPE_TABLE
	);

/**
 * matrix type. row or no matrix
 *
 * @var string
 */
	const MATRIX_TYPE_ROW_OR_NO_MATRIX = '0';

/**
 * matrix type. column
 *
 * @var string
 */
	const MATRIX_TYPE_COLUMN = '1';

/**
 * other choice type. no other field
 *
 * @var string
 */
	const OTHER_CHOICE_TYPE_NO_OTHER_FILED = '0';

/**
 * other choice type. other field with text
 *
 * @var string
 */
	const OTHER_CHOICE_TYPE_OTHER_FIELD_WITH_TEXT = '1';

/**
 * other choice type. other field with textarea
 *
 * @var string
 */
	const OTHER_CHOICE_TYPE_OTHER_FIELD_WITH_TEXTAREA = '2';

/**
 * display type. single
 *
 * @var string
 */
	const DISPLAY_TYPE_SINGLE = '0';

/**
 * display type. list
 *
 * @var string
 */
	const DISPLAY_TYPE_LIST = '1';

/**
 * skip_flag. no_skip
 *
 * @var string
 */
	const SKIP_FLAGS_NO_SKIP = '0';

/**
 * skip_flag. skip
 *
 * @var string
 */
	const SKIP_FLAGS_SKIP = '1';

/**
 * skip_flag. goto end
 *
 * @var integer
 */
	const SKIP_GO_TO_END = '99999';
/**
 * first page sequence
 *
 * @var integer
 */
	const FIRST_PAGE_SEQUENCE = 0;

/**
 * test answer status, peform( means on air or HONBAN )
 *
 * @var string
 */
	const TEST_ANSWER_STATUS_PEFORM = '0';

/**
 * test answer status, test
 *
 * @var string
 */
	const TEST_ANSWER_STATUS_TEST = '1';

/**
 * percentage unit
 * @var string
 */
	const PERCENTAGE_UNIT = '%';

/**
 * not operation(=nop) mark
 * @var string
 */
	const NOT_OPERATION_MARK = '--';

/**
 * answer delimiter
 *
 * @var string
 */
	const ANSWER_DELIMITER = '|';
	const ANSWER_VALUE_DELIMITER = ':';

/**
 * questionnaire period stat
 *
 * @var integer
 */
	const QUESTIONNAIRE_PERIOD_STAT_IN = 1;
	const QUESTIONNAIRE_PERIOD_STAT_BEFORE = 2;
	const QUESTIONNAIRE_PERIOD_STAT_END = 3;

/**
 * questionnaire template exoprt file name
 *
 * @var string
 */
	const QUESTIONNAIRE_TEMPLATE_EXPORT_FILENAME = 'ExportQuestionnaire.zip';
	const QUESTIONNAIRE_TEMPLATE_FILENAME = 'Questionnaires.zip';
	const QUESTIONNAIRE_JSON_FILENAME = 'Questionnaires.json';
	const QUESTIONNAIRE_FINGER_PRINT_FILENAME = 'finger_print.txt';

/**
 * getSortOrders
 *
 * @return array
 */
	public static function getSortOrders() {
		return array(
			'Questionnaire.modified DESC' => __d('net_commons', 'Newest'),
			'Questionnaire.created ASC' => __d('net_commons', 'Oldest'),
			'Questionnaire.title ASC' => __d('net_commons', 'Title'),
			'Questionnaire.answer_end_period ASC' => __d('questionnaires', 'End period'),
		);
	}

/**
 * アンケート質問タイプのデータ配列を返す
 *
 * @return array 質問タイプの定値とそれに相応するラベル
 */
	public function getQuestionTypeOptionsWithLabel() {
		return array(
			self::TYPE_SELECTION => __d('net_commons', 'Single choice'),
			self::TYPE_MULTIPLE_SELECTION => __d('net_commons', 'Multiple choice'),
			self::TYPE_TEXT => __d('net_commons', 'Text'),
			self::TYPE_TEXT_AREA => __d('net_commons', 'Free style'),
			self::TYPE_MATRIX_SELECTION_LIST => __d('net_commons', 'Single choice matrix'),
			self::TYPE_MATRIX_MULTIPLE => __d('net_commons', 'Multiple choice matrix'),
			self::TYPE_DATE_AND_TIME => __d('net_commons', 'Date and time'),
			self::TYPE_SINGLE_SELECT_BOX => __d('net_commons', 'List select')
		);
	}

/**
 * isSingleInputType
 *
 * @param int $type questionnaire type
 * @return bool
 */
	public static function isOnlyInputType($type) {
		// text, textarea, date などの単純入力タイプであるか
		if ($type == self::TYPE_TEXT) {
			return true;
		}
		if ($type == self::TYPE_TEXT_AREA) {
			return true;
		}
		if ($type == self::TYPE_DATE_AND_TIME) {
			return true;
		}
		return false;
	}

/**
 * isSelectionInputType
 *
 * @param int $type questionnaire type
 * @return bool
 */
	public static function isSelectionInputType($type) {
		// 択一選択、複数選択、リスト選択 などの単純選択タイプであるか
		if ($type == self::TYPE_SELECTION) {
			return true;
		}
		if ($type == self::TYPE_MULTIPLE_SELECTION) {
			return true;
		}
		if ($type == self::TYPE_SINGLE_SELECT_BOX) {
			return true;
		}
		return false;
	}

/**
 * isMatrixInputType
 *
 * @param int $type questionnaire type
 * @return bool
 */
	public static function isMatrixInputType($type) {
		// マトリクス選択タイプであるか
		if ($type == self::TYPE_MATRIX_SELECTION_LIST) {
			return true;
		}
		if ($type == self::TYPE_MATRIX_MULTIPLE) {
			return true;
		}
		return false;
	}
}