Introduction

Environnement

GoPaaS, développé par NIDS Consulting, est une plateforme agile conçue pour gérer et créer rapidement des applications métiers sur mesure, fiables et évolutives. Hébergées dans le Cloud, ces applications offrent une grande souplesse et peuvent s’adapter facilement aux besoins spécifiques des entreprises. GoPaaS permet ainsi une gestion centralisée des processus et des données, tout en garantissant une sécurité optimale et une évolutivité adaptée aux exigences métiers.

screenshot

  1. La barre de navigation

  2. La barre d'outils

  3. La barre de personnalisation

  4. L'espace principale

  5. Les onglets de navigation

La barre d'outils

La barre d'outils regroupe plusieurs boutons :

Bouton Ce bouton permet de réduire la barre de navigation.

Bouton Ce bouton permet d’ouvrir la barre de personnalisation pour accéder au paramétrage des tables, des champs, pour personnaliser plus avant votre application. Il inclut aussi la fonction d’import des données, et de mise à jour de l’environnement GoPaaS.

Bouton Ce bouton sert à attribuer une action par défaut qui sera exécutée rapidement, comme la création d'une nouvelle tâche, simplifiant ainsi le processus pour les utilisateurs en offrant un raccourci pratique.

Bouton Ce bouton "FR" permet de sélectionner la langue de votre application. Les autres options disponibles dans le menu, telles que "EN" pour l'anglais, "DE" pour l'allemand, "ES" pour l'espagnol, "IT" pour l'italien et "PT" pour le portugais.

Bouton Ce bouton permet d'accéder au menu contextuel pour la gestion des onglets actifs sur GoPaaS. Les options présentées sont "Fermer les autres onglets", "Fermer les onglets sur la gauche", "Fermer les onglets sur la droite", et "Fermer tous les onglets". Cela offre à l'utilisateur une manière rapide et facile de contrôler et d'organiser ses onglets ouverts.

Bouton Ce bouton permet d'afficher un panneau de gestion des onglets dans votre application GoPaaS, où l'utilisateur peut visualiser à la fois les onglets actuellement ouverts et ceux qui ont été récemment fermés. Les onglets ouverts sont listés avec des options pour naviguer directement vers eux, tandis que les onglets récemment fermés sont présentés avec l'heure de fermeture pour un accès rapide si l'utilisateur souhaite les rouvrir.

Bouton Ce bouton permet d'accéder aux options du profil utilisateur. Il offre des liens pour voir et éditer le profil de l'utilisateur, changer le mot de passe, et se déconnecter de la session actuelle.

Bouton Ce bouton permet de synchroniser des données du mode hors connexion. Les boutons indiquent "Synchro IN" pour importer des données, "Synchro OUT" pour exporter des données, "Sauvegarder" pour enregistrer les données actuelles, "Restaurer" pour revenir à un état antérieur des données, et "Switch" pour changer de mode ou de profil. C'est un outil pratique pour gérer des données lorsqu'on n'a pas accès à Internet.

Les applications

Une application GoPaaS est une collection d'objets réunissant les tables, les vues, les modèles, les fiches, les automatisations etc ... Ces objets organisent les informations enregistrées dans GoPaaS. Tous les objets d'une application GoPaaS sont enregistrés en base de données.

GoPaaS peut être livré avec une base telle qu’un CRM et permettre une personnalisation selon vos besoins.

Bien que le grand avantage de GoPaaS soit de permettre à tous les collaborateurs dans l’entreprise de partager des informations en temps réel, en consultant et enrichissant une seule application, il existe des situations où vous souhaiterez créer d’autres modules. Dans une même société, on pourra par exemple créer un module pour que le service commercial gère son travail de prospection et de suivi clients ainsi que l’emploi du temps de ses équipes ; on créera un autre module pour le service administratif qui l’utilisera pour ses contacts avec les fournisseurs, la gestion du matériel et des ressources communes, gestion du personnel et l’occupation des locaux.

Dans ces cas-là, GoPaaS vous permettra de gérer toutes ces informations dans un groupe de travail collaboratif.

A travers l’aide en ligne, nous vous présenterons les fonctionnalités de GoPaaS.

Pour créer votre propre application vous pourrez partir de modules existants et y apporter, à votre rythme, les modifications que vous souhaitez ou bien créer une nouvelle application.

De nombreuses applications ont été développées pour répondre aux besoins de différents secteurs et professions. N’hésitez pas à nous contacter ou consulter notre site Web NIDS pour en savoir plus sur les différentes applications de GoPaaS.

Personnalisation

GoPaaS est personnalisable et peut être adapté pour répondre aux besoins d’une entreprise ou d’un utilisateur individuel. Il permet de recréer dans une base les associations que vous faites naturellement entre les différents types d’informations qui vous parviennent.

Vous saisissez toutes les données que vous souhaitez gérer dans des catégories (tables ou fichiers) distinctes que vous reliez entre elles ; cela vous permet d’établir par exemple des liens entre une personne et l’entreprise qui l’emploie, entre un projet et un collaborateur qui en a la charge, entre un projet et une note qui s’y rapporte, bref, de créer tout lien nécessaire à un stockage et un accès rapide et intelligent aux informations.

Grâce à la puissance de ces liens, appelés connexions, les utilisateurs peuvent accéder à n’importe quelle information se trouvant dans la base.

Ils peuvent également visualiser l’ensemble des fiches (ou enregistrements) de chaque table sous forme de tableau, d’agenda, de pivot, de graphique, de graphique de Gantt, ou de liste sur les mobiles, disposant ainsi d’une gamme de méthodes de lecture des données adaptées au type d’information recherchée.

La personnalisation est totalement intégrée à la plateforme, permettant de le faire évoluer à tout moment (dans la mesure où l’administrateur nous a accordé les droits nécessaires). Un chef de service peut, par exemple, intervenir sur l’application pour adapter les vues à ses besoins ou ceux de son service. L’application peut évoluer facilement, et cela sans qu’il soit nécessaire de stopper son utilisation, ce qui permet aussi de la mettre en place rapidement, sans crainte d’avoir oublié, dans le paramétrage initial des éléments qui seraient irrécupérables par la suite. Tout est récupérable, modifiable sans perte des données saisies précédemment.

Les tables

Les informations que vous saisissez dans une base ne sont pas toutes du même type. Il y a des comptes, des contacts, des actions, etc. Pour en faciliter la saisie et la recherche, GoPaaS vous permet de les classer dans des tables.

Voici des exemples de tables que vous pourriez trouver dans une base de CRM :

Table Description
Contact Utilisez cette table pour saisir les coordonnées et toutes informations relatives à vos interlocuteurs professionnels ou privés (fournisseurs, clients, prospects, amis...).
Compte Pour saisir les sociétés avec lesquelles vous traitez. Un lien entre les tables compte et contact permet de ne pas avoir à ressaisir les coordonnées de la société, dans les fiches des contacts qu’elle emploie.
Action L'utilisation de cette table sert à classer l’historique d’un contact ou d’une société : courriers, appels, compte-rendu de visites, notes… Lors de la création d’un courrier ou d’un email, GoPaaS crée automatiquement une fiche courrier faisant référence au document créé, à laquelle vous pourrez associer le collaborateur qui en est l’auteur, le destinataire, le sujet traité et pourquoi pas le projet concerné.
Affaire Pour gérer les opportunités de vente

Les champs

Chaque table est constituée de champs. Les champs permettent de structurer l’information saisie dans une fiche.

Par exemple, le Nom, l'Adresse, le N° de téléphone et de Fax sont autant de champs de la table Contact. La Date, l'Heure de début et l'Heure de fin sont des champs de la table Action. Dans les tables qui sont déjà incluses dans GoPaaS, figurent un certain nombre de champs. Vous pourrez les modifier, en ajouter ou en supprimer à votre guise.

Les fiches

Quand vous saisissez des données dans une catégorie vous créez un nouvel enregistrement, ou ce que GoPaaS appelle une fiche. Par exemple, dans la table Contact figure la fiche Dupont, avec son nom, son adresse et un certain nombre d’informations le concernant.

Par ailleurs, si vous avez déjà créé des fiches dans un autre logiciel, GoPaaS vous permettra de les récupérer facilement grâce à sa fonction d’import des données (voir Import de données).

Les formulaires

La disposition des champs dans une fiche, la taille, la couleur des caractères sont librement modifiables et constituent un formulaire (ou encore un masque d’écran ou de saisie) que vous utiliserez pour saisir, éditer ou consulter les données d’une fiche. GoPaaS vous permet de créer un formulaire par table. Ce formulaire se présente sur plusieurs pages d’écran, représenté et accessible par des onglets.

Les vues

Pour visualiser les données saisies dans la base, GoPaaS met à votre disposition un ensemble de vues entièrement personnalisables. Ces vues peuvent se présenter sous forme de tableau, liste, agenda, graphique ou encore widget. Elles sont créées à partir d’une seule table mais peuvent afficher des informations issues d’autres tables grâce aux connexions (voir ci-après). Elles peuvent être triées, filtrées et sauvegardées sous des noms différents. Les vues liées, enfin, permettent de regrouper plusieurs vues dans un onglet d’une fiche. C’est un moyen très puissant de visualiser rapidement un ensemble d’informations liées.

Les connexions

Cette classification des données par table aurait bien peu d'intérêt si GoPaaS ne permettait de les relier entre elles et de respecter ainsi les associations que vous faites tout naturellement, dans votre esprit, entre différents types d'information. Telle note concerne tel projet et doit être communiquée à telle personne. Une telle réunion prend place dans telle salle, avec tels collaborateurs, et mobilise telles ressources. Dans GoPaaS ces liens s'appellent des connexions ; elles vous permettent de lier les informations entre elles et donc de ne les saisir qu'une fois, de les retrouver facilement, ou encore de naviguer rapidement dans votre base ; GoPaaS vous permettra d'en rajouter ou d'en supprimer librement.

Automatisation

GoPaaS met en œuvre une technologie unique d’automatisation qui permet de robotiser un certain nombre de tâches ou de procédures. La création de ces automatisations est simple,on définit dans quelles conditions elles se déclenchent et quelles sont les actions à réaliser?

Par exemple, GoPaaS peut générer une fiche de relance suite à l’appel d’un client, envoyer un email à tous les participants d’une réunion, ou signaler automatiquement à un client que son contrat arrive à échéance. En outre, il est aussi possible d’adjoindre des scripts javascript Basic aux formulaires de saisie ; cela permet d’automatiser une partie de la saisie et du traitement des données.

Cette classification des données par table aurait bien peu d'intérêt si GoPaaS ne permettait de les relier entre elles et de respecter ainsi les associations que vous faites tout naturellement, dans votre esprit, entre différents types d'information. Telle note concerne tel projet et doit être communiquée à telle personne. Une telle réunion prend place dans telle salle, avec tels collaborateurs, et mobilise telles ressources. Dans GoPaaS ces liens s'appellent des connexions ; elles vous permettent de lier les informations entre elles et donc de ne les saisir qu'une fois, de les retrouver facilement, ou encore de naviguer rapidement dans votre base ; GoPaaS vous permettra d'en rajouter ou d'en supprimer librement.

Personnalisation

Description

Un des atouts majeurs de GoPaaS réside dans ses nombreuses fonctions de personnalisation. Cela confère une souplesse au produit, qui peut ainsi se prêter aux utilisations et applications les plus variées. Selon vos besoins, vous pouvez ajouter et modifier des tables, des connexions, des vues, des formulaires, des automatisations, et tous les éléments (ou définitions) qui constituent la structure de votre application.

Dans cette rubrique, nous passons en revue l’ensemble des possibilités de personnalisation de GoPaaS.

Ajouter une table

La plateforme GoPaaS vous permet d'ajouter de nouvelles tables afin de créer de nouvelles fonctionnalités liées à vos besoins et à l’'évolution de votre utilisation.

Pour cela, rendez vous dans le menu personnalisation capture -> Tables -> cliquer sur Ajouter.

screenshot

Afin d'enregistrer la table en base de donnée, il faut obligatoirement renseigner deux champs :

Champ Valeur
Intitulé Le nom de la table en base de donnée
Alias Le nom de la table dans l'application

Pour une meilleure utilisation d'autres champs sont à renseigner également :

