Home
Home
Englische Version
Support
Impressum
25.3 Release ►

Start Chat with Collection

    Main Navigation

    • Vorbereitung
      • Einrichten InSpire G7 Primärsystem und Standby Appliances
      • Erstellen einer InSpire-VM auf Hyper-V
      • Initiale Inbetriebnahme für G7 Appliances
      • Konnektoren
    • Datenquellen
      • Anleitung zur Datenintegration mithilfe eines SQL Datenbank-Beispiels
      • Handbuch - Mindbreeze InSpire Insight Apps in Salesforce
      • Indizierung benutzerspezifischer Eigenschaften (SharePoint 2013 Connector)
      • Indizierung benutzerspezifischer Objekttypen (Documentum)
      • Installation & Konfiguration - Atlassian Confluence Sitemap Generator Add-On
      • Installation & Konfiguration - Caching Principal Resolution Service
      • Installation & Konfiguration - Mindbreeze InSpire Insight Apps in Microsoft SharePoint On-Prem
      • Konfiguration - Atlassian Confluence Connector
      • Konfiguration - Best Bets Connector
      • Konfiguration - Box Connector
      • Konfiguration - COYO Connector
      • Konfiguration - Data Integration Connector
      • Konfiguration - Datenbank Connector
      • Konfiguration - Documentum Connector
      • Konfiguration - Dropbox Connector
      • Konfiguration - Egnyte Connector
      • Konfiguration - GitHub Connector
      • Konfiguration - Google Drive Connector
      • Konfiguration - GSA Adapter Service
      • Konfiguration - HL7 Connector
      • Konfiguration - IBM Connections Connector
      • Konfiguration - IBM Lotus Connector
      • Konfiguration - Jira Connector
      • Konfiguration - JVM Launcher Service
      • Konfiguration - LDAP Connector
      • Konfiguration - Microsoft Azure Principal Resolution Service
      • Konfiguration - Microsoft Dynamics CRM Connector
      • Konfiguration - Microsoft Exchange Connector
      • Konfiguration - Microsoft File Connector (Legacy)
      • Konfiguration - Microsoft File Connector
      • Konfiguration - Microsoft Graph Connector
      • Konfiguration - Microsoft Loop Connector
      • Konfiguration - Microsoft Project Connector
      • Konfiguration - Microsoft SharePoint Connector
      • Konfiguration - Microsoft SharePoint Online Connector
      • Konfiguration - Microsoft Stream Connector
      • Konfiguration - Microsoft Teams Connector
      • Konfiguration - Salesforce Connector
      • Konfiguration - SCIM Principal Resolution Service
      • Konfiguration - SemanticWeb Connector
      • Konfiguration - ServiceNow Connector
      • Konfiguration - Web Connector
      • Konfiguration - Yammer Connector
      • Mindbreeze InSpire Insight Apps in Microsoft SharePoint Online
      • Mindbreeze Web Parts in Microsoft SharePoint
      • Whitepaper - Web Connector Erweiterte JavaScript Anwendungsfälle
    • Konfiguration
      • CAS Authentifizierung
      • Cookie Authentifizierung
      • Handbuch - AI Chat
      • Handbuch - Erstellung einer AWS 10M InSpire Applikation
      • Handbuch - Erstellung einer AWS 1M InSpire Applikation
      • Handbuch - Erstellung einer AWS 2M InSpire Applikation
      • Handbuch - Erstellung einer Google Compute Cloud Virtual Machine InSpire Applikation
      • Handbuch - Erstellung einer Oracle Cloud 10M InSpire Applikation
      • Handbuch - Erstellung einer Oracle Cloud 1M InSpire Applikation
      • Handbuch - MMC_ Services
      • Handbuch - Natural Language Question Answering (NLQA)
      • Handbuch - SSO mit Microsoft AAD oder AD FS
      • Handbuch - Text Classification Insight Services
      • I18n Item Transformation
      • JWT Authentifizierung
      • Konfiguration - Alternative Suchvorschläge und automatische Sucherweiterung
      • Konfiguration - Backend Credentials
      • Konfiguration - Benachrichtigungen
      • Konfiguration - CJK Tokenizer Plugin
      • Konfiguration - CSV Metadata Mapping Item Transformation Service
      • Konfiguration - Entity Recognition
      • Konfiguration - Export Funktionalität
      • Konfiguration - External Query Service
      • Konfiguration - Filter Plugins
      • Konfiguration - Gesammelte Ergebnisse
      • Konfiguration - GSA Late Binding Authorization
      • Konfiguration - Identity Conversion Service - Replacement Conversion
      • Konfiguration - InceptionImageFilter
      • Konfiguration - Index-Servlets
      • Konfiguration - InSpire AI Chat und Insight Services für Retrieval Augmented Generation
      • Konfiguration - Item Property Generator
      • Konfiguration - Kerberos Authentfizierung
      • Konfiguration - Management Center Menü
      • Konfiguration - Metadata Reference Builder Plugin
      • Konfiguration - Metadaten Anreicherung
      • Konfiguration - Mindbreeze InSpire
      • Konfiguration - Mindbreeze Proxy Umgebung (Remote Connector)
      • Konfiguration - Outlook Add-In
      • Konfiguration - Personalisierte Relevanz
      • Konfiguration - Plugin Installation
      • Konfiguration - Principal Validation Plugin
      • Konfiguration - Profile
      • Konfiguration - Reporting Query Log
      • Konfiguration - Reporting Query Performance Tests
      • Konfiguration - Request Header Session Authentisierung
      • Konfiguration - Verteilte Konfiguration (Windows)
      • Konfiguration - Vokabulare für Synonyme und Autovervollständigung
      • Konfiguration von Vorschaubildern
      • Mindbreeze Personalization
      • Mindbreeze Property Expression Language
      • Mindbreeze Query Expression Transformation
      • SAML Authentifizierung
      • Spracherkennung mit dem LanguageDetector Plugin
      • Trusted Peer Authentication für Mindbreeze InSpire
      • Verwendung von InSpire-Snapshots in einer CI_CD-Umgebung
    • Betrieb
      • Anpassung der InSpire Host OpenSSH Einstellungen - LoginGraceTime auf 0 setzen (Mitigation für CVE-2024-6387)
      • app.telemetry Statistiken zu Suchanfragen
      • Bereitstellen von app.telemetry Informationen mittels SNMPv3 auf G7 Appliances
      • CIS Level 2 Hardening - SELinux in den Modus Enforcing versetzen
      • Handbuch - Administration von Insight Services für Retrieval Augmented Generation
      • Handbuch - Filemanager
      • Handbuch - Indizierungs- und Suchlogs
      • Handbuch - Kommandozeilenwerkzeuge
      • Handbuch - Sichern & Wiederherstellen
      • Handbuch - Updates und Downgrades
      • Handbuch - Verteilter Betrieb (G7)
      • Index Betriebskonzepte
      • Inspire Diagnose und Ressourcen Monitoring
      • Konfiguration - app.telemetry Dashboards für Nutzungsanalyse
      • Konfiguration - Nutzungsanalyse
      • Löschung der Festplatten
      • Wiederherstellen des Lieferzustandes
    • Anwenderhandbuch
      • Browser Extension
      • Cheat Sheet
      • iOS App
      • Tastaturbedienung
    • SDK
      • api.chat.v1beta.generate Schnittstellenbeschreibung
      • api.v2.alertstrigger Schnittstellenbeschreibung
      • api.v2.export Schnittstellenbeschreibung
      • api.v2.personalization Schnittstellenbeschreibung
      • api.v2.search Schnittstellenbeschreibung
      • api.v2.suggest Schnittstellenbeschreibung
      • api.v3.admin.SnapshotService Schnittstellenbeschreibung
      • Debugging (Eclipse)
      • Einbetten des Insight App Designers
      • Entwicklung eines API V2 Search Request Response Transformer
      • Entwicklung eines Query Expression Transformer
      • Entwicklung von Insight Apps
      • Entwicklung von Item Transformation und Post Filter Plugins mit der Mindbreeze SDK
      • Java API Schnittstellenbeschreibung
      • OpenAPI Schnittstellenbeschreibung
      • SDK Übersicht
    • Release Notes
      • Release Notes 20.1 Release - Mindbreeze InSpire
      • Release Notes 20.2 Release - Mindbreeze InSpire
      • Release Notes 20.3 Release - Mindbreeze InSpire
      • Release Notes 20.4 Release - Mindbreeze InSpire
      • Release Notes 20.5 Release - Mindbreeze InSpire
      • Release Notes 21.1 Release - Mindbreeze InSpire
      • Release Notes 21.2 Release - Mindbreeze InSpire
      • Release Notes 21.3 Release - Mindbreeze InSpire
      • Release Notes 22.1 Release - Mindbreeze InSpire
      • Release Notes 22.2 Release - Mindbreeze InSpire
      • Release Notes 22.3 Release - Mindbreeze InSpire
      • Release Notes 23.1 Release - Mindbreeze InSpire
      • Release Notes 23.2 Release - Mindbreeze InSpire
      • Release Notes 23.3 Release - Mindbreeze InSpire
      • Release Notes 23.4 Release - Mindbreeze InSpire
      • Release Notes 23.5 Release - Mindbreeze InSpire
      • Release Notes 23.6 Release - Mindbreeze InSpire
      • Release Notes 23.7 Release - Mindbreeze InSpire
      • Release Notes 24.1 Release - Mindbreeze InSpire
      • Release Notes 24.2 Release - Mindbreeze InSpire
      • Release Notes 24.3 Release - Mindbreeze InSpire
      • Release Notes 24.4 Release - Mindbreeze InSpire
      • Release Notes 24.5 Release - Mindbreeze InSpire
      • Release Notes 24.6 Release - Mindbreeze InSpire
      • Release Notes 24.7 Release - Mindbreeze InSpire
      • Release Notes 24.8 Release - Mindbreeze InSpire
      • Release Notes 25.1 Release - Mindbreeze InSpire
      • Release Notes 25.2 Release - Mindbreeze InSpire
      • Release Notes 25.3 Release - Mindbreeze InSpire
    • Sicherheit
      • Bekannte Schwachstellen
    • Produktinformation
      • Produktinformation - Mindbreeze InSpire - Standby
      • Produktinformation - Mindbreeze InSpire
    Home

    Path

    Sure, you can handle it. But should you?
    Let our experts manage the tech maintenance while you focus on your business.
    See Consulting Packages

    Mindbreeze InSpire SDK Plugins
    Mindbreeze Item Transformation und Post Filter Plugins

    EinführungPermanenter Link zu dieser Überschrift

    Für die Erstellung und Bereitstellung der Beispiele aus diesem Dokument wird die folgende Software von Drittanbietern benötigt:

    • Java SE Development Kit: Version 1.8 oder neuer
    • Eclipse IDE für Java-Entwickler

    Installation des Mindbreeze Software Development ToolkitPermanenter Link zu dieser Überschrift

    Wenn Sie Microsoft Windows verwenden: Installieren Sie das Mindbreeze SDK, indem Sie MesSDKSetup.exe ausführen.

    Wenn Sie Linux oder OSX verwenden: Entpacken Sie die Datei mes-devel-<version>.zip in einen Ordner Ihrer Wahl und fügen Sie den Ordner SDK/bin aus dem Archiv zu Ihrer Path-Variable hinzu.

    Ein Mindbreeze-Plugin-Projekt generierenPermanenter Link zu dieser Überschrift

    Das Mindbreeze Software Development Toolkit enthält ein Werkzeug zum Generieren von Mindbreeze-Plugin-Projekten: mesjavaplugin.bat für Microsoft Windows-Installationen und mesjavaplugin.sh für Unix-basierte Systeme. Das Tool kann für die Generierung der folgenden Mindbreeze Erweiterungstypen verwendet werden:

    • datasource: Crawler-, Kontext- und Autorisierungs-Plugin für eine bestimmte Datenquelle.
    • filter: Filter-Plugin für einen bestimmten Datentyp.
    • postfilter: Post-Filter-Transformations-Plugin.
    • itemtransformer: Item Transformation Plugin.

    Wenn das Werkzeug mesjavaplugin ohne Parameter aufgerufen wird, zeigt es seine Verwendung anhand von Beispielen an:

    Der Parameter <name> ist der Name des Plugins. Das Projekt wird in einem Ordner mit dem Namen dieses Parameters in Kleinbuchstaben im aktuellen Pfad erstellt.

    Der Parameter <base package> ist das Java-Paket, in dem die Quelldateien erstellt werden.

    Beispiel 1: Ein Post Filter Transformation PluginPermanenter Link zu dieser Überschrift

    Führen Sie die folgenden Schritte aus, um ein Post-Filter-Transformation Plugin zum Bearbeiten oder Hinzufügen benutzerdefinierter Metadaten zu erstellen und bereitzustellen:

    1. Erstellen Sie das Plugin-Projekt: mesjavaplugin.sh postfilter MetadataProcessor com.mycompany
    1. Navigieren Sie zum Ordner „metadataprocessor“ in Ihrem aktuellen Pfad.
    1. Importieren Sie das neu erstellte Projekt in Ihre Eclipse IDE:

    1. Nach dem erfolgreichen Import des Projekts finden Sie eine Stub-Implementierung des Plugins in der Datei MetadataProcessorPostFilter.java:

    Hinweis: Der Name der Java-Datei ist <name>PostFilter.java, wobei <name> der Name des Plugin-Parameters aus dem vorherigen Schritt ist.

    1. Passen Sie den Quellcode an Ihre Bedürfnisse an. Beispielsweise würde die folgende Implementierung ein Metadatum namens “meta” mit dem String-Wert „value” hinzufügen:

    private void processRequest(FilterAndIndexRequest.Builder request) {

        // Clone the request

        Metadata.Builder metadataBuilder = request.getContentBuilder().getMetadataBuilder();

        

        NamedValue.Builder namedValueBuilder = NamedValue.newBuilder();

        namedValueBuilder.setName("meta");

        namedValueBuilder.addValue(ValueHelper.newBuilder("value"));

        metadataBuilder.addMetadatum(namedValueBuilder)

    }

    1. Erstellen Sie das Plugin-Archiv, indem Sie das Skript build.bat auf Windows-Systemen oder build.sh auf Unix-Systemen im Projektverzeichnis ausführen. Wenn der Vorgang erfolgreich war, sollte ein Archiv mit dem Namen <name>-postfilter.zip erstellt worden sein. Auch hier ist <name> der vorher angegebene Parameter für den Plugin-Namen.
    1. Das Plugin kann nun über den Tab “Plugins” im Management Center installiert werden:

    1. Nach der erfolgreichen Installation kann das Plugin für jeden Filter-Service aktiviert werden:

    Beispiel 2: Ein Item-Transformer PluginPermanenter Link zu dieser Überschrift

    Führen Sie die folgenden Schritte aus, um ein Item-Transformer-Plugin zum Bearbeiten oder Hinzufügen benutzerdefinierter Metadaten zu erstellen:

    1. Erstellen Sie das Plugin-Projekt: mesjavaplugin.sh itemtransformer MetadataProcessor com.mycompany
    1. Navigieren Sie zum Ordner metadataprocessor in Ihrem aktuellen Pfad.
    1. Importieren Sie das neu erstellte Projekt in ihrer Eclipse IDE (wie im vorherigen Beispiel).
    1. Nach dem erfolgreichen Import des Projekts finden Sie eine Stub-Implementierung des Plugins in der Datei MetadataProcessorItemTransformerService.java:

    1. Erweitern Sie den Code entsprechend Ihren Anforderungen. Dieses Beispiel fügt erneut ein Metadatum namens „meta“ mit dem Wert „value“ hinzu:

        private void processItem(Item.Builder itemBuilder) {

        itemBuilder.addProperty(

        NamedValue.newBuilder()

        .setName("meta")

        .addValue(ValueHelper.newBuilder("value"))

        );

    }

    1. Erstellen Sie das Plugin-Archiv, indem Sie das Skript build.bat auf Windows-Systemen oder build.sh auf Unix-Systemen im Projektverzeichnis ausführen. Wenn der Vorgang erfolgreich war, sollte ein Archiv mit dem Namen <name>-postfilter.zip erstellt worden sein. Auch hier ist <name> der vorher angegebene Parameter für den Plugin-Namen.
    1. Das Plugin kann nun über den Tab “Plugins” im Management Center installiert werden:

    1. Nach der erfolgreichen Installation steht das Plugin für alle Index Services zur Verfügung.

    Plugin-KonfigurationPermanenter Link zu dieser Überschrift

    Wie Sie in beiden Beispielen sehen konnten, ist es möglich, Eigenschaften für die installierten Plugins über die Konfigurationsschnittstelle zu definieren, indem benutzerdefinierte Plugin-Eigenschaften hinzugefügt werden.

    Diese Konfigurationseigenschaften sind im Quellcode des Plugins über die Properties-Map zugänglich:

    Map<String, List<String>> properties = null;

    Die Init-Methode, die die Konfigurationseigenschaften abruft, wird automatisch aufgerufen, wenn das Plugin die Schnittstelle com.mindbreeze.enterprisesearch.mesapi.Initializable implementiert.

    Das vorherige Beispiel eines Item Transformer Plugins, das nun einen Metadatenwert auf einen Konfigurationsparameter namens „meta“ setzt, sieht wie folgt aus:

        private void processItem(Item.Builder itemBuilder) {

        if (properties != null && properties.containsKey("meta")) {

        List<String> values = properties.get("meta");

        if (values != null && !values.isEmpty()) {

        String value = values.get(0);

        if (value != null) {

        itemBuilder.addProperty(

                NamedValue.newBuilder()

                .setName("meta")

                .addValue(ValueHelper.newBuilder(value))

                );

        }

        }

        }

        }

    Abschnitt zur Konfiguration der Plugin-BeschreibungPermanenter Link zu dieser Überschrift

    Die Plugin-Beschreibung „plugins.xml“ beschreibt die im Archiv verfügbaren Plugins. Die Gliederung ist wie folgt:

    version

    plugins

    Plugin

    id

    kind

    extension

    code

    wenn “kind” CODE ist

    properties

    für vordefinierte Eigenschaften, die an das Plugin übergeben werden

    config_options

    • Das Element config_options selbst ist eine Sprache zur Beschreibung von Elementen der Konfigurationsbenutzeroberfläche und ermöglicht es dem Plugin-Entwickler daher, die Mindbreeze InSpire-Konfigurationsschnittstelle zu erweitern. Als Beispiel erweitert die folgende Konfiguration die Konfigurationsbenutzeroberfläche um die Eigenschaft „meta“.  Zum Zeitpunkt der Erstellung dieser Dokumentation unterstützt die Konfigurationsschnittstelle nur englische Übersetzungen. Unterstützte Eingabetypen sind TEXT, NUMBER, BOOLEAN, TEXTAREA, SELECT, PASSWORD, CREDENTIAL. Standardwerte können über default_string oder default_numeric hinzugefügt werden. Auswahloptionen können mit dem Element select_option definiert werden.

          <config_option>

            <Group>

              <label>

                <LangString>

                  <lang>en</lang>

                  <value>Base Configuration</value>

                </LangString>

              </label>

              <level>DEFAULT_LEVEL</level>

              <option>

                <Option>

                  <name>meta</name>

                  <input>TEXT</input>

                  <hint>The value that is added as the meta property.</hint>

                  <label>

                    <LangString>

                      <lang>en</lang>

                      <value>meta property value</value>

                    </LangString>

                  </label>

                  <option />

                </Option>            

              </option>

            </Group>

          </config_option>

    PDF herunterladen

    • Entwicklung von Item Transformation und Post Filter Plugins mit der Mindbreeze SDK

    Inhalt

    • Einführung
    • Installation des Mindbreeze Software Development Toolkit
    • Ein Mindbreeze-Plugin-Projekt generieren
    • Beispiel 1: Ein Post Filter Transformation Plugin
    • Beispiel 2: Ein Item-Transformer Plugin
    • Plugin-Konfiguration

    PDF herunterladen

    • Entwicklung von Item Transformation und Post Filter Plugins mit der Mindbreeze SDK