Bindningsuttryck i on-demand-mallappar

Databindningar i en mallapp anger vilka data från en motsvarande urvalsapp som ska användas för att formulera frågor som används vid laddning av data i en on-demand-app.

Den grundläggande formen av bindningsuttryck – $(odag_FIELDNAME) – är inte det enda tillgängliga sättet att binda uttryck. Andra prefix kan användas för förfining av urval och för att säkerställa att mallappen laddar data korrekt.

Tillgängliga bindningsprefix

Den allmänna prefixformen är odag[s|o][n][cnt], där:

• s – bara inkluderar valda värden
• o – bara inkluderar valfria värden
• n – väljer den numeriska versionen, som standard utan citattecken
• cnt – infogar antalet värden istället för själva värdena.

Följande tabell listar alla versioner av de tillgängliga bindningsprefixen. I exemplen förutsätts ett fält med namnet MyField, med 1,2,3 som de valda värdena (gröna värden) och 4 som ett valfritt valt värde (vitt värde).

Optimering för stor databas

Prefixen odags_ och odagsn_ är avsedda för optimering av frågor. När det inte finns några urval i de bundna fälten, inkluderar odag_ alla värden och odags_ inkluderar inga värden. I vissa fall är det mer effektivt att använda prefixen odags_ och odagscnt_. Då kan du testa om värdeuppsättningen är tom. Följande är till exempel mer effektivt när inga urval har gjorts i MyField, än att testa alla värden i odag_MyField:

odags_ kan inte användas när ett alternativt fält som inte är ett on-demand-fält kan väljas i urvalsappen. Om användaren till exempel gör urval i CountryName men bindningsuttrycket är på det associerade fältet CountryCode, kan inte odags_ användas. I sådana fall kan odago_ användas istället. Om det inte finns några värden i en odago_-bindning, kan det antingen betyda att alla värden ska inkluderas, eller att inga värden ska inkluderas.

Binda numeriska värden

När data som bundits till on-demand-appen består av siffror i stället för strängar kan det vara praktiskt att inaktivera citattecknen i de numeriska fälten. Om till exempel försäljningsregistret har en numerisk DAY_OF_WEEK-kolumn och du vill att användaren av urvalsappen ska välja godtyckliga kombinationer av DAY_OF_WEEK kan du utöka aggregeringsfrågan som användes för att ladda urvalsappen genom att inkludera DAY_OF_WEEK i både SELECT-listan och GROUP BY-listan. Om det finns citattecken runt DAY_OF_WEEK-värdena när de är valda kan det uppstå fel vid körning av frågan om databasen inte stöder automatisk typkonvertering från sträng till numeriskt.

Du kan hantera den här situationen genom att använda en numerisk version av det bindande uttryckssuffixet. Då tvingas fältbindningen att använda numeriska värden från urvalsappen istället för strängvärden. Följande numeriska versioner är tillgängliga:

• odagn_
• odagon_
• odagsn_

När numeriska versioner används hämtas värdena från den numeriska delen av dualerna som lagrar valda värden, och som standard har värdena inga citattecken.

Kräver ett visst antal urval

I vissa situationer kan det vara nödvändigt att kräva att on-demand-appens fråga innehåller ett visst antal eller intervall av värden för ett specifikt fält. Om till exempel en on-demand-apps urval innehåller en BETWEEN-klausul för att hämta all försäljning mellan start- och slutdatum kan bindningsuttrycket för fältet YEARQUARTER ha en suffixsyntax [2] som kräver att exakt två värden väljs för YEARQUARTER, som här:

On-demand-appnavigeringspunkten i urvalsappen fortsätter vara inaktiverad så länge det inte finns exakt två valda värden för YEARQUARTER. Ett meddelande visas för att indikera att exakt två värden för YEARQUARTER måste väljas.

Urvalsantalets begränsningar skapar en förutsättning för länkning mellan urvalsappen och on-demand-appen. Detta skiljer sig från bindningsuttryck som inte använder kvantitetsbegränsningar. När mallappens skript till exempel innehåller ett bindningsuttryck utan antalsbegränsning, som i

finns det inget krav på att urvalsappen måste innehålla ett fält med namnet MYFIELD eller att det finns några valda värden i fältet om det finns. Om urvalsappen inte innehåller ett fält som heter MYFIELD, eller om användaren kanske glömmer att göra val från fältet, kan navigeringspunkten i on-demand-appen ändå aktiveras om andra val uppfyller postbegränsningsvillkoret.

Men om bindningsuttrycket är följande:

finns det nu två krav på urvalsappen.

• Urvalsappen måste innehålla ett fält med namnet MYFIELD.
• Användaren måste välja minst ett värde för MYFIELD.

Denna typ av bindningsuttryck måste användas försiktigt eftersom den begränsar vilka urvalsappar som kan användas med mallappen. Du bör inte använda den här antalsbegränsningen på bindningar i en mallapp om du inte är säker på att du vill ställa det kravet på urvalsantal på samtliga urvalsappar som länkar till den mallappen.

För att utföra databindningsprocessen använder On-demand-app-tjänsten ett sätt att ersätta strängar som inte reagerar på kommentarer i skriptet. Det innebär att du inte bör använda bindningsuttryck i kommentarer såvida du inte vill att de kommentarerna ska innehålla en lista över bundna värden efter appgenerering. Alla bindningar i kommentarer kommer också att visas i fältlistan i On-demand-appens genereringslänk, vilket kan vara oönskat.

Andra antalsbegränsningar är också möjliga. I följande tabell sammanfattas de olika kombinationerna av urvalsantalsbegränsningar.

Ändra citat- och avgränsningstecken för värde

När en lista med värden från ett fält som har valts i en urvalsapp infogas i skriptet för en mallapp, omges värdena av enkla citattecken och avgränsas med kommatecken. Dessa är standardtecken för citat och avgränsare. Dessa värden kan ändras i syntax som läggs till i bindningssatsen för varje fält. Exempel:

Dessa nya värden används sedan för att formulera listan över bindningsvärden som tas från urvalsappen. Om till exempel de valda värdena är årets tre första månader konstrueras listan så här:

Standardvärdena för citat- och avgränsningstecken fungerar för de flesta SQL-databaser av standardtyp. De kanske inte fungerar för vissa SQL-databaser och fungerar inte för många dynamiska datakällor som NoSQL och REST. För dessa källor behöver du lägga till detta bindningsuttryck för att ändra citat- och avgränsningstecken.

I följande tabell beskrivs formatparametrar som används för att ändra citat- och avgränsningstecken.

I följande tabell beskrivs formatspecifikationen och genererade värden för odag_ och odagn_. De genererade infogade värdena baseras på standarddatavärdena VAL1, VAL2.

Bearbeta individuella värden

När det är nödvändigt att bearbeta individuella fältvärden kan du använda inline-metoden för att generera värden i variabeln Values och utföra valfri bearbetning med Replace eller någon annan funktion. I exemplet nedan används Replace med platshållarvärden.