Champ Valeur
Champs à afficher dans connexion Définir les champs à afficher dans un champ de type connexion sur une autre table. Séparer les champs par une virgule pour en afficher plusieurs lors de la connexion.
Ordre Ordre de la table dans la barre de navigation.
Icône Icône de la table dans la barre de navigation, aller à l'URL suivante pour avoir accès à la bibliothèque d'icônes. (https://fontawesome.com/v5/search).
Type Choisir l'onglet de la barre de navigation dans lequel afficher la table.
Module Choisir le module de la barre de navigation dans lequel afficher la table.
Loading method Choisir l’option de chargement des données des fiches de la table.
- Synchronous: Les données se chargent en arrière-plan et l’utilisateur peut interagir avec l’interface.
- Asynchronous: Toutes les données et les interfaces sont pré-chargées et prêtes à être consultées immédiatement.
- Lazy: Seul les données de l’onglet principal se chargent et l’utilisateur peut interagir avec l’interface.
- SmartLoad: Les données de l’onglet principal et toutes les interfaces sont pré-chargées, prêtes à être consultées immédiatement et l’utilisateur peut interagir avec l’interface.
Couleur Choisir la couleur en anglais (green) ou au format hexadécimal (#095A35) pour modifier la couleur des onglets et des intitulés des sections.
Afficher les vues dans la barre de navigation Cocher cette option permet d'afficher le menu des vues en sous-menu dans la barre de navigation.
Afficher dans Ajout rapide Cocher cette option permet d'afficher une option de création rapide.

Les onglets

Chaque table est associée à un seul formulaire de saisie et de visualisation de données.

Ces masques sont organisés sous forme d'onglets, chaque onglet contenant lui-même des sections et dans chaque section, des champs.

A la création d'une nouvelle table, GoPaaS ajoute automatiquement 2 onglets, l'onglet Principal et l'onglet Système. Pour ajouter un nouvel onglet, passer par le FormDesigner puis cliquer sur le bouton capture.

capture

Afin d'enregistrer un onglet en base de données, il faut renseigner obligatoirement certains champs :

Champ Valeur
Intitulé Nom du champ en base.
Table Nom de la table dans laquelle l'onglet se trouve.
Ordre Ordre de l'onglet sur la table.

Le champ Label correspond au nom du champ dans l'application.

Le moyen le plus simple et le plus rapide pour créer des onglets est de passer par le Form Designer_.

Les champs

Cliquez sur l'onglet Champs pour pouvoir ajouter des champs à cette nouvelle table.

Par défaut, à la création d'une nouvelle table, l'application crée un certain nombre de champs système ainsi qu'un champ Intitulé.

C'est le premier champ de la table, vous pouvez le modifier ou le supprimer.

Pour ajouter un nouveau champ cliquez sur Ajouter.

screenshot

Afin d'enregistrer le champ en base de donnée, il faut renseigner obligatoirement les champs suivants :

Détails :

Champs Valeur
Table C'est la table sur laquelle le champ va être créé.
Onglet L'onglet de la table sur lequel le champ va être créé.
Section La section de l'onglet sur laquelle le champ va être créé.
Colonne Définir le numéro de colonne, une section peut contenir au maximum 3 colonnes.
Ordre du champ Ordre du champ dans la colonne.
Type Plusieurs types de champs sont mis à disposition.
Nom du champ C'est le nom du champ en base de données.
Alias/Nom table connectée L'alias du champ doit être unique dans toute la table. Dans le cas où le champ créé est de type connexion, il faut renseigner le nom de la table à connecter.
Intitulé C'est le nom du champ dans l'application.

Les valeurs de nom du champ ne doivent pas contenir de majuscule, d'espace ou de caractères spéciaux_

Pour optimiser le paramétrage de l'application, renseigner également les champs suivants :

Champs Valeur
Aide Permet d'ajouter une aide pour l'utilisateur au survole du champ.
Largeur intitulé C'est l'espacement entre le titre du champ et le champ, il existe des valeurs prédéfinies allant de 1 à 12.
Alignement intitulé Permet de régler le positionnement de l'intitulé.
Filtre de connexion A utiliser dans les champs de type Connexion pour filtrer la liste des valeurs disponibles. Par exemple, dans une connexion entre Client et Devis, pour afficher les Devis créés par la personne qui gère le Client :
[ {"field":"creation_par", "source_field":"gestion_par"} ]
Vous pouvez cumuler plusieurs filtres en les séparant par une virgule :
[ {"field":"groupe", "value":"Admin"}, {"field":"annee", "value":"2016"} ]
Valeur A utiliser dans les champs de type liste, les valeurs correspondent aux choix de la liste. Toutes les valeurs doivent être séparées par un retour à la ligne.
Hauteur (memo) Définir la hauteur par défaut d'un champ de type mémo.
Masquer Option permettant de masquer le champ.
Obligatoire Option permettant de rendre obligatoire le champ.
Lecture seule Option permettant de rendre le champ insaisissable.
Audit Trail Permet d'obtenir un historique sur les modifications apportées à ce champ.
index Permet d'indexer le champ en base de données.
Données personnelles Permet de catégoriser ce champ au niveau RGPD.
Données sensibles Permet de catégoriser ce champ au niveau RGPD.

Le moyen le plus rapide et le plus simple pour créer des champs est de passer par le Form Designer.

Type de champs

Type de champ Description
Calcul Champ calculé automatiquement à partir d'autres champs.
Checkbox Case à cocher pour des choix oui/non ou vrai/faux.
Connexion Champ lié à une autre fiche (relation vers un autre module ou entité).
Connexion multiple Permet de lier plusieurs fiches à une même entrée (relations multiples).
Date Sélection d'une date (format calendrier).
Email Champ de saisie d'adresse e-mail, avec validation automatique.
Fichier Permet d’uploader un fichier.
Heure Sélection d’une heure (HH:MM).
ID Identifiant unique, généré automatiquement.
Image Permet d’ajouter une image à la fiche.
Liste Menu déroulant avec une ou plusieurs options prédéfinies.
Memo Zone de texte étendue pour les notes ou descriptions longues.
Nombre Accepte des valeurs numériques (entiers ou décimaux)
- Nombre de décimales paramétrable (ex. : 0, 1, 2, etc.)
- Nom champ (nom technique utilisé en base)
- Intitulé (nom affiché à l'utilisateur)
- Largeur intitulé (définit l'espace réservé au libellé)
- Alignement de l’intitulé (gauche, centre, droite)
- Afficher calculatrice (ajoute une icône de calculatrice)
- Masquer (cache le champ dans l'interface)
- Obligatoire (empêche l’enregistrement sans valeur)
- Lecture seule (le champ ne peut pas être modifié)
- Audit Trail (enregistre l’historique des modifications)
- Index (optimise la recherche)
- Données personnelles / Données sensibles (pour la conformité RGPD)
Signature Permet de capturer une signature manuscrite (via souris ou tactile).
Téléphone Champ pour entrer un numéro de téléphone, avec ou sans validation.
Texte Champ de texte court pour saisir une phrase ou un mot.
Titre Champ mis en avant, souvent utilisé comme nom principal de la fiche.
URL Champ pour entrer une adresse web (lien cliquable).
Vue Sert à créer une vue filtrée ou personnalisée des données.

Les relations

Cliquez sur l'onglet Relations afin de visualiser toutes les connexions existantes de la table.

screenshot

Script JS

Cliquez sur l'onglet Script JS pour avoir accès à l'éditeur de texte de la table pour écrire du JavaScript.

Cet onglet offre une manière flexible d'étendre et de personnaliser les fonctionnalités à travers l'écritures de scripts JavaScript directement dans le paramètrage de la table. Il vous permet de manipuler les données et le comportement du formulaire selon vos besoins spécifiques.

capture

Deux fonctions sont présentes par défaut dans l'éditeur :

  • onLoad : le script inséré dans cette fonction s'exécutera lors de l'ouverture d'une fiche.

  • onSave : par défaut ce script génère une clé unique lors de l'enregistrement de nouvelles fiches.

Bonnes pratiques :

  • Il est fortement conseillé d'effectuer des tests approfondis pour vous assurer que votre script fonctionne correctement dans différentes conditions.

  • Éviter de dépasser les 1000 lignes de code pour un souci de performances lors du chargement du script.

Pour cela on peut fragmenter le code en fonction des différentes fonctionnalités que vous souhaitez implémenter. Cela permettra de mieux organiser votre code et de le rendre plus facile à comprendre et à maintenir à long terme.

Class JS

Cliquez sur l'onglet Class JS pour lister les fonctions JavaScript spécifiques liés à la table :

screenshot

Tout comme l'éditeur de texte de l'onglet Script JS, les fiches Class JS possèdent elles aussi un éditeur de texte permettant de coder du JavaScript. Cet onglet permet de fragmenter le code afin d'avoir une meilleure organisation et une meilleure maintenabilité de celui-ci.

screenshot

Champ Description
Table Nom de la table correspondante
Name Nom de la fonction que l'on développe
Note (facultatif) Remarques ou informations supplémentaires concernant la fonctionnalité développé

Script PHP

Cliquez sur l'onglet Script PHP pour avoir accès à l'éditeur de texte de la table pour écrire du PHP.

Tout comme le JavaScript, il est possible d'écrire des scripts PHP via cet onglet.

Vues

Créer une vue

Vous pouvez adapter une vue en fonction de vos besoins, par exemple changer les couleurs, l'ordre d'affichage, les conditions et les champs qui la composent. Chaque type de vue (Tableau, Agenda, Graphique et Pivot) dispose de ses propres options permettant une meilleure souplesse.

Ajouter une nouvelle vue depuis le menu "Vue" puis cliquer sur le bouton "Ajouter" pour accéder au paramétrage.

screenshot

Description

Vous voilà sur la fiche de personnalisation des vues, elle se compose de plusieurs onglets, pour le moment cliquer sur l'onglet Description pour débuter le paramétrage.

screenshot screenshot

Il est conseillé de renseigner un certain nombre de champs pour paramétrer correctement la vue :

  • Renseigner les champs suivants :
Champ Description
Intitulé Nom de la vue.
Table Table SQL sur laquelle la vue est connectée
Type Choisir le type de vue : Tableau, Agenda, Graphique, WebReport, Pivot, Kanban
Rapport Afficher la vue dans un rapport.
Afficher dans les accès rapide Permet d'afficher la vue dans l'Accès rapide capture de la barre de navigation.
Afficher dans le menu des vues Permet d'afficher la vue dans le menu des vues.
Afficher au démarrage Option permettant l'ouverture de la vue au chargement de l'application.
Pour le(s) groupes(s) Fonctionne avec la case à cocher "Afficher au démarrage".
Multi-sélection Active la multi-sélection sur la table.
Afficher total Affiche sur la dernière ligne du tableau le total.
Afficher moyenne Affiche sur la dernière ligne du tableau la moyenne.
Alterner couleur Permet d'alterner la couleur des lignes (blanc/gris).
Retour à la ligne automatique Permet de prendre en compte les retours à la ligne dans un texte, dans le cas d'un champ CKEditor.
Afficher numéro ligne Afficher un numéro de ligne.
Afficher le mode modification Offre la possibilité d'utiliser le mode “Edit View”
Hauteur Max Permet de définir la hauteur d'une vue.
Afficher barre défilement horizontale Permet d'obtenir une barre de défilement à l'horizontale.
Figer colonne Permet de figer la largeur des colonnes, en partant de la gauche.
Nombre de fiches par page par défaut Paramétrage du nombre de fiches à afficher sur une page.
Permissions Permet de gérer les permissions de la vue.
Description Champ note pour la saisie d'une description de la vue.

Il est déconseillé de cocher toutes les options pour un soucis de performance lors du chargement de la vue.

  • Il est également possible de dupliquer la vue par défaut et de modifier les paramètres pour créer une nouvelle vue :
    • Depuis la vue par défaut cliquer sur capture -> capture -> Dupliquer, il suffit alors de modifier le nom de la vue puis de cliquer sur capture pour commencer le paramétrage.

Agencer les champs

Nous allons maintenant passer à l'onglet Champs, c'est ici que vous allez sélectionner les champs que vous souhaitez voir apparaître dans votre nouvelle vue.

screenshot

  1. La liste de table affiche toutes les tables disponibles dans l'application.

  2. Affiche les champs de la table sélectionnée sur le point n°1.

  3. Permet d'ajouter un champ (flèche de droite) dans la vue ou de le supprimer (flèche de gauche).

  4. Les champs choisis pour apparaître dans la vue, l'ordre d'affichage peut-être modifié avec un glissé-déposé.

Pour ajouter ou supprimer un champ, il suffit de le sectionner et de le déplacer à droite ou à gauche à l'aide des flèches.

Propriétés de la colonne

A l'aide d'un double clic sur un des champs de la colonne de droite, vous accédez aux propriétés du champ dans la colonne. C'est ici que vous allez effectuer des actions ciblées sur le champ de votre vue comme par exemple, augmenter ou diminuer la largeur de la colonne ou encore l'alignement du champ.

screenshot

A l'ouverture de la fiche, un certain nombre de champs sont repris :

Table, Champ, Alias, Intitulé.

D'autres champs sont renseignés par défaut mais peuvent être modifiés :

Champ Signification
Largeur Définir la largeur souhaitée.
Format Par défaut, GoPaaS détecte le type de champ et renseigne la donnée automatiquement. Mais pour plus de personnalisation, il est possible de choisir un format parmi les options suivantes :
- Text
- Date
- Number
- HTML : permet d'inclure des balises HTML dnas le champ "Code"
- Gauge : permet d'afficher une jauge d'avancement (%) en se basant sur un champ nombre ou une liste ayant des valeurs allant de 0 à 100.
- Rating : permet d'afficher une note sous forme d'étoiles en se basant sur un champ nombre ou une liste ayant des valeurs allant de 0 à 5.
- Smileys : permet d'afficher des emojis en se basant sur un champ nombre ou une liste ayant des valeurs allant de 0 à 5.
- SQL : permet d'exécuter une requête SQL dans le champ "Code".
- SQLNumber : permet d'exécuter une requête SQL dans le champ "Code" pour laquelle le résultat est un nombre.
Code Permet d'écrire des balises HTML ou des requêtes SQL, à condition d'avoir choisi le bon format.
Alignement Définir l'alignement du champ dans la colonne (left, center ou right). Si aucune valeur n'est renseignée, la valeur par défaut est left.
Style Permet d'ajouter du style dans ma colonne.
Exemple :
[{"value": "Client","style":"font-size:8px;background-color:#ff0000;color:#fff;font-weight:bold;"}, {"value": "Prospect", "style":"font-size:8px;background-color:green;color:#fff;font-weight:normal;"}]
Exemple avec une condition:
[{"value": "10000", "operator": ">", "style":"font-size:8px;background-color:#ff0000;color:#fff;font-weight:bold;"}]
Visible Décocher l'option pour masquer le champ dans la vue.
Masquer sur mobile Cocher l'option pour masquer le champ sur le mobile.
Masquer intitulé sur mobile Cocher l'option pour masquer l'intitulé sur le mobile.
Afficher en ligne sur mobile Cocher l'option pour afficher les données à l'horizontal. NB Le mode mobile de l'utilisateur doit être "List".
Autoriser modification Permet de modifier le champ lors de l'utilisation du mode EditView (se référer à la section "Fonctionnalités d'EditView").

Ajouter des conditions

screenshot

  1. La liste de table nous affiche toutes les tables disponibles dans l'application.

  2. Affiche les champs de la table sélectionnée sur le point n°1.

  3. Permet d'ajouter le champ (flèche vers la droite) sur lequel nous allons faire la condition ou de le supprimer (flèche vers la gauche).

  4. Les champs choisis pour les conditions.

Trier une vue

Via l'onglet mise en forme, il est possible d'effectuer des tris sur votre vue, par exemple pour afficher des actions par statut ou encore trier des comptes par ordre alphabétique.

screenshot

  1. Les tris de 1 à 5 permettent de classer les fiches en fonction des champs qui sont affichés dans la vue (onglet Champs).
  2. Afficher par ordre croissant ou décroissant.
  3. Sélectionner le champ pour effectuer le regroupement.

Code source

Dans l'onglet "Code source" apparaît la requête SQL de la vue.

screenshot screenshot

Détails :

Champs Valeur
SELECT Génère automatiquement en fonction des champs sélectionnés dans l'onglet Champs.
FROM Indique le nom de la table.
JOIN Permet de créer une jointure avec une autre table.
WHERE Génère automatiquement en fonction des champs sélectionnés dans les conditions.
COLONNE Génère automatiquement le paramétrage de chacun des champs.
STYLE Permet d'appliquer un style en fonction de la valeur d'un champ du tableau, voir exemple ci-dessous : Si la ville de la fiche contact = "PARIS" il applique une couleur et met en gras le texte :
Au format XML :
<format><item datafield="ville" value="PARIS" code="0xAE642D" fontweight="bold" fontstyle="normal"/></format>
Ou au format JSON :
[{"datafield":"ville", "condition": "=", "value": "PARIS", "style":"background-color:lightblue;color:#AE642D;font-weight:bold;"}]

Script JS

Le champ Script JS est utilisé pour surcharger le code dans le cas d'une vue liée.

screenshot

Le script JS peut afficher dans la vue liée un nouveau menu sur le bouton "Ajouter"

screenshot

Détail pour la ligne "Appel sortant" :

vb.addAddButton("Appel sortant", null, {
      type: "Appel sortant",
      objet: "Commercial",
      statut: "En cours",
      compte: itemComponent.getValue('compte')
   }
);
Champ Valeur
Type Appel sortant
Objet Commercial
Statut En cours
Compte Récupère la connexion compte de la fiche en cours.

Tableau

La vue tableau sert à afficher tout ou partie des enregistrements d’une table donnée. Elle s’ouvre dans un onglet de l’application.

screenshot

Mettre à jour en masse

Utilisez la fonction de mise à jour en masse depuis le menu Outil de la vue pour modifier rapidement les valeurs d'une liste de fiches.

Recherche / Remplace, suppression ou concaténation de plusieurs champs, ces fonctions sont disponibles dans l'outil MassUpdate.

screenshot

L'outil de mise à jour en masse peux s'avérer très utile lorsque que vous souhaitez traiter rapidement un volume de donnée important.

Il existe 4 fonctions :

  • Remplacement d'une valeur
  • Recherche / Remplace d'une valeur précise
  • Concaténation
  • Opération sur une valeur numérique

Pour utiliser le module de mise à jour en masse, sélectionnez les fiches sur lesquelles vous souhaitez effectuer une mise à jour > Menu outil > Mettre à jour en masse.

screenshot

Remplacement

Dans notre exemple nous allons remplacer la valeur d'une fiche compte de type "Prospect" à "Client". Recherchez le(s) champ(s) à mettre à jour, dans notre exemple ce sera le champ type Ajoutez simplement votre valeur dans le(s) champ(s) concerné(s) puis cliquez sur le bouton Mettre à jour.

screenshot

Recherche / Remplace

Dans notre exemple nous allons effectuer une mise à jour de permission. Nous souhaitons remplacer la permission nicolas par Jonathan. Renseigner le code suivant : $$[%note|replace|'nicolas'|'jonathan'%]

Explication du code :

  • $$ : Déclaration de l'action
  • note : Nom du champ sur lequel effectuer l'opération
  • replace : Action de remplacement
  • nicolas : Valeur à rechercher
  • jonathan : Valeur de remplacement

    NB : Pour recherche et supprimer un élement il suffit simplement de ne pas renseigner de valeur de remplacement : $$[%note|replace|'nicolas'|''%]

​​​​​​​Concaténation

Concaténation de plusieurs champs existants dans GoPaaS.

Dans notre exemple nous allons concaténer les champs "adresse, cp, ville" dans un champ note Tapez le code suivant dans le champ note : $$[%adresse%] & " " & [%cp%] & " " & [%ville%]

Explication du code :

  • $$ : Déclaration de l'action
  • [%champ de concat%]
  • & : Déclaration d'ajout d'une autre valeur
  • " " : Caractère permettant d'effectuer un espace entre les champs

    NB : Il est possible d'ajouter d'autres caractères pour effectuer des séparation entre les champs ( " / ", " - ")

screenshot

Opération sur une valeur numérique

Dans notre exemple nous allons soustraire 2 années au champ année d'une fiche. Tapez le code suivant dans le champ année de la liste : $$[%annee%] -2.

Explication du code :

  • $$ : Déclaration de l'action
  • [%nom du champ qui subit l'opération%]
  • -2 : Opération à réaliser (+ ou -)

Faites simplement varier le chiffre de fin en fonction de l'opération que vous souhaitez effectuer, -3, -4 ou alors +1, +3,....

NB : Ce type d'opération ne peut être réalisé que sur les champs de type nombre

screenshot

Supprimer les valeurs d'un champ

Utilisez simplement le code : $$null pour vider la ou les valeur(s) d'un champ.

screenshot

Les listes déroulantes, les connexions, les champs de type date, nombre et heure définies dans le Designer sont disponibles pour les modifications en masse.

screenshot

Agenda

La vue agenda vous permet d'afficher par exemple les historiques directement dans un agenda.

screenshot

Le paramétrage de la vue Agenda s'effectue dans l'onglet "Agenda". Dans chacune des listes apparaît les champs que l'on a choisi dans l'onglet "Champs" de la vue.

screenshot

Détails :
​​​​

Champs Valeur
Titre C'est le premier texte qui sera affiché sur l'agenda.
Description / Description 2 / Description 3 Idem que sur le point précédent, ce sont les champs que l'on veut voir sur l'agenda.
Date début C'est le champ date de début de votre fiche.
Heure début C'est le champ heure de début de votre fiche.
Date fin C'est le champ date de fin de votre fiche.
Heure fin C'est le champ heure de fin de votre fiche.
Table de collaboration C'est la vue des collaborateurs que l'on veut afficher dans l'agenda.
Champ du code couleur C'est le champ que l'on choisit pour appliquer les codes couleurs.
Code couleur Il faut ici saisir le code couleur en hexadécimal, exemple ci-dessous :
{ "Nicolas.":"#8B16E5", "Nambourt.":"#FF0000" // Attention pas de virgule sur la dernière ligne }
Champ du code icône C'est le champ que l'on choisit pour l'affichage de l'icône.
Code icône Ce sont les icônes que l'on va afficher en fonction du champ code icône, les codes à utiliser viennent du site Fontawesome.

Pivot

La vue type Pivot vous permet d'avoir un tableau croisé dynamique directement sur votre application. screenshot

  1. Liste des champs que l'on a ajouté dans la vue.
  2. Afficher des champs dans l'axe des ordonnées.
  3. Afficher des champs dans l'axe des abscisses.
  4. Choix du type de pivot : Table, Bar Chart, ...
  5. Visuel dynamique du pivot.

Graphique

Vous pouvez ajouter une vue de type Graphique pour analyser par exemple vos affaires en cours.

screenshot

screenshot

Type graphique : Choix du type de graphique.

screenshot

Détails :

Champ Description
Titre Titre du graphique.
Champ Valeur C'est le champ qu'il faut sélectionner pour le calcul du pourcentage dans le tableau.
Type calcul Choix du type de calcul : Somme, Nombre, Moyenne, Max ou Min.
Sous-titre Sous-titres du graphique.
Champs Dimension
Regroupement Permet de grouper le résultat sur un champ.
Couleur de fond du widget Non utilisé sur ce type de graphique.
En savoir plus Non utilisé sur ce type de graphique.

KanBan

La vue KanBan permet de changer le statut des actions rapidement à l'aide de glisser-déposer.

screenshot

screenshot

  1. Choix du champ pour regrouper les fiches.
  2. Chaîne JSON listant les valeurs de regroupement dans l'ordre souhaité.
  3. Chaîne JSON décrivant les couleurs à appliquer.

Utilisation d’une vue

Les vues servent à afficher tout ou une partie des enregistrements d’une table donnée. Ou bien dans une fiche, généralement pour lister les enregistrements d’une table connectée, comme par exemple la liste des contacts d’un compte donné.

screenshot

  • Le bouton capture permet d’ajouter une fiche dans la table sur laquelle porte la vue.

  • Le bouton capture sert à supprimer une ou plusieurs fiches dans la vue. Si la vue est du type Multi-sélection (voir plus loin), on peut sélectionner plusieurs fiches et les supprimer en une seule passe. Si la vue n’est pas du type Multi-sélection, le bouton - Supprimer sert uniquement à supprimer la fiche en surbrillance.

  • Le menu capture de la vue permet d'exporter vers csv, mettre à jour en masse et de fusionner des modèles de document. On peut y ajouter d'autres options en javascript.

screenshot

Recherche plaintext

screenshot

  • On saisit dans la zone Rechercher la ou les chaînes de caractères que l’on recherche.

Il est possible d'utiliser des opérateurs logiques (ET, OU, AND, OR) dans la barre de recherche afin d'afiner la recherche. Ces opérateurs logiques vont aller chercher les informations dans les données affichées dans la vue.

Opérateur Description
OR - OU Les opérateurs logique "OR" / "OU" permettent de rechercher des résultats contenant au moins l'un des termes spécifiés.
AND - ET Les opérateurs logique "AND" / "ET" permettent de rechercher des résultats contenant tous les termes spécifiés.

Exemple :

Je veux rechercher les fiches dont la ville est soit PARIS soit AMIENS

screenshot

On remarque que dans la deuxième ligne la ville n'est pas égale à PARIS ou AMIENS mais on retrouve la valeur "Paris" dans "Adresse1".

Je veux rechercher les fiches dont la ville est Paris et le code postal 75008

screenshot

La zone « dans » permet de préciser sur quel champ la recherche doit s’effectuer. Par défaut, c’est l’option Tous qui est sélectionnée, c’est-à-dire que la recherche doit s’effectuer dans l’ensemble des champs présents dans la vue. Une recherche utilisant les opérateurs logiques doit s'effectuer dans "Tous".

  • Le bouton capture permet de lancer la recherche

Recherche avancée

  • Le bouton capture permet d'accéder à l'outil de recherche avancée, une nouvelle ligne apparaît en dessous

screenshot

On choisit le champ sur lequel on veut filtrer puis la condition. Là encore, n’apparaît dans la liste de champs que ceux présents dans la vue (y compris les champs invisibles). Pour ajouter une condition, cliquer sur le bouton plus. Quand on est satisfait de son filtre, on peut l’enregistrer. Cliquer sur la flèche du bouton "Filtrer".

screenshot

Sur la flèche bas du bouton filtre on retrouve les recherches sauvegardées.

screenshot

Fonctionnalités de ViewDesigner

ViewDesigner est une fonctionnalité conçue pour offrir aux utilisateurs une flexibilité et une personnalisation de leurs vues de données.

Grâce au bouton "Designer", les utilisateurs peuvent passer une vue en mode édition.

Ce mode permet de modifier l'emplacement des colonnes, d'ajuster leur taille et de changer les titres des colonnes.

Avec ViewDesigner, vous avez le contrôle total sur la présentation de vos données. Voici les fonctionnalités clés :

  • Modification de l'emplacement des colonnes : Réorganisez l'ordre des colonnes simplement par glisser-déposer pour refléter l'importance des informations selon vos besoins.
  • Ajustement de la taille des colonnes : Modifiez la largeur des colonnes pour adapter l'affichage des données, garantissant ainsi que les informations clés sont visibles sans avoir à naviguer horizontalement.
  • Changement des titres des colonnes : Personnalisez les titres des colonnes pour les rendre plus descriptifs, facilitant la compréhension et l'interprétation des données présentées.

Accès au mode Designer

  1. Ouvrir la vue de données : Accédez à la vue de données que vous souhaitez personnaliser dans l'application GoPaaS.
  2. Activer ViewDesigner : Cliquez sur le bouton "Designer" situé généralement en haut à droite de la vue de données. La vue passera en mode édition, vous permettant de modifier la présentation des données.

screenshot

Modification de l'emplacement des colonnes

  • Glisser-Déposer : Cliquez et maintenez la colonne que vous souhaitez déplacer, puis glissez-la à l'emplacement désiré. Relâchez le bouton de la souris pour confirmer le nouvel emplacement.

screenshot

Ajustement de la taille des colonnes

  • Redimensionner : Placez votre curseur sur le bord de la colonne que vous souhaitez ajuster. Le curseur se transformera en icône de redimensionnement. Cliquez et glissez pour ajuster la largeur de la colonne.

screenshot

screenshot

Changement des titres des colonnes

  • Éditer le titre : Cliquez sur le bouton avec l’icône crayon de la colonne que vous souhaitez modifier. Saisissez le nouveau titre dans le champ éditable qui apparaît et validez votre saisie. Appuyez sur la touche Entrée pour valider. screenshot

Sauvegarde des modifications

  • Enregistrement : n'oubliez pas de sauvegarder vos changements pour que la vue personnalisée soit conservée pour les prochaines sessions.

Fonctionnalités d’EditView

EditView offre la possibilité d'ajouter ou de modifier des fiches directement depuis une vue. Cet outil flexible permet une gestion des données plus rapide et plus intuitive, en évitant de naviguer entre différentes fiches pour effectuer des modifications ou ajouts de données.

Activer le Mode Modification

  1. Accès aux Propriétés de la Vue : Ouvrez les paramètres ou les propriétés de la vue où vous souhaitez utiliser EditView.

screenshot

  1. Activer EditView : Recherchez l'option "Afficher le mode modification" et cochez la case correspondante. Cette action active le mode d'édition pour la vue actuelle, permettant des modifications directes.

screenshot

Configurer les champs modifiables

Une fois le mode modification activé, vous devez spécifier quels champs seront modifiables :

  1. Accéder aux Propriétés de chaque champ : Ouvrez les propriétés ou les paramètres de chaque champ présent dans la vue.
  2. Autoriser la modification : Pour chaque champ que vous souhaitez rendre modifiable, cochez la case "Autoriser modification". Si vous ne cochez pas cette option, le champ restera en lecture seule et ne pourra pas être édité directement depuis la vue. screenshot

L'alias du champ doit rester identique au nom du champ pour que les modifications fonctionnent correctement.

Fonctionnalités Clés

  • Ajout de fiches : Créez de nouvelles fiches directement depuis la vue, facilitant l'entrée de données sans quitter le contexte actuel.
    screenshot

  • Modification de plusieurs fiches : Editez plusieurs fiches en même temps. Cette fonction est particulièrement utile pour mettre à jour des données en masse ou corriger des informations sur plusieurs entrées rapidement.
    screenshot

  • Enregistrement : N’oubliez pas d’enregistrer les modifications apportées.
    screenshot

Regrouper les colonnes

La fonctionnalité Regrouper les colonnes permet de fusionner plusieurs champs d’une vue en un bloc visuel unique (carte HTML). Cela améliore la lisibilité, réduit le nombre de colonnes et structure l’information métier.

Les colonnes d’origine sont masquées et remplacées par une colonne HTML stylée dynamiquement.

  1. Ouvrez une vue.
  2. Allez dans Propriétés de la vue.
  3. Cliquez sur l'onglet Colonnes.
  4. Cliquez sur le bouton Outils.
  5. Sélectionnez Regrouper les colonnes.

1. Sélection des colonnes

Dans la liste Colonnes dans la vue :

  • Sélectionnez au moins 2 colonnes (avec Ctrl ou Shift).
  • La première colonne sélectionnée sert de référence pour :
    • le label du regroupement,
    • l'alias technique,
    • la base du style CSS.

Recommandation : Sélectionnez les colonnes dans l’ordre d’affichage souhaité.

2. Choix du mode d’affichage

Deux modes sont disponibles :

Labels à gauche

  • Affichage en lignes.
  • Format : Label | Valeur.
  • Adapté aux :
    • fiches détaillées,
    • vues type formulaire,
    • lecture verticale.

Labels au-dessus

  • Affichage en grille (multi-colonnes avec 3 colonnes max.).
  • Adapté aux :
    • vues synthétiques,
    • tableaux larges,
    • indicateurs multiples.

Après application de l’action :

  • Les colonnes sélectionnées deviennent non visibles.
  • Deux colonnes techniques sont créées :
    1. Colonne CSS (invisible) : contient les styles spécifiques à la vue.
    2. Colonne HTML (visible) : affiche les champs regroupés sous forme de carte.

La liste des colonnes est automatiquement actualisée.

Règles d’affichage automatiques

Le rendu s’adapte au type de champ :

  • Date : format DD/MM/YYYY, badge visuel spécifique.
  • Liste : affichage sous forme de badge.
  • Texte / Nombre : affichage standard optimisé.

Fusion des colonnes

  • [%champ%] — ancienne syntaxe GoPaaS
  • {{...}} — nouvelle syntaxe enrichie, compatible IA et transformation de données
Fonction Syntaxe Description
uppercase {{uppercase:champ}} Transforme la valeur en majuscules
lowercase {{lowercase:champ}} Transforme la valeur en minuscules
ucfirst {{ucfirst:champ}} Met la première lettre en majuscule
lcfirst {{lcfirst:champ}} Met la première lettre en minuscule
length {{length:champ}} Retourne la longueur de la valeur
json {{json:champ}} Encode la valeur au format JSON
date {{date:champ,format}} Formate une date issue des données
now {{now,format}} Date / heure actuelle formatée

Formats de date disponibles

Code Description
YYYY Année sur 4 chiffres
MM Mois sur 2 chiffres
DD Jour sur 2 chiffres
HH Heures (format 24h)
mm Minutes
ss Secondes

Bonnes pratiques

  • Regroupez des champs fonctionnellement cohérents.
  • Évitez de dépasser 6 à 9 champs par regroupement.
  • Créez plusieurs regroupements si la vue est dense.
  • Utilisez cette fonctionnalité pour :
    • simplifier les vues,
    • améliorer l’expérience utilisateur,
    • structurer les informations clés.

Gestion et réversibilité

La fonctionnalité est entièrement réversible :

  • Vous pouvez rendre à nouveau visibles les colonnes d’origine.
  • Vous pouvez supprimer la colonne HTML générée.
  • Aucun impact sur les données, uniquement sur l’affichage.
  • Vous pouvez personnaliser le rendu HTML et CSS

Résumé

La fonction Regrouper les colonnes transforme une vue standard en une interface métier claire, moderne et structurée, directement depuis l’interface GoPaaS, sans développement spécifique. Elle s’inscrit dans une logique d’optimisation de l’expérience utilisateur et d’évolution progressive des vues.

Formulaire

Form Designer

Le Form Designer est de loin le moyen le plus simple et le plus rapide pour gérer vos formulaires.

C'est une interface Drag & Drop sur laquelle vous ajoutez, modifiez et déplacez vos champs, sections et onglets selon vos besoins. ​​​​​ Il existe plusieurs manières d'y accéder :

Depuis le menu alt_text d'une fiche, cliquez sur “FormDesigner”.

Depuis le menu de personnalisation alt_text sélectionnez la table à modifier puis menu alt_text -> FormDesigner.

alt_text

Depuis cette interface graphique il est possible de déplacer les champs entre les sections et les colonnes par le biais d'un glisser déposer.

Le bouton alt_text permet d'actualiser la page et d'enregistrer le modèle, à utiliser à chaque création de nouveaux éléments pour visualiser les modifications.

Le bouton alt_text va permettre d'ajouter un nouvel onglet.

Cliquer sur le bouton alt_text pour ajouter une nouvelle section.

Et enfin, il suffit de cliquer sur le bouton alt_text pour créer un nouveau champ.

Il est conseillé de rafraîchir la page et de vider le cache du navigateur à chaque modification ou création importante_.

Les sections

Les sections vous permettent d'organiser vos formulaires et de regrouper vos champs. L'utilisation des sections vous offre une meilleure ergonomie et facilite la saisie de données.

L'accès aux sections se fait via la barre de personnalisation alt_text -> Section.

Après avoir sélectionné la table et l'onglet sur lequel la section doit être créée, cliquer sur alt_text.

Sur la fiche des sections il existe un certain nombre de champs à renseigner :

alt_text

Champ Valeur
Intitulé Le titre de l'onglet dans l'application.
Masquer titre Cocher l'option pour masquer le titre de la section dans le formulaire.
Nb de colonnes Définir le nombre de colonnes à afficher dans l'onglet de 1 à 3 maximum.
Répartition colonne Définir la largeur des colonnes (disponible pour les sections à 2 ou 3 colonnes).
Table Sélectionner la table qui contient la section.
Onglet L'onglet est renseigné par défaut à la création d'une nouvelle section.
Ordre Renseigner l'ordre de la section dans le masque (valeur numérique).
Réduire par défaut Permet de réduire la section lors de l'ouverture de la fiche.

Le moyen le plus rapide et le plus simple pour créer une section est de passer par le Form Designer._

Références

Description

Le menu Références se trouve dans la barre de navigation > Références. Dans ce menu, vous trouverez plusieurs tables système telles que le journal des messages, les e-mails ou encore les paramètres des modèles d'impression, etc.

Journal

Email

Sur cette vue, vous retrouvez les emails que vous avez créés.

screenshot

Si vous avez un profil Admin, vous pouvez accéder à la vue Tous les emails, pour voir tous les mails envoyés de GoPaaS.

capture

Fiche Email

capture

Champ Description
De Expéditeur de l'email
A Destinataire(s)
CC Autre(s) destinataire(s)
Objet Objet du mail
Message Message qui sera envoyé
Date envoi Date de l'envoi d'email
Heure envoi Heure de l'envoi d'email
Statut Statut de l'email : Planifié, Envoyé ou Erreur
Fichier joint Pièce(s) jointe(s)
source Table connectée à cet email
Format HTML ou Texte
Campagne Si connecté à une campagne email dans GoPaaS
Accusé Accusé de réception
Statut serveur Code retour du serveur d'email

Messages (logs)

Sur cette vue, vous retrouvez les messages que vous avez générés.

screenshot

Si vous avez un profil Admin, vous pouvez accéder à la vue Tous les messages, pour voir tous les messages de GoPaaS.

capture

Fiche message

capture

Champ Description
Cle Clé de la fiche
Type Type d'erreur : Fatal, Warning ou Info
Line Ligne du message dans le fichier
Note Message ou Erreur
Trace Fichier ayant été appelé pour mener au message
Function Fonction associée au message
Code Code erreur
Date création Date de création du message
Heure création Heure de création du message

Modèle

Modèle email

Cette table est utilisée pour les campagnes GoPaaS ou peut être utilisée sur une fiche avec un développement spécifique.

capture

Champ Description
Table Table connectée
View Vue utilisée pour la fusion des champs
Name Nom du modèle
From Expéditeur de l'email
To Destinataire(s) (accepte un champ de fusion)
Nb jour(s) différé(s) Différer l'envoi de l'email de x nombre(s) de jours
Object Objet du message (accepte des champs de fusion)
Message Le message (accepte des champs de fusion)
File Fichier(s) joint(s)
Campagne Campagne connectée

Modèle PDF

Les modèles PDF permette de positionner des champs GoPaaS sur une document PDF.

capture

Champ Description
Intitulé Nom du modèle
Table Table connectée
Vue Vue utilisée pour la fusion des champs
Modèle PDF Document au format PDF sur lequel nous allons positionner nos champs
Description Description du modèle

Champs personnalisés

Ajouter des champs personnalisés dans un format JSON dans le champs Corps.

field Value
type Texte ou Signature
x & y les coordonnées "x" et "y" définissent la position du champ sur le document PDF
Font - Courier (fixed-width)
- Helvetica or Arial (synonymous; sans serif)
- Times (serif)
- Symbol (symbolic)
- ZapfDingbats (symbolic)
fontsize Taille de police en points.
La valeur par défaut est la taille actuelle. Si aucune taille n'a été spécifiée depuis le début du document, la valeur est de 12.
width Largeur des cellules. Si elle vaut 0, elles s'étendent jusqu'à la marge droite de la page.
height height : Hauteur des cellules.
field Champ de fusion, exemple [%nom_du_champ%].
On peut ajouter une option sur certain type de champ, voici la liste des options possibles :
- Date : [%mon_champ_date\|date%]
- Memo : [%nom_du_champ\|longtext%]
- Majuscule - [%nom_du_champ\|ucase%]
- Minuscule : [%nom_du_champ\|lcase%]
- Première lettre majuscule - [%nom_du_champ\|ucfirst%]
- Première lettre minuscule - [%nom_du_champ\|lcfirst%]
border Indique si des bords doivent être tracés autour du bloc de cellules. La valeur peut être soit un nombre :
0 : aucun bord
1 : cadre
align Contrôle l'alignement du texte. Les valeurs possibles sont :
L : alignement à gauche
C : centrage
R : alignement à droite
J : justification (valeur par défaut)

Modèle de lettre

​​​​​​​Cliquer sur le bouton Ajouter pour créer un nouveau modèle. Afin d'enregistrer le modèle de lettre, il faut obligatoirement renseigner les champs suivants :

capture

Champ Valeur
Intitulé Le nom du modèle dans l'application.
Table Sélectionner la table dans laquelle le modèle doit apparaître.
Vue Choisir la vue créée pour le modèle de lettre.
PDF Possibilité de générer le document au format PDF.
Fichier Ajoutez votre fichier au format .docx ou .odt
Vue(s) liée(s) à utiliser Choisir la ou les vues liées de fusion.

Paramètre

Assistant

L'assistant GoPaaS permet de créer des modes opératoire étape par étape pour effectuer une tache sur votre application.

Fiche Assistant

capture

Champ Valeur
Intitulé Le nom de l'assistant.
Vue étapes Liste des étapes a effectuer

Fiche Etape

capture

Champ Valeur
Action Cliquer, Ouvrir, Rechercher ou Renseigner
Description Description de l'étape
Ordre Ordre d'exécution de l'étape
Élément Classe ou ID de l'élément à mettre en évidence
Mettre en évidence Crée un effet visuel pour griser toute l'application sauf l'élément spécifié
Mode Reflex Effet visuel sur l'action

Exécution de l'assistant

Cliquez sur l'icone pour déclencher l'assistant.

capture

Dashboard

Pour créer un nouveau dashboard, rendez vous dans la barre de navigation > Références > Dashboard.

Cliquer sur le bouton Ajouter.

capture

capture

Ci-dessous, la description des champs de l’onglet principal.

Champ Valeur
Intitulé Nom du dashboard
Permission Sélection des groupes d’utilisateurs autorisés à accéder au dashboard
Regroupement Regroupement du dashboard
Afficher au démarrage Cocher l’option pour activer l’ouverture automatique à la connexion à l’application
Pour le(s) groupe(s) Sélection des groupes pour lesquels le dashboard s'affiche à la connexion
Afficher bouton Fullscreen Permet l’affichage du bouton plein écran sur le dashboard
Détails Vue liée des lignes de dashboard

Vue

Accessible via la barre de navigation > Paramètres > Vue, cette fonctionnalité regroupe l'ensemble des vues de votre application et vous permet de les ouvrir directement à partir d'ici.

screenshot

Import

Importer un fichier

Le fichier à importer doit obligatoirement être au format .CSV

Dans le menu personnalisation de l'application alt_text cliquer sur importer un fichier.

alt_text

Cliquez sur alt_text pour ajouter le fichier à importer.

Plusieurs champs sont déjà renseignés sur cette fiche, ils sont modifiables selon l'utilisation :

Charger un modèle d'import Les utilisateurs peuvent créer des modèles d'import réutilisables afin d'éviter la correspondance des champs à chaque import.
Séparateur de colonne CSV A définir, le séparateur peut être différent selon les fichiers, par défaut c'est le point virgule.
Encodage du fichier CSV Il existe trois formes d'encodage pour l'import GoPaaS : iso-8859-1, iso-8859-15, utf-8.
Format de date La plateforme propose également trois formats de date possible pour l'import : JJ/MM/AAAA, MM/JJ/AAAA, AAAA-MM-JJ.

Cocher l'option si le fichier contient une ligne d'en-tête (Ex: Nom, prénom, ville), si il n'en contient pas la correspondance se fera sur la première ligne de donnée.

Cliquez sur le bouton [image] pour passer à l'étape suivante.

alt_text

Faire la correspondance des champs

Vous devez préalablement sélectionner la table sur laquelle vous souhaitez importer le fichier.

Une fois la table sélectionnée, la page s'actualise et affiche l'ensemble des champs de cette table.

alt_text

alt_text

Il ne reste plus qu'à faire correspondre les champs de la table avec les colonnes du fichier importé.

Pour cela, en face de chaque nom de champ, cliquez dans la zone (ne pas importer) afin de sélectionner le nom de colonne à faire correspondre.

Il est possible de renseigner une valeur par défaut dans la colonne "Valeur par défaut".

Lancer l'import

Cliquer sur Importer pour lancer l'import.

Quand l'import est terminé un message apparaît avec le nombre d'enregistrements importés.

alt_text

Créer un modèle d'import

Afin d'éviter l'étape de la correspondance des champs à chaque import, vous avez la possibilité de créer des modèles d'import.

Ces modèles sont réutilisables à chaque import du même type de fichier.

alt_text

Après avoir effectué une première fois la correspondance des champs, en cliquant sur le bouton alt_text Il est possible d'enregistrer cette correspondance en tant que modèle.

Il est conseillé de lui donner un nom afin de le retrouver plus facilement lors des prochains imports.

Pour charger un modèle d'import, sélectionner le dans la liste déroulante puis cliquer sur le bouton alt_text . Si le fichier correspond bien au modèle, la correspondance se fera automatiquement.

Il est possible de modifier les correspondances puis d'enregistrer à nouveau le modèle sous un autre nom en cliquant sur alt_text .

Cliquez sur alt_text pour supprimer le modèle, ou sur alt_text pour le renommer.

Gérer les doublons

En dessous de la partie correspondance des champs, il existe un champ Traitement des fiches existantes. Ce champ de type liste vous permet de gérer les actions à mettre en place face aux potentiels doublons.

alt_text

Cliquez sur la liste déroulante pour définir l'action à mettre en place lors de l'import :

  • Remplacer les doublons, champs importés seuls

  • Remplacer les doublons, tous champs

  • Ne pas importer les doublons

Sélectionnez l'option "Ajouter nouvelles fiches" si vous désirez incorporer de nouvelles fiches durant l'importation.

Ne pas oublier de sélectionner sur quels champs identifier les doublons dans la partie "correspondance des champs".

Intégrité des données

Dans les valeurs par défaut des champs, vous ajouter des codes de champs pour contrôler l'intégrité des données qui vont être importées.

Le contrôle d'intégrité se fait à l'aide de REGEX.

Par exemple pour contrôler le format email lors d'un import il faudra insérer le code suivant :

$$REGEX("/^[_a-z0-9-]+(\.[_a-z0-9-]+)*@[a-z0-9-]+(\.[a-z0-9-]+)*(\.[a-z]{2,})$/i")

le format téléphone lors d'un import il faudra insérer le code suivant :

$$REGEX("/^(?:\+33\s|0)[1-9](?:\s\d{2}){4}$/")

La pattern REGEX est à insérer entre guillemet sous la forme "/PATTERN/"

Vous pouvez également contrôler les valeurs qui seront insérées : Dans une liste déroulante avec le code suivant :

$$STRICT_VALUES_LIST

Dans une connexion avec le code suivant :

​$$STRICT_VALUES_CONNECTION("utilisateur") où utilisateur est la table connectée

Dashboard

Description

Les Dashboard sont organisés en lignes de dashboard qui contiennent des vues personnalisées telles que des widgets et des graphiques.

La méthode pour créer un dashboard efficace consiste à créer des vues personnalisées (widget, graphique, icon ou encore webreport) et de les sélectionner dans les lignes de dashboard.

screenshot

Créer un dashboard

Pour créer un nouveau dashboard, rendez vous dans la barre de navigation > Références > Dashboard.

Cliquer sur le bouton Ajouter.

screenshot

Ci-dessous, la description des champs de l’onglet principal.

Champ Valeur
Intitulé Nom du dashboard
Permission Sélection des groupes d’utilisateurs autorisés à accéder au dashboard
Regroupement Regroupement du dashboard
Afficher au démarrage Cocher l’option pour activer l’option d’ouverture automatique à la connexion à l’application
Pour le(s) groupe(s) Sélection des groupes pour lesquels le dashboard s'affiche à la connexion.
Afficher bouton Fullscreen Permet l’affichage du bouton plein écran sur le dashboard

Pour un fonctionnement optimal, il est conseillé de renseigner, au minimum, les champs intitulé et permission.

Une fois renseigné, cliquer sur le bouton Appliquer pour continuer.

Ligne de dashboard

Dans la section détails, cliquer sur le bouton Ajouter pour créer une nouvelle ligne de dashboard.

capture

Ci-dessous, la description des champs de l’onglet principal.

Champ Valeur
Dashboard Connexion vers le dashboard
Intitulé Nom de la ligne de dashboard
Ordre Ordre de la ligne de dashboard dans le dashboard
Options avancées Cocher l’option pour activer l’onglet HTML de la ligne de dashboard
Description Description de la ligne de dashboard

Dans une ligne de dashboard, il est possible d’ajouter jusqu’à 6 vues personnalisées.

Pour ajouter une vue, choisir un emplacement (view1, view2, view3, etc) et sélectionner une vue en cliquant sur la loupe puis renseigner une largeur.

La largeur maximale est de “12”, la minimale est de “1”. 12 correspond à la largeur totale de l’écran.

La somme totale des largeurs de vue ne peut pas excéder “12”.

capture

Cliquer sur le bouton Enregistrer pour conserver le paramétrage de la ligne de dashboard.

​​​​​

Après avoir paramétré un dashboard, il est conseillé de rafraîchir la page et de vider le cache du navigateur.

Dupliquer un dashboard

Afin de gagner du temps, il est possible de dupliquer un dashboard existant pour ensuite le modifier.

Depuis la fiche dashboard, menu outil > Dupliquer Dashboard

screenshot

Dashboard designer

L’administrateur GoPaaS dispose d’un droit supplémentaire lui permettant de paramétrer rapidement un dashboard en partant de l’interface utilisateur.

Sur un dashboard existant, cliquer sur l'icône alt_text en haut à droite de l’écran.

Depuis cette interface, il est possible de :

  • Modifier la largeur du widget en glisser déposer

  • Modifier le nom du widget

  • Modifier la couleur du widget

  • Supprimer un widget du dashboard

Cliquer sur l'icône alt_text pour enregistrer les modifications.

screenshot

Webreport

Quickstart

Pour ajouter un WebReport dans GoPaaS vous devez créer un Dashboard ou utilisé un Dashboard existant.

  1. Dans le Dashboard ajouter une nouvelle ligne de Dashboard.

  2. Donner un Nom à cette nouvelle ligne plus cliquer sur le bouton « Appliquer » pour sauvegarder la fiche sans la fermer.

  3. Cocher la case « Options avancées » pour affiche l’onglet « Html » puis l’ouvrir.

  4. Dans le menu outil, cliquer sur l’option « Ajouter un WebReport ».

  5. Cette option permet d’insérer dans le champ « Html » le script pour appeler le composant WebReport.

  6. Les paramètres du script insérés devront être modifiés pour appeler une source de données existante (vue).

  7. Rechercher la ligne suivante « var viewKey = "A_RENSEIGNER" » et remplacer la chaine « A_RENSEIGNER » par la « cle » de la vue avec la source de données souhaités. Par exemple « var viewKey = "Par défaut Affaire" ».

  8. Enregistrer la ligne de dashboard et ouvrir le Dashboard pour afficher le WebReport avec la configuration par défaut.

  9. Cliquer sur la flèche diagonale en haut à droite du pivot pour modifier le WebReport en ajoutant des champs dans les lignes, colonnes, filtres, et valeurs.

  10. Configurer le WebReport selon les besoins puis cliquer sur le bouton « Enr. » pour afficher la nouvelle configuration du WebReport au format JSON.

  11. Cette configuration devra être copié afin de l'insérer dans le champ Html de la ligne de dashboard.

  12. Ouvrir la ligne de dashboard puis l’onglet Html.

  13. Coller pour remplacer la nouvelle configuration au format JSON entre les balises de commentaires ==Début== et ==Fin==.

  14. Cliquer sur le bouton « Enregistrer » pour sauvegarder dans la nouvelle configuration du WebReport.

Dans le champ Html, il est possible de modifier la configuration du WebReport en ajoutant ou modifiant les propriétés des objets slice, options, conditions et formats.

Pivot

WebReport propose de nombreuses opérations directement sur le pivot :

  • Afficher plusieurs champs par ligne, colonne et appliquer les filtres dont vous avez besoin.

  • Faites glisser les champs entre les colonnes, les lignes et les filtres de rapport.

  • Quand il a plus d’un champ dans une ligne ou colonne, développer ou réduire la liste des valeurs en cliquant sur l'icône sur la gauche de la cellule.

  • Drill up & down multi-niveau des champs en cliquant sur l’icône à droite de la cellule.

  • Filtrez les valeurs en cliquant sur le nom du champ.

  • Affichez ou masquez les totaux et les totaux généraux sur le pivot.

  • Trier les valeurs en utilisant les contrôles à droite de chaque nom de champ ou le total des cellules.

  • Double-cliquer pour afficher le détail d’une cellule avec des données non agrégées.

  • Redimensionnez les colonnes et les lignes en faisant glisser les limites de l'en-tête; double-cliquez sur les en-têtes de ligne ou colonne pour définir la taille par défaut.

  • Sélectionnez les cellules du pivot, copiez le contenu et collez-le directement dans une feuille de calcul; par exemple - Excel.

  • Utilisez la barre d'outils pour sélectionner entre les vues compact, classique et plat.

Pivot

Liste des champs

La liste des champs peut être utilisé pour définir les données présentes sur le pivot ou dans les graphiques. Cet outil peut être accessible en cliquant sur la flèche diagonale dans la partie supérieure droite du pivot ou de la barre d'outils.

Sur le côté gauche de la liste des champs, vous trouverez toutes les champs de la source de données d'origine. Lorsque la liste des champs contient plus de 50 éléments, une barre de recherche apparaît pour vous aider à trouver des éléments. Si la source de données contient des regroupements avec plus d'un niveau, le menu « Tout développer » est ajouté au sommet de la gauche partie de la liste des champs.

Faites glisser et déposez les champs de la partie gauche de la liste des champs vers les zones Lignes, Colonnes, Valeurs ou Filtres de rapport. Chaque zone peut avoir autant de champs que vous le souhaitez. L'ordre des champs à l'intérieur de la zone peut également être modifié par glisser - déposer. Il est également possible d'inclure n'importe quel niveau d'un champ, ainsi que tous ses sous-niveaux, dans les lignes ou les colonnes.

Les valeurs sont généralement placées dans des colonnes mais peuvent également être déplacées vers des lignes. Chaque valeur nécessite une fonction agrégée. Selon le type de source de données, les valeurs numériques prennent en charge entre 7 et 13 fonctions d'agrégation différentes. Les champs texte peuvent également être sélectionnées pour les valeurs, mais les seules fonctions d'agrégation disponibles seront Nombre et Nombre distinct. Par défaut, les champs numériques sont agrégés à l'aide de la somme et les champs texte utilisent le nombre. Vous pouvez modifier la fonction d'agrégation en appuyant sur l'icône sigma et en choisissant une nouvelle.

Choisissez « Ajouter une valeur calculée » en haut de la liste des champs pour ajouter un champ calculé.

Liste des champs

Champs calculés

WebReport fournit une interface pour ajouter et modifier des champs calculés. Cliquez sur « Ajouter champ calculé » dans la liste des champs et une fenêtre pour ajouter un nouveau champ s'affiche. Si nécessaire, entrez le nom de la valeur, puis composez la formule en cliquant sur les opérateurs et en faisant glisser les valeurs existantes dans la zone "formule". Cochez la case " Calculer les valeurs individuelles " pour calculer la formule à l'aide de valeurs brutes. Cliquez sur Appliquer et le nouveau champ sera ajouté à la liste des champs. Il sera déjà sélectionné dans la zone « Valeurs » et prêts à être affichés dans le pivot.

Tous les champs calculés sont regroupés dans une section « Valeurs calculées ». Modifiez le champ calculé en cliquant sur l'icône « modification » à côté du nom du champ. La fenêtre pour l'édition du champ apparaît. Modifiez la formule, mettez à jour le nom si nécessaire et cliquez sur le bouton APPLIQUER pour enregistrer les modifications. Supprimez la valeur calculée en cliquant sur l'icône de la corbeille en haut de la fenêtre d'édition.

Filtres

Chaque champ sur le pivot a une icône de filtre sur la droite. Il donne accès aux filtres avec du champ sélectionné. Le filtre peut être accessible par menu contextuel.

Dans la fenêtre, on peut trier par ordre alphabétique ou par ordre inverse alphabétique toutes les valeurs avec les boutons AZ et ZA.

Dans la liste déroulante des filtres, le premier filtre est « Top ». Il effectue un filtrage par des valeurs où seulement N premiers (ou inférieurs) éléments sont affichés sur le pivot. D’autres filtres standards sont disponibles dans cette liste déroulante. La case à cocher « Tout sélectionner » permet de sélectionner ou de désélectionner toutes les valeurs. Les valeurs peuvent également être sélectionnées ou désélectionnées manuellement. Une barre de recherche permet de rechercher des valeurs par leur nom lorsqu'il y en a beaucoup. Après les modifications, appuyez sur le bouton APPLIQUER pour voir les modifications sur le pivot.

Tri

Une ligne ou une colonne spécifique sur le pivot peut être triée à l'aide de la flèche de tri. Ces flèches sont disponibles à droite de chaque champ ou valeur. Cliquez pour la première fois pour trier par ordre décroissant, puis une deuxième fois pour trier par ordre croissant. En outre, ces options sont accessibles dans le menu contextuel de chaque champ ou valeur. Retirez le tri par le menu contextuel.

Drill-down

Double cliquez pour afficher le détail non agrégé des données de la cellule ou de l’élément. Une fenêtre s’ouvrira avec la liste des enregistrements à partir de laquelle la valeur est composée. En haut de cette fenêtre, il y a un résumé du croisement de la valeur : nom de colonne, nom de ligne nom et la valeur elle-même.

La liste de tous les champs est également disponible depuis cette fenêtre. Utilisez la flèche pour l'ajout ou la suppression des champs dans la vue détail sans changer les champs du pivot. Une autre façon d'ouvrir le détail est d’utiliser le menu contextuel sur l’élément.

Graphique

Les graphiques pivot offrent les mêmes fonctionnalités d'analyse que le pivot :

  • Dans le coin supérieur gauche, choisissez la valeur active dans la liste déroulante. Si l'option « Valeurs multiples » est sélectionné (Bouton Graphique), la liste déroulante permettra de sélectionner plusieurs valeurs.

  • Filtres pour les champs sélectionnées.

  • Cliquez deux fois sur les éléments du graphique pour afficher le détail et visualiser les premières données.

  • Utilisez la barre d'outils pour basculer facilement entre les différents types de graphiques.

  • S'il y a plusieurs champs dans les lignes, dépliez ou réduire les valeurs en cliquant sur le signe plus à gauche du nom du champ sur l'axe x. Pour plusieurs champs dans les colonnes, utilisez le signe plus sur la légende.

Barre d'outils

La barre d'outils permet de personnaliser le pivot et le graphique pivot. La barre d'outils utilise des appels d'API les plus couramment utilisés à travers des formulaires :

  • Le bouton Enregistrer enregistre le pivot avec ses configurations dans un format JSON.

  • Utilisez le bouton Exporter pour imprimer le contenu ou l’exporter au format HTML, CSV, Excel, Image et PDF.

  • Le bouton Tableau bascule la vue en mode pivot.

  • Le bouton Graphiques affiche tous les types de graphiques pivot et possède une case à cocher « Valeurs multiples » pour permettre la sélection de plusieurs valeurs pour les graphiques.

  • Le bouton Format propose deux options : Formater les cellules pour la mise en forme numérique et la mise en forme conditionnelle.

  • Cliquez sur Options pour afficher la fenêtre contextuelle avec des options de mise en page telles que les totaux généraux et les sous-totaux. Utilisez la mise en page section pour basculer entre les vues compact, classique et plat.

  • Le bouton Champs ouvre la liste des champs.

  • Cliquez sur Plein écran et passez en mode plein écran. Quittez ce mode en cliquant sur Échap.

Mise en forme

La mise en forme des nombres peut être appliquée via la fenêtre contextuelle Formater les cellules. Pour ouvrir cette fenêtre contextuelle, cliquez sur Format dans la barre d'outils et choisissez Format des cellules. Sélectionnez dans la liste déroulante la valeur à laquelle le format doit être appliqué. Ensuite, vous pouvez modifier une des propriétés suivantes : texte d’alignement, séparateurs des milliers, séparateur décimal, symbole monétaire, le format en pourcentage.

La fenêtre contextuelle de mise en forme conditionnelle peut être ouverte en cliquant sur Format dans la barre d'outils et en choisissant Mise en forme conditionnelle.

Dans la fenêtre contextuelle,

  • cliquez sur l’icône plus pour ajouter une nouvelle condition. Vous pouvez appliquer la condition soit à « toutes les valeurs » ou à une valeur spécifique de la liste déroulante.

  • Sélectionnez le type et la valeur de la condition, la famille de polices et la taille.

  • Cliquez sur l’icône de lettre A pour remplacer la police et les couleurs d’arrière-plan par défaut. Choisissez les nouvelles couleurs dans le sélecteur de couleurs ou entrez les codes hexadécimaux.

  • Cliquez sur « Appliquer » pour ajouter ces couleurs à la condition. Découvrez le résultat à l’intérieur de la zone à droite. Pour voir le résultat sur le pivot, cliquez sur le bouton APPLIQUER.

  • Supprimez la condition en cliquant sur l'icône de la corbeille à droite de la condition.

Slice

Slice est la définition de la source de données qui sera affiché dans le pivot. Cet objet a les propriétés suivantes :

  • columns – Array of objects. Liste des champs sélectionné dans le Pivot pour les. Chaque objet peut avoir les propriétés suivantes :

    • uniqueName – String. Nom de champ unique.

    • caption (optional) – String. Intitulé du champ.

    • dimensionName (optional) – String. Nom de la dimension.

    • filter (optional) – Filter Object. Contient les informations de filtres.

    • levelName (optional) – String. Permet de spécifier le niveau de la hiérarchie qui s'affiche sur le pivot.

    • sort (optional) – String. Tri sur le champ ("asc", "desc" ou "unsorted").

    • sortOrder (optional) – Array. Permet de définir un tri personnalisé pour les valeurs du champ. Vous pouvez spécifier sortOrder de la manière suivante : ["Janvier", "Février", "Mars", etc.].

  • drills (optional) – Object. Contient les informations sur le détail des valeurs :

    • drillAll (optional) – Boolean. Permet de définir si tous les niveaux seront explorés
  • drillThrough (optional) – Array. Permet de définir la liste des champs à afficher dans la fenêtre "Détails" pour l'exportation des données. Exemple: ["Compte", "Ville", "CA", etc.]

  • expands (optional) – Object. Informations sur les nœuds dépliés :

    • expandAll (optional) – Boolean. Permet d’indiquer si tout doit être condensé (false) ou déplié (true) sur le pivot et le graphique.

    • columns (optional) – Array of objects. Permet de sauvegarder les colonnes à déplier par défaut.

    • rows – Array of objects. Permet de sauvegarder les lignes à déplier par défaut.

  • flatSort – Array of objects. Contient la liste des objets définissant le tri multi-colonnes sur le tableau. Chaque objet a les propriétés suivantes :

    • uniqueName – String. Le nom de champ unique qui sera trié.

    • sort – String. Type de tri ("asc", "desc", ou "undefined").

  • measures – Array of objects. Liste des valeurs sélectionnées et ceux qui ont des propriétés différentes de celles par défaut. Chaque objet a les propriétés suivantes :

    • uniqueName – String. Nom unique de la valeur.

    • active (optional) – Boolean. Valeur sélectionnée par défaut (true ou false).

    • aggregation (optional) — String. Nom unique d'agrégation qui sera donné à la valeur ("sum", "count", "distinctcount", "average", "median", "product", "min", "max", "percent", "percentofcolumn", "percentofrow", "percentofparentrowtotal", "percentofparentcolumntotal", "index", "difference", "%difference", "runningtotals", "stdevp", "stdevs"). Si c’est un champ calculé, cette option sera à "none".

    • caption (optional) – String. Intitulé de la valeur.

    • formula (optional) – String. Formule contenant les opérations suivantes : +, -, *, / ; les autres valeurs peuvent être utilisées avec les fonctions d'agrégations, par exemple sum("Prix") ou max("Ordre").

    • individual (optional) – Boolean. Définit si la formule est calculée à l'aide de valeurs brutes (true) ou utilise des valeurs agrégées (false). Valeur par défaut : false.

    • calculateNaN (optional) – Boolean. Définit si la formule est calculée à l'aide des valeurs NaN (true) ou utilise la valeur NULL (false). Valeur par défaut : true.

    • format (optional) – String. Nom de formatage des nombres.

    • grandTotalCaption (optional) – String. Intitulé du total général.

  • flatOrder – Array of strings. Définit l’ordre des champs pour le type de tableau "plat". flatOrder peut-être spécifié comme ceci : ["Nom champ 1", "Nom champ 2", etc… ].

  • reportFilters – Array of objects. Liste des champs sélectionnés dans le slice pour filtrer le pivot. Chaque objet a des propriétés similaires aux columns.

    • uniqueName – String. Nom de champ unique.

    • caption (optional) – String. Intitulé du champ.

    • dimensionName (optional) – String. Nom de la dimension.

    • filter (optional) – Filter Object. Contient les informations du filtre.

    • levelName (optional) – String. Utilisé pour spécifier le niveau de la hiérarchie affichée sur le tableau.

    • sort (optional) – String. Type de tri ("asc", "desc" ou "unsorted").

    • sortOrder (optional) – Array. Permet de définir un tri personnalisé pour les valeurs du champ. Vous pouvez spécifier sortOrder de la manière suivante : ["champ_1", "champ_2", etc...].

  • rows – Array of objects. A list of hierarchies selected in the report slice for rows. Each object can have the following properties:

    • uniqueName – String. Nom de champ unique.

    • caption (optional) – String. Intitulé du champ.

    • dimensionName (optional) – String. Nom de la dimension.

    • filter (optional) – Filter Object. Contient les informations du filtre.

    • levelName (optional) – String. Utilisé pour spécifier le niveau de la hiérarchie affichée sur le tableau.

    • sort (optional) – String. Type de tri ("asc", "desc" or "unsorted").

    • sortOrder (optional) – Array. Permet de définir un tri personnalisé pour les valeurs du champ. Vous pouvez spécifier sortOrder de la manière suivante : ["champ_1", "champ_2", etc...].

  • sorting (optional) – Object. Définit le tri des nombres dans une ligne ou colonne spécifique du pivot.

  • column – Object. Définit le tri des nombres dans une colonne spécifique.

    • tuple – Array. Se compose de noms uniques qui identifient la colonne du tableau en fonction des données qu'elle contient.

    • measure – Object. Identifie la valeur sur laquelle le tri sera appliqué.

      • uniqueName – String. Nom de mesure unique.

      • aggregation (optional) – String. Type d’agrégation de la valeur.

    • type – String. Type de tri ("asc" ou "desc").

  • row – Object. Définit le tri des nombres dans une colonne spécifique.

    • tuple – Array. Se compose de noms uniques qui identifient la colonne du tableau en fonction des données qu'elle contient.

    • measure – Object. Object. Identifie la valeur sur laquelle le tri sera appliqué.

      • uniqueName – String. Nom de mesure unique.

      • aggregation (optional) – String. Type d’agrégation de la valeur.

    • type – String. Type de tri ("asc" ou "desc").

Changer le slice en utilisant l’API runQuery() et setReport(). Récupérer le slice d’un autre en utilisant getReport().

Options

Un WebReport peut être personnalisé à l'aide de l'objet options. Cet objet est utilisé pour définir l'apparence selon les besoins de l'utilisateur. Par exemple, vous pouvez afficher ou masquer les fonctionnalités telles que les filtres ou les tris, définir le format des champs date, ou activer/désactiver le drill down.

L'objet options est défini dans l'objet Report. Si aucune option n'est spécifiée, le WebReport utilisera les options par défaut. Nous allons voir ici toutes les options disponibles et comment les utiliser.

Toutes les options sont définies dans 3 sous-groupes :

  • Grid – définit l'apparence du pivot et les fonctionnalités.

  • Chart – définit l'apparence du graphique pivot et les fonctionnalités.

  • General – définit les options applicables à tous les composants.

Grid

Toutes les options « Grid » sont dans la section « grid » de l’objet « options ».

Property Type Description
type String Type d’affichage du pivot : "compact", "classic", et "flat". Valeur par défaut: "compact".
title String Titre du pivot. Valeur par défaut: "".
showFilter Boolean Affiche les filtres des lignes/colonnes et les filtres du pivot : (true) ou (false). Valeur par défaut: true.
showHeaders Boolean Afficher les numéros de ligne/colonne : (true) ou (false). Valeur par défaut: true.
showTotals String Indique où afficher les totaux : dans les lignes ("rows"), dans les colonnes ("columns"), dans les deux ("on") ou aucun totaux ("off"). Valeur par défaut: "on".
showGrandTotals String Indique où afficher les totaux généraux : dans les lignes ("rows"), dans les colonnes ("columns"), dans les deux ("on") ou aucun totaux ("off"). Valeur par défaut: "on".
grandTotalsPosition String Indique la position des totaux généraux du pivot : en haut ("top") ou en bas ("bottom"). Disponible uniquement pour la vue « brute ». Valeur par défaut: "top".
showHierarchies Boolean Indique comment afficher les valeurs de champs pouvant être explorées sur le pivot : Avec un lien sur la droite (true) ou avec une icône sur la gauche (false). Valeur par défaut: true.
showHierarchyCaptions Boolean Afficher les légendes (true) sur le pivot ou non (false). Valeur par défaut: true.
drillthroughMaxRows Number Définit le nombre maximal de lignes pour la fenêtre d’exploration des valeurs. Valeur par défaut: 1000.
showReportFiltersArea Boolean Affiche les filtres du pivot (true) ou (false). Valeur par défaut: true.
dragging Boolean Autoriser le glisser-déposer des champs sur le pivot (true) ou (false). Valeur par défaut: true.
showEmptyValues Boolean Afficher les valeurs vides dans le pivot (true) ou non (false). Valeur par défaut: false.

Chart

Toutes les options « chart » sont dans la section « chart » de l’objet « options ».

Property Type Description
type String Type d’affichage du graphique pivot : "column", "bar_h", "line", "scatter", "pie", "stacked_column", et "column_line". Valeur par défaut: "column".
title String Titre du graphique. Valeur par défaut: "".
showFilter Boolean Affiche les filtres des lignes/colonnes et les filtres du pivot : (true) ou (false). Valeur par défaut: true.
multipleMeasures Boolean Affiche plusieurs valeurs sur le graphique. Valeur par défaut: false.
oneLevel Boolean Dans les graphiques que l’on peut explorer, défini si le graphique affiche tous les nœuds sur l'axe des x et la légende (false) ou uniquement le nœud développé le plus bas sur l'axe des x et la légende (true). Valeur par défaut: false.
autoRange Boolean Indique si la plage de valeurs dans les graphiques est sélectionnée automatiquement ou non. Valeur par défaut: false.
reversedAxes Boolean Inverse les colonnes et les lignes. Valeur par défaut: false.
showLegend Boolean Afficher les légendes (true) sur le graphique ou non (false). Valeur par défaut: true.
showLegendButton Boolean Indique si le bouton pour afficher/masquer la légende des graphiques est visible. Lorsqu'elle est définie sur false, la légende est visible, sans bouton pour la masquer. Valeur par défaut: false.
showDataLabels Boolean Permet d’afficher les étiquettes. Si la valeur false, les étiquettes seront masquées. showAllLabels permet de configurer les étiquettes dans les graphiques de type Secteur. Valeur par défaut: false.
showAllLabels Boolean Permet d’afficher toutes les étiquettes dans les graphiques de type secteur si la valeur est à true. Si la valeur est à false alors seules les étiquettes pouvant être affichées sans se chevaucher seront affichées. Valeur par défaut: false.
showMeasures Boolean Permet d’afficher les listes déroulantes en haut des graphiques (false). Valeur par défaut: true.
showOneMeasureSelection Boolean Permet d’afficher la liste déroulante des valeurs (true) ou (false) la liste déroulante des valeurs sur les graphiques sera masquée s'il n'y a qu'une seule valeur dans la liste et visible s'il y a deux valeurs ou plus. Valeur par défaut: true.
showWarning Boolean Indique une alerte Indique si les données sont trop volumineuses pour les graphiques. Valeur par défaut: true.
position String Indique la position du graphique par rapport au pivot : "bottom", "top", "left", ou "right". Valeur par défaut: "bottom".
activeMeasure Object Liste des valeurs sélectionnées dans le graphique.
activeMeasure.uniqueName String Nom de la valeur unique.
activeMeasure.aggregation String Type d’agrégation pour les valeurs.
axisShortNumberFormat Boolean Indique si les étiquettes des axes sur les graphiques sont affichées en utilisant un format numérique court comme 10K, 10M, 10B, 10T (true) ou non (false). Valeur par défaut: undefined (affiche le format court si valeur max > 10M).

General

Toutes les options « general » sont dans l’objet « options ».

Property Type Description
viewType String Type de vue à afficher : "grid", "charts" ou "grid_charts". Valeur par défaut: "grid".
filter Object Filtres :
filter.timezoneOffset Number La différence en minute entre UTC et l’heure locale de l’utilisateur, utilisé pour ajuster les dates dans le filtre. Valeur par défaut: the user’s local time.
filter.weekOffset Number Définit le nombre de jours à ajouter au début de la semaine (dimanche). Utilisé pour ajuster le premier jour de la semaine dans le calendrier du filtre. Valeur par défaut: 1 (Lundi est le premier jour de la semaine).
filter.dateFormat String Modèle de date à utiliser pour formater les dates des filtres. Deux valeurs possibles : "dd/MM/yyyy" et "MM/dd/yyyy". Valeur par défaut: "dd/MM/yyyy".
filter.liveSearch Boolean Indique si la recherche est effectuée pendant que l'utilisateur tape (true) ou en cliquant sur le bouton Entrée (false). Valeur par défaut: true.
configuratorActive Boolean Indique si la liste des champs est ouverte (true) ou fermée (false). Valeur par défaut: false.
configuratorButton Boolean Affiche le bouton de configuration de la liste des champs. (true) ou (false). Valeur par défaut: true.
showAggregations Boolean Affiche la sélection d’agrégation (true) ou non (false) pour les valeurs dans la liste de champs. Valeur par défaut: true.
showCalculatedValuesButton Boolean Afficher le bouton « Ajouter champs calculés » (true) ou non (false). Valeur par défaut: true.
grouping Boolean Indique si le regroupement est activé. Cette fonctionnalité permet aux utilisateurs de regrouper les éléments choisis à l'aide d'une fenêtre de filtre. Valeur par défaut: false.
editing Boolean Indique si la fonction d'édition est activée (true) ou désactivée (false) dans la fenêtre d’exploration des données « Détail ». Valeur par défaut: false.
drillThrough Boolean Indique si la fonction d'exploration des données est activée (true) ou désactivée (false). Valeur par défaut: true.
showDrillThroughConfigurator Boolean Indique si le bouton Liste des champs est visible dans la vue « Détails ». Valeur par défaut: true.
sorting String Indique si les contrôles de tri sont visibles. Valeur par défaut: on.
defaultDateType String Utilisé pour spécifier les types de données à appliquer aux champs de date par défaut. Valeur par défaut: "date".
strictDataTypes Boolean Permet d'augmenter la vitesse de traitement des données. Valeur par défaut: false.
datePattern String Format des champs de type « date string ». Valeur par défaut: "dd/MM/yyyy".
dateTimePattern String Format des champs de type « datetime ». Valeur par défaut: "dd/MM/yyyy HH:mm:ss".
timePattern String Format des champs de type « time ». Valeur par défaut: "HH:mm:ss".
dateTimezoneOffset Number Permet de configurer les regroupements de date.
showDefaultSlice Boolean Définit une configuration du Slice par défaut. Valeur par défaut: true.
showEmptyData Boolean Définit le comportement en cas de source de données vide de deux manières : (true), un pivot vide s’affiche et déclenche un événement dataerror. (false), un message s’affiche «La source de données est vide» et déclenche un événement dataerror pour tous les types mentionnés de la source de données vide.Valeur par défaut: true.
defaultHierarchySortName String Tri par défaut des valeurs des champs ("asc", "desc", ou "unsorted"). Valeur par défaut:asc.
showAggregationLabels Boolean Affiche dans les titres des colonnes/lignes des agrégations "Somme des", "Somme de", etc.. Valeur par défaut: true.
showAllFieldsDrillThrough Boolean Affiche les colonnes pré-sélectionnées dans la vue « Détails » pour l’exploration des données (false) ou toutes les colonnes disponibles (true). Valeur par défaut: false.
liveFiltering Boolean Indique si le filtre dynamique pour les valeurs des champs est activé (true) ou désactivé (false). Valeur par défaut: false.
showFieldListSearch Boolean Indique si la barre de recherche dans la liste des champs est affichée (true) ou masquée (false). Valeur par défaut: false.
validateFormulas Boolean Indique si la validation est effectuée pour les champs calculées (true) ou non (false). Si la validation est activée et que le pivot contient une formule non valide, le message d'alerte «Formule incorrect» s'affiche. Pour désactiver le message d'alerte, mettre à (false). Valeur par défaut: true.
caseSensitiveMembers Boolean Indique si les valeurs des champs sont sensibles à la casse (true) ou non (false). Valeur par défaut: false.
validateReportFiles Boolean Indique si la validation des fichiers de configuration est activée (true) ou désactivée (false).. Valeur par défaut: true.
fieldListPosition String Afficher la liste des champs toujours à droite ("right") ou dans une fenêtre distincte ("undefined"). Valeur par défaut: undefined.
allowBrowsersCache Boolean Permet aux navigateurs à mettre en cache les données (true) ou non (false). Valeur par défaut: false.

Exemple de l'ojet options défini par défaut dans un Webreport:

"options": {
        "viewType": "grid",
        "grid": {
            "type": "compact",
            "title": "",
            "showFilter": true,
            "showHeaders": true,
            "showTotals": "on",
            "showGrandTotals": "on",
            "grandTotalsPosition": "top",
            "showExtraTotalLabels": false,
            "showHierarchies": true,
            "showHierarchyCaptions": true,
            "drillthroughMaxRows": 1000,
            "showReportFiltersArea": true,
            "dragging": true,
            "showAutoCalculationBar": true,
            "showEmptyValues": false
        },
        "chart": {
            "type": "column",
            "title": "",
            "showFilter": true,
            "labelsHierarchy": "",
            "multipleMeasures": false,
            "oneLevel": false,
            "autoRange": false,
            "reversedAxes": false,
            "showLegend": true,
            "showLegendButton": false,
            "showDataLabels": false,
            "showAllLabels": false,
            "showMeasures": true,
            "showOneMeasureSelection": true,
            "showWarning": true,
            "activeMeasure": {}
        },
        "filter": {
            "weekOffset": 1,
            "dateFormat": "dd/MM/yyyy",
            "liveSearch": true
        },
        "configuratorActive": false,
        "configuratorButton": true,
        "showAggregations": true,
        "showCalculatedValuesButton": true,
        "grouping": false,
        "editing": false,
        "drillThrough": true,
        "showDrillThroughConfigurator": true,
        "sorting": "on",
        "defaultDateType": "date",
        "strictDataTypes": false,
        "datePattern": "dd/MM/yyyy",
        "dateTimePattern": "dd/MM/yyyy HH:mm:ss",
        "showDefaultSlice": true,
        "showEmptyData": true,
        "defaultHierarchySortName": "asc",
        "showAggregationLabels": true,
        "sortAlphabetically": [],
        "showAllFieldsDrillThrough": false,
        "liveFiltering": false,
        "showFieldListSearch": false,
        "validateFormulas": true,
        "caseSensitiveMembers": false,
        "validateReportFiles": true,
        "fieldListPosition": undefined,
        "allowBrowsersCache": false
    }

Modèle de lettre

Description

Les modèles de lettre simplifient le processus de fusion de données en permettant aux utilisateurs de créer rapidement des documents personnalisés à partir des données de leur application. En utilisant les modèles de lettre, les utilisateurs peuvent générer des documents professionnels et cohérents en un clin d'œil.

screenshot

Prérequis

Pour assurer une fusion de données correcte, les informations de l'application doivent être accessibles à partir d'une vue personnalisée. Lorsque l'architecture de l'application le permet, il est également envisageable d'intégrer les données provenant des tables enfants et/ou parents à la table principale pour une fusion complète et précise.

Créer un modèle de lettre

Pour créer un modèle de lettre rendez vous dans dans la barre de navigation > Références > Modèle > Modèle de lettre.

screenshot

Cliquer sur ajouter.

Ci-dessous, la description des champs de l’onglet principal.

Intitulé Nom du modèle
Table Nom de la table principale pour la fusion du modèle
Vue Nom de la vue principale à utiliser pour la fusion du modèle
Type Type de modèle de lettre DOC ou HTML
PDF Option qui permet la fusion du modèle en PDF. La fusion par défaut est au format Word
Fichier Modèle de lettre au format docx, odt, xlsx, pttx
Vue(s) liée(s) à utiliser Nom des vues liées pour la fusion du modèle
Note Description détaillée du modèle de lettre

Créer et paramétrer le modèle de fusion DOC

Dans l’exemple ci dessous nous allons utiliser un modèle type odt.

La méthode implique l'insertion de balise GoPaaS aux emplacements où doivent figurer les données dans le modèle de fusion. Ces balises seront interprétées par l'application et fusionnées dans le document final.

Il existe deux types de balises:

  • Les champs

  • Les blocs

Un champ GoPaaS est une balise GoPaaS qui doit être remplacée par une donnée simple. Il est possible de spécifier un format d'affichage ainsi que d'autres paramètres.

Un bloc GoPaaS est une section qui devra être répétée. Il est défini par une ou deux balises GoPaaS.

Le plus souvent il s'agit d'une ligne d'un tableau.

Il existe quatres formats d’affichage de balise.

  • Texte

  • Nombre

  • Date

  • Image

Les différents formats sont disponibles à la fusion pour tous les types de balise existants.

Texte [onshow.NOM_ALIAS_DANS_LA_VUE;noerr;ifempty'']
Date [onshow.NOM_ALIAS_DANS_LA_VUE;frm=dd/mm/yyyy;noerr;ifempty'']
Nombre [onshow.NOM_ALIAS_DANS_LA_VUE;frm='0 000,00';noerr;ifempty]
Image [onshow.NOM_ALIAS_DANS_LA_VUE;ope=changepic;tagpos=inside;adjust;unique]
Image vue de Fusion Dans la vue de fusion, il faut indiquer le chemin serveur vers le fichier : Exemple sur la table “fichier” et champ “pj1” Colonne SQL = if(fichier.pj1<>'',CONCAT('../../file/fichier/', fichier.pj1),'') On peut remplir le else avec un fichier par défaut si nécessaire

Fusion d’un champ présent sur la vue principale

En choisissant la vue de fusion dans le modèle de lettre, GoPaaS offre une liste des champs disponibles à fusionner dans le modèle. Si un champ nécessaire à la fusion est absent, il doit être ajouté à la vue de fusion.

screenshot

Cliquer sur l'icône copie dans le tableau des champs pour copier le code de fusion puis coller dans le modèle de fusion.

Exemple dans le modèle de fusion : Adresse client : [onshow.client_adresse;noerr;ifempty'']

Fusion d’une vue liée

En sélectionnant les vues liées de fusion dans le modèle de lettre, GoPaaS offre une liste des champs disponibles à fusionner dans le modèle. Si un champ nécessaire à la fusion est absent, il doit être ajouté à la vue de fusion.

screenshot

Remarque : Lors de la fusion d'une vue liée, le code de fusion du premier champ de la vue est légèrement modifié. Il est important de prendre en compte l'ordre des champs dans la vue.

Pour inclure le premier champ d'une vue liée cliquer sur l'icône copie dans le tableau des champs, puis collez-le dans le modèle de fusion. Répéter l’opération pour les autres champs de la vue liée.

Exemple dans le modèle de fusion :

REF Montant HT Remise
[facture_ligne.Pardéfaut.WLW4M.reference;block=tbs:row] [facture_ligne.Pardéfaut.WLW4M.facture_ligne_montant_ht;frm='0 000,00'] [facture_ligne.Pardéfaut.WLW4M.remise_0;frm='0 000,00']

Créer et paramétrer le modèle de fusion HTML

Étapes à suivre

  1. Utilisez les onglets appropriés pour insérer votre code HTML, CSS et JS :
    • Le code HTML permet de créer et personnaliser un modèle de lettre.

Vous pouvez utiliser l'IA pour générer le code HTML depuis un modèle pdf

Le code qui doit être insérer dans le champs HTML doit contenir uniquement les éléments du body

  • Le code JS permet de piloter le document.
  • Le code CSS gère la mise en page du document.
  1. Insérez le code des champs GoPaaS aux emplacements souhaités dans votre modèle HTML. Ces codes seront interprétés par l'application et fusionnés dans le document final.

Codes de champs disponibles

Syntaxe historique avec crochets [%...%]

  • [%FIELDNAME%] : valeur brute du champ.
  • [%FIELDNAME|longtext%] : valeur avec sauts de ligne convertis.
  • [%FIELDNAME|date%] : valeur formatée en jj/mm/aaaa.
  • [%FIELDNAME|ucase%] : valeur en majuscules.
  • [%FIELDNAME|lcase%] : valeur en minuscules.
  • [%FIELDNAME|lcfirst%] : première lettre en minuscule.
  • [%FIELDNAME|ucfirst%] : première lettre en majuscule.
  • [%FIELDNAME|number%] : nombre formaté (0 000,00).
  • [%FIELDNAME|number|MASK%] : nombre formaté selon un masque (ex. 0 000,00 ou 0,000.00).

Syntaxe alternative avec doubles accolades {{...}}

  • {{FIELDNAME}} : valeur brute du champ.
  • {{FIELDNAME|longtext}} : valeur avec sauts de ligne convertis.
  • {{FIELDNAME|date}} : valeur formatée en jj/mm/aaaa.
  • {{FIELDNAME|ucase}} : valeur en majuscules.
  • {{FIELDNAME|lcase}} : valeur en minuscules.
  • {{FIELDNAME|lcfirst}} : première lettre en minuscule.
  • {{FIELDNAME|ucfirst}} : première lettre en majuscule.
  • {{FIELDNAME|number}} : nombre formaté par défaut (0 000,00).
  • {{FIELDNAME|number|MASK}} : nombre formaté selon un masque.

Fusion d’un champ de la vue principale

  1. Sélectionnez la vue de fusion dans le modèle de lettre. GoPaaS vous propose une liste des champs disponibles à fusionner.
  2. Ajoutez le champ manquant à la vue de fusion si nécessaire.
  3. Cliquez sur l'icône copie dans le tableau des champs pour copier le code de fusion.
  4. Collez le code dans votre modèle de fusion.

Exemple dans le modèle de fusion :
Adresse client : {{adresse}}

Fusion d’une vue liée

  1. Sélectionnez les vues liées dans le modèle de lettre. GoPaaS vous propose une liste des champs disponibles à fusionner.
  2. Ajoutez le champ manquant à la vue de fusion si nécessaire.

screenshot

Imprimer le modèle de lettre

Les modèles de lettre peuvent être imprimés depuis :

  • Une fiche

  • Une vue

Depuis une fiche, menu outil > Fusionner > choisir le modèle > Fusionner

Depuis une vue, sélectionner les fiches à fusionner > menu outil > Fusionner > choisir le modèle > Fusionner

Protection d'un modèle de lettre DOC

Pour protéger un document, ajouter dans le champ protection (onglet Système du modèle de lettre), les options souhaitées :

Option Explication
print Interdire l'impression du document.
modify Empêcher toute modification du contenu du document.
copy Interdire la copie du texte ou des éléments du document.
annot-forms Empêcher l'ajout d'annotations au document.
fill-forms Bloquer la possibilité de remplir les formulaires existants dans le document.
extract Interdire l'extraction de contenu pour une utilisation ailleurs.
assemble Empêcher la combinaison du document avec d'autres fichiers.
print-high Interdire l'impression en haute qualité.

Exemple :

["print", "modify", "copy", "annot-forms", "fill-forms", "extract", "assemble", "print-high"].

A noter : Si aucune protection n'est nécessaire, indiquer simplement : [].

Automatisation

Introduction

L’automatisation est l’une des fonctionnalités les plus utiles de GoPaaS.

Elle fonctionne un peu comme un assistant.

Les automatisations indiqueront à GoPaaS comment accomplir des tâches répétitives ou routinières, comme l’envoi d’un mail tous les jours à 9 heures avec les tâches de la journée, ou encore des tâches plus complexes, comme envoyer un mail à un commercial en charge d’un compte, pour lequel un technicien a signalé un incident important voire critique.

Grâce aux automatisations, GoPaaS peut vous rappeler vos relances téléphoniques, vos rendez-vous imminents et/ou créer des fiches, en fonction de critères que vous aurez vous-même pré-définis.

Les automatisations vous permettent de totalement robotiser des tâches répétitives, de ne pas négliger certains détails, ou de vous fournir des informations au moment opportun, sans que vous ayez à les demander.

Pour créer une nouvelle automatisation, rendez-vous dans la barre de personnalisation en haut à droite de l’écran > Automatisation puis cliquer sur ajouter pour créer une nouvelle automatisation.

Intitulé Description
Nom Nom de l'automatisation
Actif Activer ou désactiver l’automatisation
Description Description détaillée de l’automatisation
Ordre Ordre de l’automatisation dans la vue par défaut

screenshot

Mode de fonctionnement des automatisations

Un automatisation est une série d’instructions que GoPaaS exécute automatiquement lorsque survient un événement particulier. Pour créer une automatisation il faut définir un déclencheur, le nombre de conditions et d’actions consécutives sont illimitées.

Déclencheur

Evénement à partir duquel l’automatisation sera exécutée. Il existe deux types de déclencheurs :

  • Enregistrement d’une fiche

  • Timer

screenshot

Enregistrement d’une fiche

L'automatisation se déclenche lors de l'enregistrement de la fiche. Plusieurs paramètres doivent être pris en considération.

Intitulé Description
Mode Enregistrement et modification
Enregistrement
Modification
Table Sélection de la table concernée par l’automatisation

Timer

L'automatisation se déclenche avec une configuration temporelle. Plusieurs autres paramètres doivent être pris en considération.

Intitulé Description Explication
Fréquence x minutes Spécifier le temps en minutes entre chaque déclenchement
Heure Spécifier l'intervalle régulier entre chaque déclenchement. Par exemple : 15, l'automatisation se déclenchera chaque heure à la 15ème minute
Jour Spécifier le(s) jour(s) de la semaine et l’heure de déclenchement
Mois Spécifier le jour du mois et l’heure de déclenchement
Table Sélection de la table concernée par l’automatisation

Conditions

Cette section permet de définir les conditions à respecter pour que l’automatisation déclenche une série d'actions.

screenshot

Cliquer sur icone ajouter pour ajouter une condition puis renseigner :

  • Un champ dans la liste déroulante

  • Un opérateur

  • La valeur recherchée

Répéter l’opération pour cumuler d’autres conditions.

Plusieurs conditions peuvent être cumulées pour une seule automatisation.

Actions

Cette dernière section permet d’ajouter les actions à exécuter lorsque les conditions sont respectées.

screenshot

Au total de sept actions sont disponibles dans GoPaaS.

Nom de l'action Description
Modifier fiche Modifier la fiche spécifiée dans le déclencheur.
Ajouter fiche Ajoute une nouvelle fiche dans une table que l'on sélectionne.
Email Envoyer un email personnalisé
Script serveur Exécuter un script PHP côté serveur (back-end).
CURL Exécuter une requête cURL
Cron mail Exécuter une tâche cronmail
Importer les emails Exécuter une tâche d’import d’email

A l’image des conditions, plusieurs actions peuvent être cumulées dans une seule automatisation.

Admin

API Rest

L'API REST GoPaaS permet aux applications GoPaaS de communiquer entre elles.

screenshot

  • Conditions sur les vues pour filtrer les données de transit
  • Gestion des destinations
  • Mappage via JSON
  • Jeton d'identification
  • Echange de données type texte, image ou fichier
  • Déclenchement via automatisme

Audit trail

L'audit trail permet de visualiser les modifications qui ont été faites dans les fiches de l'application.

Le suivi de ces modifications est à activer dans les champs d'une table en cochant "Audit Trail" de l'onglet "Autre".

Il existe deux solutions pour accéder à l'audit trail :

  • Depuis la fiche que vous souhaitez auditer, cliquer sur le menu Outil > Audit-Trail
  • Depuis la barre de navigation > Admin > Audit trail. Dans ce cas vous arriverez sur une vue avec toutes les modifications de toutes les fiches classées par table.

Ne pas oublier d'activer l'audit trail dans les champs d'une table en cochant "Audit Trail" dans l'onglet Principal.

Champ Description
Table C'est la table reliée à cette fiche Audit trail.
Date Date de la modification.
Utilisateur L'utilisateur qui a effectué la modification.
Fiche La fiche qui est auditée.
Heure Heure de modification
Etat avant État de la fiche avant la modification.
Etat après État de la fiche après modification.

Dictionnaire

Vous pouvez importer un dictionnaire afin de bénéficier de l'application dans votre langue. Vous pouvez également créer des chaînes de caractères manuellement.

Pour importer un dictionnaire utilisez le module d'import, pour créer des chaînes de caractères cliquez sur Admin depuis la barre de navigation puis Dictionnaire.

Pour le faire manuellement cliquer sur Ajouter :

screenshot

Plusieurs champs sont à renseigner pour enregistrer la traduction :

Champ Description
Texte de référence Il correspond a l'intitulé du champ.
Type Pour l'application, sélectionner systématiquement "application".
Inscrire ensuite la traduction du texte de référence dans les autres langues pour valider la traduction.

il faudra vous déconnecter et vous reconnecter de GoPaaS pour que les nouvelles traductions soient chargées.

Groupes

Le menu groupe permet de gérer les groupes d'utilisateurs, par défaut il existe 4 groupes : ADMIN, COMMERCIAL, TECHNIQUE et COMPTA.

La notion de groupe est indispensable au paramétrage des permissions, ces différents groupes n'ont pas les mêmes droits.

Le groupe sera alors associé à un ou plusieurs utilisateurs. screenshot

Pour créer un nouveau groupe cliquez sur Ajouter, puis renseigner le champ Intitulé, il correspond tout simplement au nom du groupe.

screenshot

Section Utilisateur

Permet de voir la liste des membres du groupe

Section Permission

  • Module(s) : Permet de donner l’accès aux modules, séparés par une virgule.
  • Accès rapide : Rend disponible les Accès rapide dans la barre de navigation.
  • Dashboard : Rend disponible les Dashboard dans la barre de navigation.
  • Référence : Rend disponible le menu des Références dans la barre de navigation.
  • Ajout rapide : Rend disponible l'Ajout rapide dans la barre d'outils.

History (historique)

Vous pouvez ici retrouver la liste de toutes les fiches historiques de navigation sur l’application.

screenshot

Vous retrouverez sur la fiche les informations suivante

screenshot

Champ Description
Date Date de l’historique
Time Heure de l’historique
Utilisateur Utilisateur concerné
Name Nom de la fiche ou vue ouverte
Type Item (fiche) ou view (vue)
Tablename Table concernée
Keyvalue Clé de la fiche ou vue

Corbeille

Vous retrouverez ici la liste de toutes les fiches supprimées et si nécessaire les restaurer

Champ Description
Table Name Nom de la table
Item ID ID de la fiche supprimé
Item Key Clé de la fiche supprimé
Data JSON contenant toute la fiche
Bouton Restaurer Bouton permettant de restaurer la fiche

Sessions

Le menu Sessions permet d'afficher la liste des sessions utilisateurs des applications GoPaaS.

Dans la vue vous avez déjà accès à certaines informations comme l'heure, le statut ou encore la durée de connexion en secondes.

En effectuant un double clic sur une fiche, vous accédez à plus d'informations comme l'adresse IP de l'utilisateur, le nom de son navigateur ou encore le type d'OS utilisé.

screenshot

Transfer In

Permet d’importer des éléments d’une autre application

capture

Champ Valeur
Choisir un fichier Sélectionner un JSON à importer
Bouton Importer Lance l'import

Pour l’import d’une table il faudra se rendre dans le Check application pour créer la table et les champs

Configuration

La fiche de configuration permet de personnaliser le style de l'application en y adaptant les couleurs et l'image de l'entreprise.

​​​​​​​On retrouve également les coordonnées de l'entreprise et les éléments comptables.

La fonction de configuration se compose de plusieurs onglets qui renferment des sections, l'accès se fait uniquement depuis la barre de navigation > Admin > Configuration.

Onglet Principal

Section Société

Renseigner les informations relatives à la société, les coordonnées et le RIB.

screenshot

Application

Champ Description
Durée d'inactivité Permet de définir la durée maximale d'inactivité durant laquelle la session est ouverte. (Valeur à définir en secondes)
Activer gestion du token Un Token peut être utilisé pour authentifier les utilisateurs dans des applications externes ou via une API.
Activer corbeille Permet d’activer la corbeille sur votre application, les fiches envoyées dans la corbeille se retrouvent dans le menu Admin > Corbeille
Activer historique Vous permet d’activer l’historique de navigation

Serveur SMTP

Champ Description
Hôte Adresse du serveur SMTP utilisé pour l'envoi des e-mails
Port Port de connexion SMTP (587 pour STARTTLS)
Nom utilisateur Clé API publique ou identifiant fourni par le fournisseur de service SMTP
Mot de passe Clé API secrète ou mot de passe associé à l’utilisateur SMTP
Utiliser SSL Indique si la connexion doit utiliser SSL (désactivé ici, STARTTLS utilisé)

Docusign

Champ Description
URL Adresse de l’API DocuSign utilisée pour les requêtes
Nom utilisateur Identifiant de connexion au compte DocuSign
Mot de passe Mot de passe associé au compte utilisateur
Clé intégration Clé API unique permettant l’intégration avec l’application

Yousign

Champ Description
URL Adresse de l’API Yousign
apiKey Clé API utilisée pour s’authentifier et effectuer des requêtes

SSO (Single Sign-On)

Champ Description
Activer SSO Champ de type checkbox permettant d’activer ou désactiver le SSO
Configuration Champ de paramétrage au format JSON contenant les infos de connexion

Google

Champ Description
Google API Key Champ contenant la clé API Google utilisée pour accéder aux services Google Maps

Slow query

Champ Description
Activer Interrupteur permettant d'activer ou désactiver le suivi des Slow query
Long query time Champ numérique pour définir le seuil de temps (en secondes) à partir duquel une requête est considérée comme lente

Onglet Style

  • La section Style général permet de modifier le style de l'application, changer les couleurs, ajouter un favicon et modifier le titre de l'application.
  • La section Page de login permet de modifier le style sur la page de connexion à l'application.
  • La section Bouton connexion correspond à la personnalisation du bouton présent sur la page de connexion.

Il est possible de paramétrer la couleur des boutons :

Type de bouton Style
Bouton par défaut capture ou encore capture
Bouton principal Bouton de type capture
Bouton info Bouton de type capture
Bouton Succès Bouton de type capture
Bouton danger Bouton de type capture
Bouton avertissement Bouton de type capture

Il est également possible de personnaliser les couleurs de la vue Pivot (Tableau croisé dynamique) via la section Couleur vue pivot.

Pour le paramétrage des couleurs, veuillez renseigner une valeur au format : #FFFFFF.

Onglet Script

Ajouter un script à cet emplacement pour des paramétrages spécifiques comme :

  • Redimensionnement des photos
  • Paramétrage du mode offline
  • Ou autre fonction personnalisé qui pourra être appelé de toutes l'application

Onglet Archivage emails

Vous permet de paramétrer l’archivage email dans GoPaaS

Champ Description
Table Table où archiver les emails
Date Champ sur lequel enregistrer la date
Expéditeur Champ sur lequel connecter l’expéditeur (retrouve le contact avec l'émail)
Destinataires(s) Champ sur lequel enregistrer le ou les destinataires
Sujet Champ sur lequel enregistrer le sujet
Corps du message Champ sur lequel enregistrer le message
Pièce(s) jointe(s) Champ sur lequel enregistrer les PJ (génère un zip si plusieurs PJ)
Identifiant de l'email Champ d’identification unique de l’email

Extension

Sur cette vue vous pouvez créer vos extensions GoPaaS

Onglet principal

Saisir le nom de votre extension, une description et cocher la case pour l’activer

screenshot

Onglet Champ
Script JS Code javascript
HTML Code HTML
CSS Feuille de style
PHP Cet onglet n’est pas actif

il faudra vous déconnecter et vous reconnecter de GoPaaS pour que l’extension soit chargée

Permissions

Le menu des Permissions permet de définir les droits sur les tables en fonction d'un groupe d'utilisateurs.

​​​​​​Il est accessible depuis la barre de navigation > >

screenshot

Champ Valeur
Table Choix de la table pour les permissions
Type En fonction du type de permission (User ou Group)
Champ à utiliser Champ permettant de réaliser la permission.
Partage En fonction de la portabilité du partage.
Creation Donner les droits pour la création de fiche.
Lecture Donner les droits en lecture sur toutes les fiches.
Lecture sélective Donner les droits en lecture sur les fiches du groupe dont l'utilisateur fait partie.
Modification Donner les droits pour la modification de fiche.
Modification sélective Donner les droits en modification sur les fiches du groupe dont l'utilisateur fait partie.
Suppression Donner les droits pour la suppression sur toutes les fiches.
Suppression sélective Donner les droits en suppression sur les fiches du groupe dont l'utilisateur fait partie.
Import Donner les droits pour importer des fiches depuis un fichier csv.
Export Donner les droits pour exporter la vue au format csv.
Modification en masse Donner les droits pour la mise à jour en masse des données (la vue doit être en multi-sélection).

Transfer out

La fiche transfer out permet de sauvegarder différents éléments d’une application au format Json pour ensuite l’importer dans une autre application

Liste des transferts possible : Tables et vues, Dashboards, Rules (automatismes), Modèles import, Workflows, Extensions, Api Rest et Assistant

Pour Table et vues il y a plusieurs options possibles :

Champ Valeur
Sélectionner une table Choix de la table à exporter
Designer Exporte toute la partie FormDesigner
Scripts Exporte les champs script JS, class JS et script PHP
Permissions Exporte les permissions
Toutes les vues Exporte toutes les vues
Sélectionnez une ou plusieurs vues Permet de choisir les vues à exporter

2FA Authenticator

Le 2FA Authenticator est une méthode d'authentification à deux facteurs. On utilise une application mobile qui génère des codes de vérification temporaires et qui seront utiliséq en complément du mot de passe pour renforcer la sécurité des accès aux applications GoPaaS.

Avantages

  • Protège contre les accès non autorisés même en cas de violation du mot de passe.
  • Ajoute une couche supplémentaire de protection.

Pré-requis

  • Installer une application d'authentification sur votre mobile ou PC.

Applications mobile

Configuration avec Google Authenticator

Plateforme Télécharger
iOS Google Authenticator on App Store
Android Google Authenticator on Google Play Store
  1. Après avoir installée l'application "Google Authenticator", connectez-vous à votre compte Google.
  2. Sur votre profil GoPaaS accédez à la section "2FA Authenticator".

  1. Activez cette fonctionnalité et cliquez sur "Générer code secret" pour obtenir un QR Code.
  2. Ouvrez Google Authenticator, appuyez sur le "+" en bas à droite, puis sélectionnez "Scanner un code QR".
  3. Scannez le code QR affiché sur GoPaaS pour ajouter un 2FA à votre profil et obtenir un code unique qui se régénère toutes les 30 secondes.
  1. Enregistrez votre fiche utilisateur.

Configuration avec Microsoft Authenticator

Plateforme Télécharger
iOS Microsoft Authenticator on App Store
Android Microsoft Authenticator on Google Play Store
  1. Après avoir installé l'application "Microsoft Authenticator", connectez-vous à votre compte Microsoft.
  2. Rendez-vous sur votre profil GoPaaS et accédez à la section "2FA Authenticator".

  1. Activez cette fonctionnalité et cliquez sur "Générer code secret" pour obtenir un QR Code.
  2. Ouvrez Microsoft Authenticator, appuyez sur le "+" en haut à droite, puis choisissez "Autre (Google, Facebook, etc.)".
  3. Scannez le code QR affiché sur GoPaaS pour ajouter un 2FA à votre profil et obtenir un code unique qui se régénère toutes les 30 secondes.
  1. Enregistrez votre fiche utilisateur.

Utilisateur

Le menu Utilisateur permet d'afficher la liste des utilisateurs de l'application. L'administrateur peut créer ou modifier les profils des utilisateurs.

Modifiez la fiche d'un utilisateur en double cliquant dessus ou ajouter un nouvel utilisateur cliquez sur Ajouter

screenshot

Onglet principal

Section par défaut

Il est conseillé de renseigner un certain nombre de champ pour enregistrer la fiche :

Champ Valeur
Nom Nom de l'utilisateur.
Prénom Prénom de l'utilisateur.
Téléphone Numéro de téléphone.
Email Email de l'utilisateur.
Login Login de l'utilisateur, il sera utilisé à chaque connexion à l'application. Une fois créé, le Login ne peut pas être modifié.
Profil Choisir le profil de l'utilisateur (Admin, User, Guest).
Groupe Définir le groupe de l'utilisateur en cliquant sur la loupe.
Réduire menu navigation Cocher l'option permet de minimiser la barre de navigation à l'ouverture de l'application.
Image profil Image ou photo de profil.
Actif Cocher pour rendre actif l’utilisateur.
Initiales Renseigner les initiales.
Signature En renseignant la signature de l'utilisateur, elle sera reprise lors des envois d'email depuis GoPaaS.
Langue Choix de la langue sur GoPaaS.
Masquer Ne pas rendre visible dans la vue : “Connexion sans user masqué”.
Thème Choix du thème GoPaaS.

Section Google authenticator

Champ Valeur
Activer Activer Google Authenticator pour améliorer la sécurité au sein de l'application avec la validation en 2 étapes. Cocher l'option Activer puis cliquer sur
Code Secret Et ensuite le renseigner ou de scanner le Qr code via l'application mobile (Google authenticator) installée sur votre smartphone.
alt_text

Section API KEY

Champ Valeur
Bearer token Générer votre token
IP Authorized Address Lister les IP autorisées à utiliser le token (fortement recommandé)

Section OAuth2.0

Champs Valeur
Grant Type Client Credentials
Client ID Le Client ID est un identifiant public unique attribué à une application cliente lors de son enregistrement auprès du serveur d'autorisation de GoPaaS dans le cadre du protocole OAuth 2.0
Client Secret Le Client Secret est une chaîne de caractères secrète utilisée dans le protocole OAuth 2.0, servant à authentifier l'identité d'une application cliente auprès du serveur d'autorisation, en complément de l'identifiant de client (Client ID).
Expires in La durée d'expiration du token (Expire In), qui indique à l'application combien de temps le token sera valide.

Section SSO (Single Sign-On)

Champ Valeur
Username Votre email google pour la connexion via SSO

Onglet Email sortant

Vue des emails que vous avez envoyé depuis GoPaaS

Onglet Session

Vue de l’historiques de vos sessions GoPaaS

Onglet Webmail

Vous pouvez ici ajouter un compte mail qui sera disponible dans la barre de navigation > Admin > Webmail


Champ Valeur
Utilisateur Utilisateur qui accède à ce webmail
Hote Adresse du serveur d’email
Identifiant Identifiant email
Mot de passe Mot de passe email
Port Port de connexion au serveur d’email
Folder Dossier où télécharger les emails, par défaut : INBOX
Flags IMAP Flags IMAP, laisser la valeur par défaut

API

Définition

L'API ouverte de GoPaaS permet à des applications tierces d'interagir facilement avec la plateforme. Elle fournit un ensemble de règles et de protocoles qui autorisent l'accès aux données, facilitant ainsi l'intégration et l'extension des capacités du logiciel dans d'autres systèmes ou applications.

Avantages

  • Interconnectivité: Permet une intégration transparente avec d'autres outils et systèmes, favorisant un écosystème numérique cohérent et connecté.

  • Personnalisation: Offre aux développeurs la possibilité de personnaliser et d'étendre les fonctionnalités de la plateforme pour répondre aux besoins spécifiques de leur entreprise ou de leur projet.

  • Automatisation: Facilite l'automatisation des processus, réduisant le temps et les efforts nécessaires pour accomplir des tâches répétitives ou complexes.

  • Innovation: Encourage l'innovation en permettant aux développeurs de créer de nouvelles applications ou services qui tirent parti des fonctionnalités du logiciel.

Bénéfices

  • Amélioration de l'efficacité opérationnelle: L'intégration et l'automatisation des processus entraînent une réduction significative du temps et des coûts opérationnels.

  • Augmentation de la satisfaction client: La capacité à personnaliser et à intégrer GoPaaS avec d'autres outils peut améliorer l'expérience utilisateur.

  • Flexibilité et évolutivité: L'API ouverte permet aux entreprises de s'adapter rapidement aux changements du marché et d'évoluer en fonction des besoins croissants de leur clientèle.

Pré-requis

Pour utiliser l'API GoPaaS, il licence ADMIN ou Utilisateur est nécessaire pour la gestion des connexions.

oAuth0

list

Request

Method URL
GET api/list/{{id}}/
Type Params Values Description
HEAD bearer_token String
HEAD (option) advancedSearch String Effectuer une recherche avancée sur une ou plusieurs colonnes. ex: nom\|contain\|NIDS\|AND\|cp\|contain\|77420\|
HEAD (option) textSearch String Rechercher une chaîne de caractère présente sur une des colonnes
HEAD (option) onlyVisible String Masquer les colonnes non visibles. valeur: on
HEAD (option) columns String Ajouter un objet column dans la réponse avec la liste des colonnes et de leurs paramètres
HEAD (option) page Number Numéro de page à afficher
HEAD (option) rowPerPage Number Nombre de fiches à afficher par page

Response

Status Response
200 JSON
400 {"msg":"Invalid version."}
401 {"msg":"Invalid API key."}
500 {"msg":"Something went wrong. Please try again later."}

Exemple

Avec curl.

  • {{URL}} URL de l’application

  • {{id}} identifiant unique de la vue

  • {{bearer_token}} est une chaîne

  • {{onlyVisible}} est une chaîne

  • {{columns}} est une chaîne

  • {{page}} est un nombre entier

  • {{rowPerPage}} est un nombre entier

curl -X GET \
{{URL}}/api/list/{{id}}/
-H 'Authorization: Bearer {{bearer_token}}' \
-H 'content-type: application/json' \
-H 'advancedSearch: nom|contain|NIDS|' \
-H 'onlyVisible: on' \
-H 'colums: on' \
-H 'page: 3' \
-H 'rowPerPage: 10'

item

Request

Method URL
GET api/item/tableName/{{id}}/
Type Params Values
HEAD bearer_token String

Response

Status Response
200 JSON
400 {"msg":"Invalid version."}
401 {"msg":"Invalid API key."}
500 {"msg":"Something went wrong. Please try again later."}

Exemple

Avec curl.

  • {{URL}} URL de l’application

  • {{id}} identifiant unique de la fiche

  • {{bearer_token}} est une chaîne

  • {{tableName}} est une chaîne avec le nom de la table

curl -X GET \
{{URL}}/api/list/{{id}}/
curl -X POST \
{{URL}}/api/item/{{tableName}}/{{id}}/
-H "Authorization: Bearer {{bearer_token}}" \
-H 'content-type: application/json'

items

Crée ou met à jour plusieurs fiches en une seule requête.
Cette méthode permet également d’uploader des fichiers encodés en Base64 et de les associer directement à des champs de la fiche.

Request

Method URL
POST api/items/{{tableName}}/

Headers / Body

Type Paramètre Valeur Description
HEAD bearer_token String Jeton d’authentification Bearer
POST data JSON Tableau JSON contenant les fiches à créer ou mettre à jour

Paramètre spécial : files

Le paramètre files permet d’uploader un ou plusieurs fichiers encodés en Base64 et de les affecter directement à un champ de la fiche.

Champ Type Description
fieldName String Nom du champ de destination dans la table
fileName String Nom du fichier avec son extension
base64 String Contenu du fichier encodé en Base64

Lors du traitement :

  • le fichier est décodé et stocké sur le serveur
  • le chemin du fichier est automatiquement enregistré dans le champ fieldName
  • la propriété files est supprimée avant l’enregistrement final de la fiche

Response

Status Response
200 JSON
400 {"msg":"Invalid version."}
401 {"msg":"Invalid API key."}
500 {"msg":"Something went wrong. Please try again later."}

Exemple

Avec curl.

  • {{URL}} : URL de l’application
  • {{tableName}} : nom de la table
  • {{key}} : identifiant de la fiche
  • {{bearer_token}} : jeton d’authentification
curl -X POST \

  {{URL}}/api/items/{{tableName}}/
-H "Authorization: Bearer {{bearer_token}}" \
-H 'content-type: application/json' \
-d '[{
"cle": "{{key}}",
"num_commande": "551035",
"date_billed": "2016-07-05",
"actual_billable_amount": "437.50",
"num_invoice": "16000162",
“date_closed”:”2016-09-05”
},{
"cle": "{{key}}",
"num_commande": "672620",
"date_billed": "2017-06-14",
"actual_billable_amount": "595",
"num_invoice": "17000100",
“date_closed”:”2017-07-31”
}]'

Et avec fichiers :

curl -X POST \
  {{URL}}/api/items/{{tableName}}/ \
  -H "Authorization: Bearer {{bearer_token}}" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "cle": "{{key}}",
      "num_commande": "551035",
      "num_invoice": "16000162",
      "files": [
        {
          "fieldName": "fichier",
          "fileName": "facture_16000162.pdf",
          "base64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago..."
        }
      ]
    }
  ]'

file

Method URL
POST api/file/tableName/
Type Params Values
HEAD bearer_token String
POST file file

Exemple

Avec curl.

  • {{URL}} URL de l’application

  • {{file}} Fichier à envoyer

  • {{bearer_token}} est une chaîne

  • {{tableName}} est une chaîne avec le nom de la table

curl -X POST \

  {{URL}}/api/file/{{tableName}}/
-H "Authorization: Bearer {{bearer_token}}" \
--form 'file=@"{file}"'

filebase64

Cette version permet d'uploader un fichier et de l'assigner directement à un champ spécifique de la fiche en une seule opération.

Request

Method URL
POST api/filebase64/{{tableName}}/
Type Params Values
HEAD bearer_token String
POST data JSON

Response

Status Response
200 JSON
400 {"msg":"Invalid version."}
401 {"msg":"Invalid API key."}
500 {"msg":"Something went wrong. Please try again later."}

Exemple

Avec curl.

  • {{URL}} URL de l’application
  • {{tableName}} Nom de la table
  • {{bearer_token}} Jeton d'authentification
  • {{cle}} Identifiant de la fiche
  • {{intitule}} Libellé de la fiche
  • {{fieldName}} Nom du champ de destination
  • {{fileName}} Nom du fichier avec extension
  • {{base64}} Contenu du fichier encodé en base64
curl -X POST \
  {{URL}}/api/filebase64/{{tableName}}/ \
  -H "Authorization: Bearer {{bearer_token}}" \
  -H "Content-Type: application/json" \
  -d '[
    {
        "cle": "test_NIDS",
        "intitule" : "FC2025-145358",
        "files": [
            {
                "fieldName": "fichier",
                "fileName": "2025-03-31_FC2025-145358.pdf",
                "base64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago..."
            }
        ]
    }
]'

authenticate

Permet d’obtenir un token d’authentification pour accéder à l’API.

Le token doit ensuite être utilisé dans les autres appels via le header :

Authorization: Bearer {{token}}

Request

Method URL
GET api/authenticate/
POST api/authenticate/

Headers

Type Paramètre Valeur Description
HEAD Authorization Basic Base64 Authentification Basic encodée en Base64

Le header doit contenir :

Basic base64(login:password)

Exemple encodage

login:password

Encodé en Base64 :

bG9naW46cGFzc3dvcmQ=

Exemple avec curl

curl -X POST \
{{URL}}/api/authenticate/ \
-H "Authorization: Basic bG9naW46cGFzc3dvcmQ="
Response
Status  Response
200 JSON
401 {"msg":"Invalid credentials"}
500 {"msg":"Something went wrong. Please try again later."}
Exemple de réponse
{
  "token": "ezjidsojd...."
}

Utilisation du token

Une fois récupéré, le token doit être utilisé dans les appels API :

-H "Authorization: Bearer ezjidsojd...."

Doc pour Swagger / OpenAPI: gopaas.yaml.

oAuth2

OAuth 2.0 est un protocole standard de délégation d'autorisation pour la sécurisation des accès aux API. Il permet aux applications externe d'obtenir un accès limité à GoPaaS sans avoir accès aux mots de passe.

Configuration

Dans la fiche utilisateur API définir dans la section OAuth2 les informations suivante :

Champs Valeur
Grant Type Client Credentials
Client ID Le Client ID est un identifiant public unique attribué à une application cliente lors de son enregistrement auprès du serveur d'autorisation de GoPaaS dans le cadre du protocole OAuth 2.0
Client Secret Le Client Secret est une chaîne de caractères secrète utilisée dans le protocole OAuth 2.0, servant à authentifier l'identité d'une application cliente auprès du serveur d'autorisation, en complément de l'identifiant de client (Client ID).
Expires in La durée d'expiration du token (Expire In), qui indique à l'application combien de temps le token sera valide.

Authorization

Request Access Token

Type Valeur
Method POST
Access Token URL api/oauth2/access_token/
Type AUTH Basic Auth
Type Param Valeur / Description
DATA grant_type client_credentials – Type d’autorisation utilisé pour obtenir un token d’accès sans intervention utilisateur.
DATA client_id Identifiant public de votre application client fourni par le serveur d’autorisation GoPaaS.
DATA client_secret Secret privé de votre application client, également fourni lors de l’enregistrement sur GoPaaS.

Response

Status Response
200 JSON
400 {"msg":"Invalid version."}
401 {"msg":"Invalid Information."}
500 {"msg":"Something went wrong. Please try again later."}

Exemple

{
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3MTEzODUzNjUsImlzcyI6IjU0Ljg2LjUwLjEzOSIsInN1YiI6Im1nb29yaWFoIiwiZXhwIjoxNzExMzg1NDI1LCJzY29wZSI6IkFETUlOIiwianRpIjoiIn0.LRKkcIupGvp81NXKy1rdvD8XusVCYNyyhMCamNdM9p4",
    "token_type": "Bearer",
    "expires_in": "60",
    "scope": "ADMIN"
}

Endpoints

list

Request
Method URL
GET api/oauth2/list/{{id}}/
Type Params Values
HEAD bearer_token String
HEAD (option) advancedSearch String
Response
Status Response
200 JSON
400 {"msg":"Invalid version."}
401 {"msg":"Invalid API key."}
500 {"msg":"Something went wrong. Please try again later."}

Exemple

Avec curl.

  • {{URL}} URL de l’application

  • {{id}} identifiant unique de la vue

  • {{bearer_token}} est une chaîne

  • {{advancedSearch}} est une chaîne

curl -X GET \
{{URL}}/api/oauth2/list/{{id}}/
-H 'Authorization: Bearer {{bearer_token}}' \
-H 'content-type: application/json' \
-H 'advancedSearch: nom|contain|NIDS|'

item

Request
Method URL
GET api/oauth2/item/tableName/{{id}}/
Type Params Values
HEAD bearer_token String
Response
Status Response
200 JSON
400 {"msg":"Invalid version."}
401 {"msg":"Invalid API key."}
500 {"msg":"Something went wrong. Please try again later."}
Exemple

Avec curl.

  • {{URL}} URL de l’application

  • {{id}} identifiant unique de la fiche

  • {{bearer_token}} est une chaîne

  • {{tableName}} est une chaîne avec le nom de la table

curl -X GET \
{{URL}}/api/oauth2/list/{{id}}/
curl -X POST \
{{URL}}/api/oauth2/item/{{tableName}}/{{id}}/
-H "Authorization: Bearer {{bearer_token}}" \
-H 'content-type: application/json'

items

Request
Method URL
POST api/oauth2/items/tableName/
Type Params Values
HEAD bearer_token String
POST data JSON
Response
Status Response
200 JSON
400 {"msg":"Invalid version."}
401 {"msg":"Invalid API key."}
500 {"msg":"Something went wrong. Please try again later."}

Exemple

  • {{URL}} URL de l’application

  • {{key}} identifiant unique de la fiche

  • {{bearer_token}} est une chaîne

  • {{tableName}} est une chaîne avec le nom de la table

curl -X POST \

  {{URL}}/api/items/{{tableName}}/
-H "Authorization: Bearer {{bearer_token}}" \
-H 'content-type: application/json' \
-d '[{
"cle": "{{key}}",
"num_commande": "551035",
"date_billed": "2016-07-05",
"actual_billable_amount": "437.50",
"num_invoice": "16000162",
“date_closed”:”2016-09-05”
},{
"cle": "{{key}}",
"num_commande": "672620",
"date_billed": "2017-06-14",
"actual_billable_amount": "595",
"num_invoice": "17000100",
“date_closed”:”2017-07-31”
}]'

Restricition IP

La restriction IP limite les requêtes à une API aux adresses IP spécifiées ou à des plages d'adresses IP. Cela signifie que seules les requêtes provenant d'adresses IP autorisées peuvent accéder à l'API, tandis que toutes les autres tentatives sont rejetées. Cette approche ajoute une couche de sécurité supplémentaire en s'assurant que même si des clés API sont compromises, l'accès est toujours restreint aux emplacements réseau approuvés.

Utilisation

Les restrictions IP sont couramment utilisées dans les scénarios suivants :

  • Environnements d'entreprise : Pour limiter l'accès aux API aux bureaux de l'entreprise ou à des réseaux spécifiques.

  • Applications B2B : Pour restreindre l'accès entre entreprises partenaires à des plages d'adresses IP connues.

  • Sécurisation des environnements de production : Pour s'assurer que seuls les serveurs de production ou les systèmes backend peuvent communiquer avec l'API.

Avantages

  • Réduction du Risque de Fuites de Données : En limitant l'accès aux adresses IP fiables, le risque de fuites de données dues à des accès non autorisés est réduit.

  • Contrôle d'Accès Amélioré : Fournit un moyen simple mais efficace de contrôler qui peut accéder à l'API.

  • Complément aux Autres Méthodes de Sécurité : Utilisé en combinaison avec l'authentification, le chiffrement et d'autres politiques de sécurité, il renforce la posture de sécurité globale.

Implémentation

Dans la fiche utilisateur API définir dans la section API KEY les informations suivante :

Champs Valeur
IP Authorized Address Liste des adresse IP autorisées, les IP seront séparée par un ";"

JS

gopaas.util

printItem

Ouvrir la page d'impression de la fiche dans une nouvelle fenêtre du navigateur. Cette page au format HTML n'a pas de style css.

Paramètres :

Param Type Description
tableName string Nom de la table
itemId string ID de la fiche
Mettre null si on utilise itemKey
itemKey string Clé de la fiche
Ne pas renseigner si on utiliser itemId

generateRandomString

Paramètres :

Param Type Description
size string Longueur de 4 à 8
longueur de 4 = 1,6 millions de possibilités
longueur de 5 = 60 millions de possibilités
longueur de 6 = 2 milliards de possibilités
longueur de 7 = 78 milliards de possibilités
longueur de 8 = 2800 milliards de possibilités
type string "number" ou "alpha"

Retour :

  • String

deleteItems

Supprimer une liste de fiches à partir de leurs IDs

Paramètres :

Param Type Description
tableName string Nom de la table
itemId string Liste de ID délimité par une ","
showMessageOnSuccess boolean Afficher un message quand la suppression est terminée : (true) ou (false).
Valeur par défaut : true.
onSuccess function Fonction à appeler en cas de succès

deleteItem

Supprimer une fiche à partir de son ID ou KEY.

Paramètres :

Param Type Description
tableName string Nom de la table
itemId string ID ou KEY
showMessageOnSuccess boolean Afficher un message quand la suppression est terminée : (true) ou (false).
Valeur par défaut : true.
onSuccess function Fonction à appeler en cas de succès

autocomplete

Proposer une liste de valeur d'une table dynamiquement sans passer par une connexion en renseignant les premiers caractères.

Paramètres :

Param Type Description
autocompletedElement id id du champ pour l'autocompletion
sourceTable string Nom de la table de recherche
sourceField string Nom du champ à rechercher
optionalFilterElement string Valeur de filtre
optionalFilterField string Nom du champ pour le filtre
maxValuesDisplayed int Nombre de valeurs à afficher.
Valeur par défaut : 10
minLength int Nombre de caractères à renseigner avant de lancer la recherche.
Valeur par défaut : 0

Remarque : Cette fonction doit être appelée dans l'évènement "onLoad" de la fiche.

Exemple

// Autocomplétion sur la liste des intitulés des fonctions enregistrées dans la table "fonction"
gopaas.util.autocomplete(thisComponent.ui.find('#fonction'),'fonction','intitule');

// Autocomplétion du champ code postal en filtrant sur la ville
gopaas.util.autocomplete(thisComponent.ui.find('#codepostal'),'postcode','postcode', thisComponent.ui.find('#ville'), 'city');

logout

Quitter une session utilisateur en cours.
Cette fonction redirige l'utilisateur vers la page de "Connexion".

loadWorkflow

Charger un Workflow pour une fiche

Paramètres :

Param Type Description
thisComponent object L'objet représentant la fiche dans laquelle le code courant est exécuté.
tableName string Nom de la table du Workflow

Remarque : Cette fonction doit être appelée dans l'évènement "onLoad" de la fiche.

gopaas.ui

openTab

Ouvrir un onglet existant

Paramètres :

Param Type Description
title string Nom de la table

Retour :

  • `true', si l'onglet existe
  • 'false', si l'onglet n'existe pas

closeActiveTab

Fermer l'onglet actif.

forceCloseTab

Fermer un onglet depuis un composant ou un index

Paramètres :

Param Type Description
componentOrTabIndex object or int Composant de type fiche, vue ou dashboard ou le numéro d'un onglet

forceCloseAllTab

Fermer tous les onglets sans demander d'enregistrement.

closeAllTab

Fermer tous les onglets sauf ceux qui ont besoin d'être enregistrés.

getTabIndex

Paramètres :

Param Type Description
component object or int Composant de type fiche, vue ou dashboard

Retour :

  • `Int' Index de l'onglet

addTab

Ajouter un nouvel onglet.

Paramètres :

Param Type Description
title string Titre de l'onglet
content string Contenu de l'onglet (texte, html...)

renameTab

renameTab(component, title, subtitle, color, borderColorOnly, tooltip, icon)

Paramètres :

Param Type Description
component object or int Composant de type fiche, vue ou dashboard ou le numéro d'un onglet
title string Titre de l'onglet
subtitle string Texte entre crochet, en plus petit, après le titre principal
color string Couleur en hexa du carré
borderColorOnly boolean Afficher une couleur que sur les bords. Valeur par défaut : False.
tooltip string Texte au survol l'onglet avec le curseur de la souris
icon string Icône du type Fontawesome

gopaas.date

dateFr

Retourne la date du jour au format dd/mm/yyyy.

dateSql

Retourne la date du jour au format yyyy-mm-dd.

addDateMySQL

Ajoute un nombre de jours à la date du jour.

Paramètres :

Param Type Description
days int Nombre de jours

Retour :

  • Date au format yyyy-mm-dd.

time

Retourne l'heure actuelle au format hh:mm:ss.

dateTime

Retourne la date et l'heure actuelles au format yyyymmddhhmmss.

toFr

Convertit une date au format yyyy-mm-dd en dd/mm/yyyy.

Paramètres :

Param Type Description
sqlDate string Date au format yyyy-mm-dd

Retour :

  • Date au format dd/mm/yyyy.

toSql

Convertit une date au format dd/mm/yyyy en yyyy-mm-dd.

Paramètres :

Param Type Description
frenchDate string Date au format dd/mm/yyyy

Retour :

  • Date au format yyyy-mm-dd.

gopaas.dialog

fatal

Affiche une popup modale d'erreur fatale.

Paramètres :

Param Type Description
message string Message fatal à afficher
onClose callback Fonction à appeler à la fermeture de la popup modale. Valeur par défaut : null

error

Affiche une popup modale d'erreur utilisateur.

Paramètres :

Param Type Description
message string Message d'erreur à afficher
onClose callback Fonction à appeler à la fermeture de la popup modale. Valeur par défaut : null

warning

Affiche une popup modale d'avertissement.

Paramètres :

Param Type Description
message string Message d'avertissement à afficher
onClose callback Fonction à appeler à la fermeture de la popup modale. Valeur par défaut : null

success

Affiche une popup modale de succès.

Paramètres :

Param Type Description
message string Message de succès à afficher
onClose callback Fonction à appeler à la fermeture de la popup modale. Valeur par défaut : null

info

Affiche une popup modale d'information.

Paramètres :

Param Type Description
message string Message d'information à afficher
onClose callback Fonction à appeler à la fermeture de la popup modale. Valeur par défaut : null

okcancel

Affiche une modale de confirmation avec les boutons Ok/Annuler.

Paramètres :

Param Type Description
message string Message de confirmation à afficher
onClose callback Fonction à appeler à la fermeture de la popup modale. Valeur par défaut : null

yesno / confirm

Affiche une modale de confirmation avec les boutons Oui/Non.

Paramètres :

Param Type Description
message string Message de confirmation à afficher
onClose callback Fonction à appeler à la fermeture de la popup modale. Valeur par défaut : null

prompt

Affiche une modale de saisie.

Paramètres :

Param Type Description
message string Message à afficher
defaultValue string Valeur par défaut dans le champ de saisie
onClose callback Fonction à appeler à la fermeture de la popup modale. Valeur par défaut : null

gopaas.webservice

getItem

Récupère les données d'une fiche.

Paramètres :

Param Type Description
tableName string Nom de la table
itemKey string Clé de la fiche

*Retour :

  • Object JSON

getItems

Récupère les données d'une vue.

Paramètres :

Param Type Description
viewKey string Clé de la vue
advancedSearch string Filtre avancé
Ex: NOM_CHAMPS|equal|VALEUR|AND

Retour :

  • Object JSON

updateItem

Met à jour les données d'une fiche.

Paramètres :

Param Type Description
tableName string Nom de la table
cle string cle de la fiche (obligatoire)
id string ID de la fiche
data objet Objet avec les données de la fiche Ex : {nom: 'GOORIAH', prenom:'Marvin'}

Retour :

  • Ok

updateItems

Met à jour les données de plusieurs fiches avec la clé.

Paramètres :

Param Type Description
tableName string Nom de la table
data array Array avec des objets de données par fiche. Le champ "clé" est obligatoire dans les objets.
Ex: [{cle:'1234', nom: 'GOORIAH', prenom:'Marvin'}, {cle:'5678', nom: 'RUNGEN', prenom:'Jonathan'}]

Retour :

  • Ok

duplicateItem

Duplique une fiche avec les éléments enfants du premier sous-niveau.

Paramètres :

Param Type Description
tableName string Nom de la table
itemKey string Clé de la fiche
level int Définir si il faut prendre les fiches enfants de niveau 1 ou non. Valeurs possibles : 0 ou 1
defaultValues array Tableau avec une liste de valeur par table.
Ex: [{tableName:"compte", data:{type : "Prospect", origine : "Site Web"}}, {tableName:"contact", data:{type : "Prospect", origine : "Site Web"}}]
except array Tableau avec une liste de table à exclure.
Ex: ["action","affaire"]

Retour :

  • Ok

Exemple :

var defaultValues = [
    {
      tableName:"compte",
      data:{type : "Prospect", origine : "Site Web"}
    }];
var except = ["action","affaire"];

$.when(gopaas.webservice.duplicateItem("compte", thisComponent.getValue('cle'), 0, defaultValues, except)).done(function (data) {
  // ouvrir la copie
  ItemGeneric.open("compte", data.result.cle);

  gopaas.dialog.notifySuccess("Copie effectuée, ID de votre nouvelle fiche = " + data.result.id);

  // fermer l'original
  thisComponent.removeComponent();
});

ViewDatagrid

getAllSelected

La fonction getAllSelected renvoie un tableau contenant les IDs de toutes les lignes sélectionnées ou cochées dans une vue.

Retour :

  • Array Un tableau contenant les IDs des lignes sélectionnées ou cochées.

Exemple :

// Récupérer les IDs des lignes sélectionnées ou cochées dans la datagrid
var selectedIDs = thisComponent.getAllSelected();

if (selectedIDs.length) {
    console.log("IDs sélectionnés :", selectedIDs);
} else {
    console.log("Aucun élément sélectionné.");
}

getAllSelectedRow

La fonction getAllSelectedRow renvoie toutes les lignes sélectionnées dans une datagrid, dans le cas d'une multi-sélection ou d'une sélection unique.

Retour :

  • Array Un tableau contenant les objets représentant les lignes sélectionnées.

Exemple :

// Récupérer toutes les lignes sélectionnées dans la datagrid
var selectedRows = thisComponent.getAllSelectedRow();
if (selectedRows.length) {
    console.log("Lignes sélectionnées :", selectedRows);
} else {
    console.log("Aucune ligne sélectionnée.");
}

getSelectedItem

La fonction getSelectedItem renvoie la ligne actuellement sélectionnée dans une vue de type tableau.

Retour :

  • Object Un objet avec les données de la ligne sélectionnée dans la vue.

Exemple :

// Récupérer la ligne sélectionnée dans la datagrid
var selectedItem = thisComponent.getSelectedItem();
if (selectedItem) {
    console.log("L'élément sélectionné est :", selectedItem);
} else {
    console.log("Aucun élément sélectionné.");
}

getAllSelectedKey

La fonction getAllSelectedKey renvoie les clés de tous les éléments sélectionnés dans une datagrid, dans le cas d'une multi-sélection. Si la datagrid utilise des cases à cocher, elle récupère les lignes cochées, sinon elle récupère les lignes sélectionnées.

Retour :

  • Array Un tableau avec les clés des éléments sélectionnés.

Exemple :

// Pour un datagrid avec multi-sélection, cela retournera un tableau de clés sélectionnées
var selectedKeys = thisComponent.getAllSelectedKey(); // thisComponent est un composant View
console.log(selectedKeys); // Affichera un tableau de clés.

getDatagridElement

La fonction getDatagridElement renvoie l'élément DOM correspondant à une datagrid dans l'interface utilisateur.

Retour :

  • Object L'élément table de la vue.

Exemple :

// Récupérer l'élément DOM de la datagrid
var datagridElement = thisComponent.getDatagridElement();

if (datagridElement.length) {
    console.log("Élément datagrid trouvé :", datagridElement);
} else {
    console.log("Aucun élément datagrid trouvé.");
}

Intégration

API REST permettant d’accéder aux données et fichiers d’une application GoPaaS.

Base URL {{URL}}

Exemple :

https://app.example.com

Authentification

L’API utilise un token Bearer.

Étape 1 : obtenir un token

Endpoint :

POST /api/authenticate/

Header :

Authorization: Basic base64(login:password)

Exemple

login:password

Encodé en Base64 :

bG9naW46cGFzc3dvcmQ=

Requête

curl -X POST \
{{URL}}/api/authenticate/ \
-H "Authorization: Basic bG9naW46cGFzc3dvcmQ="

Réponse

{
  "token": "ezjidsojd...."
}

Étape 2 : utiliser le token

Tous les appels API suivants doivent inclure :

Authorization: Bearer {{token}}

Endpoints principaux

Lire une liste de fiches

GET /api/list/{{id}}/

Headers

Header Type Description
Authorization string Token d’authentification au format Bearer {token} permettant d’accéder à l’API.
advancedSearch string / JSON Paramètre permettant d’effectuer une recherche avancée avec des filtres structurés (conditions multiples, opérateurs, etc.).
textSearch string Recherche simple en texte libre sur les champs indexés.
onlyVisible boolean Si true, retourne uniquement les colonnes visibles configurées dans la vue.
columns boolean Si true, ajoute les métadonnées des colonnes dans la réponse (nom, type, propriétés, etc.).
page integer Numéro de page pour la pagination des résultats.
rowPerPage integer Nombre d’enregistrements retournés par page.

Exemple

curl -X GET \
{{URL}}/api/list/{{id}}/ \
-H "Authorization: Bearer {{token}}" \
-H "advancedSearch: nom|contain|NIDS|" \
-H "page: 1" \
-H "rowPerPage: 10"

Lire une fiche

GET /api/item/{{tableName}}/{{id}}/

Exemple

curl -X GET \
{{URL}}/api/item/{{tableName}}/{{id}}/ \
-H "Authorization: Bearer {{token}}"

Créer ou mettre à jour des fiches

POST /api/items/{{tableName}}/

Permet :

  • insertion
  • mise à jour
  • import de données
  • synchronisation depuis un workflow

Exemple

curl -X POST \
{{URL}}/api/items/{{tableName}}/ \
-H "Authorization: Bearer {{token}}" \
-H "Content-Type: application/json" \
-d '[
{
"cle": "CMD001",
"num_commande": "551035",
"date_billed": "2016-07-05",
"num_invoice": "16000162"
}
]'

