Les rapports et les tableaux de bord visuels sont essentiels lorsqu'il s'agit de comprendre l'information. Les solutions de séquençage de Dartfish peuvent générer des centaines d'événements avec des dizaines de mots-clés chacun. Présenter ces données de manière claire et structurée à travers des graphiques, des visuels et des métriques permet aux utilisateurs de comprendre ce qui se passe et de prendre immédiatement les bonnes décisions.


Dartfish a développé une API pour relier les données de séquençage dans Live à des outils de visualisation de données externes tels que Power BI, Tableau, Qlik ou Excel. Utilisez les outils de visualisation avancés des solutions professionnelles pour créer des tableaux de bord.


Exigences

  • Logiciel myDartfish Pro S avec la version 11.6.1030.0
  • Un réseau local pour tous les appareils équipés du logiciel de tableau de bord


Dartfish Live Collaboration REST API

Depuis sa version 11.6.1030.0, le logiciel Dartfish offre un point d'accès en lecture seule pour accéder aux données générées par le service DLC. Cela permet d'utiliser le DLC comme source de données pour importer des données de manière transparente dans des applications tierces. Ce guide montre comment créer un lien avec un tableau de bord Power BI, mais d'autres applications tierces peuvent être utilisées.


Pour récupérer les paramètres de la source de données DLC, procédez comme suit :

  • Lancer le logiciel Dartfish avec une licence Pro S

  • Dans le module Live, démarrez une session de collaboration Live en cliquant sur Rejoindre > Créer une session.

  • Une fois la session créée, dans la fenêtre Statut de la session, ouvrez l'onglet Source de données.
  • Sélectionnez le réseau sur lequel le dispositif de rapport est connecté et copiez le point de terminaison de la source de données
    • Il se peut que plusieurs adresses soient répertoriées. Il y aura une adresse par réseau auquel votre ordinateur est connecté. Pour choisir la bonne adresse, recherchez le réseau qui relie votre ordinateur au dispositif de rapport.

Conseil : L'API REST de la DLC propose 3 méthodes:
LiveCollaboration/EventData: renvoie tous les évènements de la session par défaut. La session par défaut est celle qui a été créée en dernier.
LiveCollaboration/{sessionid}/EventData: renvoie tous les évènements de la session id = sessionid
LiveCollaboration/Sessions: renvoie toutes les sessions en cours, leur identifiant respectif et leur description

Logiciel de visualisation (Excel, Power BI, Tableau, Qlik, etc.)


Une fois que vous avez récupéré le point final de la source de données dans le logiciel Dartfish, il est temps de commencer à travailler sur le logiciel de visualisation. Power BI sera utilisé comme exemple dans ce guide, mais sachez que vous pouvez utiliser d'autres outils de reporting tant qu'ils sont compatibles avec l'API REST.

  • Lancer PowerBI et créer un nouveau rapport vierge
  • Dans le ruban Accueil, cliquez sur Obtenir des données > Requête vierge

  • Cliquez sur Gérer les paramètres > Nouveau paramètre

  • Choisissez les paramètres suivants, puis appuyez sur OK
  • Définir le Nom sur Point d'arrivée
  • Définir le Type sur Texte
  • Définir la valeur suggérée sur N'importe quelle valeur
  • Copier le point final de la source de données du logiciel Dartfish dans Valeur actuelle

  • Sélectionnez Query1 et cliquez sur Advanced Editor

  • Supprimez tout ce qui se trouve dans la requête et copiez le code suivant, puis cliquez sur Terminé
  • Les valeurs surlignées en jaune sont les catégories de mots-clés des événements dans le logiciel Dartfish. Supprimez celles dont vous n'avez pas besoin et remplacez-les par des catégories que vous avez dans votre panneau de marquage.
