Ce guide a été conçu pour vous faciliter lintégration du service FIFA Connect ID. Il comporte cinq étapes correspondant à des niveaux dintégration : plus létape est élevée, plus lintégration est près dêtre finalisée.

Avant de commencer lintégration, il est recommandé de lire cet article, qui décrit les concepts fondamentaux du service Connect ID. Ce n’est pas obligatoire mais cela vous aidera à comprendre les raisons pour lesquelles nous vous demandons de réaliser certaines étapes.

En cas de problème, nhésitez pas à nous contacter via notre page daide (Support Portal – voir ci-dessous) et à consulter les questions fréquemment posées. Vu le nombre dassociations membres concernées, il y a de fortes chances que quelquun dautre soit déjà passé par là !

Remarque : lorsque les instructions ci-dessous évoquent une documentation SDK [principale], il sagit dun fichier HTML contenant le pack SDK zippé que nous vous demandons de télécharger à l’étape n°1. Son nom peut varier en fonction de la technologie et de la version du pack. À lheure actuelle, la documentation se trouve dans les fichiers suivants :

  • fifa-connectid-sdk-php-6.1.html
  • fifa-connectid-sdk-net-6.1.html
  • fifa-connectid-sdk-java-6.2.html

 

Étape n°1 – Fondamentaux

