38
Pour Windows 7®, Windows 8® et Windows 10® Pour Windows Server 2008, 2012, 2016, 2019® Guide d’installation du DataPlug et des connecteurs Oxatis Sage – EBP – OpenScript Version 9.60

Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

  • Upload
    others

  • View
    1

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Pour Windows 7®, Windows 8® et Windows 10®

Pour Windows Server 2008, 2012, 2016, 2019®

Guide d’installation du DataPlug

et des connecteurs Oxatis

Sage – EBP – OpenScript

Version 9.60

Page 2: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 2 / 38

Accueil Bienvenue dans la documentation d’installation des Connecteurs Oxatis.

Le connecteur est l’outil qui permet d’échanger automatiquement des données entre votre/vos site(s)

Oxatis et votre Gestion Commerciale.

Le premier chapitre de ce guide est consacré à la présentation des généralités des Connecteurs Oxatis.

Les chapitres suivants précisent les différentes phases d’installation et de configuration à suivre pour la

mise en place du Connecteur Oxatis.

Enfin un dernier chapitre est dédié à vous aider dans le choix du mode de fonctionnement du Connecteur

Oxatis à mettre en place en fonctions de vos besoins.

Des guides d’utilisation des Connecteurs Oxatis sont disponibles en téléchargement depuis l’aide en ligne

Oxatis ou depuis les prérequis techniques.

Nous vous souhaitons une bonne lecture, une bonne installation et surtout une bonne utilisation au

quotidien.

Les collaborateurs d’Oxatis se tiennent à votre disposition pour vous accompagner, notamment par le

biais de l’assistance en ligne à partir de votre site.

L’équipe Oxatis

Page 3: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 3 / 38

Sommaire Accueil ............................................................................................................................................................ 2

Sommaire ................................................................................................................................................... 3

Introduction ............................................................................................................................................... 5

Mode de fonctionnement du Connecteur Oxatis .............................................................................. 5

Détail des opérations exécutées par le Connecteur Oxatis ....................................................... 6

Terminologie ..................................................................................................................................... 6

Les consoles d’administration du Connecteur Oxatis ...................................................................... 7

Mise en Garde ........................................................................................................................................ 8

Le téléchargement du Setup d’installation ......................................................................................... 9

Installation du Connecteur Oxatis ............................................................................................................ 11

Prérequis .................................................................................................................................................. 11

Assistant d’installation ............................................................................................................................ 12

Assistant de démarrage ............................................................................................................................. 17

La configuration de la base de données .............................................................................................. 17

L’authentification du site ........................................................................................................................ 19

La Source de données ............................................................................................................................ 22

Fichier Excel ou CSV ....................................................................................................................... 23

Connexion à une Gestion Commerciale ..................................................................................... 24

Le mode de configuration ...................................................................................................................... 25

Le mode rapide .................................................................................................................................... 25

Le mode Expert .................................................................................................................................... 25

Connecteurs et modes de configuration associés .............................................................................. 26

Annexes ........................................................................................................................................................ 27

Comparatif fonctionnel .......................................................................................................................... 27

Déploiement du DP-Connecteur ........................................................................................................... 30

Répertoire d’installation par défaut .................................................................................................. 30

Répertoire des fichiers de données (par défaut) ............................................................................. 30

Répertoire des fichiers de sauvegarde (par défaut) .................................................................. 30

Répertoire des données ................................................................................................................ 30

Répertoire des images ................................................................................................................... 30

Répertoire des fichiers Logs tâches planifiées (Planificateur).................................................. 30

Répertoire des fichiers temporaires ............................................................................................ 30

Page 4: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 4 / 38

Répertoire des fichiers Paramètres ............................................................................................. 31

Répertoire des fichiers copies écrans des paramètres ............................................................. 31

Le DP-Connecteur multi-instances ....................................................................................................... 32

Introduction .......................................................................................................................................... 32

Paramétrage ......................................................................................................................................... 33

Syntaxe ............................................................................................................................................ 33

Exemples ......................................................................................................................................... 33

Lancement et planification ................................................................................................................. 35

Exemple de planification ............................................................................................................... 35

Lancement d’une même instance ................................................................................................ 36

Planification d’une même tache ................................................................................................... 36

Exploitation ........................................................................................................................................... 37

Exécution des taches ..................................................................................................................... 37

Filtres appliqués sur le dernier import ........................................................................................ 38

