Série v4.7 – Nouveau contrôle BarCode

Ce billet fait partie d’une série de billets sur les nouveautés de la version 4.7, mise à disposition le 22 septembre 2016.

Quelques nouveaux contrôles ont été ajoutés à la liste des contrôles smartforms existants à l’occasion de la sortie de la 4.7. Il s’agit de contrôles dédiés à une utilisation mobile au travers de l’application K2 mobile permettant pour le 1er de scanner des codes barres et pour le 2nd de faire des annotations sur une image. Ces contrôles ont été rendus disponibles dans un 1er temps sur notre application pour iOS et seront disponibles sous peu sur les autres applications mobiles.

Donc voyons, au travers de ce billet, comment utiliser le contrôle BarCode qui est, à ce jour disponible sur iOS et sur Android.

Comme son nom l’indique, ce contrôle permet de lire dans un formulaire K2 un code barre grâce à la fonctionnalité appareil photo de votre terminal et de stocker le code OCRisé dans un champ du formulaire.

Le formulaire utilisé pour l’exemple

Pour le test, nous utiliserons un formulaire très simple dédié uniquement à l’utilisation de ce contrôle. Celui-ci va être composé :

  1. Du contrôle BarCode. Contrôle qui n’a pas de représentation visuelle à l’exécution (comme les contrôles ImageAnnotation, Timer, SaveAsPDF ou LocationServices).
  2. D’un bouton qui permettra de lancer l’action de scanner (et donc l’appareil photo du terminal).
  3. D’un champ de saisie qui affichera le code reconnu par le scanner.
  4. D’un libellé de statut.
  5. Dans notre exemple, le formulaire doit être un Application Form. En effet, on souhaite pouvoir y accéder depuis notre application mobile, mais il n’est pas pour autant disponible au sein d’une tâche à faire. Donc afin de pouvoir le tester, nous devons le rendre accessible dans la liste des formulaires d’application sur notre application mobile (au même titre qu’un formulaire d’initialisation d’un processus par exemple). Pour ce faire, il doit donc être enregistré dans le dossier System\Application Forms, puis dans les propriétés avancées du formulaire, la case Application Form doit être cochée.
Les ingrédients nécessaires à notre test
Les ingrédients nécessaires à notre test

Les règles du formulaire

Une fois que tous les éléments sont placés, il n’y a plus qu’à jouer avec les règles :

  1. Tout d’abord, nous allons vérifier que le contrôle est utilisable sur le terminal qui affiche le formulaire. Quand le contrôle BarCode est initialisé, si la propriété IsSupported du contrôle est positionnée à False, alors nous désactivons le bouton scan et nous affichons un message à l’utilisateur. Pour la condition, nous utilisons une condition avancée.

    Règles de vérification de compatibilité
    Règles de vérification de compatibilité
  2. Ensuite, nous allons activer le contrôle BarCode lors du clic sur le bouton Scan, ce qui va avoir effet de lancer l’appareil photo à l’exécution. Pour cela, il faut utiliser l’action Execute a control's method afin de lancer la méthode Scan du contrôle BarCode à la capture de l’événement Clicked de notre bouton. Il n’y a rien de plus à configurer.

    Règle d'exécution du scan
    Règle d’exécution du scan
  3. Enfin, il nous reste simplement à afficher dans notre champ de saisie la valeur capturée par notre contrôle BarCode lors de l’événement Changed, nous utiliserons alors un transfer data pour envoyer la valeur capturée vers le champ.

    Récupération de la valeur capturée
    Récupération de la valeur capturée

Le résultat

Il ne nous reste plus qu’à tester ce que cela donne. Voici donc des captures d’écran faîtes depuis un téléphone Android.

Résultat
Résultat

Et voilà pour le contrôle BarCode, il pourra être utilisé ainsi au sein de formulaires de tâches standard, au milieu d’autres contrôles et d’autres règles. Vous trouverez également plein d’informations intéressantes et complémentaires sur l’espace dédié à ce contrôle dans la documentation K2.

Happy K2ing !

Et à très bientôt pour un article sur d’autres fonctionnalités de la 4.7.0.

Ce billet fait partie d’une série de billets sur les nouvelles fonctionnalités de la 4.7.0. Les autres articles disponibles sur ce sujet sont :

jean

Directeur technique de K2 France depuis 2006 et passionné par les technologies, je travaille dans le monde du BPM et des applications métier depuis... que je travaille :). Vous pouvez également me suivre sur twitter, linkedin.

Une réponse à “Série v4.7 – Nouveau contrôle BarCode

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *