Skriv ut      Öppna PDF-version av onlinehjälpen

Administrera Oracle CRM On Demand > Applikationsanpassning > Sidan Applikationsanpassning för posttyper > Om att ange filter för inbäddade rapporter och infopaneler

Om att ange filter för inbäddade rapporter och infopaneler

Du kan bädda in rapporter och infopaneler i en anpassad webbapplet och på anpassade webbflikar. Du kan dessutom konfigurera webblänksfälten så att de öppnar rapporter och infopaneler.

När du skapar en anpassad webbapplet, webbflik eller webblänk av rapport- eller infopanelstyp kan du ange filter som ska tillämpas vid körning. För en infopanel: Filtren som du anger gäller för alla rapporter i infopanelen.

För de kolumner som du anger i filtren måste du även konfigurera ett filter i rapporten som du vill bädda in och om du bäddar in en infopanel måste du konfigurera ett filter för kolumnen i var och en av rapporterna på infopanelen. Filtret i rapporten kan ställas in till ”efterfrågas” eller konfigureras med en operator och ett värde. Om inget filter konfigureras för en kolumn i rapporten tillämpas inga filter som du anger för kolumnen i webbappleten, på webbfliken eller i webblänken när rapporten körs. Information om hur du lägger till filter till kolumner i rapporter finns i Lägga till filter i kolumner i Analys.

Obs! När du skapar en anpassad webbapplet, webbflik eller webblänk av typen Rapport kan du markera kryssrutan Visa rapportfrågor om du vill att frågor som definierats för den inbäddade rapporten ska visas vid körningstillfället. När frågor visas vid körningstillfället kan användare filtrera rapporten. Inställningen för Visa rapportfrågor har dock företräde framför filter som definierats i parameterfältet för den inbäddade rapporten eller infopanelen. Om du markerar kryssrutan Visa rapportfrågor för en anpassad webbapplet, webbflik eller webblänk ignoreras därför eventuella filter som definierats i parameterfältet enligt vad som beskrivits i detta avsnitt, även om inga frågor har definierats för den inbäddade rapporten.

Syntax för att ange filter

Du kan ange parametrarna för filter på något av följande sätt:

• Med Pn-parametrarna, eller den så kallade Pn-syntaxen.
• Med grupper med opn-, coln- och valn-parametrarna, eller den så kallade opn-syntaxen.

Du kan inte använda en kombination av de två syntaxtyperna.

Med Pn-syntaxen kan du ange upp till sex filter. I P0-parametern anger du hur många filter du vill konfigurera. De giltiga värdena för P0-parametern är heltal 1 till och med 6. P0-parametern kan användas endast en gång i parametersträngen. Varje filter använder tre parametrar för att lagra operatorn, kolumnen och värdet. Du anger det första filtret i parametrarna P1–P3. P1 definierar operatorn, P2 definierar kolumnen och P3 definierar värdet. Du anger de efterföljande filtren i uppsättningar med tre parametrar, dvs. P4–P6, P7–P9, P10–P12, P13–P15 och P16–P18. Parametrarna måste avgränsas med et-tecken (&). Varje parameter kan användas endast en gång i parametersträngen.

Nedan ser du hur syntaxen för ett enstaka filter ser ut. Observera att parametrarna kan placeras i valfri ordning i parametersträngen.

P0=1&P1=operator&P2=table.column&P3=värde

Om du vill ange fler filter lägger du till parametrarna P4-P6, P7-P9 osv. samt ökar värdet för P0-parametern så att det matchar antalet filter som du lägger till. För två filter anges syntaxen därmed på följande sätt:

P0=2&P1=operator&P2=tabell.kolumn&P3=värde&P4=operator&P5=tabell.kolumn&P6=värde

Med opn-syntaxen kan du ange ett obegränsat antal filter. Varje filter använder en grupp med tre parametrar: opn-parametern definierar operatorn, coln-parametern definierar kolumnen och valn-parametern definierar värdet. Parametrarna måste avgränsas med et-tecken (&). Du måste numrera alla parametrarna i en filtergrupp med samma nummer (ett heltal som är större än 0), och du måste numrera grupperna med parametrar i följdordning. Nedan ser du hur syntaxen för ett enstaka filter ser ut. Observera att parametrarna kan placeras i valfri ordning i parametersträngen.

op1=operator&col1=tabell.kolumn&val1=värde

Och så här ser syntaxen för två filter ut:

op1=operator&col1=tabell.kolumn&val1=värde&op2=operator&col2=tabell.kolumn&val2=värde

Obs! Om ett tabellnamn eller ett kolumnnamn innehåller blanksteg måste du omge namnet med dubbla citattecken i kolumnparametern. Om ett tabellnamn eller ett kolumnnamn inte innehåller blanksteg behöver du inte omge namnet med dubbla citattecken, men du kan göra det om du vill. Detta gäller båda syntaxtyperna.

Sidparametern

När du bäddar in en infopanel kan du även använda sidparametern om du vill ange vilken sida på infopanelen som ska öppnas när infopanelen återges. Syntaxen för sidparametern ser ut så här:

Page=sidnamn