L’historique des tâches .................................................................................................................. 38

Page 5: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 5 / 38

Introduction Le DataPlug Oxatis est le logiciel dédié au transfert des articles, des clients utilisateurs et des bons

de commande entre un site e-Commerce Oxatis et des fichiers locaux (.csv, .xml, .jpg…).

Totalement intégré au menu du DataPlug, le connecteur Oxatis permet d’automatiser la liaison

entre les articles, les clients et les commandes directement depuis ou vers une base de données

Gestion Commerciale.

Mode de fonctionnement du Connecteur Oxatis

Import et Transfert des fiches Article et Client/Contact

Téléchargement et Export des commandes et création de fiches Client

Mise à jour et transfert des états d’avancement des bons de commande

Les e-commerçants vont ainsi bénéficier d’une parfaite intégration de leur Gestion Commerciale à

leur boutique en ligne.

En collaboration avec les principaux éditeurs de logiciels de gestion, partenaires e-commerce

exclusifs, les experts Oxatis ont développé les connecteurs qui permettent d’intégrer les

fonctionnalités majeures dédiées à la vente en ligne.

Gestion Commerciale (ERP) Connecteur (DP – DataPlug)Console administration Site (BO –

Back Office)Site (FO – Front Office)

Gestion Commerciale (ERP) Connecteur (DP – DataPlug)Console administration Site (BO –

Back Office)Site (FO – Front Office)

Gestion Commerciale (ERP) Connecteur (DP – DataPlug)Console administration Site (BO –

Back Office)Site (FO – Front Office)

Page 6: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 6 / 38

Détail des opérations exécutées par le Connecteur Oxatis

Pour chaque opération, une étape de paramétrage est proposée. Elle va permettre de

déterminer les critères sur lesquels le traitement va être lancé.

Terminologie

Ordre Taches Gestion

Commerciale

Connecteur

Oxatis

Site Oxatis

1 Import des images et des articles

2 Transfert des images et des articles

3 Import des Client/Contact

4 Transfert des Client/Contact

5 Téléchargement des commandes Oxatis

6 Export des commandes Oxatis (Et création des Nouvelles fiches Client)

7 Mise à jour des états d’avancement

8 Transfert des états d’avancement

Opérations Informations

Import

L’import consiste à utiliser le modèle de données et les interfaces

spécifiques de la Gestion Commerciale (Objets Métiers, SDK…)

pour récupérer les données (Images, Articles, Clients) commerciales et

les intégrer dans la base du Connecteur.

Transfert Le transfert consiste à utiliser la technologie Web Services pour recueillir

les données (Images, Articles, Clients) de la base du Connecteur et les

enregistrer au niveau du site Oxatis.

Téléchargement Le téléchargement consiste à utiliser la technologie Web Services pour

récupérer des données (commandes et nouveaux clients) depuis le site

Oxatis et les intégrer dans la base du Connecteur.

Export

L’export consiste à utiliser le modèle de données et les interfaces

spécifiques de la Gestion Commerciale (Objets Métiers, SDK…)

pour recueillir les données (commandes et nouveaux clients) de la base

du Connecteur et les enregistrer au niveau de la Gestion Commerciale.

Page 7: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 7 / 38

Les consoles d’administration du Connecteur Oxatis

2 consoles d’administration sont proposées en fonction du mode de configuration adopté.

Console d’administration du connecteur en mode Quick Connect (mode Rapide)

Console d’administration du connecteur en mode Expert

Page 8: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 8 / 38

Mise en Garde

Le Connecteur Oxatis permet de faire communiquer deux bases de données qui ont des points

communs mais qui ne sont absolument pas identiques.

• Le connecteur associe en standard les données qui peuvent l'être de manière évidente

avec si nécessaire une transformation.

• Les données non standard de type "info perso" ou des zones détournées du logiciel de

Gestion Commerciale peuvent être associées de manière manuelle au niveau des

assistants d'importation/exportation.

Après la publication de ces informations, il reste à les maintenir à jour sans que la notion de mise

à jour n’existe dans la base de données initiale. Il faut donc vérifier les changements pour chaque

article et chaque client, d'où un temps de traitement incompressible.

Concernant l'écriture dans la base Gestion Commerciale, il existe des contraintes techniques qui

empêchent d’obtenir le même comportement que celui pratiqué par l’application.

Tous ces éléments font donc partie du fonctionnement normal de l'application.

