Suche

Cloud Talent Solution ermöglicht Nutzern, nach Jobs zu suchen, die Sie im Cloud Talent Solution-Index gespeichert haben. Die Jobsuche ist anpassbar und kann an Ihre geschäftlichen Anforderungen angepasst werden. Diese Seite bietet eine Übersicht über die Suchfunktionen der CTS-Jobsuche.

Suchanfragen erstellen

Um eine Jobsucheanforderung zu stellen, senden Sie eine POST-Anforderung an den Endpunkt jobs:search und übergeben Sie die Suchdaten im Hauptteil.

Häufig verwendete Felder (optional)

• JobQuery: Das JobQuery Objekt besteht aus zwei Komponenten, einer query Zeichenfolge und den Filtern, die auf diese Zeichenfolge angewendet werden. Mit dieser Funktion können Nutzer anhand eines oder mehrerer Filter (Standort, Anfahrtszeit, Bezahlung usw.) nach einem Suchanfragestring suchen (z. B. "Kommunikationsassistent"). Weitere Informationen sowie eine Liste der verfügbaren Filteroptionen finden Sie unter Suchfilter.

• searchMode: Gibt den anzuwendenden Suchtyp an. Optionen sind:

  • JOB_SEARCH (empfohlen): Dies ist der Standardsuchmodus, der nach allen Jobobjekten sucht. Die relevantesten Jobs werden in der Reihenfolge ihrer Relevanz für die Suchanfrage an den Nutzer geliefert.
  • FEATURED_JOB_SEARCH: Sucht nur nach Jobobjekten mit einem promotionValue größer als 0. Die Ergebnisse werden nach dem höchsten promotionValue zuerst geordnet. Im Falle eines Unentschieden wird die Relevanz verwendet, um die Position zu bestimmen. Weitere Informationen finden Sie unter Hervorgehobene Jobs.

• jobView: Definiert die Anzahl der Felder, die für jedes übereinstimmende Jobobjekt zurückgegeben werden. Kann JOB_VIEW_SMALL (Standard), JOB_VIEW_MINIMAL oder JOB_VIEW_FULL sein. Beschreibungen für jede Option finden Sie in der Referenzdokumentation JobView.

• orderBy: Die Sortierreihenfolge für zurückgegebene Jobs. Zulässige Werte finden Sie in der Referenzdokumentation. Standardmäßig wird absteigend nach Relevanz sortiert (RELEVANCE_DESC).

Pflichtfelder

Folgendes Feld ist erforderlich:

• requestMetadata: Enthält Nutzer- und Sitzungsinformationen für diese Suchanforderung.

RequestMetadata

Jede Such- und Histogrammanforderung muss ein RequestMetadata -Objekt enthalten. Dieses Objekt enthält Informationen zum Nutzer, von dem die Suche ausgeht. Dies ist aus zwei Hauptgründen wichtig:

• Nutzerkonsistenz: Cloud Talent Solution führt mehrere Versionen der zugrunde liegenden Modelle gleichzeitig aus, um die Suchrelevanz zu verbessern. CTS bietet Jobsuchenden (durch userId, sessionId und domain gekennzeichnet) eine einheitliche Umgebung. Diese Felder sollten verschleiert sein.

• Suchverbesserungen: Die Optimierungsalgorithmen basieren auf den Informationen in den Feldern RequestMetadata sowie den von Ihnen angegebenen Daten der Arbeitssuchenden. Damit können relevantere Suchergebnisse geliefert werden.

Suchoperatoren verwenden

Die Suchoperatoren in der folgenden Tabelle können allein oder in Kombination verwendet werden.

Operator	Beschreibung
( )	Gruppiert einen oder mehrere Suchbegriffe.
OR	Sucht nach Ergebnissen, die für die Suchbegriffe oder Gruppen von Suchbegriffen auf jeder Seite des Operators relevant sind. Beispiel: "software OR java" gibt Jobs mit entweder "Software" oder "Java" in ihren Metadaten zurück.
AND	Sucht nach Ergebnissen, die für die Suchbegriffe oder Gruppen von Suchbegriffen auf beiden Seiten des Operators relevant sind. Beispiel: "(software OR java) AND (marketing)" gibt Jobs zurück, die entweder für beide "Software" und "Marketing", oder Jobs sind, die für beide relevant sind "Java" und "Marketing".
NOT	Schließt Ergebnisse aus, die für den Suchbegriff oder die Gruppe von Suchbegriffen direkt nach dem Operator relevant sind. Der Suchbegriff oder die Gruppe von Suchbegriffen muss in Klammern stehen.
-	Schließt Ergebnisse aus, die für den Suchbegriff oder die Gruppe von Suchbegriffen nach dem Operator relevant sind. Beispiel: "software -java" gibt Jobs zurück, die für "Software" relevant sind, aber schließt Jobs aus, die für "Java" relevant sind.
Anforderung oder Anforderung:	Gibt Jobs mit der angegebenen Anforderungs-ID zurück. Beispiel: req:1234 gibt Jobs mit der Anforderungs-ID 1234 zurück.

Anfragen von Jobsuchenden

Suchbegriffe können auch als tatsächliche jobbezogene Entitäten erkannt werden. Wenn ein Nutzer beispielsweise nach "Praktikant" fragt, behandelt Cloud Talent Solution dies als Beschäftigungstyp INTERN und filtert nach Jobs mit der Bezeichnung EMPLOYMENT_TYPE - INTERN. Daher würde auch ein Jobobjekt mit "intern" in seiner Beschreibung nicht zurückgegeben, wenn das Feld EMPLOYMENT_TYPE für diesen Job auf etwas anderes gesetzt wäre.

