Sortera och filtrera svar i API:t för Flow Service

När du utför listförfrågningar (GET) i Flow Service API kan du använda frågeparametrar för att sortera och filtrera svar. Den här handboken innehåller en referens för hur du använder de här parametrarna för olika användningsområden.

Sortering

Du kan sortera svar med hjälp av en orderby-frågeparam. Följande resurser kan sorteras i API:

Om du vill använda parametern måste du ange dess värde för den specifika egenskap som du vill sortera efter (till exempel ?orderby=name). Du kan lägga till ett plustecken (+) för stigande ordning eller minustecken (-) för fallande ordning. Om inget ordningsprefix anges sorteras listan som standard i stigande ordning.

GET /flows?orderby=name
GET /flows?orderby=-name

Du kan också kombinera en sorteringsparameter med en filterparameter genom att använda en"och"-symbol (&).

GET /flows?property=state==enabled&orderby=createdAt

Filtrering

Du kan filtrera svar med en property-parameter med ett nyckelvärdesuttryck. ?property=id==12345 returnerar till exempel bara resurser vars id-egenskap är exakt 12345.

Filtrering kan tillämpas generellt på alla egenskaper i en entitet så länge som den giltiga sökvägen till den egenskapen är känd.

NOTE
Om en egenskap är kapslad i ett arrayobjekt måste du lägga till hakparenteser ([]) till arrayen i sökvägen. Se avsnittet filtrera arrayegenskaper för exempel.

Returnera alla källanslutningar där källtabellens namn är lead:

GET /sourceConnections?property=params.tableName==lead

Returnera alla flöden för ett specifikt segment-ID:

GET /flows?property=transformations[].params.segmentSelectors.selectors[].value.id==5722a16f-5e1f-4732-91b6-3b03943f759a

Kombinera filter

Flera property filter kan inkluderas i en fråga förutsatt att de avgränsas med"och"-tecken (&). En AND-relation antas när filter kombineras, vilket innebär att en enhet måste uppfylla alla filter för att den ska kunna inkluderas i svaret.

Returnera alla aktiverade flöden för ett segment-ID:

GET /flows?property=transformations[].params.segmentSelectors.selectors[].value.id==5722a16f-5e1f-4732-91b6-3b03943f759a&property=state==enabled

Filtrera på arrayegenskaper arrays

Du kan filtrera baserat på egenskaperna för objekt i arrayer genom att lägga till [] i arrayegenskapens namn.

Returflöden som är associerade med specifika källanslutningar:

GET /flows?property=sourceConnectionIds[]==9874984,6980696

Returflöden som har en omformning som innehåller ett specifikt väljarvärde-ID:

GET /flows?property=transformations[].params.segmentSelectors.selectors[].value.id==5722a16f-5e1f-4732-91b6-3b03943f759a

Returnera källanslutningar som har en kolumn med ett specifikt name-värde:

GET /sourceConnections?property=params.columns[].name==firstName

Slå upp flödeskörnings-ID för ett mål genom att filtrera på segment-ID:

GET /runs?property=metrics.recordSummary.targetSummaries[].entitySummaries[].id==segment:068d6e2c-b546-4c73-bfb7-9a9d33375659

count

Alla filtreringsfrågor kan läggas till med frågeparametern count med värdet true för att returnera antalet resultat. API-svaret innehåller en count-egenskap vars värde representerar antalet filtrerade objekt. De filtrerade objekten returneras inte i det här anropet.

Returnera antalet aktiverade flöden i systemet:

GET /flows?property=state==enabled&count=true

Svaret på frågan ovan ser ut så här:

{
  "count": 95
}

Filterbara egenskaper efter resurs

Beroende på vilken Flow Service-enhet du hämtar kan olika egenskaper användas för filtrering. Tabellerna nedan delar upp rotnivåfälten för varje resurs som vanligtvis används vid filtrering.

connectionSpec

Egenskap
Exempel
id
/connectionSpecs?property=id==736873,9485095
name
/connectionSpecs?property=name==TestConn
providerId
/connectionSpecs?property=providerId==3897933
attributes.{ATTRIBUTE_NAME}
/connectionSpecs?property=attributes.sampleAttribute="abc"

flowSpec

Egenskap
Exempel
id
/flowSpecs?property=id==736873,9485095
name
/flowSpecs?property=name==TestConn
providerId
/flowSpecs?property=providerId==3897933

