Freigeben über

Entwickeln einer neuen Kaizala-Aktion

  • Artikel

Ein Kaizala-Aktionspaket ist eine ZIP-Datei, die alle im Stammverzeichnis enthaltenen manifest- und ressourcenrelevanten Dateien enthält.

Erstellen Sie zunächst einen neuen Ordner auf Ihrem PC, um ihn zu Ihrem Arbeitsverzeichnis zu machen.

Sie benötigen einen Code-Editor, um mit verschiedenen Arten von Webressourcen & Manifestdateien zu arbeiten.

Wir empfehlen den Visual Studio Code-Editor. Sie können es hier herunterladen.

Definieren des App-Modells

Die Kaizala-Aktionen unterstützen derzeit formularbasierte Datenmodelle, die zum Erstellen, Sammeln und Aggregieren von Daten mithilfe der Kaizala-Aggregationsdienste verwendet werden können.

Daher müssen Sie zunächst die "Fragen" definieren, die Sie einschließen müssen, um ein Formularobjekt zu erstellen.

Informationen zum Erstellen des App-App-Modellmodells finden Sie im JSON-Schema der App .

Definieren der Erstellungsansicht

Wenn eine neue instance der Kaizala-Aktion über die Aktionspalette der App aufgerufen wird, wird die als CreationView markierte HTML-Ressource gerendert. Das Ziel dieser Erstellungsansicht besteht darin, eine neue instance des Form-Objekts zu erstellen, wie im App-Modell definiert.

Um mit den Kaizala-Aggregationsdiensten zu interagieren und das neue Formular instance zu erstellen, können Sie auf die APIs im KASClient JS SDK verweisen. Sie müssen die KASClient JS-Datei herunterladen und in Ihr Paket einschließen.

Erstellen Sie eine neue HTML-Datei, die diese Erstellungsansicht darstellt. Rufen Sie in der entsprechenden Javascript-Datei das KASClient JS SDK auf, und erstellen Sie ein Formularobjekt.

Erstellen der Paketmanifestdatei

Nachdem Sie nun den Anschein haben, was Sie erreichen möchten und erfolgreich eine Ansicht erstellt haben, können Sie mit dem Erstellen ihrer Paketmanifestdatei beginnen.

Die Kaizala-Paketmanifestdatei enthält wichtige Informationen für die Kaizala-Plattform, damit sie Ihre benutzerdefinierte Kaizala-Aktion erkennen und ausführen kann.

Lesen Sie das JSON-Schema des Paketmanifests , um das Paketmanifest Ihrer Aktion zu erstellen.

An diesem Punkt sollten Sie auch eine Symboldatei für Ihre benutzerdefinierte Aktion in das Paket einschließen.

Verweisen Sie auf die HTML-Datei ihrer Erstellungsansicht im Paketmanifest, und ordnen Sie sie dem relevanten Parameterobjekt zu.

Konfigurieren der Karte, die auf der Unterhaltungscanvas angezeigt wird

Wenn eine neue instance einer Kaizala-Aktion erstellt und in einer Unterhaltung gepostet wird, wird auf der Canvas eine Aktionskarte angezeigt, damit andere Benutzer in der Unterhaltung ihre Antworten anzeigen und übermitteln können.

Informationen zum Anpassen der Chatkartenansicht finden Sie unter Anpassen von ChatCardView.

Definieren der Antwort-& Zusammenfassungsansichten

Wenn Benutzer versuchen, Details anzuzeigen und auf eine instance der Kaizala-Aktion zu reagieren, die in einer Unterhaltung gepostet wurde, können sie zwei Arten von Ansichten sehen.

  • Antwortansicht, wenn sie auf die primäre Handlungsaufforderungsschaltfläche tippen und eine Antwort posten möchten
  • Zusammenfassungsansicht, wenn sie auf den Karte-Header tippen und die aggregierte Ansicht aller veröffentlichten Reesponses anzeigen möchten

Erstellen Sie eine oder mehrere HTML-Dateien nach Bedarf, damit Sie Ihre Aktion definieren und sie den relevent-Parametern in der Paketmanifestdatei zuordnen können.

Um mit den Kaizala Aggregation Services und dem Kaizala Native-Client zu interagieren, um Informationen abzurufen, eine Antwort zu übermitteln oder aggregierte Antworten zu erhalten, können Sie auf die APIs im KASClient JS SDK verweisen.

Erstellen der ZIP-Datei

Wählen Sie alle Dateien in Ihrem Arbeitsverzeichnis aus, und erstellen Sie eine neue ZIP-Datei für Ihr Paket. Stellen Sie sicher, dass alle Dateien im Stammverzeichnis des Pakets vorhanden sind.