Difference between revisions of "ProDon:Transaction importation module"

From Logilys
Jump to: navigation, search
m
Line 3: Line 3:
 
<br>  
 
<br>  
  
=== Liste des champs transaction ===
+
=== 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" | Libellé complet
+
! scope="col" | Full Label
! scope="col" | Abrégé 1  
+
! scope="col" | Abbreviation 1  
! scope="col" | Abrégé 2  
+
! scope="col" | Abbreviation 2  
! scope="col" | Valeurs possibles
+
! scope="col" | Possible Values
! width="75" align="center" scope="col" | Longeur maximale
+
! width="75" align="center" scope="col" | Maximum Length
! width="90" scope="col" | Particularité
+
! width="90" scope="col" | Specific Properties
 
|-
 
|-
| TrxDateDon
+
| TrxGiftDate
 
| TrxDate<br>  
 
| TrxDate<br>  
 
| <br>  
 
| <br>  
| '''Date'''<br>'''Vide''' = Date du jour
+
| '''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>
 
|-
 
|-
| TrxCodeOccasion
+
| TrxOccasionCode
| TrxOcc<br>  
+
| TrxEvent<br>  
| TrxOccasion<br>  
+
| TrxEvent<br>  
| '''Code''' d'occasion existant<br>  
+
| Existing occasion '''Code'''<br>  
 
| style="text-align: center;" | 15<br>  
 
| style="text-align: center;" | 15<br>  
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
| TrxCodeActivité
+
| TrxActivityCode
 
| TrxAct<br>  
 
| TrxAct<br>  
| TrxActivité<br>  
+
| TrxActivity<br>  
| '''Code''' d'activité existant<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>
 
|-
 
|-
| TrxActProvenance
+
| TrxActSource
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
| '''Provenance''' existante<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>
 
|-
 
|-
| TrxCodeGL
+
| TrxGLCode
 
| TrxGL<br>  
 
| TrxGL<br>  
 
| <br>  
 
| <br>  
| '''Vide''' = Valeur par défaut de l'activité<br>'''Compte''' de GL existant
+
| '''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/AA ou MM/AAAA<br>'''Barre oblique obligatoire<br>  
+
| '''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>
 
|-
 
|-
| TrxQuantité
+
| TrxQuantity
| TrxQté<br>  
+
| TrxQty<br>  
 
| <br>  
 
| <br>  
| '''Nombre entier'''<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>
 
|-
 
|-
| TrxMontantDon
+
| TrxGiftAmount
| TrxDon<br>  
+
| TrxGift<br>  
 
| <br>  
 
| <br>  
| '''Format monétaire'''<br>Sans séparateur de millier
+
| '''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>
 
|-
 
|-
| TrxModePaiement
+
| TrxPaymentMethod
| TrxPai<br>  
+
| TrxPaym<br>  
| TrxPaiement<br>  
+
| TrxPayment<br>  
| '''Code''' de paiement existant<br>  
+
| Existing payment '''Code'''<br>  
 
| style="text-align: center;" | 15<br>  
 
| style="text-align: center;" | 15<br>  
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
| TrxRéférencePaiement
+
| TrxPaymentReference
| TrxRefPai<br>  
+
| TrxPayRef<br>  
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
Line 84: Line 84:
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
| TrxBiens
+
| TrxProperty
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
Line 91: Line 91:
 
| align="center" | [[#5trx|5]]<br>
 
| align="center" | [[#5trx|5]]<br>
 
|-
 
|-
| TrxEvaluateurs
+
| 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>  
| '''Nombre entier'''<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>
 
|-
 
|-
| TrxNoInstitution
+
| TrxInstitutionNo
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
| '''Nombre entier'''<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>
 
|-
 
|-
| TrxNomInstitution
+
| TrxNameInstitution
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
Line 119: Line 119:
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
| TrxNoCarteCredit
+
| TrxCreditCardNo
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
| '''Nombre entier'''<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>
 
|-
 
|-
| TrxNoCompte
+
| TrxNoAccount
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
| '''Nombre entier'''<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>
 
|-
 
|-
| TrxCleRIB
+
| TrxRIBKey
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
| '''Nombre entier'''<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>
 
|-
 
|-
| TrxReçuStatut<br>  
+
| TrxRecdStatus<br>  
| TrxReçuS<br>  
+
| TrxRecdS<br>  
 
| <br>  
 
| <br>  
| '''N''' ou '''F''' = Aucun<br>'''O''' ou '''V''' = À émettre<br>'''C''' = À calculer<br>'''Vide''' = Selon l'activité
+
| '''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>
 
|-
 
|-
| TrxReçuMontant<br>  
+
| TrxReceiptAmount<br>  
| TrxReçuM<br>  
+
| TrxReceiptAmt<br>  
 
| <br>  
 
| <br>  
| '''Format monétaire'''<br>'''Vide''' =&nbsp;Selon l'activité et transaction<br>  
+
| '''Currency format'''<br>'''Empty''' =&nbsp;According to activity and transaction<br>  
 
| style="text-align: center;" | 15<br>  
 
| style="text-align: center;" | 15<br>  
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
| TrxReçuAnnuel<br>  
+
| TrxRecdAnnual<br>  
| TrxReçuA<br>  
+
| TrxRecdA<br>  
 
| <br>  
 
