Integración con .NET: guía de inicio rápido

El objetivo de esta guía es explicar cómo llevar a cabo una integración básica de CrowdHandler .NET en tu aplicación MVC.

Para obtener más información sobre la personalización y las configuraciones avanzadas, consultala documentación de NuGet del proyectoen .

1.) Añade una referencia a tu proyecto.#

La forma más sencilla de hacerlo es mediante NuGet; busca el Crowdhandler.MVCSDK paquete en el gestor de paquetes NuGet o, si lo prefieres, a través de la CLI de dotnet.

dotnet add package Crowdhandler.MVCSDK

2.) Aplica el atributo de filtro «Crowdhandler» a las acciones de tu controlador.#

ExampleTicketingController.cs

using Crowdhandler.MVC5SDK;

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

Configura los patrones de URL que deben ignorarse pasando el parámetro «Exclusions» al filtro con una expresión regular que contenga los patrones que no deseas que se tengan en cuenta para la puesta en cola.

ExampleTicketingController.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.) Inyectar la configuración de CrowdHandler.#

* Las claves pública y privada se encuentran en la sección «Cuenta -> API» del panel de control de administración de CrowdHandler.

a través de 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>

Como alternativa, se pueden inyectar directamente en el 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();
        }
    }
}

* En la sección 2b de la documentación de NuGet se puede consultar una lista completa de los parámetros configurables y sus valores predeterminados.

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

4.) Instalar la integración de JavaScript de CrowdHandler#

¿Por qué tengo que hacer esto si estoy integrando CrowdHandler del lado del servidor?

Para garantizar que la integración se ejecute lo más rápido posible, las funciones que no se consideran esenciales se transfieren al lado del cliente a través de nuestra integración con JavaScript.

Si esa funcionalidad no es esencial para el funcionamiento del sistema, ¿puedo saltarme este paso?

En teoría sí, pero en la práctica no lo recomendamos. Al instalar la integración de JavaScript se activan funciones como el seguimiento del rendimiento de las páginas y el mantenimiento inteligente de la sesión.

Lo primero es un requisito para que nuestra función de ajuste automático funcione correctamente, además de ofrecer información sobre el rendimiento de tu aplicación bajo carga.

Este último sincroniza la información de la sesión entre el lado del cliente y el backend de CrowdHandler, lo que evita que los usuarios que han estado activos recientemente y han superado el tiempo de sesión configurado en CrowdHandler sean enviados innecesariamente al validador de sesiones de CrowdHandler para su revalidación.

¿Cómo instalo la integración de JavaScript?

El código JavaScript se puede instalar a través de Google Tag Manager, incluyéndolo directamente en la sección «head» de tu plantilla maestra o de cualquier otra forma que te resulte más cómoda.

Aquí encontrarás instrucciones sobre cómo instalar nuestra integración de JavaScript.

5.) Cambia el tipo de integración a .NET en el panel de control de CrowdHandler.#

La selección de la implementación se puede realizar desde la pantalla de dominios.

6.) ¿Y ahora qué?#

Una vez que hayas completado los pasos de integración con .NET, te recomendamos que consultes nuestra guía de introducción, que te ayudará a familiarizarte con la creación y configuración de salas de espera desde el panel de control de CrowdHandler.