1. class
  2. Civi
  3. \
  4. ActionSchedule
  5. \
  6. Mapping

Mapping

abstract class Mapping implements MappingInterface

Class Mapping

Properties

protected $id
protected string $entity The basic entity to query (table name).

Methods

static Mapping
create(array $params)

Create mapping.

__construct(array $params)

Class constructor.

mixed
getId()

No description

string
getEntity()

No description

string
getLabel()

Get a printable label for this mapping type.

string
getValueHeader()

Get a printable label to use a header on the 'value' filter.

string
getStatusHeader()

Get a printable label to use a header on the 'status' filter.

array
getValueLabels()

Get a list of value options.

array
getStatusLabels(string|int $value)

Get a list of status options.

array
getDateFields()

Get a list of available date fields.

array
getRecipientTypes()

Get a list of recipient types.

array
getRecipientListing(string $recipientType)

Get a list of recipients which match the given type.

static 
getValueLabelMap($name)

No description

array
validateSchedule(CRM_Core_DAO_ActionSchedule $schedule)

Determine whether a schedule based on this mapping is sufficiently complete.

CRM_Utils_SQL_Select
createQuery(CRM_Core_DAO_ActionSchedule $schedule, string $phase, array $defaultParams)

Generate a query to locate contacts who match the given schedule.

bool
resetOnTriggerDateChange(CRM_Core_DAO_ActionSchedule $schedule)

Determine whether a schedule based on this mapping should reset the reminder state if the trigger date changes.

Details

at line 85
static Mapping create(array $params)

Create mapping.

Parameters

array $params

Return Value

Mapping

at line 94
__construct(array $params)

Class constructor.

Parameters

array $params

at line 167
mixed getId()

Return Value

mixed

at line 174
string getEntity()

Return Value

string

at line 183
string getLabel()

Get a printable label for this mapping type.

Return Value

string

at line 192
string getValueHeader()

Get a printable label to use a header on the 'value' filter.

Return Value

string

at line 201
string getStatusHeader()

Get a printable label to use a header on the 'status' filter.

Return Value

string

at line 212
array getValueLabels()

Get a list of value options.

Return Value

array Array(string $value => string $label). Ex: array(123 => 'Phone Call', 456 => 'Meeting').

at line 226
array getStatusLabels(string|int $value)

Get a list of status options.

Parameters

string|int $value The list of status options may be contingent upon the selected filter value. This is the selected filter value.

Return Value

array Array(string $value => string $label). Ex: Array(123 => 'Completed', 456 => 'Scheduled').

at line 244
array getDateFields()

Get a list of available date fields.

Return Value

array Array(string $fieldName => string $fieldLabel).

at line 265
array getRecipientTypes()

Get a list of recipient types.

Note: A single schedule may filter on zero or one recipient types. When an admin chooses a value, it's stored in $schedule->recipient.

Return Value

array array(string $value => string $label). Ex: array('assignee' => 'Activity Assignee').

at line 282
array getRecipientListing(string $recipientType)

Get a list of recipients which match the given type.

Note: A single schedule may filter on multiple recipients. When an admin chooses value(s), it's stored in $schedule->recipient_listing.

Parameters

string $recipientType Ex: 'participant_role'.

Return Value

array Array(mixed $name => string $label). Ex: array(1 => 'Attendee', 2 => 'Volunteer').

See also

getRecipientTypes

at line 286
static protected getValueLabelMap($name)

Parameters

$name

at line 328
array validateSchedule(CRM_Core_DAO_ActionSchedule $schedule)

Determine whether a schedule based on this mapping is sufficiently complete.

Parameters

CRM_Core_DAO_ActionSchedule $schedule

Return Value

array Array (string $code => string $message). List of error messages.

at line 342
abstract CRM_Utils_SQL_Select createQuery(CRM_Core_DAO_ActionSchedule $schedule, string $phase, array $defaultParams)

Generate a query to locate contacts who match the given schedule.

Parameters

CRM_Core_DAO_ActionSchedule $schedule
string $phase See, e.g., RecipientBuilder::PHASE_RELATION_FIRST.
array $defaultParams Default parameters that should be included with query.

Return Value

CRM_Utils_SQL_Select

at line 352
bool resetOnTriggerDateChange(CRM_Core_DAO_ActionSchedule $schedule)

Determine whether a schedule based on this mapping should reset the reminder state if the trigger date changes.

Parameters

CRM_Core_DAO_ActionSchedule $schedule

Return Value

bool