Aucxis W-Fish Mode d'emploi

CCI DE QUIMPER
MODE D’ EMPLOI
PARTIE EXTERNE
EXPORTATION
TRANSACTIONS
SUR W-FISH
22 Décembre 2011
Version 2.1
Laprudence Christophe
Aucxis Trading Solutions cvba
Zavelstraat 40, 9190 Stekene, België - tel. +32 (0)3 790 17 17 - fax.+32 (0)3 790 17 18 - RPR Dendermonde 04 292851 78
[email protected] - www.aucxis.com
QUI-Mode d’Emploi – Partie externe exportation transactions sur W-Fish – p. 2/8
CONTENU
1.
INTRODUCTION ....................................................................................................................................................... 3
1.1 BUT DU DOCUMENT .................................................................................................................................................. 3
1.1.1
Abréviations................................................................................................................................................. 3
2.
CONFIGURATION DE LA FONCTIONALITÉ ........................................................................................................... 4
2.1
2.2
3.
PAGE WEB .............................................................................................................................................................. 4
BASE DE DONNEES ................................................................................................................................................... 4
DESCRIPTION TECHNIQUE .................................................................................................................................... 5
3.1 EXPORTER LES TRANSACTIONS .................................................................................................................................. 5
3.1.1
URL ............................................................................................................................................................. 5
3.1.2
Paramètres URL.......................................................................................................................................... 5
3.1.3
Format d‘exportation ................................................................................................................................... 6
3.2 SUIVI DES ERREURS ................................................................................................................................................. 7
3.2.1
Messages d’erreurs en cas d’appel url non valable..................................................................................... 7
3.2.2
Pas d’autorisation sur les données de transaction ...................................................................................... 7
4.
TESTS ....................................................................................................................................................................... 8
4.1
PAR LE NAVIGATEUR................................................................................................................................................. 8
 Aucxis Trading Solutions cvba. All rights reserved.
QUI-Mode d’Emploi – Partie externe exportation transactions sur W-Fish – p. 3/8
1. INTRODUCTION
1.1 BUT DU DOCUMENT
Dans ce document, nous décrivons l’opération de la fonctionnalité comme stipulé dans l’offre QUI.90.69 de
Rony Steelandt pour l’exportation des données de transaction sur demande, de sorte qu’ un système d’une
partie externe peut les consulter / traiter en temps réel.
CCI de Quimper peut aussi utiliser ce document pour fournir des informations techniques aux parties
externes concernant l’usage de cette fonctionnalité.
1.1.1 ABREVIATIONS
•
•
W-FISH
Site web de CCI de Quimper joignable sur http://www.w-fish.com
ASPX
Page serveur actif. Technologie par laquelle W-FISH est construit.
 Aucxis Trading Solutions cvba. All rights reserved.
QUI-Mode d’Emploi – Partie externe exportation transactions sur W-Fish – p. 4/8
2. CONFIGURATION DE LA FONCTIONALITE
2.1 PAGE WEB
Cette fonctionnalité est construite dans une page ASPX.
Cette page est à mettre sur le site web W-FISH sous le nom ‘Export4ThirdParty.aspx’.
Aucxis s’occupe de l’installation et la configuration de cette page web (tant le site web de production que le
site web de sauvegarde).
2.2 BASE DE DONNEES
La nouvelle page web se sert une ‘stored procedure’ sur la base des données QUI_WEB.
La procédure qui est utilisée pour ce but est: spWeb_Export4ThirdParty.
Aucxis s’occupe de l’installation et la configuration de ces procédures dans les bases de données (tant la
production que la base de données de sauvegarde).
 Aucxis Trading Solutions cvba. All rights reserved.
QUI-Mode d’Emploi – Partie externe exportation transactions sur W-Fish – p. 5/8
3. DESCRIPTION TECHNIQUE
3.1 EXPORTER LES TRANSACTIONS
3.1.1 URL
On peut ouvrir les données de transaction à l’aide de la nouvelle page ASPX. Il s’agit d’une requête http au
site web W-FISH.
Cette page est a ouvrir par le URL suivant:
http://www.w-fish.com/Export4ThirdParty.aspx
3.1.2 PARAMETRES URL
Le URL est à compléter avec des paramètres. On ajoute des paramètres dans un URL en mettant un ?
derrière le URL.
Le nom du paramètre doit être suivi pas la valeur du paramètre, séparé par un signe =.
Si plusieurs paramètres sont donnés, ils sont séparés par un signe &.
http://www.wfish.com/Export4ThirdParty.aspx?parameter1=parameterwaarde1&parameter2=parameterwaarde2 …
Les paramètres suivants sont à donner obligatoirement dans le URL:
Nom du paramètre
Login
Pass
Acheteur
Datedevente
Heuredevente
Description
Login de l’utilisateur wfish
Mot
de
passe
de
l’utilisateur w-fish
Numéro d’acheteur pour
lequel les transactions
sont demandées.
Date de laquelle les
transactions
sont
demandées.
Limite
inférieure
du
moment
des
transactions
demandées. Toutes les
transactions plus tard ou
pareil à ce moment sont
exportés.
Format
Identique au login pour
w-fish
Identique au login pour
w-fish
Numéro d’acheteur de 6
caractères avec zéros
de démarrage
jj/mm/aaaa
hh:mm:ss
Exemple
1301B078600
motdepasse
000786
06/04/2010
17:00:00
Exmpel d’un URL valable:
http://www.wfish.com/Export4ThirdParty.aspx?login=1301B078600&pass=motdepasse&acheteur=000786&datedevente=
06/04/2010&heuredevente=17:00:00
 Aucxis Trading Solutions cvba. All rights reserved.