Ce chapitre présente ce qu’il convient de faire avant de commencer à intégrer votre solution à Connect ID. Il faut obtenir les identifiants, télécharger les bibliothèques et les enregistrer au sein de votre solution. Une fois cette étape terminée, vous êtes prêt à commencer lintégration et à dérouler le premier scénario denregistrement d’une personne.

 

  1. Rendez-vous sur Support Portal (https://support.id.ma.services/support/home) et appuyez sur « New support ticket ».
  2. Demandez des identifiants pour lenvironnement bêta à léquipe Connect ID. Indiquez le nom de votre association membre.
  3. Les identifiants vous sont envoyés par courriel sous la forme de valeurs ClientID et SecretKey. Vous devez ensuite ajouter ces valeurs dans le code source, ce qui permettra à Connect ID de vérifier votre identité et vos autorisations.
  4. Vous recevrez également un nouveau nom dutilisateur et un mot de passe, que vous utiliserez ultérieurement pour accéder à notre système (Admin Console) à des fins de dépannage et de signalement de problèmes. Par exemple, si vous avez utilisé un SDK pour enregistrer un joueur, vous devez probablement vous rendre sur Admin Console pour confirmer son enregistrement.
  5. Vous pouvez utiliser les mêmes nom dutilisateur et mot de passe que dans le point 4 pour accéder au système DevTools, qui vous permet de suivre la progression de votre intégration.
  6. Téléchargez la dernière version du SDK depuis le Support Portal (https://support.id.ma.services/support/solutions/7000001343). Choisissez la version correspondant à votre technologie (.NET, Java, PHP).
  7. Décompressez le SDK (téléchargé comme fichier zip).
  8. Ouvrez le fichier fifa-connectservicebus-certificates-generation.html et suivez les instructions indiquées qu’il contient. Vous pourrez ainsi générer votre clé publique et votre clé privée, qui serviront à chiffrer les communications directes avec dautres associations membres via Service Bus.
  9. Référencez les bibliothèques de Connect ID dans votre solution. La liste des bibliothèques à référencer se trouve dans le chapitre 2. Paramétrage de la documentation SDK (Setup).

 

Étape n°2 – Enregistrement forcé dune personne

Cette étape a pour objectif de vérifier que vous pouvez vous authentifier sur Connect ID et y déposer des informations à partir de votre système, deux éléments indispensables à l’enregistrement d’une personne. Lors de cette étape, nous allons dérouler le scénario le plus simple et partir du principe que le service Connect ID ne trouve aucun doublon potentiel. Pour faire en sorte que le Connect ID ignore les doublons, vous allez utiliser loption enregistrement forcé plutôt que lenregistrement standard.

 

Veuillez noter quaux étapes n°2, 3 et 4, vous utilisez uniquement la catégorie RegistrationFacade. Celle-ci permet de simplifier lintégration car elle propose des procédures faciles à utiliser qui dissimulent toute la complexité technique de Connect ID. Vous nêtes pas supposé utiliser la catégorie FifaConnectIDClient décrite au chapitre 3.3 de la documentation SDK ( FIFA Connect ID Client).

  1. Rendez-vous dans la documentation SDK et suivez les instructions décrites au chapitre 2.3 (Using Registration Facade). La catégorie RegistrationFacade doit connaître lemplacement de votre clé privée. Elle en aura besoin à l’étape n°3, lorsque nous traiterons des dossiers dont l’enregistrement est impossible en raison de la présence de doublons. Dans notre cas particulier (enregistrement forcé), nous n’avons pas besoin d’utiliser la clé privée mais le constructeur de RegistrationFacade la demandera.
  2. Suivez les instructions du chapitre 2.3 pour créer RegistrationFacade. Veuillez noter que vous utilisez des identifiants déjà générés, notamment ClientID, SecretKey et PrivateKey [emplacement].
  3. Passez au chapitre 2.3.1 (Register new person) et créez un objet PersonData, comme décrit dans le premier extrait de code.
  4. Passez lobjet de votre personne à la méthode RegistrationFacade.ForceRegisterPerson(...). Noubliez pas que cette étape consiste à enregistrer une personne sans passer par la vérification de doublons. Vous nêtes donc pas obligé dutiliser la méthode RegistrationFacade.RegisterPersonAndWaitForDetailsInCaseOfDuplicates(...), décrite dans lextrait de code au chapitre 2.3.1.
  5. Rendez-vous dans Admin Console https://fci-adminconsole-beta.azurewebsites.net/ et sélectionnez Audit Trail. Si votre enregistrement a réussi, vous verrez apparaître votre dossier tout en haut.
  6. Nous partons du principe que vous avez pensé à sauvegarder l’identifiant FIFA dune personne nouvellement enregistrée dans votre Football Management System. Dans le cas contraire, veuillez le faire car nous en aurons besoin à l’étape n°4 de ce guide.
  7. Remarque : consignez les détails de la personne que vous avez enregistrée. À l’étape n°4, nous allons vous demander denregistrer la même personne, mais cette fois sans enregistrement forcé.

 

Une fois la première personne enregistrée, nous passons à la gestion des doublons internationaux. Cette activité comporte deux étapes. Vous allez tout dabord mettre en place un service chargé de répondre aux associations membres demandant les détails dune personne à votre système. Ensuite, vous apprendrez vous-même à demander les détails dune personne et à interpréter les réponses envoyées par d’autres associations membres.

 

Étape n°3 – Partager les détails dune personne avec dautres associations membres

L’étape n°3 décrit comment partager les détails dune personne avec dautres associations membres. Ceci permet d’éviter lenregistrement de doublons.

 

À l’étape n°4, vous apprendrez comment demander aux autres associations membres des informations concernant des doublons potentiels de votre dossier. Pour commencer sur le sujet des doublons, nous allons vous demander de mettre en place un service qui répondra aux demandes d’information de joueurs émises par dautres associations membres. Cette fonctionnalité répond aux besoins du scénario denregistrement dune personne le plus important. Imaginez que lassociation membre X essaie denregistrer une personne. Connect ID linforme de la présence dun doublon potentiel. Lassociation membre en question ne reçoit pas de données personnelles car leur stockage n’est pas prévu dans Connect ID. En revanche, il lui est indiqué que le doublon potentiel provient de votre association membre et quil correspond à un certain identifiant FIFA.

Dans cette situation, lassociation membre X vous adresse via Service Bus un message chiffré de type request-for-person-details. Nous allons désormais vous montrer comment reconnaître ce genre de message et y répondre. 

 

Le bon côté de cet outil, cest qu’il facilite les échanges avec les autres associations membres. Le SDK se charge du chiffrement des messages échangés sur la plateforme. Il comprend également quun message est arrivé et qu’il s’agit d’une request-for-person-details. Vous devez alors procéder comme suit :

  • Exécutez un code personnalisé (interface PersonDetailsProvider), qui recherche les informations de la personne correspondant à l’identifiant FIFA reçu comme paramètre PersonDetailsRequest sur votre propre Football Management System et les renvoie. Bien qu’il s’agisse d’un message XML, vous n’avez pas à vous préoccuper des problèmes de format car le SDK comporte un outil (PersonLocalXmlSerializer) qui transforme automatiquement votre objet PersonLocal en XML. Vous trouverez de plus amples informations sur le fournisseur d’informations de personnes et sur la gestion du format XML au chapitre 2.4.1 (Person Details Provider) & 3.1 (Working with PersonLocal).
    • Vous vous demandez peut-être quelles informations vous devez renvoyer à une association membre vous adressant une demande de ce genre. En fait, nous nous conformons à la norme FIFA Data Standard, qui, pour faciliter les choses, contient les informations requises par le constructeur PersonLocal : nom de famille, sexe, nationalité, date de naissance, pays de naissance, lieu de naissance, langue et pays. Lors de l’installation finale, nous vous recommandons de fournir davantage dinformations (par exemple, l’historique du joueur) mais, pour linstant, vous pouvez vous en tenir aux données obligatoires. Veuillez noter que les champs susmentionnés sont obligatoires. Vous devez donc les renseigner lors de chaque demande d’informations dune personne. Vérifiez si votre base de données contient des enregistrements incomplets pour pouvoir définir une solution alternative (ex. : vous pouvez éventuellement indiquer « inconnu » sil manque le lieu de naissance).
  • Lancez votre listener darrière-plan pour pouvoir échanger des messages avec les autres associations membres. La configuration du listener dépend de la technologie que vous utilisez. Les technologies .NET et Java sont multithread, contrairement à PHP, qui a donc besoin dune couche supplémentaire pour partager des données entre le listener et lapplication web/le script denregistrement. Vous trouverez dans la documentation SDK (2.4) une description détaillée vous expliquant comment démarrer le listener selon votre technologie.

 

Si vous avez appliqué les mesures ci-dessus, vous devez désormais disposer dun listener actif prêt à recevoir des demandes d’informations de la part dautres associations membres. Vous aurez besoin de faire un peu plus de codage pour vérifier son bon fonctionnement (l’étape n°4 décrit comment faire). Nous vous suggérons donc de nous contacter dès maintenant. Indiquez-nous l’identifiant FIFA dune personne enregistrée à l’étape n°2 et nous vérifierons grâce à notre outil interne si votre système nous envoie les informations de la personne.

Votre solution est désormais capable :

  • denregistrer de façon forcée une personne ;
  • denvoyer les informations dune personne à une association membre cherchant à déterminer si une personne en cours d’enregistrement est un doublon dune personne de votre Football Management System.

Le dernier élément du scénario denregistrement dune personne consiste à apprendre à demander à une autre association membre les informations dune personne et à en interpréter la réponse.

 

Étape n°4 – Comprendre les informations de doublons potentiels

L’étape n°4 va vous permettre de dérouler la fin du scénario denregistrement dune personne. Vous allez apprendre à gérer les doublons potentiels lors de lenregistrement et à récupérer les informations dune personne fournies par dautres associations membres.

 

Souvenez-vous, à l’étape n°2, vous avez créé un objet PersonData et vous lavez soumis à la procédure RegistrationFacade.ForceRegisterPerson(...). Celle-ci peut être utilisée dans le système Production, mais seulement dans certaines circonstances : lorsque vous savez déjà que la personne que vous êtes sur le point denregistrer ne présente aucun véritable doublon. Mais comment distinguer un véritable doublon d’un faux positif ? Le processus complet denregistrement dune personne est le suivant (vous trouverez ci-après une description rapide ; les étapes techniques spécifiques sont indiquées par la suite) :

  • Une fois lobjet PersonData créé, au lieu de forcer lenregistrement comme dans l’étape n°2, vous devez essayer de lenregistrer avec la procédure RegistrationFacade.RegisterPersonAndWaitForDetailsInCaseOfDuplicates(...).
  • Cette méthode contacte en arrière-plan Connect ID, vérifie la présence de doublons et, le cas échéant, télécharge les informations de base vers le client/SDK.
  • Toujours avec cette procédure, notre code envoie des messages chiffrés via Service Bus à toutes les associations membres ayant des doublons potentiels pour leur demander les informations complètes de la personne.
  • La procédure se termine lorsque toutes les réponses ont été reçues (ou, au plus tard, dans le délai défini en secondes en tant que paramètre timeout) et renvoie un ensemble de doublons potentiels comportant les informations personnelles envoyées par les autres associations membres.
  • Maintenant que vous disposez des données personnelles des doublons potentiels, vous pouvez les afficher sur le Football Management System de sorte que l’utilisateur puisse décider si la personne à enregistrer présente des doublons ou non (vous trouverez tous les détails dans larticle Building user interface for duplicate resolution).
  • Les mesures à prendre en fonction de cette décision dépendent des processus professionnels (également décrits ici), mais ne vous préoccupez pas de cela pour linstant. Il vous suffit de comprendre que si tous les doublons sont en réalité des faux positifs, vous devez forcer lenregistrement (comme à l’étape n°2) et que si un véritable doublon a été trouvé, vous devez utiliser son identifiant FIFA (et potentiellement lancer un processus de transfert).

Veuillez noter que la catégorie RegistrationFacade vous évite toutes les difficultés liées à la vérification des doublons et à lobtention des informations de la part dautres associations membres. Cest pour cette raison que nous avons nommé cette catégorie de la sorte.

 

Si vous vous demandez encore pourquoi il faut recourir au mécanisme de communication de Service Bus pour un simple enregistrement de personne, noubliez pas que le service didentifiant ne stocke pas les données personnelles. Si, pour statuer sur les doublons, lutilisateur ne comptait que sur les informations de Connect ID, il serait rarement en mesure de prendre la bonne décision. Il verrait par exemple les informations suivantes : « La personne que vous essayez denregistrer semble être le doublon dun joueur amateur, de sexe masculin, né en France le 23/04/1978. Le taux de correspondance des noms est de 0,6. » Nous ne serions même pas en mesure dafficher le nom complet dun doublon potentiel et encore moins la photo ou lhistorique de la personne !

Il y a encore autre chose à savoir avant de passer au déroulement de ce scénario. Vous y avez peut-être déjà pensé : « que se passe-t-il si la personne que jessaie denregistrer ne présente pas de doublon international mais un doublon local/national ? ». « Dois-je lancer une nouvelle procédure pour vérifier la présence de doublons locaux puis de doublons internationaux sur Connect ID ? »

Alors, bonne nouvelle : non, pas du tout ! Nous utilisons exactement le même mécanisme pour vérifier les doublons locaux et internationaux. Relisez la description ci-dessus. Est-il indiqué que le système contactera toutes les associations membres sauf la vôtre ? Non, fort heureusement. Si le service didentifiant trouve un doublon au sein de votre association membre, votre client/SDK s’auto-envoie un message via Service Bus, exécute PersonDetailsProvider (que vous avez utilisé à l’étape n°3) et renvoie les informations de la personne. En fin de compte, votre utilisateur visualise également les informations fournies par votre propre Football Management System. Cest vrai que le système implique beaucoup de va-et-vient et qu’on pourrait abréger. Sauf que pour ce faire, vous devez lancer une procédure distincte de gestion des doublons locaux et nous ne souhaitons pas que vous perdiez du temps avec ceci. Au lieu de cela, nous avons accru la puissance de Service Bus afin quil puisse gérer toutes les communications requises.

Après cette introduction plutôt longue, vous êtes désormais prêt à passer à la partie technique. Comme précédemment (pour les doublons nationaux et internationaux), nous allons vous présenter plusieurs scénarios.

 

Scénario 1 – Obtenir les informations de doublons figurant dans votre propre base de données (doublons nationaux)

  • Vous avez déjà enregistré une personne à l’étape n°2 de ce guide. Vous allez désormais prendre les données de cette personne et essayer de lenregistrer à nouveau. Cette fois, en revanche, vous allez utiliser la procédure RegistrationFacade.RegisterPersonAndWaitForDetailsInCaseOfDuplicates(...) au lieu de RegistrationFacade.ForceRegisterPerson(...). Cette opération est bien décrite dans le chapitre 3.2.1 de la documentation SDK (Register new person). Étant donné que la personne est déjà enregistrée dans la base de données de la FIFA, il nest pas possible de lenregistrer à nouveau (si lenregistrement nest pas forcé). La requête renvoie donc un code derreur 409 HTTP (conflit). Noubliez pas, cependant, que tout cela se produit en arrière-plan. Lorsque le code 409 est renvoyé en interne, le SDK adresse automatiquement des demandes d’informations de personne à toutes les associations membres ayant des doublons potentiels dans leur base de données locale. Dans ce cas précis, votre SDK s’auto-envoie la requête et y répond (parce que la personne est enregistrée dans votre système).
  • Consultez lextrait de code du chapitre 3.2.1. Dans la chaîne duplicateWithDetails.PersonDetails, vous trouverez une réponse au format XML générée et renvoyée par votre PersonDetailsProvider. Lorsque vous ouvrez le document XML, vous voyez quil contient les mêmes données que celles définies à laide de la catégorie PersonLocal à l’étape n°3.

 

Si vous en êtes arrivé là, c’est que votre installation réagit correctement avec les informations de la personne. Nous lavons vérifié à la fin de l’étape n°3 sur notre outil, mais vous en avez désormais la preuve concrète.

 

Scénario 2 – Obtenir les informations de doublons en provenance dautres associations membres (doublons internationaux)

  • En gros, les étapes à suivre ici sont très similaires à celles du scénario 1. En revanche, on va utiliser ici les données de personnes enregistrées par dautres associations membres dans lenvironnement bêta au lieu de vos propres données. Vous trouverez ci-dessous la liste de ces personnes. Vous pouvez dérouler ce scénario pour quelques-unes dentre elles ou pour l’intégralité, puis comparer le nombre de doublons affichés.
  • Dans ce cas, vous devez suivre les instructions décrites au chapitre 3.2.1 (Register new person). En quelques mots, vous devez créer un objet PersonType et le remplir avec les données dune personne de la liste.
  • Lexécution de RegistrationFacade.RegisterPersonAndWaitForDetailsInCaseOfDuplicates(...) renvoie désormais également un code derreur 409 en interne mais, cette fois, votre exécution de PersonDetailsProvider n’est pas déclenchée. Vous obtenez une réponse XML de la part dautres associations membres, celles qui détiennent les informations de la personne que vous souhaitez enregistrer. Vous vous souvenez de la catégorie PersonLocalXmlSerializer que vous avez utilisée à l’étape n°3 ? Vous pouvez vous servir du même outil pour créer une occurrence de PersonLocal à partir dune chaîne XML brute (vous trouverez de plus amples détails concernant ceci au chapitre 3.1.3 (Deserialize XML with person details) de la documentation SDK). Vous pouvez utiliser le XML avec les informations de la personne ou le désérialiser en tant quobjet PersonLocal. Tout dépend de vos préférences et de votre contexte.

 

Scénario 3 – Comprendre les enregistrements créés dans mon association membre par dautres systèmes

Si, au cours de la mise en place, vous remarquez que la propriété RequestRecipientOrganisationSystemId sous PersonDuplicateWithDetails est remplie, rendez-vous à la section Concepts avancés pour en savoir plus sur les enregistrements créés par des systèmes externes. 

Liste des personnes test enregistrées dans lenvironnement bêta :

  • Tres Bruno, 29 avril 1989
  • Yacine Adli, 29 juillet 2000
  • Nabil Alioui, 18 février 1999
  • Danilo Cataldi, 6 août 1994

 

Veuillez noter que cette liste était valable au moment de rédiger le présent article. Si vous ne parvenez pas à recevoir les informations des personnes susmentionnées (autrement dit, si vous recevez une chaîne vide au lieu dun document XML), veuillez nous en informer pour que nous puissions effectuer une vérification et vous fournir dautres noms.

Si vous êtes arrivé à ce stade et que vous avez réussi à dérouler les étapes n°1 à n°4, félicitations ! Il vous reste un peu de travail à faire, mais vous avez assimilé les concepts les plus importants. Votre solution devrait désormais être capable :

  • denregistrer une personne, de recevoir un identifiant FIFA et de le sauvegarder dans votre Football Management System ;
  • denregistrer une personne et, en cas de doublons, de demander les informations à dautres associations membres, dobtenir les informations et de les comprendre :
  • de forcer lenregistrement d’une personne ;
  • d’envoyer les informations dun joueur depuis votre Football Management System en réponse à la requête dautres associations membres.

 

Du point de vue du système :

  • vous êtes intégré au service Connect ID ;
  • vous êtes intégré au Service Bus de Connect ID et vous êtes en mesure dutiliser linfrastructure de clé publique/privée pour échanger des messages avec dautres « utilisateurs » du Service Bus.

 

L’étape n°5 décrit les éléments que vous navez pas encore mis en place.

 

Étape n°5 – Concepts avancés

 

La dernière étape vous explique comment mettre en œuvre les opérations restantes, notamment :

  • Mise à jour d’une personne
  • Enregistrement dun club
  • Enregistrement dinstallations
  • Processus de transfert

Elle explique également comment fournir des informations supplémentaires lorsque vous partagez les données dune personne avec dautres associations membres.

 

Le présent chapitre renvoie à trois ressources complémentaires, les listes de contrôle. Elles vous servent à vérifier que vous avez bien suivi toutes les opérations nécessaires à l’intégration de Connect ID. À des fins pratiques, vous trouverez ci-dessous les liens, mais veuillez noter quils se trouvent également dans les parties concernées :

Veuillez noter qu’un nouvel outil a été mis à disposition en octobre 2019 pour aider les associations membres à réaliser une auto-évaluation de leur progression. Vous pouvez utiliser les mêmes identifiants que pour Admin Console. L’outil est accessible sur cette page.

Mettre à jour les informations de profil dune personne

Il est possible de modifier ou de mettre à jour les informations d’une personne que vous avez enregistrée à l’étape n°3. Plusieurs options sont possibles :

  • Mettre à jour une personne
  • Ajouter des enregistrements
  • Mettre à jour les enregistrements
  • Fusionner des personnes

 

La procédure UpdatePerson donne la possibilité de mettre à jour le nom, la date de naissance ou le sexe dune personne. Vous avez alors besoin dau moins un des éléments mentionnés. Vous pouvez mettre à jour les trois éléments à la fois ou nen choisir quun (par exemple, la date de naissance) et donner une valeur nulle aux autres. Noubliez pas que ce genre dopération peut potentiellement entraîner l’apparition de doublons. Pour dérouler un tel scénario, suivez les instructions du chapitre 3.2.2 de la documentation SDK :

  1. Créez et forcez l’enregistrement de deux personnes avec des informations différentes.
  2. Utilisez la procédure UpdatePersonAndWaitForDetailsInCaseOfDuplicates pour mettre à jour les informations de la personne enregistrée en deuxième avec celles de la personne enregistrée en premier (noms, date de naissance et sexe). Vous devriez obtenir un ou plusieurs doublons potentiels à la fin de l’opération.
  3. Vous pouvez à présent retenter la même opération (UpdatePersonAndWaitForDetailsInCaseOfDuplicates) avec des données différentes. Essayez par exemple de mettre à jour une seule valeur. Si vous mettez à jour les noms, essayez dutiliser autant de valeurs uniques que possible. Ensuite, vous pouvez tester le scénario « mise à jour des informations de la personne sans obtenir de doublons ».

 

Comme vous lavez peut-être déjà remarqué, il est techniquement possible denregistrer une personne sans enregistrement. Un tel cas, bien quil soit autorisé, est inutile dun point de vue professionnel (puisque la personne nest affectée à aucune association membre). En revanche,
il est facile de modifier une personne enregistrée de la sorte en ajoutant des enregistrements 

  1. Commencez par enregistrer une personne sans enregistrement. Vous pouvez suivre le chapitre 3.2.1 mais noubliez pas dignorer la partie où PlayerRegistrationType est créé et rattaché à la liste denregistrements.
  2. À la suite de cette opération, vous obtenez un identifiant FIFA unique pour la personne enregistrée. À ce moment-là, vous pouvez vous connecter à Admin Console (https://fci-adminconsole-beta.azurewebsites.net/) et vérifier que vous pouvez voir cette personne et quaucun enregistrement ne lui est affecté.
  3. Passez désormais au chapitre 3.3.6 (et à son sous-chapitre 3.3.6.1, en particulier). À laide de lidentifiant FIFA que vous venez dobtenir et de lidentifiant de votre association membre (organisationId), vous pouvez désormais créer linstance PlayerRegistrationType et laffecter à AddRegistrationsRequestType.
  4. Vous êtes alors prêt à envoyer la requête. En voyant lextrait de code du chapitre 3.3.6.1, vous vous demandez sans doute ce quest le client et comment lobtenir facilement. Comme indiqué à l’étape n°2, nous nallons pas créer linstance FifaConnectIDClient séparément. Vous pouvez lobtenir à partir de RegistrationFacade en déclenchant la propriété ConnectIdClient ou via la procédure getConnectIdClient, selon la technologie utilisée (2.5.1).
  5. Il vous suffit maintenant de lancer la procédure AddRegistrations, dattendre une réponse puis de vérifier votre personne dans Admin Console (le mieux étant de passer par la fonctionnalité Audit Trail).

 

Rendons les choses encore plus compliquées en essayant de mettre à jour lenregistrement dune personne :

  1. Comme à létape précédente, nous avons ajouté PlayerRegistrationType à notre personne. Veuillez réaliser la même opération. Cette fois, cependant, ajoutez un autre type denregistrement (vous avez le choix parmi les options suivantes : MatchOfficialRegistrationType, OrganisationOfficialRegistrationType et TeamOfficialRegistrationType). 
  2. Lorsque vous êtes prêt, rendez-vous sur Admin Console et assurez-vous de voir deux enregistrements sur la page de la personne.
  3. Passez au chapitre 3.3.6.2 et essayez de mettre à jour un seul enregistrement pour cette personne. Essayez par exemple de modifier le statut de lenregistrement du joueur.

 

À un moment donné, lorsque vous utilisez le SDK de Connect ID, vous allez peut-être avoir besoin de fusionner deux personnes enregistrées (primaire et secondaire). Pour rappel, il nest pas possible de supprimer une personne de la base de données. Si une même personne a été enregistrée deux fois, la seule action possible consiste donc à fusionner les dossiers. Dun point de vue technique, ce processus plutôt facile peut être effectué tout simplement à laide de la procédure MergePersons (voir chapitre 3.3.4). À la suite de cette opération :

  • dans Admin Console, vous verrez (dans les pages informations de la personne et Audit Trail) quune personne secondaire a été fusionnée avec une personne primaire ;
  • aucun enregistrement nest déplacé/copié, donc les deux personnes gardent les mêmes enregistrements quavant la fusion ;
  • tous les enregistrements conservent leur statut actuel ;
  • GetPerson renvoie une FifaPersonMergedException lors dune requête didentifiant de personne secondaire.


Si vous avez suivi le guide étape par étape jusquà maintenant, vous devriez être en mesure de réaliser toutes les opérations sur les personnes dont vous avez besoin pour lintégration au service FIFA Connect ID.
Veuillez vous reporter à cet article, qui comporte une liste de contrôle des opérations que chaque Football Management System devrait pouvoir réaliser.
 

Enregistrement d'un club

La base de données du service FIFA Connect ID est prête à stocker les clubs de toutes les associations membres. Chaque club reçoit un identifiant FIFA unique après lenregistrement. Veuillez noter que :

  • chaque enregistrement de personne est exclusivement lié à une association membre (nous ne conservons pas les relations entre les personnes et les clubs).
  • Dans la mesure du possible, veuillez utiliser lidentifiant du club lorsque vous renvoyez un XML avec les informations dune personne (c’est ainsi que l’on peut lier lenregistrement à lidentifiant du club). Rendez-vous au chapitre 3.1.1 de la documentation SDK pour savoir comment préparer les données pour la sérialisation XML.

 

Passons désormais à lutilisation du SDK pour l’enregistrement d’un club 

  • Tout comme lorsque vous ajoutez des enregistrements à une personne, vous devez récupérer FifaConnectIDClient dans RegistrationFacade
  • Passez ensuite au chapitre 4.1, qui explique comment construire et exécuter la requête du processus denregistrement. 
  • Chaque type dorganisation impose la saisie de champs différents lors de lenregistrement. Lors de lenregistrement dun club, vous devrez fournir les propriétés suivantes : Status, InternationalName, LocalName, LocalLanguage, LocalCountry, OrganisationNature, ParentOrganisationFIFAId et OfficialAddress.
  • Les autres champs sont facultatifs mais nous recommandons de les remplir également dans la mesure du possible (pour quils puissent être utilisés par lalgorithme de déduplication du club).

 

Pour effectuer les étapes susmentionnées, nous partons du principe quaucun doublon na été trouvé lors de lenregistrement.
Si un doublon est trouvé, vous recevez une FifaDuplicatedOrganisationFoundException comportant les détails du doublon potentiel.

Si vous estimez quil sagit dun faux positif, vous pouvez utiliser le paramètre facultatif pour forcer lenregistrement de lorganisation.

 

Tout comme pour les personnes, il est possible de mettre à jour ou de fusionner les clubs/organisations. Vous trouverez toutes les informations nécessaires concernant ces opérations aux chapitres 4.3 et 4.4.

 

Tout comme pour les personnes, nous avons préparé une liste de contrôle pour les organisations. Vous la trouverez ici.

 

Enregistrement dinstallations

La base de données de Connect ID peut également stocker des Installations (par exemple, un stade).
Vous pouvez enregistrer une installation, qui sera associée à lorganisation indiquée (association nationale ou tout autre type dorganisation).

Voici les étapes à suivre pour enregistrer une installation :

  • Tout comme pour les personnes et les organisations, nous utilisons FifaConnectIdClient de RegistrationFacade.
  • Le chapitre 5.1 comporte un bloc de code expliquant comment créer et exécuter la requête. 
  • Les champs obligatoires pour les installations sont les suivants : Status, LocalName, LocalLanguage, LocalCountry, OrganisationFifaId, OfficialAddress.
  • Tout comme pour les organisations, nous vous recommandons dindiquer les champs non obligatoires pour quils puissent être utilisés par lalgorithme de déduplication de linstallation.

 

Tout comme pour les organisations, en cas de détection de faux positifs, vous pouvez utiliser le paramètre facultatif pour forcer lenregistrement de linstallation.

 

Une fois lenregistrement de linstallation terminé, vous pouvez en modifier les données. Le chapitre 5.3 vous explique comment y parvenir.

Contrairement aux personnes et aux organisations, les installations ne peuvent pas être fusionnées/défusionnées.

Pour finir, voici une liste de contrôle pour les installations.

 

Partage dun passeport de joueur complet avec dautres associations membres

À l’étape n°3, nous vous avons demandé de créer la fonctionnalité permettant de partager les informations dun joueur avec dautres associations membres. Cela permet aux autres associations membres de résoudre les doublons internationaux. À l’étape n°3, seule la bonne configuration du processus importait, donc nous vous avons demandé de saisir uniquement les informations obligatoires dans le message.

Nous vous recommandons à présent de fournir autant dinformations que possible sur le joueur, dans les limites de la norme FIFA Data Standard, bien entendu. Il ne vous manque certainement quune seule partie, intitulée <PlayerRegistration>. Nous vous demandons de répertorier tout lhistorique des enregistrements du joueur que vous connaissez. Si vous ne connaissez pas son parcours, vous devez au moins indiquer son enregistrement actuel auprès de votre association membre.

La dernière chose à expliquer est le champ OrganisationFIFAId. Sa valeur doit être :

  • dans lidéal, l’identifiant FIFA du club pour lequel le joueur évolue/a évolué (noubliez pas que nous pouvons avoir affaire à des enregistrements historiques également) ;
  • si vous ne le connaissez pas, au moins l’identifiant FIFA de lassociation membre pour laquelle le joueur évolue/a évolué.

 

Envoyer plus que les informations obligatoires dans une réponse à une demande d’informations de personne

 

Comme décrit à l’étape n°3 du présent guide, vous devez remplir un certain nombre de champs obligatoires lorsque vous répondez à une demande d’informations dune personne. Rendez-vous au chapitre 3.1.1 de la documentation SDK pour voir comment définir ces valeurs dans la technologie que vous utilisez. En gros, vous devez créer et modifier lobjet PersonLocal, qui est ensuite sérialisé directement dans un document XML. Nous vous encourageons à ouvrir cette catégorie (PersonLocal) et à lexplorer afin de comprendre ce que vous pouvez en tirer. Vous trouverez également ci-dessous la liste des champs non obligatoires :

  • LocalFirstName (chaîne)
  • LocalBirthName (chaîne)
  • Photo (vous trouverez les instructions expliquant comment créer un tel objet au chapitre 3.1.1)
  • LocalPersonName (liste de noms de personnes localisés)
  • NationalIdentifier (liste didentifiants de personnes nationaux uniques, comme le numéro de sécurité sociale, le numéro de passeport ou l’identifiant fiscal)
  • PlayerRegistration (liste)
  • TeamOfficialRegistration (liste)
  • MatchOfficialRegistration (liste)
  • OrganisationOfficialRegistration (liste)
  • PersonFIFAId (chaîne)
  • InternationalFirstName (chaîne)
  • InternationalLastName (chaîne)
  • RegionOfBirth (chaîne)
  • LocalSystemMAId (chaîne, identifiant provenant de votre base de données locale)

 

Chaque type denregistrement (Player, TeamOfficial, etc.) contient uniquement des champs obligatoires. Cela signifie (selon votre technologie) que pour créer une instance de ces enregistrements, vous devez simplement répondre aux besoins du constructeur ou utiliser toutes les méthodes de mutateur possibles.

 

Joueurs enregistrés par des systèmes externes (SystemID)

Pour en savoir plus sur ce scénario, veuillez consulter larticle suivant : System ID explained.

Veuillez noter que certains des exemples mentionnés à l’étape n°4 ont été enregistrés par un système externe. Nous vous recommandons de réaliser des tests afin de pouvoir faire la différence entre un doublon enregistré par une association membre et un doublon enregistré par un système externe.

 

Transferts / prise en charge dun joueur existant

Cet article devenant extrêmement long, nous avons décidé de décrire les transferts dans un autre article.