1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
<?php
namespace Civi\Api4\Utils;
use CRM_Utils_Array as UtilsArray;
require_once 'api/v3/utils.php';
class FormattingUtil {
/**
* Massage values into the format the BAO expects for a write operation
*
* @param $params
* @param $entity
* @param $fields
* @throws \API_Exception
*/
public static function formatWriteParams(&$params, $entity, $fields) {
foreach ($fields as $name => $field) {
if (!empty($params[$name])) {
$value =& $params[$name];
// Hack for null values -- see comment below
if ($value === 'null') {
$value = 'Null';
}
FormattingUtil::formatValue($value, $field, $entity);
// Ensure we have an array for serialized fields
if (!empty($field['serialize'] && !is_array($value))) {
$value = (array) $value;
}
}
/*
* Because of the wacky way that database values are saved we need to format
* some of the values here. In this strange world the string 'null' is used to
* unset values. Hence if we encounter true null we change it to string 'null'.
*
* If we encounter the string 'null' then we assume the user actually wants to
* set the value to string null. However since the string null is reserved for
* unsetting values we must change it. Another quirk of the DB_DataObject is
* that it allows 'Null' to be set, but any other variation of string 'null'
* will be converted to true null, e.g. 'nuLL', 'NUlL' etc. so we change it to
* 'Null'.
*/
elseif (array_key_exists($name, $params) && $params[$name] === NULL) {
$params[$name] = 'null';
}
if (strstr($entity, 'Custom_')) {
if ($name == 'entity_id') {
$params['entityID'] = $params['entity_id'];
unset($params['entity_id']);
}
elseif (!empty($field['custom_field_id'])) {
$params['custom_' . $field['custom_field_id']] = $params[$name];
unset($params[$name]);
}
}
}
}
/**
* Transform raw api input to appropriate format for use in a SQL query.
*
* This is used by read AND write actions (Get, Create, Update, Replace)
*
* @param $value
* @param $fieldSpec
* @throws \API_Exception
*/
public static function formatValue(&$value, $fieldSpec, $entity) {
if (is_array($value)) {
foreach ($value as &$val) {
self::formatValue($val, $fieldSpec, $entity);
}
return;
}
$fk = UtilsArray::value('fk_entity', $fieldSpec);
if ($fieldSpec['name'] == 'id') {
$fk = $entity;
}
$dataType = UtilsArray::value('data_type', $fieldSpec);
if ($fk === 'Domain' && $value === 'current_domain') {
$value = \CRM_Core_Config::domainID();
}
if ($fk === 'Contact' && !is_numeric($value)) {
$value = \_civicrm_api3_resolve_contactID($value);
if ('unknown-user' === $value) {
throw new \API_Exception("\"{$fieldSpec['name']}\" \"{$value}\" cannot be resolved to a contact ID", 2002, ['error_field' => $fieldSpec['name'], "type" => "integer"]);
}
}
switch ($dataType) {
case 'Timestamp':
$value = date('Y-m-d H:i:s', strtotime($value));
break;
case 'Date':
$value = date('Ymd', strtotime($value));
break;
}
}
}
|