Envoi de fichiers

Upload classique

POST /api/file/{{tableName}}/

Exemple

curl -X POST \
{{URL}}/api/file/{{tableName}}/ \
-H "Authorization: Bearer {{token}}" \
--form 'file=@"facture.pdf"'

Upload Base64

POST /api/filebase64/{{tableName}}/

Permet d’assigner un fichier directement à une fiche.

Exemple

curl -X POST \
{{URL}}/api/filebase64/{{tableName}}/ \
-H "Authorization: Bearer {{token}}" \
-H "Content-Type: application/json" \
-d '[
{
"cle": "test_NIDS",
"intitule": "FC2025-145358",
"files": [
{
"fieldName": "fichier",
"fileName": "facture.pdf",
"base64": "JVBERi0xLjQKJeLjz9MK..."
}
]
}
]'

Upload Base64 via endpoint items

L’endpoint items permet aussi d’envoyer des fichiers.

Exemple

[
{
"cle": "CMD001",
"num_commande": "551035",
"files": [
{
"fieldName": "fichier",
"fileName": "facture.pdf",
"base64": "JVBERi0xLjQKJeLjz9MK..."
}
]
}
]

Lors du traitement :

  • le fichier est décodé
  • il est enregistré sur le serveur
  • le chemin est automatiquement affecté au champ fieldName

