Difference between revisions of "ProDon:Transaction importation module"
m (Created page with '{{Entete_ProDon|22|4.5|Louis-Sébastien Garneau|Jessy Fontaine|2010/05/27}} <br> === Liste des champs transaction === {| width="100%" cellspacing="1" cellpadding="1" border…') |
|||
(28 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{Header_TOC}}<br> |
<br> | <br> | ||
− | === | + | === List of Transaction Fields === |
{| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable" | {| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable" | ||
|- | |- | ||
− | ! scope="col" | | + | ! scope="col" | Full Label |
− | ! scope="col" | | + | ! scope="col" | Abbreviation 1 |
− | ! scope="col" | | + | ! scope="col" | Abbreviation 2 |
− | ! scope="col" | | + | ! scope="col" | Possible Values |
− | ! width="75" align="center" scope="col" | | + | ! width="75" align="center" scope="col" | Maximum Length |
− | ! width="90" scope="col" | | + | ! width="90" scope="col" | Specific Properties |
|- | |- | ||
− | | | + | | TrxGiftDate |
| TrxDate<br> | | TrxDate<br> | ||
| <br> | | <br> | ||
− | | '''Date'''<br>''' | + | | '''Date'''<br>'''Empty''' = Current date |
| style="text-align: center;" | 10<br> | | style="text-align: center;" | 10<br> | ||
| align="center" | [[#1trx|1]]<br> | | align="center" | [[#1trx|1]]<br> | ||
|- | |- | ||
− | | | + | | TrxOccasionCode |
+ | | TrxOccasion<br> | ||
| TrxOcc<br> | | TrxOcc<br> | ||
− | | | + | | Existing occasion '''Code'''<br> |
− | |||
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxActivityCode |
+ | | TrxActivity<br> | ||
| TrxAct<br> | | TrxAct<br> | ||
− | | | + | | Existing activity '''Code'''<br> |
− | |||
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | [[#2trx|2]]<br> | | align="center" | [[#2trx|2]]<br> | ||
|- | |- | ||
− | | | + | | TrxOccasionDesc |
+ | | <br> | ||
+ | | <br> | ||
+ | | <br> | ||
+ | | style="text-align: center;" | 100 | ||
+ | | align="center" | [[#3trx|3]] | ||
+ | |- | ||
+ | | TrxActivityDesc | ||
+ | | <br> | ||
+ | | <br> | ||
+ | | <br> | ||
+ | | style="text-align: center;" | 100 | ||
+ | | align="center" | [[#3trx|3]] | ||
+ | |- | ||
+ | | TrxActOrigin | ||
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | ''' | + | | Existing '''Origin'''<br> |
| style="text-align: center;" | 100<br> | | style="text-align: center;" | 100<br> | ||
| align="center" | [[#3trx|3]]<br> | | align="center" | [[#3trx|3]]<br> | ||
|- | |- | ||
− | | | + | | TrxGLCode |
| TrxGL<br> | | TrxGL<br> | ||
| <br> | | <br> | ||
− | | ''' | + | | '''Empty''' = Default activity code<br>Existing GL '''account''' |
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | [[#etoiletrx|[*]]]<br> | | align="center" | [[#etoiletrx|[*]]]<br> | ||
Line 52: | Line 66: | ||
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | '''MM/ | + | | '''MM/YY or MM/YYYY<br>'''Slash is required<br> |
− | | style="text-align: center;" | 5 | + | | style="text-align: center;" | 5 or 7<br> |
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxQuantity |
− | | | + | | TrxQty<br> |
| <br> | | <br> | ||
− | | ''' | + | | '''Integer'''<br> |
| style="text-align: center;" | 6<br> | | style="text-align: center;" | 6<br> | ||
| align="center" | [[#4trx|4]]<br> | | align="center" | [[#4trx|4]]<br> | ||
|- | |- | ||
− | | | + | | TrxGiftAmount |
− | | | + | | TrxGift<br> |
| <br> | | <br> | ||
− | | ''' | + | | '''Currency format'''<br>Without thousands separator |
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | [[#4trx|4]]<br> | | align="center" | [[#4trx|4]]<br> | ||
|- | |- | ||
− | | | + | | TrxPaymentMethod |
− | | | + | | TrxPayment<br> |
− | | | + | | TrxPaym<br> |
− | | '''Code''' | + | | Existing payment '''Code'''<br> |
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxPaymentReference |
− | | | + | | TrxRefPaym<br> |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 84: | Line 98: | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxProperty |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 91: | Line 105: | ||
| align="center" | [[#5trx|5]]<br> | | align="center" | [[#5trx|5]]<br> | ||
|- | |- | ||
− | | | + | | TrxAppraisers |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 101: | Line 115: | ||
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | ''' | + | | '''Integer'''<br> |
| style="text-align: center;" | 10<br> | | style="text-align: center;" | 10<br> | ||
| align="center" | [[#6trx|6]]<br> | | align="center" | [[#6trx|6]]<br> | ||
|- | |- | ||
− | | | + | | TrxInstitutionNo |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | ''' | + | | '''Integer'''<br> |
| style="text-align: center;" | 10<br> | | style="text-align: center;" | 10<br> | ||
| align="center" | [[#6trx|6]]<br> | | align="center" | [[#6trx|6]]<br> | ||
|- | |- | ||
− | | | + | | TrxInstitutionName |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 119: | Line 133: | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxCreditCardNo |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | ''' | + | | '''Integer'''<br> |
| style="text-align: center;" | 30<br> | | style="text-align: center;" | 30<br> | ||
| align="center" | [[#6trx|6]]<br> | | align="center" | [[#6trx|6]]<br> | ||
|- | |- | ||
− | | | + | | TrxAccountNo |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | ''' | + | | '''Integer'''<br> |
| style="text-align: center;" | 20<br> | | style="text-align: center;" | 20<br> | ||
| align="center" | [[#6trx|6]]<br> | | align="center" | [[#6trx|6]]<br> | ||
|- | |- | ||
− | | | + | | TrxRIBKey |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | ''' | + | | '''Integer'''<br> |
| style="text-align: center;" | 2<br> | | style="text-align: center;" | 2<br> | ||
| align="center" | [[#7trx|7]]<br> | | align="center" | [[#7trx|7]]<br> | ||
|- | |- | ||
− | | | + | | TrxReceiptStatus<br> |
− | | | + | | TrxReceiptS<br> |
| <br> | | <br> | ||
− | | '''N''' | + | | '''N''' or '''F''' = None<br>'''Y''' or '''T''' = To be issued<br>'''C''' = To be calculated<br>'''Empty''' = According to activity |
| style="text-align: center;" | 1<br> | | style="text-align: center;" | 1<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxReceiptAmount<br> |
− | | | + | | TrxReceiptAmt<br> |
| <br> | | <br> | ||
− | | ''' | + | | '''Currency format'''<br>'''Empty''' = According to activity and transaction<br> |
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxAnnualReceipt<br> |
− | | | + | | TrxAReceipt<br> |
| <br> | | <br> | ||
− | | '''N''' | + | | '''N''' or '''F''' or '''Empty''' = No<br>'''Y''' or '''T''' = Yes |
| style="text-align: center;" | 1<br> | | style="text-align: center;" | 1<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
Line 168: | Line 182: | ||
| align="center" | [[#plustrx|[+]]]<br> | | align="center" | [[#plustrx|[+]]]<br> | ||
|- | |- | ||
− | | | + | | TrxCanvasserCode<br> |
− | | | + | | TrxCanvCode<br> |
| <br> | | <br> | ||
− | | '''Code''' | + | | Existing solicitor '''Code'''<br> |
| style="text-align: center;" | 255<br> | | style="text-align: center;" | 255<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxCanvasserName<br> |
− | | | + | | TrxCanvName<br> |
| <br> | | <br> | ||
− | | ''' | + | | '''Firstname Lastname''' of an existing solicitor.<br>'''Note: '''The use of this field is not recommended.<br>A known issue can arise if there are multiple identical existing solicitors.<br> |
| style="text-align: center;" | 200<br> | | style="text-align: center;" | 200<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxThirdPartyUCN<br> |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | ''' | + | | Existing client '''number'''<br> |
| style="text-align: center;" | 7<br> | | style="text-align: center;" | 7<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxThirdPartyRefNo<br> |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 196: | Line 210: | ||
| align="center" | [[#8trx|8]]<br> | | align="center" | [[#8trx|8]]<br> | ||
|- | |- | ||
− | | | + | | TrxAnonymous<br> |
| TrxAnony<br> | | TrxAnony<br> | ||
| TrxAno<br> | | TrxAno<br> | ||
− | | '''N''' | + | | '''N''' or '''F''' or '''Empty''' = No<br>'''Y''' or '''T''' = Yes |
| style="text-align: center;" | 1<br> | | style="text-align: center;" | 1<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxCharacteristicLabel<br> |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 210: | Line 224: | ||
| align="center" | [[#9trx|9]]<br> | | align="center" | [[#9trx|9]]<br> | ||
|- | |- | ||
− | | | + | | TrxCustomFieldLabel<br> |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 218: | Line 232: | ||
|} | |} | ||
− | '''{{Anchor|[+]|plustrx}}''' : | + | '''{{Anchor|[+]|plustrx}}''' : If the symbol [+] is added to the end of the label, the imported data will be added to the existing information in the database. Otherwise, the imported data will replace the existing information. |
− | '''{{Anchor|[*]|etoiletrx}}''' : | + | '''{{Anchor|[*]|etoiletrx}}''' : If the symbol [*] is added to the end of the label, the code will be created if it does not already exist. |
− | '''{{Anchor|1|1trx}}''' : | + | '''{{Anchor|1|1trx}}''' : The date format is determined by the format selected in the import options. Characters that extend beyond the maximum length will be ignored. |
− | '''{{Anchor|2|2trx}}''' : | + | '''{{Anchor|2|2trx}}''' : This field requires the presence of a similar field under Occasion. |
− | '''{{Anchor|3|3trx}}''' : | + | '''{{Anchor|3|3trx}}''' : Useful only if the "Create non-existent activities or occasion" option is selected. The use of more than one origin or description for a given activity or occasion is not allowed. |
− | '''{{Anchor|4|4trx}}''' : | + | '''{{Anchor|4|4trx}}''' : If the transaction activity is defined by sales price, a quantity or gift amount must be entered. |
− | '''{{Anchor|5|5trx}}''' : | + | '''{{Anchor|5|5trx}}''' : Required if payment method is gift in kind. |
− | '''{{Anchor|6|6trx}}''' : | + | '''{{Anchor|6|6trx}}''' : The field must contain at least 1 character and no more than ? characters. The maximum length is defined in the electronic payment configuration. |
− | '''{{Anchor|7|7trx}}''' : | + | '''{{Anchor|7|7trx}}''' : This field is required if the 3 other RIB validation-related fields are used. |
− | '''{{Anchor|8|8trx}}''' : | + | '''{{Anchor|8|8trx}}''' : This column is ignored if the TrxThirdPartyUCN column exists. |
− | '''{{Anchor|9|9trx}}''' : | + | '''{{Anchor|9|9trx}}''' : For custom fields and characteristics, it is necessary to specify the label defined in ProDon using the prefix "Trx" and only letters and/or numbers (no spaces). For example, a field named "% of people" would become TrxOfPeople.<br> |
{| width="635" cellspacing="1" cellpadding="1" border="1" class="wikitable" | {| width="635" cellspacing="1" cellpadding="1" border="1" class="wikitable" | ||
Line 244: | Line 258: | ||
|- | |- | ||
! scope="col" | Type<br> | ! scope="col" | Type<br> | ||
− | ! scope="col" | | + | ! scope="col" | Possible Values<br> |
− | ! scope="col" | | + | ! scope="col" | Maximum Length<br> |
|- | |- | ||
− | | | + | | Numeric<br> |
− | | | + | | Numbers only<br> |
| <br> | | <br> | ||
|- | |- | ||
− | | | + | | Text<br> |
| <br> | | <br> | ||
| 255<br> | | 255<br> | ||
|- | |- | ||
− | | Date | + | | Date and time<br> |
− | | | + | | Date format as specified in import options<br> |
| 10<br> | | 10<br> | ||
|- | |- | ||
− | | | + | | True/False<br> |
− | | '''N''' | + | | '''N''' or '''F''' = No ('''Empty''' = No)<br>'''Y''' or '''T''' = Yes<br> |
| 1<br> | | 1<br> | ||
|- | |- | ||
− | | | + | | List of options<br> |
− | | | + | | If the value does not already exist, it will be automatically added to the list.<br> |
| 250<br> | | 250<br> | ||
|- | |- | ||
− | | | + | | Predefined list of options<br> |
− | | | + | | Existing selection from '''''ProDon'''''<br> |
| 250<br> | | 250<br> | ||
|} | |} | ||
− | + | To add a note, start date or end date to a characteristic by import, the appropriate suffix must be added: _note, _start or _end. Example: TrxDPeople_note. The note can include up to 255 characters; dates must adhere to the format specified in the import options. This information will be ignored if the base column contains no values (e.g., if TrxDPeople is empty). To use start and end dates, the corresponding boxes must be checked in the configuration of the characteristic. | |
− | + | If supported by the characteristic, several values can be imported by adding the suffix -1, -2 to the end of any label. Example: TrxOfPeople_note-1.<br> | |
<br> | <br> | ||
− | === | + | === List of receipt fields === |
<br> | <br> | ||
Line 284: | Line 298: | ||
{| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable" | {| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable" | ||
|- | |- | ||
− | ! scope="col" | | + | ! scope="col" | Full Label |
− | ! scope="col" | | + | ! scope="col" | Abbreviation 1 |
− | ! scope="col" | | + | ! scope="col" | Abbreviation 2 |
− | ! scope="col" | | + | ! scope="col" | Possible Values |
− | ! width="75" align="center" scope="col" | | + | ! width="75" align="center" scope="col" | Maximum Length |
− | ! width="90" scope="col" | | + | ! width="90" scope="col" | Specific Properties |
|- | |- | ||
− | | | + | | RecTrxNo |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | | + | | Existing transaction number<br> |
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | RecReceiptDate |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | '''Date<br>'''''' | + | | '''Date<br>''''''Empty''' = Current date<br> |
| style="text-align: center;" | 10<br> | | style="text-align: center;" | 10<br> | ||
| align="center" | [[#1recu|1]]<br> | | align="center" | [[#1recu|1]]<br> | ||
|- | |- | ||
− | | | + | | RecReceiptNo |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | | + | | Integer<br> |
| style="text-align: center;" | 6<br> | | style="text-align: center;" | 6<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | RecReceiptAmt |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | ''' | + | | '''Currency format'''<br>'''Empty''' = Transaction amount<br> |
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|} | |} | ||
− | '''{{Anchor|1|1recu}}''' : | + | '''{{Anchor|1|1recu}}''' : The date format is determined by the format selected in the import options. Characters that extend beyond the maximum length will be ignored. |
− | {{ | + | {{Footer_ProDon}} |
Latest revision as of 15:54, 24 May 2016
Transaction importation module |
List of Transaction Fields
Full Label | Abbreviation 1 | Abbreviation 2 | Possible Values | Maximum Length | Specific Properties |
---|---|---|---|---|---|
TrxGiftDate | TrxDate |
|
Date Empty = Current date |
10 |
1 |
TrxOccasionCode | TrxOccasion |
TrxOcc |
Existing occasion Code |
15 |
|
TrxActivityCode | TrxActivity |
TrxAct |
Existing activity Code |
15 |
2 |
TrxOccasionDesc | |
|
|
100 | 3 |
TrxActivityDesc | |
|
|
100 | 3 |
TrxActOrigin | |
|
Existing Origin |
100 |
3 |
TrxGLCode | TrxGL |
|
Empty = Default activity code Existing GL account |
15 |
[*] |
TrxExpiration | |
|
MM/YY or MM/YYYY Slash is required |
5 or 7 |
|
TrxQuantity | TrxQty |
|
Integer |
6 |
4 |
TrxGiftAmount | TrxGift |
|
Currency format Without thousands separator |
15 |
4 |
TrxPaymentMethod | TrxPayment |
TrxPaym |
Existing payment Code |
15 |
|
TrxPaymentReference | TrxRefPaym |
|
|
255 |
|
TrxProperty | |
|
|
100 |
5 |
TrxAppraisers | |
|
|
255 |
5 |
TrxTransit | |
|
Integer |
10 |
6 |
TrxInstitutionNo | |
|
Integer |
10 |
6 |
TrxInstitutionName | |
|
|
255 |
|
TrxCreditCardNo | |
|
Integer |
30 |
6 |
TrxAccountNo | |
|
Integer |
20 |
6 |
TrxRIBKey | |
|
Integer |
2 |
7 |
TrxReceiptStatus |
TrxReceiptS |
|
N or F = None Y or T = To be issued C = To be calculated Empty = According to activity |
1 |
|
TrxReceiptAmount |
TrxReceiptAmt |
|
Currency format Empty = According to activity and transaction |
15 |
|
TrxAnnualReceipt |
TrxAReceipt |
|
N or F or Empty = No Y or T = Yes |
1 |
|
TrxNote |
|
|
|
255 |
[+] |
TrxCanvasserCode |
TrxCanvCode |
|
Existing solicitor Code |
255 |
|
TrxCanvasserName |
TrxCanvName |
|
Firstname Lastname of an existing solicitor. Note: The use of this field is not recommended. A known issue can arise if there are multiple identical existing solicitors. |
200 |
|
TrxThirdPartyUCN |
|
|
Existing client number |
7 |
|
TrxThirdPartyRefNo |
|
|
|
25 |
8 |
TrxAnonymous |
TrxAnony |
TrxAno |
N or F or Empty = No Y or T = Yes |
1 |
|
TrxCharacteristicLabel |
|
|
Variable |
Variable |
9 |
TrxCustomFieldLabel |
|
|
Variable |
Variable |
9 |
[+] : If the symbol [+] is added to the end of the label, the imported data will be added to the existing information in the database. Otherwise, the imported data will replace the existing information.
[*] : If the symbol [*] is added to the end of the label, the code will be created if it does not already exist.
1 : The date format is determined by the format selected in the import options. Characters that extend beyond the maximum length will be ignored.
2 : This field requires the presence of a similar field under Occasion.
3 : Useful only if the "Create non-existent activities or occasion" option is selected. The use of more than one origin or description for a given activity or occasion is not allowed.
4 : If the transaction activity is defined by sales price, a quantity or gift amount must be entered.
5 : Required if payment method is gift in kind.
6 : The field must contain at least 1 character and no more than ? characters. The maximum length is defined in the electronic payment configuration.
7 : This field is required if the 3 other RIB validation-related fields are used.
8 : This column is ignored if the TrxThirdPartyUCN column exists.
9 : For custom fields and characteristics, it is necessary to specify the label defined in ProDon using the prefix "Trx" and only letters and/or numbers (no spaces). For example, a field named "% of people" would become TrxOfPeople.
Type |
Possible Values |
Maximum Length |
---|---|---|
Numeric |
Numbers only |
|
Text |
|
255 |
Date and time |
Date format as specified in import options |
10 |
True/False |
N or F = No (Empty = No) Y or T = Yes |
1 |
List of options |
If the value does not already exist, it will be automatically added to the list. |
250 |
Predefined list of options |
Existing selection from ProDon |
250 |
To add a note, start date or end date to a characteristic by import, the appropriate suffix must be added: _note, _start or _end. Example: TrxDPeople_note. The note can include up to 255 characters; dates must adhere to the format specified in the import options. This information will be ignored if the base column contains no values (e.g., if TrxDPeople is empty). To use start and end dates, the corresponding boxes must be checked in the configuration of the characteristic.
If supported by the characteristic, several values can be imported by adding the suffix -1, -2 to the end of any label. Example: TrxOfPeople_note-1.
List of receipt fields
Full Label | Abbreviation 1 | Abbreviation 2 | Possible Values | Maximum Length | Specific Properties |
---|---|---|---|---|---|
RecTrxNo | |
|
Existing transaction number |
15 |
|
RecReceiptDate | |
|
Date 'Empty' = Current date |
10 |
1 |
RecReceiptNo | |
|
Integer |
6 |
|
RecReceiptAmt | |
|
Currency format Empty = Transaction amount |
15 |
|
1 : The date format is determined by the format selected in the import options. Characters that extend beyond the maximum length will be ignored.
Document name: ProDon:Transaction importation module