# Logiciel Pastèque/Installation desktop

Ces instructions d’installation s’adressent à un public débutant, si vous êtes à l’aise avec l’informatique, vous ne devriez avoir aucune difficulté à installer et lancer le logiciel.

## Télécharger Pastèque

Rendez-vous sur la page https://downloads.pasteque.org/desktop/ pour obtenir la dernière version de Pastèque

## Installation manuelle

Si vous ne souhaitez pas utiliser les installeurs, Pastèque peut fonctionner avec la version standalone.
Pour tous les systèmes, décompressez l'archive pasteque desktop en version standalone. L'installateur graphique effectuera à peu près les mêmes instructions, mais avec moins de contrôle.
Dans tous les cas, Java doit être installé sur le système.

### Windows

La version standalone se lance avec pasteque.exe, qui porte de logo Pastèque. Vous pouvez créer un raccourcis sur le bureau avec le clic droit.

### GNU/Linux

Utilisez le script start.sh pour démarrer Pastèque. Avec les droits root (via sudo ou su) vous pouvez exécuter le script install.sh pour copier les fichiers dans votre système et créer un raccourcis dans le menu d'applications.
Pastèque sera installé dans ce cas dans /opt/pasteque, un executable sera placé dans /usr/bin et un raccourcis dans /usr/share/applications.

### Pour Mac OS

Voici la procédure que j'ai utilisé pour installer Pasteque Desktop sur Mac OS X (Yosemite).
* Installer la dernière version de Java JRE + rebooter
* Télécharger l'application Pasteque Desktop (archive java)
* Lancer l'application Terminal
* Se déplacer dans le dossier où se trouve l'archive java (en principe dans Téléchargements) cd Downloads
* Rendre certain fichiers "exécutables" sudo chmod a+x configure.sh sudo chmod a+x start.sh
* Pouvoir lancer l'application ("start.sh") depuis le Finder Ouvrir le Finder, aller dans le dossier Pasteque Faire <clic droit> sur le fichier "start.sh" Choisir "Ouvrir avec" et "Autre …" Sur la nouvelle fenêtre, changer le champ « Activer » pour « Toutes les applications ». Ensuite cocher la case « Toujours ouvrir avec » et choisir l'application « Terminal » dans le dossier Utilitaires. Terminer en appuyant sur « Ouvrir ». Cette manipulation n'est nécessaire que la première fois.
* Vous pouvez ensuite créer un alias du fichier "start.sh" et le placer dans le Bureau.
* Par la suite, double-cliquer sur le fichier "start.sh", lance Pasteque Caisse

## Configurer Pastèque

Lors du premier lancement de Pastèque ou en y accédant depuis le menu latéral (via un utilisateur administrateur), l'écran de configuration s'ouvre.
Il est divisé en quatre sections.

### Connexion

Les paramètres de connexion concernent votre compte Pastèque. Les informations à y saisir vous sont fournies par votre prestataire Pastèque.

#### Hôte

    L'adresse de l'API Pastèque à laquelle vous vous connectez, comprennent http(s)://.

#### Identifiant

    Votre identifiant de compte Pastèque sur l'API pointée.

#### Mot de passe

    Le mot de passe associé à votre identifiant.

#### Nom de la machine

    Il s'agit du nom de cette caisse. Chaque caisse doit avoir un nom distinct et ils doivent être enregistrés au préalable via l'interface de gestion.
    Par défaut Caisse est renseigné. C'est le nom par défaut de la caisse unique présent dans les données d'exemple.
    Pour utiliser plusieurs caisses, il est nécessaire de créer une nouvelle caisse via l'interface de gestion et il est impératif que chaque caisse physique utilise son propre nom de caisse. Dans ce cas il est préférable de renommer la caisse Caisse pour éviter de l'assigner par erreur.

### Interface

La section interface regroupe les différents comportements de la caisse ainsi que son affichage à l'écran.

#### Apparence

    Définit le thème de couleur de l'interface.

#### Écran

    window pour un affichage fenêtré.
    fullscreen pour un affichage plein écran.

#### Type d'écran

    touchscreen s'assure que les boutons sont de taille raisonnable pour l'utilisation en mode tactile. Ce mode est recommandé même pour un usage à la souris.
    standard ancien mode de fonctionnement sans taille minimale de boutons.

#### Densité de l'écran

    Le nombre de pixels par pouce sur votre écran.
    Sans être aussi précis, augmenter le nombre aura un effet d'agrandissement général (façon zoom) en mode touchscreen.

#### Barre de titre

    Afficher ou non la barre de titre en haut. Désactivé par défaut.