Toujours dans l'esprit d'obtenir une solution de qualité, l’équipe Oxatis reste à votre disposition

pour toute correction à apporter sur un dysfonctionnement détecté ou pour toute demande

d'évolution produit.

Dans ce guide :

Des conseils et des remarques d’experts agrémentent cette documentation et sont

signalés par ce symbole de couleur bleue.

Des points de vigilance particuliers sont signalés par ce symbole de couleur orange.

Page 9: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 9 / 38

Le téléchargement du Setup d’installation

Le programme d’installation est disponible depuis :

• L’aide en ligne Oxatis : https://help.oxatis.com/s/?language=fr

Cette aide en ligne propose également de consulter et de télécharger les guides

d’installation et d’utilisation des connecteurs Oxatis.

Page 10: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 10 / 38

• Les prérequis : http://www.support-oxatis.com/brief-connecteur.htm

Le Setup d’installation ainsi que les guides d’installation et d’utilisation des connecteurs

Oxatis sont disponibles depuis cette page des prérequis techniques.

Page 11: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 11 / 38

Installation du Connecteur Oxatis Ce chapitre est consacré à l’installation pas à pas du Connecteur Oxatis.

Prérequis Avant toute installation et exploitation des Connecteurs Oxatis, il est nécessaire de valider les

préconisations techniques obligatoires.

Dans le cas où le Connecteur Sage 100 i7 version 9 doit être déployé, il est nécessaire

de s’assurer que la version 3.11 des Objets Métiers Sage soit installé au préalable sur

l’environnement concerné.

Eléments Détails

Site L’utilisation du Connecteur Oxatis nécessite l’activation de services sur votre

site e-Commerce Oxatis. Cette opération est réalisée lors de la souscription.

Le nom et le mot de passe du site Oxatis

Internet et réseaux En fonction de la politique de sécurité de l’entreprise, il peut être nécessaire

de contacter l’Administrateur système et réseau pour permettre une

communication sur les ports 80 et 443.

Navigateurs internet Chrome de Google, Firefox de Mozilla

Systèmes d’exploitation Postes clients : toutes les versions de Windows Workstation à partir de

Windows 7 Edition professionnelle ou entreprise.

Serveurs : toutes les versions de Windows Server à partir de Windows Server

2008, hors éditions "Small Business Server".

Logiciel ERP Editeurs et versions à respecter

Tous les détails depuis http://www.support-oxatis.com/brief-connecteur.htm

Page 12: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 12 / 38

Assistant d’installation Le programme d’installation DataPlug s’effectue depuis le fichier OxatisDataPlugSetupFR.msi.

Il suffit d’accepter le contrat de licence utilisateur pour poursuivre l’installation

Page 13: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 13 / 38

Un dossier d’installation est proposé par défaut.

L’option Installer Oxatis DataPlug pour vous ou pour toute personne qui utilise cet ordinateur

permet de restreindre l’accès à l’application.

Option non cochée ou option cochée avec choix Tout le monde

L’application DataPlug d’Oxatis est utilisée par toutes les sessions utilisateur qui ont l’accès au

poste de travail sur lequel est déployé la solution Oxatis.

Option cochée avec choix Seulement moi

L’application DataPlug d’Oxatis est utilisée uniquement par la session de l’utilisateur en-cours

d’installation.

Préconisations

Afin de pouvoir partager la base de données et de favoriser le changement

d’utilisateur, nous vous conseillons d’opter pour une des configurations suivantes :

• Une session de bureau à distance et une installation avec l’option Seulement

moi. Cette session peut alors être utilisée alternativement par plusieurs personnes

qui en connaissent l’accès. Elle permet également au DataPlug, lorsque la session

n’est pas arrêtée, de fonctionner en tâche de fond et de poursuivre

l’automatisation des échanges de données 24h/24h grâce au planificateur de

tâches.

• Un poste partagé et une installation avec l’option Tout le monde afin de permettre

d’accéder au DataPlug à partir de plusieurs sessions Windows sur un même

ordinateur.

Page 14: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 14 / 38

Il suffit de valider l’installation par le bouton …

… pour déclencher le déploiement de la solution.

Page 15: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 15 / 38

L’opération terminée, l’exécution du DataPlug peut être lancée par le bouton avec

l’option Exécuter Oxatis DataPlug cochée.

L’application se lance.

Le message suivant apparaît

