Difference between revisions of "ProDon:Transaction importation module"
m |
Pgillespie (talk | contribs) |
||
Line 3: | Line 3: | ||
<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 |
− | | | + | | TrxEvent<br> |
− | | | + | | TrxEvent<br> |
− | | '''Code''' | + | | Existing occasion '''Code'''<br> |
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxActivityCode |
| TrxAct<br> | | TrxAct<br> | ||
− | | | + | | TrxActivity<br> |
− | | '''Code''' | + | | 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> | ||
|- | |- | ||
− | | | + | | TrxActSource |
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | ''' | + | | Existing '''Source'''<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 '''Compte''' |
| style="text-align: center;" | 15<br> | | style="text-align: center;" | 15<br> | ||
| align="center" | [[#etoiletrx|[*]]]<br> | | align="center" | [[#etoiletrx|[*]]]<br> | ||
Line 52: | Line 52: | ||
| <br> | | <br> | ||
| <br> | | <br> | ||
− | | '''MM/ | + | | '''MM/YY or MM/YYYY<br>'''Slash is required<br> |
| style="text-align: center;" | 5 ou 7<br> | | style="text-align: center;" | 5 ou 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 |
− | | | + | | TrxPaym<br> |
− | | | + | | TrxPayment<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 |
− | | | + | | TrxPayRef<br> |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 84: | Line 84: | ||
| align="center" | <br> | | align="center" | <br> | ||
|- | |- | ||
− | | | + | | TrxProperty |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 91: | Line 91: | ||
| align="center" | [[#5trx|5]]<br> | | align="center" | [[#5trx|5]]<br> | ||
|- | |- | ||
− | | | + | | TrxAppraisers |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 98: | Line 98: | ||
| align="center" | [[#5trx|5]]<br> | | align="center" | [[#5trx|5]]<br> | ||
|- | |- | ||
− | | TrxTransit | + | | TrxTransit |
| <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> | ||
|- | |- | ||
− | | | + | | TrxNameInstitution |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 119: | Line 119: | ||
| 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> | ||
|- | |- | ||
− | | | + | | TrxNoAccount |
| <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> | ||
|- | |- | ||
− | | | + | | TrxRecdStatus<br> |
− | | | + | | TrxRecdS<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> | ||
|- | |- | ||
− | | | + | | TrxRecdAnnual<br> |
− | | | + | | TrxRecdA<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 168: | ||
| align="center" | [[#plustrx|[+]]]<br> | | align="center" | [[#plustrx|[+]]]<br> | ||
|- | |- | ||
− | | | + | | TrxSolicitorCode<br> |
| TrxSolCode<br> | | TrxSolCode<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> | ||
|- | |- | ||
− | | | + | | TrxSolicitorName<br> |
− | | | + | | TrxSolName<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 196: | ||
| 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 210: | ||
| align="center" | [[#9trx|9]]<br> | | align="center" | [[#9trx|9]]<br> | ||
|- | |- | ||
− | | | + | | TrxCustomFieldLabel<br> |
| <br> | | <br> | ||
| <br> | | <br> | ||
Line 218: | Line 218: | ||
|} | |} | ||
− | '''{{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" option is selected. The use of more than one source for a given activity code 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 values and characteristics, it is necessary to specify the label defined in ProDon using the prefix "Cli" and only letters and/or numbers (no spaces). For example, a field named "% people" would become TrxDPeople.<br> |
{| width="635" cellspacing="1" cellpadding="1" border="1" class="wikitable" | {| width="635" cellspacing="1" cellpadding="1" border="1" class="wikitable" |
Revision as of 14:01, 25 October 2010
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 | TrxEvent |
TrxEvent |
Existing occasion Code |
15 |
|
TrxActivityCode | TrxAct |
TrxActivity |
Existing activity Code |
15 |
2 |
TrxActSource | |
|
Existing Source |
100 |
3 |
TrxGLCode | TrxGL |
|
Empty = Default activity code Existing GL Compte |
15 |
[*] |
TrxExpiration | |
|
MM/YY or MM/YYYY Slash is required |
5 ou 7 |
|
TrxQuantity | TrxQty |
|
Integer |
6 |
4 |
TrxGiftAmount | TrxGift |
|
Currency format Without thousands separator |
15 |
4 |
TrxPaymentMethod | TrxPaym |
TrxPayment |
Existing payment Code |
15 |
|
TrxPaymentReference | TrxPayRef |
|
|
255 |
|
TrxProperty | |
|
|
100 |
5 |
TrxAppraisers | |
|
|
255 |
5 |
TrxTransit | |
|
Integer |
10 |
6 |
TrxInstitutionNo | |
|
Integer |
10 |
6 |
TrxNameInstitution | |
|
|
255 |
|
TrxCreditCardNo | |
|
Integer |
30 |
6 |
TrxNoAccount | |
|
Integer |
20 |
6 |
TrxRIBKey | |
|
Integer |
2 |
7 |
TrxRecdStatus |
TrxRecdS |
|
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 |
|
TrxRecdAnnual |
TrxRecdA |
|
N or F or Empty = No Y or T = Yes |
1 |
|
TrxNote |
|
|
|
255 |
[+] |
TrxSolicitorCode |
TrxSolCode |
|
Existing solicitor Code |
255 |
|
TrxSolicitorName |
TrxSolName |
|
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" option is selected. The use of more than one source for a given activity code 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 values and characteristics, it is necessary to specify the label defined in ProDon using the prefix "Cli" and only letters and/or numbers (no spaces). For example, a field named "% people" would become TrxDPeople.
Type |
Valeurs possibles |
Longeur maximale |
---|---|---|
Numérique |
Chiffre uniquement |
|
Texte |
|
255 |
Date et heure |
Format de date tel que specifié dans les options d'importation |
10 |
Vrai/Faux |
N ou F = Non (Vide = Non) O ou V = Oui |
1 |
Liste de choix |
Si la valeur n'existe pas déjà, elle sera automatiquement ajoutée à la liste |
250 |
Liste de choix prédéfinie |
Choix existant dans ProDon |
250 |
Pour ajouter une note, une date de début ou de fin à une caractéristique par une importation, il faut ajouter un suffixe approprié. Les suffixes sont : _note, _début et _fin. Par exemple : TrxDIndividus_note. La note peut contenir jusqu'à 255 caractères et les dates doivent correspondre au format spécifié dans les options d'importation. Ces informations sont ignorées si la colonne de base ne contient pas de valeurs (ie TrxDIndividus serait vide). Pour pouvoir utiliser les dates de début et fin, il faut aussi que les cases correspondantes soient cochées dans la configuration de la caractéristique.
Si la caractéristique le permet, il est possible d'importer plusieurs valeurs en utilisant le suffixe -1, -2 à la toute fin du libellé. Par exemple : TrxDIndividus_note-1.
Liste des champs reçus
Libellé complet | Abrégé 1 | Abrégé 2 | Valeurs possibles | Longeur maximale | Particularité |
---|---|---|---|---|---|
RecNoTrx | |
|
Numéro de transaction existant |
15 |
|
RecDateReçu | |
|
Date 'Vide' = Date du jour |
10 |
1 |
RecNoReçu | |
|
Nombre entier |
6 |
|
RecMntReçu | |
|
Format monétaire Vide = Montant de la transaction |
15 |
|
1 : Le format de date est dicté par le format choisi dans les options d'importation. Les caractères en trop par rapport à la longueur maximale seront ignorés.
Document name: ProDon:Transaction importation module