Intégration .NET - Guide de démarrage rapide

Ce guide a pour objectif de vous expliquer comment réaliser une intégration de base de CrowdHandler .NET dans votre application MVC.

Pour plus d'options de personnalisation et de configurations avancées, veuillez consulter ladocumentation NuGet du projet .

1.) Ajoutez une référence à votre projet.#

Le plus simple est d'utiliser NuGet. Recherchez le Crowdhandler.MVCSDK dans le gestionnaire de paquets NuGet, ou bien via l'interface de ligne de commande dotnet.

dotnet add package Crowdhandler.MVCSDK

2.) Appliquez l'attribut de filtre Crowdhandler à vos actions de contrôleur.#

ExempleTicketingController.cs

using Crowdhandler.MVC5SDK;

namespace MyTicketingApp.Controllers
{
    public class TicketingController : Controller
    {
        [CrowdhandlerFilter]
        public ActionResult Index()
        {
            return View();
        }
    }
}

Définissez les modèles d'URL à ignorer en transmettant au filtre le paramètre « Exclusions » avec une expression régulière contenant les modèles que vous ne souhaitez pas voir pris en compte pour la mise en file d'attente.

ExempleTicketingController.cs

using Crowdhandler.MVCSDK;

namespace MyTicketingApp.Controllers
{
    public class TicketingController : Controller
    {
        [CrowdhandlerFilter(Exclusions = @"^(\/contact-us.*)|((?!.*\?).*(\.(avi|css|eot|gif|ICO|jpg|jpeg|js|json|mov|mp4|mpeg|mpg|og[g|v]|pdf|png|svg|ttf|txt|wmv|woff|woff2|xml)))$")]
        public ActionResult Index()
        {
            return View();
        }
    }
}

3.) Injecter la configuration de CrowdHandler.#

* Les clés publiques et privées se trouvent dans la section « Compte -> API » du panneau d'administration de CrowdHandler.

via app.config ou web.config

<appSettings>
    <add key="CROWDHANDLER_PUBLIC_KEY" value="YOUR_PUBLIC_KEY"/>
    <add key="CROWDHANDLER_PRIVATE_KEY" value="YOUR_PRIVATE_KEY"/>
</appSettings>

Il est également possible de les injecter directement dans le filtre.

using Crowdhandler.MVC5SDK;

namespace MyTicketingApp.Controllers
{
    public class TicketingController : Controller
    {
        [CrowdhandlerFilter(PrivateApiKey = "YOUR_PRIVATE_KEY", PublicApiKey = "YOUR_PUBLIC_KEY")]
        public ActionResult Index()
        {
            return View();
        }
    }
}

* Vous trouverez la liste complète des paramètres configurables et de leurs valeurs par défaut dans la section 2b de la documentation NuGet.

https://www.nuget.org/packages/Crowdhandler.MVCSDK/

4.) Installer l'intégration JavaScript de CrowdHandler#

Pourquoi dois-je faire cela si j'intègre CrowdHandler côté serveur ?

Afin de garantir que l'intégration s'exécute aussi rapidement que possible, les fonctionnalités qui ne sont pas considérées comme essentielles sont déchargées côté client grâce à notre intégration JavaScript.

Si cette fonctionnalité n'est pas essentielle à la mission, puis-je sauter cette étape ?

En théorie, oui, mais dans la pratique, nous vous le déconseillons. L'installation de l'intégration JavaScript permet d'activer des fonctionnalités telles que le suivi des performances des pages et le maintien intelligent des sessions.

Le premier est indispensable au bon fonctionnement de notre fonctionnalité d'ajustement automatique et permet en outre de suivre les performances de votre application en situation de charge.

Ce dernier synchronise les informations de session entre le côté client et le backend de CrowdHandler, ce qui évite que les utilisateurs récemment actifs ayant dépassé la durée de session configurée dans CrowdHandler ne soient inutilement envoyés au validateur de session de CrowdHandler pour une revalidation.

Comment installer l'intégration JavaScript ?

Le code JavaScript peut être installé via Google Tag Manager, en l'intégrant directement dans la balise de votre modèle principal ou par tout autre moyen qui vous convient.

Vous trouverez ici les instructions pour installer notre intégration JavaScript.

5.) Modifiez le type d'intégration en .NET dans le panneau de configuration de CrowdHandler.#

La sélection du déploiement peut s'effectuer depuis l'écran des domaines.

6.) Et maintenant ?#

Une fois que vous aurez suivi toutes les étapes d'intégration .NET, nous vous recommandons de consulter notre guide de démarrage, qui vous aidera à vous familiariser avec la création et la configuration des salles d'attente depuis le panneau de configuration de CrowdHandler.