Page 16: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 16 / 38

Pour permettre la mise en place et l’utilisation du DP-Connecteur, il est nécessaire d’exécuter

l’application en mode Administrateur.

L’installation a générée un bouton raccourci sur le bureau Windows.

Il suffit de :

1. Effectuer un clic droit et d’accéder aux Propriétés

2. Sélectionner le volet Compatibilité, d’activer l’option Exécuter ce programme en tant

qu’administrateur et de cliquer sur le bouton [Appliquer] puis [OK]

3. Lancer le DP-Connecteur par un double clic sur le raccourci

Page 17: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 17 / 38

Assistant de démarrage La mise en place du connecteur Oxatis comporte 4 étapes :

1. Configurer le moteur de base de données

2. Etablir la connexion avec le site e-Commerce Oxatis

3. Définir la source des données

4. Déterminer le mode de fonctionnement

La configuration de la base de données Pour une base de données performante (optimisation des temps de traitements), il est nécessaire

d’adopter le moteur de données correspondant à la volumétrie d’informations à gérer dans le DP-

Connecteur.

Si dans l’environnement d’installation du DP-Connecteur, Microsoft SQL Server 2012

LocalDB est déjà déployé, ce choix n’est pas proposé. Si l’installation concerne

l’utilisation du DataPlug en mode OpenScript, il est nécessaire de déployer la solution

Microsoft SQL Server 2012 LocalDB.

Si la volumétrie dépasse ultérieurement la limite indiquée, le changement de moteur

de base de données peut s’effectuer très facile grâce à la fonction Outils > Base de

données du DataPlug > Convertir la base de données SQL CE en SQL Server 2012

LocalDB disponible depuis la console d’administration du DP-Connecteur.

Nombre de fiches à gérer Moteur de base de données Bouton

Moins de 2000 fiches Article et Client Moteur de base de données SQL CE

Plus de 2000 fiches Article et Client Moteur de base de données SQL Express

Page 18: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 18 / 38

Dans le cas où le choix a été effectué sur la mise en place du moteur de base de données SQL

Express LocalDB, le système effectue le téléchargement et l’installation de Microsoft SQL Server

2012 Express LocalDB

La fonction Windows Programmes et fonctionnalités affiche son déploiement.

Le DP-Connecteur Oxatis ne fonctionne plus si vous procédez à la désinstallation de ce

programme.

Page 19: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 19 / 38

L’authentification du site La première étape de l’assistant de démarrage consiste à s’authentifier sur le site e-Commerce à

l’aide du nom du site et du mot de passe communiqué par notre conseiller clientèle Oxatis.

Dans le cas où les données du DP-Connecteur sont déjà existantes, l’assistant de

démarrage propose un bouton

qui permet d’effectuer directement la restauration d’une sauvegarde du DataPlug.

Page 20: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 20 / 38

Le bouton déclenche automatiquement l’ouverture du navigateur internet avec un accès

à l’espace membres d’Oxatis.

Il suffit de saisir le nom du site concerné, ainsi que son mot de passe.

Dans le cas où l’identification échoue, veuillez contacter notre conseiller clientèle

Oxatis.

Le message suivant confirme votre authentification et permet de poursuivre la procédure.

Page 21: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 21 / 38

Il suffit de revenir sur l’assistant du Connecteur Oxatis pour finaliser l’opération d’authentification.

Le bouton permet de confirmer la connexion.

Page 22: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 22 / 38

La Source de données La seconde étape de l’assistant va permettre de définir la source de données pour le site e-

Commerce Oxatis connecté.

2 sources de données sont proposées :

La source de données Fonctions

Fichier Excel ou CSV Le choix de cette source permet de mettre en place une synchronisation

des données avec le site e-Commerce Oxatis depuis des fichiers au format

Excel ou CSV via le connecteur Excel/CSV/OpenScript planifiable.

Connexion à une

Gestion Commerciale

Le choix de cette source permet de mettre en place une synchronisation des

données avec le site e-Commerce Oxatis depuis une Gestion Commerciale

via l’un des connecteurs ERP (Sage, Ciel, EBP …)

Page 23: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 23 / 38

Fichier Excel ou CSV

L’utilisation de la source Fichier Excel ou CSV de données permet de :

➢ Transférer des données telles que les articles, les images, les utilisateurs (clients/contacts)