connection

Egenskap
Exempel
id
/connections?property=id==736873,9485095
name
/connections?property=name==TestConn
description
/connections?property=description==Test%20description
connectionSpec.id
/connections?property=connectionSpec.id==938903,849048
state
/connections?property=state==enabled

sourceConnection

Egenskap
Exempel
id
/sourceConnections?property=id==736873,9485095
connectionSpec.id
/sourceConnections?property=connectionSpec.id==938903,849048
baseConnectionId
/sourceConnections?property=baseConnectionId==983908,4908095

targetConnection

Egenskap
Exempel
id
/targetConnections?property=id==736873,9485095
connectionSpec.id
/targetConnections?property=connectionSpec.id==938903,849048
baseConnectionId
/targetConnections?property=baseConnectionId==983908,4908095

flow

Egenskap
Exempel
id
/flows?property=id==736873,9485095
name
/flows?property=name==TestFlow
description
/flows?property=description==Test%20description
flowSpec.id
/flows?property=flowSpec.id==938903,849048
state
/flows?property=state==enabled
sourceConnectionIds
/flows?property=sourceConnectionIds[]==9874984,6980696
targetConnectionIds
/flows?property=targetConnectionIds[]==598590,690666

run

Egenskap
Exempel
id
/runs?property=id==736873,9485095
flowId
/runs?property=flowId==8749844
state
/runs?property=state==inProgress

Användningsfall use-cases

I det här avsnittet finns några specifika exempel på hur du kan använda filtrering och sortering för att returnera information om vissa anslutningar eller för att hjälpa dig med felsökningsfrågor. Om det finns fler användningsfall som du vill att Adobe ska lägga till använder du Detailed feedback options på sidan för att skicka en begäran.

Filtrera bara för att returnera anslutningar till ett visst mål

Du kan bara använda filter för att returnera anslutningar till vissa mål. Fråga först connectionSpecs-slutpunkten enligt nedan:

GET /connectionSpecs

Sök sedan efter önskad connectionSpec genom att undersöka parametern name. Du kan till exempel söka efter Amazon Ads, Pega eller SFTP och så vidare i parametern name. Motsvarande id är den connectionSpec som du kan söka efter i nästa API-anrop.

Du kan till exempel filtrera destinationerna så att endast befintliga anslutningar till Amazon S3-anslutningar returneras:

GET /connections?property=connectionSpec.id==4890fc95-5a1f-4983-94bb-e060c08e3f81

Filtrera så att dataflöden endast returneras till mål

När du skickar en fråga till slutpunkten /flows kan du, i stället för att returnera alla källor och destinationsdataflöden, använda ett filter för att endast returnera dataflöden till destinationer. Använd isDestinationFlow som frågeparameter så här:

GET /flows?property=inheritedAttributes.properties.isDestinationFlow==true

Filtrera bara för att returnera dataflöden till en viss källa eller mål

Du kan filtrera dataflöden om du bara vill returnera dataflöden till ett visst mål eller från en viss källa. Du kan till exempel filtrera destinationerna så att endast befintliga anslutningar till Amazon S3-anslutningar returneras:

GET /flows?property=inheritedAttributes.targetConnections[].connectionSpec.id==4890fc95-5a1f-4983-94bb-e060c08e3f81

Filtrera för att hämta alla körningar av ett dataflöde för en viss tidsperiod

Du kan filtrera dataflödeskörningar av ett dataflöde så att du bara tittar på körningar under ett visst tidsintervall, som nedan:

GET /runs?property=flowId==<flow-id>&property=metrics.durationSummary.startedAtUTC>1593134665781&property=metrics.durationSummary.startedAtUTC<1653134665781

Filter som endast returnerar felaktiga dataflöden

I felsökningssyfte kan du filtrera och se alla misslyckade dataflöden för ett visst käll- eller måldataflöde, som nedan:

GET /runs?property=flowId==<flow-id>&property=metrics.statusSummary.status==Failed

Nästa steg

I den här guiden beskrivs hur du använder frågeparametrarna orderby och property för att sortera och filtrera svar i API:t för Flow Service. Stegvisa guider om hur du använder API:t för vanliga arbetsflöden i Platform finns i API-självstudiekurserna i dokumentationen för sources och destination .

recommendation-more-help
d4f38c9a-ed8e-4b74-98e7-57b4df1b999f