QUI-Mode d’Emploi – Partie externe exportation transactions sur W-Fish – p. 6/8
3.1.3 FORMAT D‘EXPORTATION
Si le URL est appelé avec les paramètres corrects et si l’utilisateur a la permission (login et mot de passe
correct) de consulter les données de transaction, la page ASPX fournit une réponse http du type texte.
(Techniquement : http réponse type ‘text/plain’)
La réponse http contient X nombre de lignes avec des données de transactions.
Chaque ligne contient les données de transactions d’une transaction.
Les transactions sont séparées par une nouvelle ligne (nouvelle ligne caractère #13#10 ou $0D $0A)
Les champs différents ont une longueur fixe et sont mis s’une seule traite.
Chaque ligne de transaction consiste des données suivantes:
Champ
CRIEE
ACHETEUR
DATE_DE_VENTE
HEURE_DE_VENTE
LOT
NAVIRE
ESPECE
TAILLE
PRESENTATION
QUALITE
POIDS
Description
Code de vente
AD = Audierne
CC = Concarneau
DZ = Douarnenez
GV = Le Guilvinec
LN = Lesconil
LC = Loctudy
SG = Saint Guénolé
Numéro d’acheteur
Date de la transaction
Heure de la transaction
Numéro du lot
Code du navire
Code de l’espèce
Taille de l’espèce
Présentation de l’espèce
Qualité de l’espèce
Poids du lot
BAC
BAC_NBRE
PRIX_KG
Type de caisse
Numéro de caisses
Prix par kilo
TRANS_CODE
PRIX_LOT
Code de transaction
18 = qualité C
11 = vendu
Prix du lot
CODE_CCI_ESPECE
Code CCI Espece
 Aucxis Trading Solutions cvba. All rights reserved.
Format
String[2]
String[6], contient zéros de démarrage
String[8], JJMMAAA
String[6], HHMMSS
String[5]
String[6]
String[5], contient zéros de démarrage
String[2], contient zéros de démarrage
String[3]
String[1]
String[14], contient 2 zéros de démarrage
et 2 décimales après la virgule, signe
virgule = ‘.’
String[3]
String[3]
String[14], contient 2 zéros de démarrage
et 2 décimales après la virgule, signe
virgule = ‘.’
String[2]
String[14], contient 2 zéros de démarrage
et 2 décimales après la virgule, signe
virgule = ‘.’
String[4]
QUI-Mode d’Emploi – Partie externe exportation transactions sur W-Fish – p. 7/8
3.2 SUIVI DES ERREURS
3.2.1 MESSAGES D’ERREURS EN CAS D’APPEL URL NON VALABLE
Si les paramètres introduits dans le URL ne sont pas valables; le message d’erreur est aussi montré comme
réponse http du type texte. (Techniquement : réponse http type ‘text/plain’)
Les messages d’erreur suivants peuvent être montré:
Message
ERROR CODE 001 : Veuillez spécifier un login
ERROR CODE 002 : Veuillez spécifier un mot de
passe
Cause
Le paramètre ‘login’ n’a pas été introduit dans le
URL
Le paramètre ‘pass’ n’a pas été introduit dans le
URL
ERROR CODE 003 : Veuillez spécifier le code
d'acheteur
Le paramètre ‘acheteur’ n’a pas été introduit dans
le URL
ERROR CODE 004 : Veuillez spécifier une date de
vente
Le paramètre ‘datedevente’ n’a pas été introduit
dans le URL
ERROR CODE 005 : Veuillez spécifier une heure de
vente
Le paramètre ‘heuredevente’ n’a pas été introduit
dans le URL
3.2.2 PAS D’AUTORISATION SUR LES DONNEES DE TRANSACTION
Si le URL est appelé en utilisant un login/mot de passe/numéro d’acheteur erroné, une réponse http vide du
type texte sera renvoyé par la page ASPX. (Techniquement : réponse http type ‘text/plain’)
Le login et le mot de passe sont toujours vérifiés en appelant la fonctionnalité. Le numéro d’acheteur est
aussi contrôlé après cette validation. Avec une combinaison login/mot de passe valide on peut seulement
consulter les données de transactions liées à ce login. De cette manière, la consultation des données de
transactions des autres personnes est sécurisée.
 Aucxis Trading Solutions cvba. All rights reserved.
QUI-Mode d’Emploi – Partie externe exportation transactions sur W-Fish – p. 8/8
4. TESTS
4.1 PAR LE NAVIGATEUR
On peut facilement tester cette fonctionnalité dans le navigateur, par exemple Internet Explorer.
Un URL valable est à appeler en l’introduisant manuellement dans la barre d’adresses.
En effet, Internet Explorer peut montrer un type de texte http réponse dan l’écran du navigateur même.
Exemple d’un appel valable:
Exemple d’un appel URL non valable:
 Aucxis Trading Solutions cvba. All rights reserved.
">