3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2015 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2015
35 class CRM_Contribute_Import_Field
{
47 * Title of the field to be used in display
58 * Is this field required
64 * Data to be carried for use by a derived class
70 * Regexp to match the CSV header of this column/field
73 public $_headerPattern;
76 * Regexp to match the pattern of data from various column/fields
88 * This is soft credit field
91 public $_softCreditField;
97 * @param string $headerPattern
98 * @param string $dataPattern
99 * @param null $softCreditField
101 public function __construct($name, $title, $type = CRM_Utils_Type
::T_INT
, $headerPattern = '//', $dataPattern = '//', $softCreditField = NULL) {
102 $this->_name
= $name;
103 $this->_title
= $title;
104 $this->_type
= $type;
105 $this->_headerPattern
= $headerPattern;
106 $this->_dataPattern
= $dataPattern;
107 $this->_softCreditField
= $softCreditField;
108 $this->_value
= NULL;
111 public function resetValue() {
112 $this->_value
= NULL;
118 * The value is in string format. Convert the value to the type of this field
119 * and set the field value with the appropriate type
123 public function setValue($value) {
124 $this->_value
= $value;
132 public function validate() {
134 if (CRM_Utils_System
::isNull($this->_value
)) {
138 switch ($this->_name
) {
140 // note: we validate existence of the contact in API, upon
141 // insert (it would be too costly to do a db call here)
142 return CRM_Utils_Rule
::integer($this->_value
);
147 case 'thankyou_date':
148 return CRM_Utils_Rule
::date($this->_value
);
150 case 'non_deductible_amount':
154 return CRM_Utils_Rule
::money($this->_value
);
157 static $seenTrxnIds = array();
158 if (in_array($this->_value
, $seenTrxnIds)) {
161 elseif ($this->_value
) {
162 $seenTrxnIds[] = $this->_value
;
166 $this->_value
= NULL;
172 return CRM_Utils_Rule
::currencyCode($this->_value
);
174 case 'financial_type':
175 static $contributionTypes = NULL;
176 if (!$contributionTypes) {
177 $contributionTypes = CRM_Contribute_PseudoConstant
::financialType();
179 if (in_array($this->_value
, $contributionTypes)) {
187 case 'payment_instrument':
188 static $paymentInstruments = NULL;
189 if (!$paymentInstruments) {
190 $paymentInstruments = CRM_Contribute_PseudoConstant
::paymentInstrument();
192 if (in_array($this->_value
, $paymentInstruments)) {
204 // check whether that's a valid custom field id
205 // and if so, check the contents' validity
206 if ($customFieldID = CRM_Core_BAO_CustomField
::getKeyID($this->_name
)) {
207 static $customFields = NULL;
208 if (!$customFields) {
209 $customFields = CRM_Core_BAO_CustomField
::getFields('Contribution');
211 if (!array_key_exists($customFieldID, $customFields)) {
214 return CRM_Core_BAO_CustomValue
::typecheck($customFields[$customFieldID]['data_type'], $this->_value
);