TransformerOutputSurveyResponses
extends TransformerOutputActiveRecord
in package
Table of Contents
Properties
- $fieldMap : array<string|int, mixed>
- $hasTokenTable : bool|null
- $registry : Registry|null
- $dataMap : array<string|int, mixed>
- $defaultConfig : array<string|int, mixed>
Methods
- __construct() : mixed
- Construct
- getDataMap() : array<string|int, mixed>
- Get data map
- setDataMap() : void
- Set data map
- setDefaultConfig() : void
- Set default config
- setRegistry() : void
- Called automatically by DI container via @Inject annotation Whenever we are on PHP 8.1 we can switch this to PHP attributes
- transform() : array<string|int, mixed>
- Transform
- transformAll() : array<string|int, mixed>
- Transform collection
- validate() : bool|array<string|int, mixed>
- validateAll() : bool|array<string|int, mixed>
- Validate collection
- applyTokenData() : void
- Appends token-related participant data if the survey is not anonymized.
- cast() : mixed
- Cast Value
- extractAnswers() : array<string|int, mixed>
- Parses SGQA-keyed response attributes into structured answer entries.
- filter() : mixed
- Filter Value
- format() : mixed
- Format Value Looks for possible formatter in the config, tries to get it from the registry and calls the format method on it.
- getDefaultConfig() : array<string|int, mixed>
- Get default config
- normaliseConfig() : array<string|int, mixed>
- Normalise config
- normalizeDateFields() : void
- Converts placeholder dates to null for API consistency.
- transformerResponseItem() : array<string|int, mixed>
- Transforms a single survey response item into a structured array.
- validateKey() : bool|array<string|int, mixed>
- Validate Value
Properties
$fieldMap
public
array<string|int, mixed>
$fieldMap
= []
$hasTokenTable
public
bool|null
$hasTokenTable
= null
Pre-cached token table existence check
$registry
public
Registry|null
$registry
$dataMap
protected
array<string|int, mixed>
$dataMap
= []
$defaultConfig
protected
array<string|int, mixed>
$defaultConfig
= []
Methods
__construct()
Construct
public
__construct() : mixed
getDataMap()
Get data map
public
getDataMap() : array<string|int, mixed>
Return values
array<string|int, mixed>setDataMap()
Set data map
public
setDataMap(array<string|int, mixed> $dataMap) : void
Data map is an associative array. Key is the key in the source data and value is either boolean true
- to include the data as is or a a string field name to map the value
- to in the output.
Parameters
- $dataMap : array<string|int, mixed>
setDefaultConfig()
Set default config
public
setDefaultConfig(array<string|int, mixed> $defaultConfig) : void
Parameters
- $defaultConfig : array<string|int, mixed>
setRegistry()
Called automatically by DI container via @Inject annotation Whenever we are on PHP 8.1 we can switch this to PHP attributes
public
setRegistry(Registry $registry) : void
Parameters
- $registry : Registry
Tags
transform()
Transform
public
transform([mixed|null $data = [] ][, mixed|null $options = [] ]) : array<string|int, mixed>
Returns an array of entity references indexed by the specified key.
Parameters
- $data : mixed|null = []
- $options : mixed|null = []
Tags
Return values
array<string|int, mixed>transformAll()
Transform collection
public
transformAll(array<string|int, mixed> $collection[, array<string|int, mixed>|null $options = [] ]) : array<string|int, mixed>
Parameters
- $collection : array<string|int, mixed>
- $options : array<string|int, mixed>|null = []
Return values
array<string|int, mixed>validate()
public
validate(mixed $data[, array<string|int, mixed>|null $options = [] ]) : bool|array<string|int, mixed>
Parameters
- $data : mixed
- $options : array<string|int, mixed>|null = []
Return values
bool|array<string|int, mixed> —Returns true on success or array of errors.
validateAll()
Validate collection
public
validateAll(array<string|int, mixed> $collection[, array<string|int, mixed>|null $options = [] ]) : bool|array<string|int, mixed>
Parameters
- $collection : array<string|int, mixed>
- $options : array<string|int, mixed>|null = []
Return values
bool|array<string|int, mixed> —Returns true on success or array of errors.
applyTokenData()
Appends token-related participant data if the survey is not anonymized.
private
applyTokenData(array<string|int, mixed> &$responseArray, SurveyDynamic $surveyResponse, array<string|int, mixed> $options) : void
Parameters
- $responseArray : array<string|int, mixed>
- $surveyResponse : SurveyDynamic
- $options : array<string|int, mixed>
cast()
Cast Value
private
cast(mixed $value, array<string|int, mixed> $config) : mixed
Parameters
- $value : mixed
- $config : array<string|int, mixed>
extractAnswers()
Parses SGQA-keyed response attributes into structured answer entries.
private
extractAnswers(array<string|int, mixed> $attributes) : array<string|int, mixed>
Parameters
- $attributes : array<string|int, mixed>
Return values
array<string|int, mixed>filter()
Filter Value
private
filter(mixed $value, array<string|int, mixed> $config) : mixed
Parameters
- $value : mixed
- $config : array<string|int, mixed>
format()
Format Value Looks for possible formatter in the config, tries to get it from the registry and calls the format method on it.
private
format(mixed $value, array<string|int, mixed> $config) : mixed
Parameters
- $value : mixed
- $config : array<string|int, mixed>
getDefaultConfig()
Get default config
private
getDefaultConfig() : array<string|int, mixed>
Return values
array<string|int, mixed>normaliseConfig()
Normalise config
private
normaliseConfig(bool|int|string|array<string|int, mixed> $config, string|int $inputKey[, array<string|int, mixed> $options = [] ]) : array<string|int, mixed>
Parameters
- $config : bool|int|string|array<string|int, mixed>
- $inputKey : string|int
- $options : array<string|int, mixed> = []
Return values
array<string|int, mixed>normalizeDateFields()
Converts placeholder dates to null for API consistency.
private
normalizeDateFields(array<string|int, mixed> &$responseArray) : void
Parameters
- $responseArray : array<string|int, mixed>
transformerResponseItem()
Transforms a single survey response item into a structured array.
private
transformerResponseItem(SurveyDynamic $surveyResponse, array<string|int, mixed> $options) : array<string|int, mixed>
Parameters
- $surveyResponse : SurveyDynamic
- $options : array<string|int, mixed>
Tags
Return values
array<string|int, mixed>validateKey()
Validate Value
private
validateKey(string $key, mixed $value, array<string|int, mixed> $config, array<string|int, mixed> $data[, array<string|int, mixed>|null $options = [] ]) : bool|array<string|int, mixed>
Returns boolean true or array of errors.
Parameters
- $key : string
- $value : mixed
- $config : array<string|int, mixed>
- $data : array<string|int, mixed>
- $options : array<string|int, mixed>|null = []