Integrazione .NET - Guida rapida : Sala d'attesa virtuale CrowdHandler

Lo scopo di questa guida è di illustrare come eseguire un'integrazione di base di CrowdHandler .NET nella propria applicazione MVC.

Per ulteriori personalizzazioni e configurazioni avanzate, consultare ladocumentazione Nuget del progetto .

1.) Aggiungete un riferimento al vostro progetto.

Questa operazione è più semplice se si utilizza NuGet, trovando il file Crowdhandler.MVCSDK nel gestore di pacchetti NuGet o, in alternativa, tramite la CLI di dotnet.

dotnet aggiungere il pacchetto Crowdhandler.MVCSDK

2.) Applicare l'attributo Filtro Crowdhandler alle azioni del controllore.

EsempioTicketingController.cs

using Crowdhandler.MVC5SDK;

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

Impostare i modelli di URL da ignorare passando al filtro il parametro "Esclusioni" con un'espressione regolare contenente i modelli che si desidera non considerare per l'accodamento.

I modelli comuni da ignorare sono:

* Percorsi utilizzati per la memorizzazione di risorse statiche e media, ad esempio /static-media/*
* URL di callback creati da fornitori di pagamenti di terze parti. 
* JSON e feed RSS.

EsempioTicketingController.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.) Iniettare la configurazione di CrowdHandler.

* Le chiavi pubbliche e private si trovano nella sezione Account -> API del pannello di controllo amministrativo di CrowdHandler.

tramite app.config o web.config

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

In alternativa, possono essere iniettati direttamente nel filtro.

using Crowdhandler.MVC5SDK;

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

* L'elenco completo dei configurabili e delle loro impostazioni predefinite si trova nella sezione 2b della documentazione di Nuget.

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

4.) Installare l'integrazione Javascript di CrowdHandler

Perché devo farlo se sto integrando CrowdHandler lato server?

Per garantire che l'integrazione venga eseguita il più rapidamente possibile, le funzionalità non considerate mission-critical vengono scaricate sul lato client tramite la nostra integrazione Javascript.

Se la funzionalità non è mission critical, posso saltare questo passaggio?

In teoria sì, ma in pratica lo sconsigliamo. L'installazione dell'integrazione Javascript abilita funzioni come il monitoraggio delle prestazioni della pagina e il mantenimento intelligente della sessione.

Il primo è un requisito per il corretto funzionamento della funzione di autotune, oltre a fornire visibilità sulle prestazioni dell'applicazione sotto carico.

Quest'ultimo sincronizza le informazioni sulla sessione tra il lato client e il backend di CrowdHandler, evitando che gli utenti attivi di recente che hanno trascorso un tempo superiore a quello configurato per la sessione di CrowdHandler vengano inviati inutilmente al validatore di sessioni di CrowdHandler per una nuova convalida.

Come si installa l'integrazione Javascript

Il Javascript può essere installato tramite Google Tag Manager, includendolo direttamente nell'head del template principale o in qualsiasi altro modo conveniente per voi.

Le istruzioni su come installare la nostra integrazione Javascript sono disponibili qui.

5.) Cambiare il tipo di integrazione in .NET nel pannello di controllo di CrowdHandler.

La selezione dell'installazione può essere effettuata dalla schermata dei domini.

6.) E adesso?

Una volta completate le fasi di integrazione .NET, vi consigliamo di consultare la nostra guida introduttiva che vi aiuterà a familiarizzare con la creazione e la configurazione delle sale d'attesa dal pannello di controllo di CrowdHandler.

Integrazione .NET - Guida rapida