Hinweis: Es ist sehr wichtig, die Beschäftigungsart für jedes Jobobjekt anzugeben. Sonst wirkt sich dies negativ auf die Nutzerfreundlichkeit für den Jobsuchenden aus.

Fehlerbehebung

Jede Suchanforderung generiert eine eindeutige Suche requestID im Jobsuchensystem. Mit diesem Wert werden die Parameter dieser Suche und die Antwort nachverfolgt. Dies ist für die Fehlerbehebung in Zusammenhang mit bestimmten Suchanfragen oder CRUD-Anfragen wichtig und sollte entsprechend protokolliert werden. Die requestID wird im Feld ResponseMetadata im Suchantworttext oder im zugehörigen CRUD-Aufrufantwortobjekt zurückgegeben.

Bei Supportproblemen, die sich auf Relevanz, Suchanfragen, Indexierungsanfragen usw. beziehen, wenden Sie sich bitte an ein Ticket einreichen mit unserem Support-Team und relevant einschließen requestID s oder die Anfragen selbst.

Datenprobleme mit der Console diagnostizieren

Auf der Seite Jobs und Unternehmen in der CTS-Konsole können Sie Probleme im Zusammenhang mit Jobdaten diagnostizieren. Wenn Sie Datenprobleme beheben müssen, rufen Sie Jobstatistiken auf, suchen nach Metadaten bestimmter Jobs und exportieren Daten nach Job, Unternehmen oder Mandant. Weitere Informationen zur Verwendung dieser Tools finden Sie in der Dokumentation im Abschnitt Job- und Unternehmensdaten.

Ergebniszahlen

Die Ergebniszahl wird verwendet, um dem Jobsuchenden die Anzahl der Suchergebnisse mitzuteilen. Sie entspricht nicht immer den Histogrammergebnissen oder der tatsächlichen Anzahl gelieferter Jobs. Die Jobsuche gibt maximal 5000 Jobs zurück.

Paginierung (optional)

Standardmäßig gibt die Jobsuche 100 Ergebnisse in einem einzigen Aufruf zurück (oder weniger, wenn die Gesamtzahl der Ergebnisse weniger als 100 beträgt). Um mehr als 100 Ergebnisse anzuzeigen, können Sie die Paginierung implementieren. Wenn die Gesamtzahl der Ergebnisse das Maximum von 5000 überschreitet, sind alle Seiten nach der Seite mit dem 5000. Ergebnis leer. Die Felder unter steuern die Paginierung:

• pageSize: Die Anzahl der zurückgegebenen Ergebnisse
• nextPageToken: Ein eindeutiges Token, das mit den Ergebnissen jeder Seite der Suchergebnisse zurückgegeben wird und die Startposition für die nächste Ergebnisseite angibt. Dieses Feld ist leer, wenn keine weiteren Ergebnisse vorhanden sind.
• offset: Gibt den Versatz zwischen dem Relevanzranking des oben auf einer bestimmten Seite zurückgegebenen Jobs und 1 (dem relevantesten zurückgegebenen Job) an. Als Beispiel führt ein Nutzer eine Suche durch und pageSize wird auf 10 gesetzt. Die erste Seite gibt den Job Nr. 1 oben zurück, daher ist der Wert offset für diese Seite 0. Auf der nächsten Seite wird Job Nr. 11 oben zurückgegeben. offset für diese Seite ist 10.

Es gibt zwei Möglichkeiten, die Paginierung zu implementieren. Mit pageSize und nextPageToken können Sie direkt auf die nächste Ergebnisseite verweisen (jede Seite hat einen neuen nextPageToken -Wert, der auf die nachfolgende Seite verweist). Wenn Sie diese Methode verwenden, beginnen Sie immer oben in den Ergebnissen und blättern in sequentieller Reihenfolge durch. Alternativ können Sie pageSize mit offset verwenden, um direkt anzugeben, welches nummerierte Ergebnis oben auf jeder Seite angezeigt wird. Wenn Sie offset anstelle von nextPageToken verwenden, können Sie zu einem beliebigen Punkt in der Ergebnismenge springen.

Wir empfehlen, die Seitengröße auf 20 Ergebnisse oder weniger festzulegen, um Latenzprobleme zu vermeiden. Führen Sie als Best Practice einen separaten Suchaufruf pro Seite aus, die für den Jobsuchenden gerendert wird. Die Alternative, eine große Anzahl von Jobs mithilfe eines einzigen Suchaufrufs zu liefern und die Paginierung auf der Clientseite auszuführen, beeinträchtigt die Lernfähigkeit des Modells für maschinelles Lernen über das Jobs Analytics Framework.

Wenn Sie den Seitenumbruch in allen Feldern außer pageSize verwenden, müssen nextPageToken und offset gleich bleiben. Wenn diese Felder nicht übereinstimmen, kann die Reihenfolge der in den Ergebnissen zurückgegebenen Jobs inkonsistent sein.

Rechtschreibprüfung

Die Rechtschreibprüfung ist eine optionale Funktion einer CTS-Suchanfrage. Sie ermittelt potenziell falsch geschriebene Suchbegriffe, korrigiert sie und liefert Ergebnisse auf Basis der korrigierten Suchanfrage. Wenn die Rechtschreibprüfung aktiviert ist und ein Jobsuchender beispielsweise nach "Manaer" statt "Manager" sucht, liefert CTS Jobs für "Manager". Die Rechtschreibprüfung kann aktiviert/deaktiviert werden, indem das Feld disableSpellCheck der Suchanforderung festgelegt wird. Wenn die Rechtschreibprüfung aktiviert ist, finden Sie die korrigierte Abfrage in der Suchantwort im Feld spellResult.