#### Barre du bas

    Afficher ou non la barre informative en bas de l'écran. Désactivé par défaut.

#### Replier le menu

    Replier automatiquement le menu latéral lors de la bascule d'un écran à l'autre pour gagner un peu de place. Activé par défaut.

#### Émettre un beep

    Jouer un son en plus des fenêtres d'alerte. Activé par défaut.

#### Forcer à choisir le mode de paiement

    Lorsque désactivé (par défaut), le premier mode de paiement disponible est déjà sélectionné à l'ouverture de la fenêtre de paiement.
    Si activé, aucun mode de paiement ne sera sélectionné et il faudra en sélectionner un explicitement.

#### Prix sur les boutons de produits

    Contrôle l'affichage du prix des produits sur les boutons en plus de leur intitulé.
    none N'affiche pas le prix.
    untaxed Affiche le prix unitaire hors taxe.
    taxed Affiche le prix unitaire TTC.

#### Tickets

    standard mode file, les tickets mis en attente sont sélectionnable depuis une liste sur l'écran de ventes.
    restaurant affiche le plan de tables, chaque commande est assignée à une table.

#### Type de marge

    non utilisé.

#### Imprimer par défaut

    Active ou non le bouton imprimer à l'ouverture de la fenêtre de paiement. L'impression papier du ticket peut être activée ou non de manière individuelle sur cette fenêtre.

### Périphériques

Cette section concerne le matériel connecté à la caisse.

#### Imprimante

    indique le matériel pour l'imprimante principale.
    screen il n'y a pas d'imprimante physique, les impressions sont visibles dans l'écran Imprimante dans le menu latéral.
    printer utiliser une imprimante installée dans le système d'exploitation. La liste des imprimantes installées s'affiche dans une boîte de sélection un peu plus bas lorsque ce mode d'imprimante est choisi.
    epson, tmu220, star, ithaca, surepos connexion directe entre le logiciel et l'imprimante. Voir la page dédiée à l'impression directe en ESC/POS
    plain ???
    javapos utiliser une imprimante javapos.
    Not defined aucune imprimante.

#### Caractères par ligne

    Indique le nombre de caractères par ligne de ticket.

#### Points par ligne

    Indique le nombre de points d'impression par ligne.
Imprimante 2 et 3 proposent la même configuration. Ces imprimantes supplémentaires peuvent être utilisées pour l'impression de commandes via l'écran des ventes. Lorsqu'elles sont configurées, des boutons supplémentaires apparaissent en haut de l'écran pour envoyer la commande sur l'imprimante ciblée.

#### Afficheur client

    Indique le matériel et le fonctionnement de l'afficheur client

#### Balance

    Indique le matériel utilisé pour la pesée.
    **screen** ouvre une fenêtre de saisie du poids lors de l'ajout d'un produit vendu au poids pour une saisie manuelle.
    Les autres valeurs indiquent le protocole à utiliser pour tenter de se connecter à la balance. Chaque modèle utilise un protocole défini.

#### Scanner

    Indique le matériel spécifique pour lire les codes barres, et l'identification
    L'utilisation de douchettes de lecture de code barre classiques ne nécessite aucune configuration dans Pastèque et la valeur Not defined peut être laissée.

#### Rapports imprimante

    Inutilisé.

### Localisation

Cette section regroupe les paramètres de langue.

#### Localisation

    La langue utilisée ainsi que sa région.
    Si le logiciel est en Anglais , la langue sélectionnée n'est pas disponible. Essayez de changer de région.

## Configurer les périphériques en dehors de Pastèque
### Écran tactile

La gestion de l'écran tactile est laissée au système d'exploitation de l'ordinateur. S'il ne marche pas, consultez la documentation de votre système d'exploitation. Pour tester, appuyez simplement sur l'écran et voyez ce qui se passe.
Il est généralement nécessaire d'installer le driver de l'écran sur votre système d'exploitation. Consultez le site du fabriquant pour l'obtenir.

### Lecteur de code barre

Les lecteurs de code barre simulent le comportement d'un clavier. Quand un code barre est lu, le lecteur envoie à l'ordinateur le nombre du code barre comme s'il avait été saisi au clavier.
Il n'y a rien à configurer dans Pastèque.
Pour tester, ouvrez un éditeur de texte et scannez un code barre. Le code devrait s'afficher.
Si rien ne si affiche, ou si la lecture est erronée, votre lecteur doit probablement être configuré. Cette opération consiste généralement à scanner une série de code barre spéciaux fournis avec le manuel de votre lecteur.
Pour valider la lecture dans Pastèque, assurez-vous que votre lecteur est configuré pour envoyer le code entrer en suffixe du code barre. Lorsque c'est le cas, chaque lecture dans un éditeur de texte effectuera un retour à la ligne automatiquement.