| <br>  
| '''N''' ou '''F''' ou '''Vide''' = Non<br>'''O''' ou '''V''' = Oui
+
| '''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>
 
|-
 
|-
| TrxSolliciteurCode<br>  
+
| TrxSolicitorCode<br>  
 
| TrxSolCode<br>  
 
| TrxSolCode<br>  
 
| <br>  
 
| <br>  
| '''Code''' solliciteur existant<br>  
+
| Existing solicitor '''Code'''<br>  
 
| style="text-align: center;" | 255<br>  
 
| style="text-align: center;" | 255<br>  
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
| TrxSolliciteurNom<br>  
+
| TrxSolicitorName<br>  
| TrxSolNom<br>  
+
| TrxSolName<br>  
 
| <br>  
 
| <br>  
| '''Prénom Nom''' d'un solliciteur existant<br>'''N.B. '''Il n'est pas recommandé d'utiliser ce champ.<br>Problème connu si plusieurs solliciteurs existants identiques.<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>
 
|-
 
|-
| TrxTiersNUC<br>  
+
| TrxThirdPartyUCN<br>  
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
| '''Numéro''' de client existant<br>  
+
| Existing client '''number'''<br>  
 
| style="text-align: center;" | 7<br>  
 
| style="text-align: center;" | 7<br>  
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
| TrxTiersNoRef<br>  
+
| TrxThirdPartyRefNo<br>  
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
Line 196: Line 196:
 
| align="center" | [[#8trx|8]]<br>
 
| align="center" | [[#8trx|8]]<br>
 
|-
 
|-
| TrxAnonyme<br>  
+
| TrxAnonymous<br>  
 
| TrxAnony<br>  
 
| TrxAnony<br>  
 
| TrxAno<br>  
 
| TrxAno<br>  
| '''N''' ou '''F''' ou '''Vide''' = Non<br>'''O''' ou '''V''' = Oui
+
| '''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>
 
|-
 
|-
| TrxLibellé de la caractéristique<br>  
+
| TrxCharacteristicLabel<br>  
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
Line 210: Line 210:
 
| align="center" | [[#9trx|9]]<br>
 
| align="center" | [[#9trx|9]]<br>
 
|-
 
|-
| TrxLibellé du champ personnalisé<br>  
+
| TrxCustomFieldLabel<br>  
 
| <br>  
 
| <br>  
 
| <br>  
 
| <br>  
Line 218: Line 218:
 
|}
 
|}
  
'''{{Anchor|[+]|plustrx}}'''&nbsp;: Si le code [+] est ajouté à la fin du libellé, l'information importée sera ajoutée à l'information déjà présente dans la base de données. Dans le cas contraire, l'information importée remplacera l'information déjà présente.  
+
'''{{Anchor|[+]|plustrx}}'''&nbsp;: 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}}'''&nbsp;: Si le code [*] est ajouté à la fin du libellé, le code sera créé s'il n'existe pas déjà.  
+
'''{{Anchor|[*]|etoiletrx}}'''&nbsp;: 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}}'''&nbsp;: 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.  
+
'''{{Anchor|1|1trx}}'''&nbsp;: 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}}'''&nbsp;: Ce champ requiert la présence du champ similaire en Occasion.  
+
'''{{Anchor|2|2trx}}'''&nbsp;: This field requires the presence of a similar field under Occasion.  
  
'''{{Anchor|3|3trx}}'''&nbsp;: Utile seulement si vous utilisez l'option «&nbsp;Créer les activités inexistantes&nbsp;». Il est impossible d'avoir plus d'une provenance pour un code d'activité donné.  
+
'''{{Anchor|3|3trx}}'''&nbsp;: 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}}'''&nbsp;: Si l'activité de la transaction est par «&nbsp;prix de vente&nbsp;», on doit entrer une quantité ou un montant de don.  
+
'''{{Anchor|4|4trx}}'''&nbsp;: If the transaction activity is defined by sales price, a quantity or gift amount must be entered.  
  
'''{{Anchor|5|5trx}}'''&nbsp;: Obligatoire si le mode de paiement utilisé est de type «&nbsp;Don en nature&nbsp;».  
+
'''{{Anchor|5|5trx}}'''&nbsp;: Required if payment method is gift in kind.  
  
'''{{Anchor|6|6trx}}'''&nbsp;: Le champ doit contenir au moins 1 caractère et un maximum de&nbsp;? caractères. La longueur maximale est définie dans la «&nbsp;Configuration des paiements électroniques&nbsp;».  
+
'''{{Anchor|6|6trx}}'''&nbsp;: 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}}'''&nbsp;: Ce champ est obligatoire si les 3 autres champs liés à la validation RIB sont utilisés.  
+
'''{{Anchor|7|7trx}}'''&nbsp;: This field is required if the 3 other RIB validation-related fields are used.  
  
'''{{Anchor|8|8trx}}'''&nbsp;: Cette colonne est ignorée si la colonne TrxTiersNuc existe.  
+
'''{{Anchor|8|8trx}}'''&nbsp;: This column is ignored if the TrxThirdPartyUCN column exists.  
  
'''{{Anchor|9|9trx}}'''&nbsp;: Pour les valeurs personnalisées ou les caractéristiques, il faut indiquer le libellé défini dans ProDon, précédé du préfixe «&nbsp;Trx&nbsp;», en ne conservant que les lettres et les chiffres. Par exemple, un champ nommé&nbsp;% d'individus deviendrait TrxDIndividus.<br>  
+
'''{{Anchor|9|9trx}}'''&nbsp;: 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 15:01, 25 October 2010

Template:Header ProDon


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.

Variables
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