let 
    Source = Json.Document(Web.Contents(EndPoint,                                                       [Headers=[ 
         Authorization=".",#"Content-Type"="application/json"], 
         RelativePath="/EventData"])),
    StripTopElem = Source[Events], 
    Unifie = List.Transform(StripTopElem,  
    each Record.TransformFields(_,{                                                                

    {"Name", Text.Trim}, 
    {"Position", Int64.From}, 
    {"Duration", Int64.From}, 
    {"Detail", Text.Trim}, 
    {"GameTime", Text.Trim}, 
    {"Opponent", Text.Trim}
    }, MissingField.UseNull)), 

    Pivotage = Table.FromRecords(Unifie,                                        
    {"Name", 
    "Position", 
    "Duration", 
    "Detail", 
    "GameTime", 
    "Opponent"
    }), 

    #"Sorted" = Table.Sort(Pivotage,{{"Position", Order.Ascending}})                                in 
    #"Sorted"


  • Cliquez sur Fermer et appliquer. Power BI va maintenant importer l'ensemble de données de votre session de séquençage en direct Dartfish et l'utiliser pour construire des graphiques et des visualisations.


Conseils et recommandations sur le déroulement des opérations


Actualisation des données

Le tableau de bord peut être actualisé à tout moment en cliquant sur Actualiser. Le tableau de bord sera alors rechargé avec les données les plus récentes. Certains outils offrent des possibilités de rafraîchissement automatique à intervalles fixes. Utilisez ces fonctionnalités pour améliorer l'efficacité des tableaux de bord.


Se préparer à l'avance

Vous pouvez préparer votre tableau de bord et vos visuels à l'avance. Pour cela, vous aurez besoin de données compatibles avec le panneau de séquençage que vous utilisez pendant vos matchs. Voici une suggestion de déroulement des opérations :


  • Dans Dartfish Software, ouvrez le module Différé. Chargez un jeu qui a été séquencé avec un panneau de séquençage compatible.
  • Dans le panneau de la liste des séquences, cliquez sur Exporter et partager et sélectionnez Exporter les données des séquences (CSV). Enregistrez les données sous myData.csv.
  • Dans Power BI desktop, créez un nouveau rapport.
  • Dans l'onglet du menu Accueil, cliquez sur Obtenir des données et sélectionnez Texte/CSV. Sélectionnez le fichier myData.csv sur votre disque. Cela créera une source de données appelée myData qui liera les données à votre fichier csv.
  • Créez vos visuels sur la base des données contenues dans le fichier csv.
  • Une fois que vos visuels sont prêts, vous pouvez éditer la requête myData pour vous connecter à la source de données DLC plutôt qu'au fichier csv exporté par le logiciel Dartfish.
  • Pour ce faire, sélectionnez la requête myData, cliquez avec le bouton droit de la souris et sélectionnez éditer. Power Query s'ouvre.
  • Dans Power Query, sélectionnez la requête et renommez-la DLCLanQuery.

Suivez maintenant les instructions de la section du logiciel de visualisation


Créer un modèle

Une fois que vous avez créé un document lié au DLC avec tous les visuels qui correspondent à vos besoins d'analyse, sauvegardez le document pour l'utiliser comme modèle pour votre prochain match.


Lorsque vous préparez un nouveau match, faites une copie de votre modèle et utilisez le nouveau document pour l'analyse de votre nouveau match. Il vous suffira de modifier l'adresse IP dans la valeur du paramètre EndPoint (si l'adresse IP de l'ordinateur sur lequel tourne le DLC a changé).


Réutiliser vos tableaux de bord Power BI dartfish.tv existants


Si vous avez déjà préparé un rapport Power BI pour une collection sur votre chaîne dartfish.tv, vous pourriez vouloir réutiliser le travail que vous ou votre équipe avez déjà effectué. Après tout, les visuels d'après-match peuvent être utiles pour une analyse en cours de match.


Pour cela, vous devrez modifier la source de données afin qu'elle se connecte à l'API REST du DLC plutôt qu'au correspondant dartfish.tv. Pour ce faire, procédez comme suit:

  • Ouvrez votre rapport Power BI
  • Sélectionnez la source de données dans l'onglet Données (à droite) et sélectionnez Modifier dans le menu contextuel.
  • Power Query s'ouvre pour vous permettre de modifier la requête.
  • Sélectionnez Gérer les paramètres, supprimez tous les paramètres et ajoutez un nouveau paramètre EndPoint comme dans la section Logiciel de visualisation. Fermez la fenêtre Gérer les paramètres.
  • Sélectionnez maintenant la requête et cliquez sur Editeur Avancé.
  • Ici, vous voudrez préserver votre typage de données et vos transformations et ne modifier que la connexion à la source de données, c'est-à-dire la première section du code. Remplacez
Source = Json.Document(Web.Contents(
"https://api.dartfish.tv",
[Headers=
[Authorization = "ChannelKey " & ChannelKey, #"Content-Type" = "application/json"],
RelativePath = "/api/v2/video/" & CollectionID & "/" & MatchID & "/EventData",
Content=Text.ToBinary("{""IncludeMatchKeywords"":false}")] )),

StripTopElem = Source[Events],


par


Source = Json.Document(Web.Contents(
EndPoint, 
[Headers=[
Authorization=".",#"Content-Type"="application/json"],
RelativePath="/EventData"])),

StripTopElem = Source[Events],


  • Conservez le reste de la requête en l'état


Partager

Enregistrez votre rapport sur OneDrive et partagez-le avec votre équipe pour qu'elle puisse y accéder. Il est important que vous le partagiez en mode Affichage uniquement, sinon des conflits d'édition peuvent survenir. Vous garderez votre classeur ouvert dans Excel Desktop et l'actualiserez en fonction des nouvelles données, si nécessaire, et votre équipe verra les changements.