Intégration avec n8n

Node HTTP Request

Authentification

POST {{URL}}/api/authenticate/

Header : Authorization: Basic base64(login:password)

Récupérer le token {{$json["token"]}}

Appels suivants

Header : Authorization: Bearer {{$json["token"]}}

Intégration avec Make

Module

HTTP > Make a request

Authentification

POST /api/authenticate/

Header : Authorization: Basic base64(login:password)

Utilisation du token Authorization: Bearer {{token}}

Intégration avec Zapier

Module

Webhooks by Zapier

Étape 1

POST /api/authenticate/

Header : Authorization: Basic base64(login:password)

Étape 2

Utiliser : Authorization: Bearer {{token}}

Mapping des données

Les champs JSON envoyés doivent correspondre aux noms techniques des champs GoPaaS.

Exemple
[
{
"cle": "CLI001",
"nom": "Martin",
"prenom": "Paul",
"email": "paul.martin@example.com"
}
]

Bonnes partiques

  • Respecter les noms de champs définis par l’API.
  • Utiliser le format YYYY-MM-DD pour les dates.
  • Envoyer les données en JSON encodé en UTF-8.
  • Vérifier que le champ fichier existe avant l’envoi.

Codes d’erreur

Code Description
200 Succès
400 Version API invalide
401 Token ou credentials invalides
500 Erreur serveur

Erreurs fréquentes

401 – Invalid API key

Cause :

  • Token manquant
  • Token expiré

Solution : Authorization: Bearer {{token}}

401 – Invalid credentials

Cause :

  • Login / mot de passe incorrect

Solution :

  • Vérifier l’encodage Base64 de la chaîne : login:password

500 – Something went wrong

Causes possibles :

  • JSON invalide
  • Table inexistante
  • Champ incorrect
  • Fichier Base64 invalide