Commit | Line | Data |
---|---|---|
6a488035 TO |
1 | <?php |
2 | /** | |
3 | * params must contain at least id=xx & {one of the fields from getfields}=value | |
4 | */ | |
5 | function civicrm_api3_generic_setValue($apiRequest) { | |
6 | $entity = $apiRequest['entity']; | |
7 | $params = $apiRequest['params']; | |
8 | // we can't use _spec, doesn't work with generic | |
9 | civicrm_api3_verify_mandatory($params, NULL, array('id', 'field', 'value')); | |
10 | $id = $params['id']; | |
11 | if (!is_numeric($id)) { | |
12 | return civicrm_api3_create_error(ts('Please enter a number'), array('error_code' => 'NaN', 'field' => "id")); | |
13 | } | |
14 | ||
15 | $field = CRM_Utils_String::munge($params['field']); | |
16 | $value = $params['value']; | |
17 | ||
18 | $fields = civicrm_api($entity, 'getFields', array('version' => 3, 'action' => 'create', "sequential")); | |
19 | // getfields error, shouldn't happen. | |
20 | if ($fields['is_error']) | |
21 | return $fields; | |
22 | $fields = $fields['values']; | |
23 | ||
24 | if (!array_key_exists($field, $fields)) { | |
25 | return civicrm_api3_create_error("Param 'field' ($field) is invalid. must be an existing field", array("error_code" => "invalid_field", "fields" => array_keys($fields))); | |
26 | } | |
27 | ||
28 | $def = $fields[$field]; | |
5ba3bfc8 CW |
29 | // Disallow empty values except for the number zero. |
30 | // TODO: create a utility for this since it's needed in many places | |
31 | if (array_key_exists('required', $def) && empty($value) && $value !== '0' && $value !== 0) { | |
6a488035 TO |
32 | return civicrm_api3_create_error(ts("This can't be empty, please provide a value"), array("error_code" => "required", "field" => $field)); |
33 | } | |
34 | ||
35 | switch ($def['type']) { | |
36 | case 1: | |
37 | //int | |
38 | if (!is_numeric($value)) { | |
39 | return civicrm_api3_create_error("Param '$field' must be a number", array('error_code' => 'NaN')); | |
40 | } | |
41 | ||
42 | case 2: | |
43 | //string | |
6a488035 TO |
44 | if (!CRM_Utils_Rule::xssString($value)) { |
45 | return civicrm_api3_create_error(ts('Illegal characters in input (potential scripting attack)'), array('error_code' => 'XSS')); | |
46 | } | |
47 | if (array_key_exists('maxlength', $def)) { | |
48 | $value = substr($value, 0, $def['maxlength']); | |
49 | } | |
50 | break; | |
51 | ||
52 | case 12: | |
53 | //date | |
54 | $value = CRM_Utils_Type::escape($value,"Date",false); | |
55 | if (!$value) | |
56 | return civicrm_api3_create_error("Param '$field' is not a date. format YYYYMMDD or YYYYMMDDHHMMSS"); | |
57 | break; | |
58 | ||
59 | case 16: | |
60 | //boolean | |
61 | $value = (boolean) $value; | |
62 | break; | |
63 | ||
64 | default: | |
65 | return civicrm_api3_create_error("Param '$field' is of a type not managed yet (".$def['type']."). Join the API team and help us implement it", array('error_code' => 'NOT_IMPLEMENTED')); | |
66 | } | |
67 | ||
68 | if (CRM_Core_DAO::setFieldValue(_civicrm_api3_get_DAO($entity), $id, $field, $value)) { | |
69 | $entity = array('id' => $id, $field => $value); | |
70 | CRM_Utils_Hook::post('edit', $entity, $id, $entity); | |
71 | return civicrm_api3_create_success($entity); | |
72 | } | |
73 | else { | |
74 | return civicrm_api3_create_error("error assigning $field=$value for $entity (id=$id)"); | |
75 | } | |
76 | } | |
77 |