Intégration Twitter


À propos de cette intégration
SAS_IntegrationNotRESTIntroduction

Il existe plusieurs moyens d’intégrer des systèmes tiers avec Product name - ev sas.png. Cela, en fonction des besoins métiers, des contraintes d’architecture et de sécurité en vigueur ainsi que des spécificités de chaque application ou service tiers. Notamment, vous pouvez utiliser les datasources REST, CSV, Online CSV ainsi que le widget Html Script.

Cette page présente un processus d’intégration type déjà mis en œuvre dans un contexte client.

Pour plus de détails sur cette intégration, veuillez contacter les départements "Consulting & Professional Services" et Support d'Logo - EasyVista.png ou vos fournisseurs de services et intégrateurs habituels.

Synthèse de l'intégration

Twitter est un outil de microblogage géré par l’entreprise Twitter, Inc. Il permet à un utilisateur d’envoyer gratuitement de brefs messages, appelés tweets, sur internet, par messagerie instantanée ou par SMS. Ces messages sont actuellement limités à 140 caractères.
         Open url.png voir  Glossaire Twitter

Cette intégration très simple à mettre en œuvre permet d’insérer un fil d’actualité Twitter (également appelé Collection de tweets ou Timeline) directement dans une application Product name - ev sas.png, soit en insérant le code Html d’un widget Twitter de Twitter, Inc dans un widget Html Script (Processus d'intégration n° 1), soit en insérant l'identifiant Twitter Widget ID dans un widget Twitter Product name - ev sas.png (Processus d'intégration n° 2).

Le widget de Twitter, Inc permet d’intégrer :

  • 4 types de fils d’actualité, comparables aux fils d’actualité affichés sur le site twitter.com : Fil d'utilisateur (uniquement les tweets publics d’un utilisateur), Favoris, Liste publique, Recherche ;
  • un tweet unique (ex. : Tweet du compte @EasyVista) ;
  • un profil (ex. : Profil EasyVista) ;
  • un handle (ex. : @easyvista) ;
  • un hashtag (ex. : #ServiceApps).
     
Flux d’intégration des données (sens) Type d'authentification Options du connecteur d'intégration

Product name - ev sas - big.png

Up arrow.png

Logo - Twitter.png

N/A

Widget Html Script   Apps - Widget - Html icon.png

Widget Twitter   Apps - Widget - Twitter icon.png

Version SaaS du produit tiers

Version On-premise du produit tiers

Check icon.png

Not check icon.png

Processus d'intégration pas-à-pas

Les 2 processus d’intégration sont à peu près équivalents. Pour vous aidez à choisir :

  • Le processus n° 1 qui utilise un widget Html Script :
    • permet d’intégrer d'avantage d’objets Twitter différents ;
    • permet de définir les hauteur/largeur du widget de Twitter, Inc pour certains objets (Profil, Liste publique, Favoris, Handle) via l’assistant de configuration du widget de Twitter, Inc, modifiable ensuite dans le volet Conception de l'éditeur graphique Product name - ev sas.png ;
    • ne nécessite pas de connaître l'identifiant Twitter widget ID.
  • Le processus n° 2 qui utilise un widget Twitter Product name - ev sas.png :
    • permet d'intégrer essentiellement des fils d'actualité basés sur des widgets de Twitter, Inc de type Recherche (ex. : #Easyvista, @Easyvista) ;
    • ne permet pas de définir les hauteur/largeur du widget de Twitter, Inc ;
    • nécessite de connaître l'identifiant Twitter widget ID.

Processus n° 1 : Intégration d’un fil d'actualité Twitter via un widget Html Script

   Open url.png  voir les pages du Twitter Help Center : Intégrer un fil d’actualité sur un site
    Open url.png  voir Glossaire Twitter

Twitter, Inc propose des widgets de fil d’actualité : grâce un assistant de configuration de type Plug & Play, ils permettent d’intégrer un tweet ou une série de tweets dans vos applications Product name - ev sas.png. Via cette méthode, un fil d'actualité Twitter peut être intégré avec Product name - ev sas.png en 3 étapes simples :


Étape 1: Vérifier la liste des prérequis

Pour réaliser l’intégration, cette documentation suppose que vous disposez d’un compte Twitter et d’identifiants pour vous y loguer.


Étape 2 : Choisir un fil d'actualité Twitter et récupérer le code Html du widget de Twitter, Inc correspondant

Suivez les étapes 1 à 5 de la procédure Intégrer un fil d’actualité sur un site.


Étape 3 : Intégrer dans une application Product name - ev sas.png le code Html du widget de Twitter, Inc pour afficher le fil d'actualité

1. Allez sur Product name - ev sas.png et ouvrez l'application souhaitée.

2. Affichez le fil d'actualité Twitter de l'étape 2 via un widget Html Script :

  • dans le volet Objets, cliquez sur Apps - Add widget icon.png ; ouvrez la catégorie Basic et cliquez-glissez le widget HTML Script sur le volet Conception ;
  • renommez le nouveau widget pour l'identifier facilement ;
  • collez le code Html obtenu à l'étape 2 dans la zone Html Code ;
  • ajoutez éventuellement un entête via la propriété Theme > Header ;
  • ajustez les hauteur/largeur du widget via le volet Conception.

3. Cliquez sur EVApps - GUI - Execute icon.png pour passer en mode Visualisation et testez le bon affichage et fonctionnement du fil d'actualité Twitter.

Processus n° 2 : Intégration d’un fil d'actualité Twitter via un widget Twitter Product name - ev sas - big.png

        Open url.png voir  widget Twitter Product name - ev sas.png

1. Récupérer l’identifiant Twitter widget ID du fil d'actualité Twitter souhaité.

Best Practice icon.png  Pour obtenir rapidement l’identifiant Twitter widget ID d’un tweet, cliquez n’importe où sur celui-ci (hormis sur les tags) : l'URL s'affiche dans la barre d'adresse de votre navigateur internet. Vous pouvez alors copier l’identifiant situé à la fin de l'URL.

Example documentation icon FR.png    URL d'un tweet du compte @EasyVista Twitter widget ID
https://twitter.com/EasyVista/status/775322164258017280 775322164258017280

2. Suivez les étapes de la vidéo d’intégration pas-à-pas.

 

Note : Dans l’interface actuelle de Twitter (2016), seul le choix de widgets Search (Recherche) vous permet d’utiliser l’assistant de création et de sauvegarder des widgets de Twitter, Inc dans la liste des widgets.

        Processus2 - Widgets list.png   Processus2 - Widgets creation wizard.png

Cas d'utilisation

Intégrer dans une application Product name - ev sas.png un tweet unique d’un fil d’actualité et permettre aux utilisateurs de suivre le compte Twitter associé (via un bouton Suivre) : il s’agit d’une illustration du processus n° 1 d’intégration pas-à-pas utilisant un widget Html Script.

1. Allez sur l’assistant de configuration du widget de Twitter, Inc -  Open url.png  voir procédure Intégrer un fil d’actualité sur un site

    Puis :

  • Saisissez l'URL du tweet souhaité dans la zone dédiée (1).

Best Practice icon.png  Pour obtenir rapidement l’URL d’un tweet, cliquez n’importe où sur le tweet (hormis sur les tags). Vous pouvez ensuite copier l'URL qui s'affiche dans la barre d’adresse de votre navigateur internet.

        Processus1 - Use case - Widget creation wizard.png  Processus1 - Use case - Widget creation wizard - set customization options.png

  • Vous pouvez sélectionner le type d'affichage graphique souhaité : cliquez sur l'une des options (2) pour obtenir le code à insérer dans votre application.
  • Paramétrez éventuellement les options du widget en cliquant sur le lien set customization options (3) .
  • Cliquez sur [ COPY CODE ].

2. Allez sur votre application Product name - ev sas.png et affichez le fil d'actualité Twitter via un widget Html Script -  Open url.png  voir Procédure

        Example documentation icon FR.png  Affichage dans une application basée sur l'application modèle IT Portal
         Processus1 - Use case - Service store template.png

        Best Practice icon.png

  • Pour les types de fil d’actualité Profil, Liste publique, Favoris et Handle, l’assistant de configuration propose, via le lien set customization options, de fixer les hauteur/largeur du widget de Twitter, Inc. Le code Html généré contient alors les balises data-width et data-height (avec les valeurs sélectionnées), que vous pouvez ensuite modifier dans le widget Html Script inséré dans votre application Product name - ev sas.png.
  • Dans l’assistant de configuration, les hauteur/largeur minimales imposées sont respectivement de 200 et 220 pixels. Dans votre application Product name - ev sas.png, pour que le widget de Twitter, Inc s’adapte à la taille du support de l'utilisateur, fixez une largeur et une hauteur de 100 %.
             Processus1 - Use case - Html code width height.png
Tags:
Modifié par Utilisateur inconnu le 2017/09/08 11:40
Créé par Administrator XWiki le 2016/10/28 17:42

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020