Vorbedingungen

Um die Volltextsuche über Azure Search nutzen zu können, müssen folgende Bedingungen erfüllt sein:

• Ein zur Verfügung stehender Azure Search-Dienst
• Ein API-Admin Schlüssel
• Ein API-Abfrage Schlüssel

Verfügbare Tabellen im Volltextindex

• Artikel
• Katalogartikel
• Artikelreferenzen (Debitor/Kreditor)
• Original Artikelnr. (NAI)

Azure Suche Einrichtung

Folgende Felder müssen bei der Einrichtung eingepflegt werden:

  Bei Änderungen der Felder Azure Index Kunden-ID, Azure Suche URL, API-Version und API Adminschlüssel wird der Wert des Feldes "API Adminschlüssel Verbindung getestet" zurückgesetzt und es können ohne erneute Verbindungsprüfung keine Suchanfragen mehr durchgeführt werden!

Azure Index Kunden-ID

Hier muss eine eindeutige, kundenindividuelle ID hinterlegt werden.
Der Index im Azure Search-Dienst wird gebildet aus AzureIndex Kunden-ID_Mandant_itemsearch, wodurch es möglich ist, mehrere Indizies (auch kundenübergreifend) in einem Dienst abzubilden.

Azure Suche URL

Hier wird die Basis-URL für den Azure Search Index hinterlegt. Die URL wird nur über das Azure Portal zur Verfügung gestellt.

API-Version

Um bei API-Änderungen keine Einbußen in der Funktionalität zu haben, muss bei jeden Kommunikation mit dem Azure Search-Dienst eine API-Version angegeben werden.
Format: JJJJ-MM-TT

Die faveo Volltextsuche benötigt derzeit zwingend die angegebene Version!

Suchmodus

Hier kann die Standardeinstellung für Suchoperationen hinterlegt werden (UND-/ODER-Verknüpfung).
Diese kann in der Suche vom Benutzer nach Wahl umgestellt werden. 

API Adminschlüssel

Dieser Schlüssel wird benötigt, um Änderungen am Azure Index vornehmen zu können (Erstellen, Aktualisieren, Löschen, etc.). Der Schlüssel
wird nur über das Azure Portal zur Verfügung gestellt.

API Adminschlüssel Verbindung getestet

(nur lesend)
Gibt an, ob der eingegebene API Adminschlüssel für den angegebenen Index gültig und durch die Verbindungsprüfung getestet wurde.

API Abfrageschlüssel

Dieser Schlüssel wird benötigt um Suchanfragen durchführen zu können. Es können im Azure Portal mehrere Abfrageschlüssel erstellt werden, um diese z.B. Kunden zuordnen zu können. Der Schlüssel wird nur über das Azure Portal zur Verfügung gestellt.

Ersteinrichtung

Nachdem die Parameter zur Volltextsuche hinterlegt wurden, müssen folgende Schritte zur weiteren Einrichtung erfolgen:

• Aktion „Verbindungsprüfung“ auswählen

1. Aktion „Initialisiere Azure Search“
   
   1. Abfrage, ob die Synchronisierung direkt in der aktuellen User-Session erfolgen soll
   2. Für jeden Datensatz wird nun ein Eintrag in die Synchronisierungstabelle geschrieben (das kann je nach Anzahl der Datensätze etwas dauern)
   3. Wenn „Ja“ angeklickt wird, werden alle Synchronisierungseinträge in der aktuellen UserSession synchron verarbeitet (mit Fortschrittsdialog)
   4. Wenn „Nein“, dann müssen die Synchronisierungseinträge über die Aufgabenwarteschlange asynchron verarbeitet werden