.NET-Integration – Schnellstartanleitung

In diesem Leitfaden soll erläutert werden, wie Sie eine grundlegende CrowdHandler-.NET-Integration in Ihre MVC-Anwendung vornehmen können.

Weitere Informationen zur individuellen Anpassung und zu erweiterten Konfigurationen finden Sie im GitHub-Repository des Projekts oder in der NuGet-Dokumentation.

1.) Fügen Sie einen Verweis auf Ihr Projekt hinzu.#

Am einfachsten geht das mit NuGet. Suchen Sie die Crowdhandler.MVCSDK Paket im NuGet-Paketmanager oder alternativ über die dotnet-Befehlszeilenschnittstelle.

dotnet add package Crowdhandler.MVCSDK

2.) Wenden Sie das Crowdhandler-Filterattribut auf Ihre Controller-Aktionen an.#

BeispielTicketingController.cs

using Crowdhandler.MVC5SDK;

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

Legen Sie URL-Muster fest, die ignoriert werden sollen, indem Sie den Parameter „Exclusions“ an den Filter übergeben und dabei einen regulären Ausdruck angeben, der die Muster enthält, die bei der Einreihung in die Warteschlange nicht berücksichtigt werden sollen.

Häufige Muster, die man ignorieren sollte, sind:

• Pfade zum Speichern statischer Assets und Medien, z. B. /static-media/*
• Callback-URLs, die von Zahlungsanbietern von Drittanbietern erstellt wurden.
• JSON- und RSS-Feeds.

BeispielTicketingController.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.) CrowdHandler-Konfiguration einbinden.#

* Die öffentlichen und privaten Schlüssel finden Sie im Bereich „Konto → API“ des CrowdHandler-Verwaltungsbereichs.

über app.config oder web.config

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

Alternativ können sie direkt in den Filter eingespritzt werden.

using Crowdhandler.MVC5SDK;

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

* Eine vollständige Liste der konfigurierbaren Parameter und ihrer Standardeinstellungen finden Sie in Abschnitt 2b der NuGet-Dokumentation.

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

4.) CrowdHandler-JavaScript-Integration installieren#

Warum muss ich das tun, wenn ich CrowdHandler serverseitig integriere?

Um sicherzustellen, dass die Integration so schnell wie möglich ausgeführt wird, werden Funktionen, die nicht als geschäftskritisch gelten, über unsere JavaScript-Integration auf die Client-Seite ausgelagert.

Wenn die Funktion nicht geschäftskritisch ist, kann ich diesen Schritt dann überspringen?

Theoretisch ja, aber in der Praxis raten wir davon ab. Durch die Installation der JavaScript-Integration werden Funktionen wie die Überwachung der Seitenleistung und das „Smart Session Keep Alive“ aktiviert.

Ersteres ist eine Voraussetzung dafür, dass unsere Autotune -Funktion ordnungsgemäß funktioniert, und bietet zudem Einblick in die Leistung Ihrer Anwendung unter Last.

Letzteres synchronisiert die Sitzungsinformationen zwischen der Client-Seite und dem Backend von CrowdHandler und verhindert so, dass kürzlich aktive Benutzer, deren Inaktivität länger als die konfigurierte CrowdHandler-Sitzungsdauer gedauert hat, unnötigerweise zur erneuten Validierung an den Sitzungsvalidator von CrowdHandler weitergeleitet werden.

Wie installiere ich die JavaScript-Integration?

Das JavaScript kann über den Google Tag Manager installiert werden, indem Sie es direkt in den Head-Bereich Ihrer Master-Vorlage einbinden oder auf eine andere Weise, die für Sie am besten geeignet ist.

Hier finden Sie eine Anleitung zur Installation unserer JavaScript-Integration.

5.) Ändern Sie im CrowdHandler-Kontrollfeld den Integrationstyp auf .NET.#

Die Auswahl der Bereitstellung kann über den Domänenbildschirm erfolgen.

6.) Wie geht es nun weiter?#

Sobald Sie die Schritte zur .NET-Integration abgeschlossen haben, empfehlen wir Ihnen, einen Blick in unsere Einführungsanleitung zu werfen, die Ihnen dabei hilft, sich mit der Erstellung und Konfiguration von Warteräumen über das CrowdHandler-Kontrollpanel vertraut zu machen.