VALUEIN ER-funktion
VALUEIN-funktion bestämmer om specifik indata matchar något värde för en angiven objekt i den angivna listan. Det returnerar ett booleskt värde på SANT om den angivna indata matchar resultatet av att köra det angivna uttrycket för minst en post i den angivna listan. Annars returnerar uttrycket värdet boolesk av FALSK.
Syntax
VALUEIN (input, list, list item expression)
Argument
input: Fält
Den giltiga sökvägen för ett objekt av en datakälla för typen Postlista. Värdet för det här objektet kommer att matchas.
list: Post-lista
Den giltiga sökvägen av en datakälla för datatypen Postlista.
list item expression: Boolesk
Ett giltigt villkorsuttryck som antingen refererar till eller innehåller ett enskilt fält för den angivna listan som ska användas för matchningen.
Returvärden
Booleskt
Det resulterande booleska värdet.
Användningsanteckningar
I allmänhet översätts funktionen VALUEIN till en uppsättning ELLER-villkor. Om listan med villkor ELLER är stor och den maximala totala längden för en SQL-sats kan överskridas, kan du överväga att använda VALUEINLARGE-funktionen.
(input = list.item1.value) OR (input = list.item2.value) OR …
I vissa fall kan den översättas till en SQL-databassats med hjälp av EXISTS JOIN-operatorn.
Notering
Värdet som funktionen VALUEIN returnerar används på olika sätt, beroende på om denna funktion används för att ange urvalskriterierna för funktionen FILTER för WHERE.
Exempel 1
Du kan definiera följande datakälla i din modellmappning lista för typen beräknat fält. Datakällan innehåller uttrycket SPLIT ("a,b,c", ",").
När en datakälla anropas, om den har konfigurerats som VALUEIN ("B", List, List.Value)-uttryck, returneras SANT. I det här fallet översätts funktionen VALUEIN till följande uppsättning villkor: (("B" = "a") or ("B" = "b") or ("B" = "c")) där ("B" = "b") är lika med SANT
När en datakälla anropas, om den har konfigurerats som VALUEIN ("B", List, LEFT(List.Value, 0))-uttryck, returneras FALSKT. I det här fallet översätts funktionen VALUEIN till följande uppsättning villkor: ("B" = "") som inte är lika med SANT.
Den övre gränsen för antalet tecken i texten i sådant tillstånd är 32 768 tecken. Därför bör du inte skapa datakällor som eventuellt överskrider begränsningen vid körning. Programmet ska sluta köras om gränsen överskrids och ett undantag genereras. Till exempel kan detta inträffa om datakällan har konfigurerats som WHERE (List1, VALUEIN (List1.ID, List2, List2.ID) och listorna List1 och List2 innehåller en stor mängd poster.
I vissa fall kan funktionen VALUEIN översätts till en databas med hjälp av operatören EXISTS JOIN. Det här problemet uppstår när funktionen FILTER används och följande villkor uppfylls:
- Alternativet FRÅGA EFTER FRÅGA är inte markerat för datakällan för funktionen
VALUEINsom refererar till listan över poster. Inga ytterligare villkor ska kopplas till den här datakällan vid körning. - Inga kapslade uttryck är konfigurerade för funktionen
VALUEINsom refererar till listan över poster. - Ett listobjekt för funktionen
VALUEINrefererar till ett fält i den angivna datakällan, inte ett uttryck eller en metod.
Överväg att använda det här alternativet i stället för funktionen WHERE som beskrivs tidigare i det här exemplet.
Exempel 2
Du definierar följande datakällor i din modellmappning:
- Datakällan In för typen tabellposter. Den här datakällan refererar till tabellen Intrastat.
- Datakällan Port för typen tabellposter. Den här datakällan refererar till tabellen IntrastatPort.
När en datakälla anropas som konfigurerats som uttrycket FILTER (In, VALUEIN(In.Port, Port, Port.PortId) genereras följande SQL-sats för att returnera filtrerade poster i Intrastat-registret:
select … from Intrastat
exists join TableId from IntrastatPort
where IntrastatPort.PortId = Intrastat.Port
För fälten dataAreaId genereras den slutliga SQL-satsen utifrån operatör IN.
Exempel 3
Du definierar följande datakällor i din modellmappning:
- Le-datakällan för typen beräknade fält. Datakällan innehåller uttrycket
SPLIT ("DEMF,GBSI,USMF", ","). - Datakällan In för typen tabellposter. Den här datakällan refererar till Intrastattabellen och alternativet korsföretag aktiveras för den.
När en datakälla anropas som konfigurerats som den FILTER (In, VALUEIN (In.dataAreaId, Le, Le.Value), slutgiltiga SQL-satsen innehåller följande villkor.
Intrastat.dataAreaId IN ('DEMF', 'GBSI', 'USMF')