depuis des fichiers au format texte (.csv) ou Excel (.xls, .xlsx) vers le site e-Commerce Oxatis,

➢ Récupérer des données telles que les bons de commande saisis sur le site e-Commerce

Oxatis.

Tous les détails sur la configuration et l’’utilisation de ce connecteur depuis l’aide en

ligne Oxatis :

https://help.oxatis.com/s/article/dataplug-guide-conditions-utilisation?language=fr

Page 24: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 24 / 38

Connexion à une Gestion Commerciale

Ce choix permet d’établir une connexion avec une Gestion Commerciale selon un mode.

Si à cette étape, cette page de l’assistant ne s’affiche pas, le site ne doit certainement

pas posséder les services nécessaires pour la mise en place du connecteur. Se reporter

aux prérequis techniques.

2 modes de configuration sont proposés :

Selon l’évolution des besoins, l’utilisation du connecteur Oxatis en mode Quick Connect

peut s’avérer par la suite incomplet. Dans ce cas, il est très facile de basculer la

connexion en mode Expert. Tous les détails sur cette fonctionnalité depuis le guide

d’utilisation des Connecteurs Oxatis en mode Quick Connect (mode rapide).

Le mode Fonctions

Quick Connect Ce mode de configuration permet de déployer simplement et rapidement la

connexion du site avec une base Gestion Commerciale.

Ce mode de configuration ne nécessite aucun paramétrage particulier

Expert Ce mode de configuration propose de bénéficier de toutes les options de configuration

afin d’obtenir une mise en place optimale.

Pour un paramétrage qui sollicite d’activer certaines options (multi dépôts, multi

tarifs, multi livraisons…), ce choix est plus approprié.

Page 25: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 25 / 38

Le mode de configuration

Le mode rapide

2 connecteurs Gestion Commerciale sont proposés dans ce mode de configuration.

Le mode Expert

Tous les connecteurs Gestion Commerciale disponibles sont accessibles par ce mode de

configuration

Page 26: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 26 / 38

Connecteurs et modes de configuration associés Le tableau suivant présente une synthèse des modes de configuration par source de données.

Un comparatif fonctionnel est disponible dans le chapitre suivant pour vous aider à effectuer votre

choix.

Nos consultants Experts Oxatis restent à votre disposition pour tout complément

d’informations via le support technique depuis votre console d’administration de votre

site (Back office).

En fonction de la solution de Gestion et du mode de fonctionnement sélectionnés, des guides

d’utilisation des Connecteurs Oxatis sont disponibles depuis :

• L’aide en ligne Oxatis : https://help.oxatis.com/s/?language=fr

• Les prérequis Connecteurs Oxatis : http://www.support-oxatis.com/brief-connecteur.htm

Source de données Configuration Quick Connect Configuration Expert

EBP open Line

Sage 100cloud V6

Sage 100cloud V5

Sage 100cloud V3/v4

Sage 100 i7 V9

Page 27: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 27 / 38

Annexes

Comparatif fonctionnel Les fonctionnalités présentes dans les tableaux ci-après peuvent varier selon la solution de Gestion

Commerciale à connecter.

Pour obtenir plus de détails, veuillez-vous reporter aux guides d’utilisation du

Connecteur Oxatis correspondants à votre version de Gestion Commerciale.

Fonctionnalités Le mode Rapide (Quick Connect) Le Mode Expert

Langues

France

Autres pays (Angleterre, Espagne,

Allemagne, Italie, Pays-Bas, Portugal,

Catalogne)

TVA par Pays France métropolitaine

Gestion des tarifs

Multi-tarifs Prix de vente principal 10 max.

Remise client simple sur tous les

articles (%)

10 max.

Remise client globale (panier)

Remise associée à un article et un