där sidnamn är namnet på sidan så som det ser ut när sidan öppnas på infopanelen. Omge inte sidnamnet med dubbla citattecken, även om namnet innehåller ett eller flera blanksteg. Du kan ange bara sidparametern eller kombinera den med andra parametrar. Du kan placera sidparametern på valfri plats i parametersträngen, men du måste använda ett et-tecken (&) för att avgränsa sidparametern från andra parametrar som kommer före eller efter den.

Sidparametern valideras inte när du sparar parametrarna. Om du utelämnar sidparametern, eller om du lägger till den men lämnar parametervärdet tomt, öppnas den första sidan på infopanelen när infopanelen återges. Om du anger ett annat värde än det giltiga namnet på en sida på den valda infopanelen returneras ett fel vid körningstillfället.

Om specialtecken i parametrar

Om ett tabellnamn, kolumnnamn, värde eller namnet på en infopanelssida som du anger i en parameter innehåller något av följande tecken måste tecknet kodas enligt följande:

• % (procenttecken). Kodas som %25.
• & (et-tecken). Kodas som %26.
• [ (inledande parentes). Kodas som %5B.
• ] (avslutande parentes). Kodas som %5D.
• + (plustecken). Kodas som %2B.

Om dessa tecken inte kodas kan det hända att ett fel visas när du försöker spara parametrarna, eller så kanske fel resultat returneras vid körningstillfället.

Parametervalidering

Med undantag för sidparametern valideras de parametrar som du anger när du försöker spara dina ändringar. Om det uppstår fel måste du åtgärda dessa innan du kan spara ändringarna.

Obs! I äldre versioner än utgåva 40 validerades inte filterparametrarna innan de sparades. Därför kan det hända att en filterparameter som angavs för en inbäddad rapport eller en inbäddad infopanel i en tidigare version än utgåva 40 innehåller fel. Om ett fel påträffas i syntaxen för ett filter när en inbäddad rapport eller en inbäddad infopanel återges så visas ett felmeddelande. Om du redigerar ett befintligt webbapplet-, webbfliks- eller webblänksfält av typen Rapport eller Infopanel och du gör ändringar i ett fält valideras alla fälten, inklusive fältet Parametrar, när du försöker spara dina ändringar. Om ett fel påträffas måste du åtgärda det.

I följande sektioner beskrivs parametrarna som skapar ett filter.

Operator

I följande tabell listas operatorerna som du kan använda i ett filter.

Kolumn

När du anger kolumnen ska du tänka på följande punkter:

• Du måste ange både tabellnamnet och kolumnnamnet, avgränsade med punkt (.).
• Om ett tabellnamn eller ett kolumnnamn innehåller blanksteg måste du omge namnet med dubbla citattecken. Om ett tabellnamn eller ett kolumnnamn inte innehåller blanksteg behöver du inte omge namnet med dubbla citattecken, men du kan göra det om du vill. Detta gäller båda syntaxtyperna. Exempelvis är samtliga format nedan giltiga:

  "Account"."Account Name"

  "Service Request".Area

  Account."Account Name"

• Du måste använda de ursprungliga kolumnnamnen och inte visningsnamnen.

Värde

Notera följande när du anger värdet för ett filter:

• Du kan ange ett värde direkt eller ange ett fält som en parameter.
• Om du använder opn-syntaxen och direkt anger ett värde som innehåller ett blanksteg måste värdet omges av dubbla citattecken. Om mer än ett värde anges och något av värdena innehåller ett blanksteg måste vart och ett av de angivna värdena omges av dubbla citattecken, t.ex.:

  val1="New York"+"Alabama"+"Kalifornien"

  Om du använder Pn-syntaxen behöver du inte omge värden som innehåller blanksteg med dubbla citattecken.

• Om du vill inkludera ett användar- eller systemfält i en filterparameter ska du placera markören i fältet Parametrar i positionen där du vill lägga till parametern och sedan markera fältet som du vill inkludera via listan Användar- och systemfält.

  Information om användar- och systemfält som du kan använda i parametrarna finns i Användar- och systemfält.

• (Webbappletar för endast posttypsdetaljsidor och webblänkar) Om du vill inkludera ett fält från posttypen i en filterparameter ska du placera markören i fältet Parametrar i positionen där du vill lägga till fältet och sedan markera fältet i listan Posttypsfält. Posttypen är namnet på posttypen som du skapar appleten för.

  Om du t.ex. väljer fältet Rad-id i listan över posttypsfält infogas %%%Row_Id%%%. Vid körning ersätts %%%Row_Id%%% med rad-id:t för den aktuella posten.

Obs! URL:en för en rapport eller infopanel genereras vid körning. Längden på URL:en för rapporten eller infopanelen varierar, beroende på vilka värden som överförs till URL:en för filtren vid körningstillfället. Alla webbläsare har en maxlängd för URL:ar. Om URL:en för en rapport eller infopanel överskrider den här längden kan webbläsaren få ett obestämbart beteende när användarna försöker visa den rapporten eller infopanelen.

Obs! Du kan ange parametrar för en rapport, en infopanel eller en infopanelssida i en åtgärd av typen Skicka e-post i en schemalagd händelse för Analys på samma sätt som du anger parametrarna för en inbäddad rapport eller infopanel i en webbapplet, på en webbflik eller i en webblänk. Däremot kan du inte välja fält och ange dem som parametervärden i en åtgärd av typen Skicka e-post. Mer information om hur du skapar schemalagda händelser för Analys finns i Skapa schemalagda händelser för Analys.