--- title: "How to Set Query Parameters" slug: "how-to-set-query-parameters" updated: 2025-01-08T14:16:06Z published: 2025-01-08T14:16:06Z canonical: "support.tulip.co/how-to-set-query-parameters" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Wie man Abfrageparameter festlegt *Lernen Sie die Grundlagen der Arbeit mit Abfrageparametern in Ihren HTTP-Connector-Funktionen in Übereinstimmung mit der API-Dokumentation.* Abfrageparameter ermöglichen es Ihnen, die Ergebnisse einer Connector-Funktion zu verfeinern und anzupassen. Verwenden Sie Parameter, um zu sortieren, zu filtern, Grenzen zu setzen, einen Index zu verschieben und vieles mehr. Dieser Artikel verwendet die Parameter der Tulip Table API, aber andere APIs können andere Parameteranforderungen haben. Überprüfen Sie die Dokumentation, um sicherzustellen, dass Sie die korrekte Syntax und Spezifikationen verwenden. ## Abfragen mit Filtern Filter können sehr nützlich sein, um nur die Daten zu extrahieren, an denen Sie interessiert sind. Die Syntax dieser Filter kann manchmal ein wenig kompliziert sein. Im Folgenden wird erläutert, wie jeder Filter im Beispiel einer GET-Abfrage für Datensätze gebildet wird, gefolgt von einem vollständigen Beispiel. **Den Feldnamen** für benutzerdefinierte Felder wird immer eine fünfstellige Kennung vorangestellt. Diese können am einfachsten nach einer GET-All-Anfrage gefunden werden, um den wahren Namen des Feldes zu überprüfen. - Beispiel. "Feld"="maytq_scrap_count" **Argumentwerte** sind oft einfach. Wenn es sich um einen Textwert handelt, müssen Sie ihn in Anführungszeichen setzen. - Beispiel. "arg":15 Passen Sie den **Funktionstyp** an, den Sie verwenden möchten. - Bsp. "functionType": "greaterThan" Eine vollständige Anfrage hierfür könnte etwa so aussehen: `https://brian.tulip.co/api/v3/tables/W2HPvyCZrjMMHTiip/records?limit=100&sortBy=\_sequenceNumber&sortDir=asc&filters=[{"field": "maytq\_scrap\_count", "arg":15, "functionType": "greaterThan"}]&filterAggregator=any` ## So finden Sie Abfrageparameter in der Dokumentation Um die verfügbaren Abfrageparameter für Ihre Anfrage zu finden, navigieren Sie zur API-Dokumentation. Wenn Sie die Tulip Table API verwenden, finden Sie die Dokumentation unter: your-instance.tulip.co/apiDocs.Wählen Sie die gewünschte Abfrage aus und scrollen Sie nach unten zur Registerkarte **Parameter**. ![Parameters in API Docs.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Parameters%20in%20API%20Docs.png) Jede einzelne Methode hat ihren eigenen Parametersatz, aber nicht jede Anfrage hat zugehörige Parameter. Informieren Sie sich daher vorher in der Dokumentation über die verfügbaren Parameter. ## Syntax der Abfrageparameter Die Abfragen für die Parametersyntax beruhen auf einem [Abfrage-String-Format](https://en.wikipedia.org/wiki/Query_string). Dieses Format weist den angegebenen Parametern Werte zu, wobei der Abfrage-String selbst Teil der URL ist. Klicken Sie im Editor für Verbindungsfunktionen auf **Parameter hinzufügen**, um einen neuen Abfrageparameter zu erstellen. ![Query Parameters - Add Parameter.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Add%20Parameter.png) Ein Abfrageparameter besteht aus zwei Teilen: einem **Schlüssel** und einem **Wert**. Der Schlüssel ist der Name des Parameters und der Wert ist die Information, die den Parameter für die Ergebnisse festlegt. Die Syntax der Abfrageparameter verwendet die Dot Notation, die den genauen Typ des Parameters angibt. Achten Sie darauf, dass die Schreibweise mit dem API-Standard des anderen Systems übereinstimmt. ## Gemeinsame Parameter auf Verbindungsfunktionen anwenden Um Ihrer Konnektor-Funktion einen Parameter zuzuweisen, identifizieren Sie zunächst den Parameter, den Sie verwenden möchten, in der API-Dokumentation. Für jeden Parameter gibt es unterschiedliche Anforderungen, daher gehen wir kurz darauf ein, wie sie aussehen. NOTE For continuity purposes, we’ll use the same request API Call in each of the examples below. This is the GET request that retrieves a list of records in a tulip Table via the Tulip Table API. Other APIs you use will have different specifications for parameters, be sure to look at the API documentation requirements. ### Begrenzungen Limits legen eine bestimmte Obergrenze für die zurückgegebenen Ergebnisse fest. Beachten Sie, dass einige Grenzwerte Standardeinstellungen haben. Schauen Sie also unbedingt in der API-Dokumentation nach, um den Anfangswert zu verstehen. **BeispielWir**möchten nicht mehr als 70 Datensätze erhalten, wenn die Verbindungsfunktion ausgeführt wird. Glücklicherweise ist der Standardwert für den Grenzwert in dieser Abfrage 10 und der Höchstwert 100. Die Syntax für den Abfrageparameter sollte wie folgt aussehen: ![Query Parameters - Limits.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Limits.png) ### Filter Filter trennen und verfeinern die Ergebnisse auf der Grundlage der im Parameter angegebenen Informationen. Filter bestehen aus drei Teilen, die Sie in einzelne Parameter schreiben müssen: - Field - der Name der Spalte in der Tabelle - Funktionstyp - der Typ der Vergleichsfunktion - Argument - der Wert, mit dem die Ergebnisse verglichen werden sollen Jeder Filter besteht aus 3 Teilen und jeder vollständige Filter ist ein Objekt. Verwenden Sie die Punktnotation, um jeden Schlüssel zu schreiben, und geben Sie die Art des Parameters ("filter"), die Filternummer (0 bis n) und den Teil des Filters ("field", "functionType" oder "arg") an. Für alle drei Teile des Filters muss es einen Parameter geben. **BeispielWir**möchten sicherstellen, dass die Ergebnisse der Konnektor-Funktion nur Werte eines bestimmten Feldes (eubmc_value) anzeigen, die dem angegebenen Eingabewert (consumable) der Funktion entsprechen. Da dies unser erster Filter in den Parametern der Funktion ist, ist die Filternummer 0. Das bedeutet, dass jeder Schlüssel für diesen Filter mit "filter.0" beginnt. Die Syntax für diesen Filter sollte wie folgt aussehen: ![Query Parameters - Filters.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Filters.png) ### Sortieren Die Sortierung der Ergebnisse priorisiert die Ansicht auf der Grundlage der Informationen des Parameters. Die sortierten Ergebnisse bestimmen, welche in Aggregationen einbezogen werden. Sie können mehrere Sortierfunktionen haben, wobei die Reihenfolge der Optionen die Priorität der Sortierung bestimmt. Sortierfunktionen bestehen aus zwei Teilen: - sortBy - das Feld, nach dem Sie die Ergebnisse sortieren möchten - sortDir - die Richtung der Sortierung, entweder aufsteigend (asc) oder absteigend (desc) Jede Sortierfunktion besteht aus 3 Teilen. Verwenden Sie die Punktnotation, um jeden Schlüssel zu schreiben, und geben Sie die Art des Parameters ('sortOptions'), die Sortiernummer (0 bis n) und das Sortierargument ('sortBy' oder 'sortDir') an. Es muss ein Parameter für alle drei Teile der Sortierfunktion vorhanden sein, damit sie funktioniert. **BeispielWir**möchten, dass die Ergebnisse der Verbindungsfunktion nach dem zuletzt aktualisierten Feld in aufsteigender Reihenfolge sortiert werden. Da dies unsere erste Sortierfunktion ist, ist die Sortiernummer 0. Das bedeutet, dass beide Schlüssel für diese Sortierung mit "sortOptions.0" beginnen. Für den sortBy-Schlüssel ist der Wert ein spezieller Wert ("_updatedAt"), der aus der API-Dokumentation abgeleitet wurde, um durch aktualisierte Felder zu sortieren. Die Syntax für diese Parameter sollte wie folgt aussehen: ![Query Parameters - Sorting.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Sorting.png) ### Offsets Offsets bestimmen den Index, bei dem das zurückgegebene Ergebnis beginnen soll. Dieser Parameter wird für die Paginierung verwendet, nicht für die Reihenfolge der Datensätze, die durch die Sortierparameter bestimmt wird. Der Wert des Parameters muss eine Ganzzahl sein, die größer oder gleich 0 ist. **BeispielWir**möchten nur die Datensätze ab der 5. Position anzeigen, so dass wir nicht die ersten 5 Ergebnisse sehen. Die Syntax für den Abfrageparameter sollte wie folgt aussehen: ![Query Parameters - Offset.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Offset.png) ### Filter-Aggregatoren Filteraggregatoren bestimmen, wie die Filter in den Parametern kombiniert werden. Die beiden zur Auswahl stehenden Werte sind "any" und "all". Der Wert "all" bedeutet, dass alle Filter einen Datensatz enthalten müssen, damit der Datensatz in die Ergebnisse aufgenommen wird. Der Wert "any" bedeutet, dass mindestens einer der Filter einen Datensatz enthalten muss, damit er in die Ergebnisse aufgenommen wird. Der Standardwert ist "all", unabhängig davon, ob Sie den Parameter setzen oder nicht. **BeispielWir**haben eine Reihe von Filtern in den Abfrageparametern, aber nur einer dieser Filter muss wahr sein, damit die Datensätze mit unserer Anfrage übereinstimmen. Die Syntax für den Abfrageparameter sollte wie folgt aussehen: ![Query Parameter - Filter Aggregators.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameter%20-%20Filter%20Aggregators.png) ### Mehrere Filter In manchen Fällen müssen Sie vielleicht mehrere Filter in der Tabelle überprüfen. In diesem Fall können Sie mehrere zum Filterobjekt hinzufügen. Dies könnte etwa so aussehen: `filters=[{"field": "maytq\_scrap\_count", "arg":15, "functionType": "greaterThan"},{"field": "maytq\_scrap\_reason", "arg": "scratch", "functionType": "equal"}]` ## Weitere Lektüre - [Ein Überblick über HTTP-Konnektoren](/r230/docs/an-overview-of-http-connectors) - [Erstellen und Konfigurieren einer HTTP-Konnektorfunktion](/r230/docs/how-to-create-and-configure-an-http-connector-function) - [Wie man die Tabellen-API verwendet](/r230/docs/how-to-use-the-table-api) **Dot Notation** **Dot notation** is a way to access a property of an object. Structure dot notation by using the name of an object, followed by a dot, followed by the name of the property. **Example**: data.Id.datetime **API Call** An **API call** is a message sent to a server asking an API to provide a service or information.