client (Tarif d'exception)

Remise associée à une famille

d'articles et un client

Remise sur quantité

(% - avec palier)

Remise sur montant

(% - avec palier)

Remise sur prix net

Priorité tarifs d'exception

Tarifs en devises

Page 28: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 28 / 38

Fonctions Le mode Rapide (Quick Connect) Le Mode Expert

Gestion des articles

Gammes ou options

Article visible / invisible et Position

de l'article dans le catalogue

Descriptions et descriptions

détaillées, Url externe

Dimensions (hauteur, largeur,

longueur), marques…

Prix barrés

Eco-participation

Articles à conditionnement (mono)

Nomenclature de fabrication

Articles liés

Articles composés (Pack) -

Nomenclature commerciale

composée

Upsell / Cross-sell (Ventes

suggestives, meilleures ventes…)

Navigation / recherche à facettes

Catégorie(s) d'articles 1

Gestion des stocks

Consolidation multi-dépôts

Gestion des images

Principales, vignettes et zoom

Additionnelles

Images dynamiques

Page 29: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 29 / 38

Fonctions Le mode Rapide (Quick Connect) Le Mode Expert

Gestion des clients (Utilisateurs)

Import des contacts

Catégorie(s) de clients 1

Clients en compte ou paiement sur

site

Mots de passe clients, points de

fidélité

Abonnement à la lettre

d'information, abonnement aux

campagnes SMS

Import des adresses de livraison

complémentaires

Représentant affecté au client

Gestion des commandes

Création des commandes

Choix d'un dépôt par défaut ou

dépôt du client Le premier de la liste

Multidevises

Gestion des articles avec

nomenclatures

Association des modes de livraisons

et de paiement Oxatis et Gestion

commerciale

1 mode de livraison par défaut

Instructions spéciales de

commandes et informations de

livraison

Création des nouveaux clients

Création des acomptes

Mise à jour des états d’avancement

et PDF associés

Planificateur de tâches

Import des articles Toutes les X heures Mode avancé

Import des clients Toutes les X heures Mode avancé

Export des commandes Toutes les X heures Mode avancé

MAJ états avancement Mode avancé

Page 30: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 30 / 38

Déploiement du DP-Connecteur

Répertoire d’installation par défaut

C:\Program Files (x86)\Oxatis

Répertoire des fichiers de données (par défaut)

C:\ProgramData\Oxatis

Ce répertoire n’est peut-être pas visible. Il suffit d’activer l’affichage des éléments

masqués depuis l’explorateur Windows.

Répertoire des fichiers de sauvegarde (par défaut)

C:\ProgramData\Oxatis\Backup

Répertoire des données

C:\ProgramData\Oxatis\DATA

Il contient les fichiers de la base de données :

• OxDataPlug.mdf et OxDataPlug.log (SqlCe)

• OxDataPlugLocalDB.MDF et OXDATAPLUGLOCALDB_log.ldf (LocalDB)

Le fichier de configuration du DP-Connecteur : OxDataPlugConfig

Les fichiers LogError : [AnnéeMoisJourHeuresMinutesSecondes]_Ox.DataPlug.Application.exe.OxLog

Répertoire des images

C:\ProgramData\Oxatis\DATA\[Id Site]

[Id Site] = N° identifiant du site Oxatis

Répertoire des fichiers Logs tâches planifiées (Planificateur)

C:\ProgramData\Oxatis\DATA\[Id Site Oxatis]\TasksLogs

Répertoire des fichiers temporaires

C:\ProgramData\Oxatis\DATA\[Id Site Oxatis]\Temp

Page 31: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 31 / 38

Répertoire des fichiers Paramètres

C:\ProgramData\Oxatis\DATA\[Nom ERP]

[Nom ERP] = Nom de la solution de gestion (ex : SageBO pour Sage, EBP pour EBP OL …)

Format du nom du fichier paramètre : [Id Site]_[langue].[Nom ERP] (ex : 999999_fr.SageBO)

Répertoire des fichiers copies écrans des paramètres

Entités Emplacements

Articles C:\ProgramData\Oxatis\DATA\[Nom ERP]\Products

Clients C:\ProgramData\Oxatis\DATA\SageBO\Users

Entités Emplacements

Mise à jour des états

d’avancement

C:\ProgramData\Oxatis\DATA\[Nom

ERP]\OrderProgressStatesHistory\ScreenCaptures Commandes C:\ProgramData\Oxatis\DATA\[Nom ERP]\Orders\ScreenCaptures [langue]

Articles C:\ProgramData\Oxatis\DATA\[Nom ERP]\Products\ScreenCaptures [langues]

Paramètres

généraux C:\ProgramData\Oxatis\DATA\[Nom ERP]\SageFRSettings\ScreenCaptures

Clients C:\ProgramData\Oxatis\DATA\SageBO\Users\ScreenCaptures

Page 32: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 32 / 38

Le DP-Connecteur multi-instances

Introduction

Le multi-instances va permettre de lancer plusieurs fois le DP-Connecteur depuis le poste de travail

où il est déployé avec un numéro d’instance différent. Cette fonctionnalité est très utile lorsque

certaines opérations nécessitent un temps de traitement assez important (ex : la volumétrie des

données à traiter)

Cela permet surtout de mettre en place des tâches planifiées distincts sur chaque instance et de

les exécuter en simultané.

Chaque Numéro d’instance utilisé est indiqué sur la console d’administration du DP-Connecteur.

Fonction disponible depuis la version 9.60 du DP-Connecteur.

Page 33: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 33 / 38

Paramétrage

Syntaxe

La syntaxe à exécuter depuis l’invite DOS (CMD Windows) est :

C:\Program Files (x86)\Oxatis\DataPlug\Ox.DataPlug.Application.exe INSTANCE=[N° Instance]

Exemples

Instance Tâches Syntaxe depuis la commande DOS

0 Aucune planification C:\Program Files

(x86)\Oxatis\DataPlug\Ox.DataPlug.Application.exe

1 Téléchargement &

Export des

commandes

C:\Program Files

(x86)\Oxatis\DataPlug\Ox.DataPlug.Application.exe INSTANCEID=1

3 MAJ du Stock C:\Program Files

(x86)\Oxatis\DataPlug\Ox.DataPlug.Application.exe INSTANCEID=3

5 Import & transfert des

articles

C:\Program Files

(x86)\Oxatis\DataPlug\Ox.DataPlug.Application.exe INSTANCEID=5

7 Import & transfert des

clients

C:\Program Files

(x86)\Oxatis\DataPlug\Ox.DataPlug.Application.exe INSTANCEID=7

9 MAJ des états

d’avancement

C:\Program Files

(x86)\Oxatis\DataPlug\Ox.DataPlug.Application.exe INSTANCEID=9

Page 34: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 34 / 38

La commande peut être également lancée depuis un fichier .BAT

Exemple de fichier sur le lancement du DP-Connecteur en instance N°3 :

echo off

cls

echo -------------------------------------------------------------

echo Lancement du DP-Connecteur Instance 3

echo -------------------------------------------------------------

echo -------------------------------------------------------------

echo Pour arreter definitivement l'instance,

echo quittez le DP-Connecteur (Site > Quitter)

echo Cette fenetre se ferme automatiquement

echo -------------------------------------------------------------

pause

CD\Program Files (x86)

CD Oxatis\DataPlug

Ox.DataPlug.Application.exe INSTANCEID=3

echo on

Exit

Il suffit de quitter définitivement l’application (fonction Site > Quitter) pour clore la

commande.

Page 35: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 35 / 38

Lancement et planification

Exemple de planification

Instance 1 – Flux Commandes

Instance 3 – Mise à jour du stock

Pour connaître le paramétrage du planificateur et son mode de fonctionnement,

veuillez-vous reporter au chapitre concerné depuis le guide d’utilisation du DP-

Connecteur.

Page 36: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 36 / 38

Lancement d’une même instance

Dans le cas où une même instance est en cours d’exécution un message apparaît et la nouvelle

instance n’est pas lancée.

Planification d’une même tache

Dans le cas où une instance est lancée avec la mise en place d’une tache planifiée déjà programmée

sur une autre instance, le message suivant apparait et la planification ne peut être validée.

Page 37: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 37 / 38

Exploitation

Exécution des taches

Les tâches planifiées par instance sont ainsi exécutées et peuvent être déclenchées au même

instant.

Page 38: Guide d’installation du DataPlug et des connecteurs Oxatis ... · Oxatis à mettre en place en fonctions de vos besoins. Des guides d’utilisation des Connecteurs Oxatis sont disponibles

Connecteurs Oxatis Version 9.60

23 juin 2020

Page 38 / 38

Filtres appliqués sur le dernier import

Chaque tache s’appuie sur le dernier paramétrage et traitement lancé manuellement.

Par conséquent, si des filtres ont été appliqués (ex : sélection sur familles d’articles, Choix sur les

codes clients…), il est nécessaire de lancer à nouveau les opérations manuellement en supprimant

les filtres. Certains assistants proposent également une option qui permet de Ne pas sauver les

paramètres d’import lors de l’exécution manuelle.

L’historique des tâches

Quel que soit l’instance sur laquelle l’utilisateur est positionné, l’historique des tâches permet de

visualiser toutes tâches exécutées par les différentes instances avec leur statut et message associé.