### Tiroir-caisse et imprimante à tickets

Pastèque permet de connecter jusqu'à 3 imprimantes à tickets sur un même terminal. Les modes disponible sont :

#### Printer

Ce mode est pour les imprimantes configurées au niveau du système d'exploitation. C'est le mode recommandé. Sélectionnez l'imprimante via le menu déroulant et cochez la case pour indiquer s'il s'agit d'une imprimante à ticket (inutile si c'est une imprimante normale) Certaines options avancées existent mais n'apparaissent pas dans l'interface. Vous pouvez les régler en modifiant le fichier .pasteque/config.properties situé dans le dossier utilisateur. Voici une liste de ces propriétés :
* paper.receipt.x
* paper.receipt.y
* paper.receipt.width
* paper.receipt.height
* paper.receipt.mediasizename : La propriété mediasizename sert à définir la taille du papier à utiliser (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10).
Les propriétés des abscisses et des ordonnées (X et Y) servent pour définir la zone imprimable sur le papier. Les unités sont des subdivisions de 1/72 ème d'un pouce (2,54cm) Les valeurs par défaut des imprimantes tickets sont celles des matériels Star Micronics et sont les suivantes :
* paper.receipt.x=10
* paper.receipt.y=287
* paper.receipt.width=190
* paper.receipt.height=546
* paper.receipt.mediasizename=A4
Si vous avez une imprimante Epson, modifiez les valeurs pour celles-ci :
* paper.receipt.x=10
* paper.receipt.y=10
* paper.receipt.width=190
* paper.receipt.height=546
* paper.receipt.mediasizename=A4
Pour les imprimantes normales, imprimant des feuilles A4, voici les valeurs :
* paper.standard.x=72
* paper.standard.y=72
* paper.standard.width=451
* paper.standard.height=698
* paper.standard.mediasizename=A4

#### javapos

Ce mode est pour les imprimantes et tiroir-caisses avec un driver JavaPOS installé. Ces pilote sont fournis par le constructeur du matériel ; vous devez suivre ses instructions pour les installer. Quand vous choisissez ce mode, deux zones de texte apparaissent. La première indique le nom de l'imprimante, le second celui du tiroir-caisse.

#### Epson, TMU220, Star, Ithaca et Surepos

Ces modes peuvent être utilisés avec certains matériels spécialisés pour les points de vente. Si vous avez un tel matériel, n'installez pas son pilote : Pastèque se connectera directement avec ses propres drivers.

#### Screen

Mode pour le développement et les tests. Les tickets apparaissent dans « Système → Imprimante »

### Afficheur client

POS-Tech supporte les afficheurs clients de 2 lignes sur 20 caractères.
Nous vous recommandons l'usage d'un afficheur client Epson DM 110 avec un port série et une interface parallèle. Si votre afficheur fait 4 lignes de haut et 30 de larges, seules les deux premières lignes et les 20 premiers caractères sont affichés.
Les afficheurs suivants sont disponibles :
* Window : Une nouvelle fenêtre est créée et sert d'afficheur client. Utile si vous avez 2 écrans
* javapos : Afficheur client avec driver JavaPOS. Le driver doit avoir été installé en suivant les instructions du constructeur du matériel.
* Epson, Ld200, Surepos : Ces modes sont pour différents matériels spécialisés pour les points de vente.
Si vous avez un tel matériel, n'installez pas les drivers pour ces matériel : Pastèque se connectera directement avec ses propres drivers.
* Screen : Affichage sur l'écran, utilisé pour les tests

### Balance

Pastèque gère les balances connectées via un port série en 4800bauds, 8 data bits, 1 stop bit et en parity à odd
Deux protocoles sont supportés :
* Samsung (poids en kilos)
* Dialog1 (poids en grammes)
Si vous n’avez pas de balance connectée, le poids des produits à la pesée vous sera demandé par un pop up

## Configuration avancée

Il est possible de modifier le fichier .pasteque/config.properties présent dans votre répertoire utilisateur (dans /home pour Gnu/Linux, dans /Users pour macOS ou C:\Utilisateurs pour Windows)
Voici les options disponibles et leur valeur par défaut. Notez que plusieurs de ces valeurs sont accessibles via l’interface de gestion des paramètres, mais certaines ne sont disponibles qu’en modifiant le fichier config.properties