Skriv ut      Åpne PDF-versjon av elektronisk hjelp


Previous Topic

Next Topic

Om angivelse av filtre for innebygde rapporter og instrumentpaneler

Du kan bygge inn rapporter og instrumentpaneler i egendefinerte Web-appleter og Web-faner. Du kan også konfigurere Web-koblingsfelt til å åpne rapporter eller instrumentpaneler.

Når du oppretter en egendefinert Web-applet, Web-fane eller Web-kobling av typen Rapport eller Instrumentpanel, kan du angi filtre som skal brukes under kjøring. Filtrene du angir for et instrumentpanel, vil gjelde for alle rapportene i instrumentpanelet.

Hver av kolonnene du angir i filtrene, må også ha et filter konfigurert for i rapporten du vil bygge inn, og hvis du bygger inn et instrumentpanel, må kolonnen ha et filter konfigurert i hver av rapportene i instrumentpanelet. Filteret i rapporten kan angis basert på ledetekster eller konfigureres med en operator og en verdi. Hvis et filter ikke er konfigurert for en kolonne i rapporten, blir ikke noe filter du angir for denne kolonnen i Web-appleten, Web-fanen eller Web-koblingen, brukt når rapporten kjøres. Hvis du vil ha opplysninger om hvordan du legger til filtre i kolonner i rapporter, se Legge til filtre i kolonner i Analytics.

MERKNAD: Når du oppretter en egendefinert Web-applet, Web-fane eller Web-kobling av typen Rapport, kan du angi at eventuelle ledetekster som er definert for den innebygde rapporten, skal vises under kjøring. Merk i så fall av i boksen Vis rapportledetekster. Når ledetekster vises under kjøring, kan brukerne filtrere rapporten. Innstillingen i avmerkingsboksen Vis rapportledetekster har imidlertid høyere prioritet enn eventuelle filtre som er definert i feltet Parametre for den innebygde rapporten eller instrumentpanelet. Hvis du merker av i boksen Vis rapportledetekster for en egendefinert Web-applet, Web-fane eller Web-kobling, ignoreres derfor eventuelle filtre som er definert i feltet Parametre slik det er beskrevet i dette emnet, selv om ingen ledetekster er definert for den innebygde rapporten.

Syntaks for angivelse av filtre

Du kan angi parametrene for filtre på følgende måter:

  • Ved hjelp av parametrene Pn, som kalles Pn-syntaksen.
  • Ved hjelp av parametrene opn, coln og valn, som kalles opn-syntaksen.

Du kan ikke bruke en blanding av de to syntakstypene.

Når du bruker syntaksen Pn, kan du angi maksimalt seks filtre. I parameteren P0 angir du antall filtre du vil sette opp. De gyldige verdiene for parameteren P0 er heltall fra 1 til og med 6. Parameteren P0 kan brukes bare én gang i parameterstrengen. Hvert filter bruker tre parametre til å angi operatoren, kolonnen og verdien. Du angir det første filteret i parametrene P1-P3. P1 må angi operatoren, P2 må angi kolonnen og P3 må angi verdien. Du angir de neste filtrene i sett med tre parametre, det vil si P4-P6, P7-P9, P10-P12, P13-P15 og P16-P18. Du må bruke en ampersand (&) til å skille parametrene. Hver parameter kan brukes bare én gang i parameterstrengen.

Syntaksen for ett enkelt filter er som følger. Parametrene kan imidlertid plasseres i en hvilken som helst rekkefølge i parameterstrengen:

P0=1&P1=operator&P2=tabell.kolonne&P3=verdi

Hvis du vil angi flere filtre, legger du til parametrene P4-P6, P7-P9 og så videre, og øker verdien for parameteren P0 slik at den samsvarer med antall filtre du legger til. For to filtre blir syntaksen dermed som følger:

P0=2&P1=operator&P2=tabell.kolonne&P3=verdi&P4=operator&P5=tabell.kolonne&P6=verdi

Når du bruker syntaksen opn, er det ingen begrensning for antall filtre du kan angi. Hvert filter bruker en gruppe med tre parametre: parameteren opn angir operatoren, parameteren coln angir kolonnen, og parameteren valn angir verdien. Du må bruke en ampersand (&) til å skille parametrene. Du må nummerere hver av parametrene i en filtergruppe med det samme nummeret, som må være et heltall større enn 0 (null), og du må nummerere gruppene med parametre sekvensielt. Syntaksen for ett enkelt filter er som følger. Parametrene kan imidlertid plasseres i en hvilken som helst rekkefølge i parameterstrengen:

op1=operator&col1=tabell.kolonne&val1=verdi

For to filtre blir syntaksen på en lignende måte følgende:

op1=operator&col1=tabell.kolonne&val1=verdi&op2=operator&col2=tabell.kolonne&val2=verdi

MERKNAD: Hvis et tabellnavn eller kolonnenavn i kolonneparameteren inneholder et mellomrom, må du bruke doble anførselstegn rundt navnet. Hvis et tabellnavn eller kolonnenavn ikke inneholder mellomrom, trenger du ikke å bruke doble anførselstegn rundt navnet, men du kan gjøre det hvis du vil. Dette gjelder for begge syntakstypene.

Sideparameter

Når du bygger inn et instrumentpanel, kan du også velge å bruke sideparameteren for å angi hvilken side i instrumentpanelet som skal åpnes når instrumentpanelet gjengis. Syntaksen for sideparameteren er:

Page=sidenavn

der sidenavn er navnet på siden slik det vises i instrumentpanelet. Ikke bruk doble anførselstegn rundt sidenavnet selv om navnet inneholder ett eller flere mellomrom. Du kan angi sideparameteren for seg selv eller med andre parametre. Du kan plassere sideparameteren hvor som helst i parameterstrengen, men du må bruke an ampersand (&) for å skille sideparameteren fra parametre som kommer før eller etter.

Sideparameteren valideres ikke når du lagrer parametrene. Hvis du ikke inkluderer sideparameteren, eller hvis du inkluderer den, men lar parameterverdien stå tom, åpnes den første siden i instrumentpanelet når instrumentpanelet gjengis. Hvis du angir en verdi som er noe annet enn det gyldige navnet på en side i det valgte instrumentpanelet, vises en feil under kjøring.

Om spesialtegn i parametre

Hvis et tabellnavn, et kolonnenavn, en verdi eller et navn på en instrumentpanelside du angir i en parameter, inneholder noen av følgende tegn, må tegnet kodes på følgende måte:

  • % (prosenttegn). Kodes som %25.
  • & (ampersand). Kodes som %26.
  • [ (venstre hakeparentes). Kodes som %5B.
  • ] (høyre hakeparentes). Kodes som %5D.
  • + (plusstegn). Kodes som %2B.

Hvis disse tegnene ikke kodes, kan det bli returnert en feil når du prøver å lagre parametrene, eller det kan være at resultatene ikke blir riktige under kjøring.

Parametervalidering

Bortsett fra sideparameteren valideres parametrene du angir, når du prøver å lagre endringene. Hvis det blir oppdaget feil, må du rette opp disse feilene før du kan lagre endringene.

MERKNAD: I versjoner før versjon 40 ble ikke filterparametrene validert før de ble lagret. En filterparameter som ble angitt for en innebygd rapport eller et innebygd instrumentpanel i en versjon før versjon 40, kan derfor inneholde feil. Hvis det blir oppdaget feil i syntaksen for et filter når en innebygd rapport eller et innebygd instrumentpanel gjengis, vises en feilmelding. Hvis du redigerer et eksisterende felt for Web-appleter, Web-faner eller Web-koblinger av rapport- eller instrumentpaneltypen, og hvis du foretar en endring i et hvilket som helst felt, valideres også alle feltene, inkludert feltet Parametre, når du prøver å lagre endringene. Hvis det blir oppdaget feil, må du rette opp disse feilene.

De neste avsnittene beskriver parametrene som inngår i et filter.

Operator

Tabellen nedenfor viser operatorene du kan bruke i et filter.

Operator

Beskrivelse

eq

Lik eller i

neq

Ikke lik eller ikke i

lt

Mindre enn

gt

Større enn

ge

Større enn eller lik

le

Mindre enn eller lik

bwith

Begynner med

ewith

Slutter med

cany

Inneholder hvilke som helst. Verdiparameteren kan ha flere verdier, som hver er atskilt med et plusstegn (+). Hvis du bruker syntaksen Pn, må du angi antall verdier i begynnelsen av verdilisten. Hvis du bruker syntaksen opn, skal du ikke angi antall verdier. Ellers vil Oracle CRM On Demand forutsette at det angitte tallet er en annen verdi.

Eksempel: Finne firmaregionene Øst, Vest og Sentral (det vil si tre regioner):

P0=1&P1=cany&P2="Firma"."Firmaregion"&P3=3+Øst+Vest+Sentral

eller:

op1=cany&col1="Firma"."Firmaregion"&val1=Øst+Vest+Sentral

call

Inneholder alle. Verdiparameteren kan ha flere verdier, som hver er atskilt med et plusstegn (+). Hvis du bruker syntaksen Pn, må du angi antall verdier i begynnelsen av verdilisten. Hvis du bruker syntaksen opn, skal du ikke angi antall verdier. Ellers vil Oracle CRM On Demand forutsette at det angitte tallet er en annen verdi.

like

Ligner. Verdiparameteren må inneholde en verdi. Verdistrengen må slutte med jokertegnet % (prosenttegn). Hvis ikke vil likhetsoperatoren returnere bare nøyaktige treff for strengen. Prosenttegnet må kodes som %25.

Hvis du for eksempel vil finne firmanavn som ligner Acme:

P0=1&P1=like&P2="Firma"."Firmanavn"&P3=Acme%25

eller:

op1=like&col1="Firma"."Firmanavn"&val1=Acme%25

top

Øverste n elementer. Hvis du for eksempel vil finne de seks høyeste salgsinntektene:

P0=1&P1=top&P2="Firma"."Firmainntekt"&P3=6

eller:

op1=top&col1="Firma"."Firmainntekt"&val1=6

bottom

Nederste n elementer. Hvis du for eksempel vil finne de fire laveste salgsinntektene:

P0=1&P1=bottom&P2="Firma"."Firmainntekt"&P3=4

eller:

op1=bottom&col1="Firma"."Firmainntekt"&val1=4

bet

Mellom. Verdiparameteren må ha to verdier, atskilt med et plusstegn (+). Hvis du bruker syntaksen Pn, må du angi antall verdier (2) i begynnelsen av verdilisten. Hvis du bruker syntaksen opn, skal du ikke angi antall verdier. Ellers vil Oracle CRM On Demand forutsette at det angitte tallet er en annen verdi.

Eksempel: Filtrere etter firmainntekt mellom 100 000 og 500 000:

P0=1&P1=bet&P2="Firma"."Firmainntekt"&P3=2+100000+500000

eller:

op1=bet&col1="Firma"."Firmainntekt"&val1=100000+500000

null

Er null. Verdiparameteren må være 0 (null) og kan ikke utelates.

nnull

Er ikke null. Verdiparameteren må være 0 (null) og kan ikke utelates.

Kolonne

Når du angir kolonnen, må du være oppmerksom på følgende:

  • Du må angi både tabellnavnet og kolonnenavnet, atskilt med punktum (.).
  • Hvis et tabellnavn eller kolonnenavn inneholder et mellomrom, må du bruke doble anførselstegn rundt dette navnet: Hvis et tabellnavn eller kolonnenavn ikke inneholder mellomrom, trenger du ikke å bruke doble anførselstegn rundt navnet, men du kan gjøre det hvis du vil. Dette gjelder for begge syntakstypene. Alle de følgende er for eksempel gyldige:

    "Account"."Account Name"

    "Service Request".Area

    Account."Account Name"

  • Du må bruke de opprinnelige kolonnenavnene, og ikke de viste navnene.

Verdi

Vær oppmerksom på følgende når du angir verdien for et filter:

  • Du kan angi en verdi direkte, eller du kan angi et felt som en parameter:
  • Hvis du bruker syntaksen opn, og hvis du angir en verdi direkte som inneholder et mellomrom, må du bruke doble anførselstegn rundt verdien. Hvis du angir flere verdier, og hvis noen av verdiene inneholder et mellomrom, må du bruke doble anførselstegn rundt hver av de angitte verdiene. Eksempel:

    val1="New York"+"Alabama"+"California"

    Hvis du bruker syntaksen Pn, trenger du ikke å bruke doble anførselstegn rundt en verdi som inneholder et mellomrom.

  • Hvis du vil inkludere et bruker- eller systemfelt i en filterparameter, plasserer du markøren i feltet Parametre i den posisjonen der du vil legge til parameteren, og deretter velger du feltet du vil inkludere fra listen over bruker- og systemfelt.

    For informasjon om bruker- og systemfeltene du kan bruke i parametrene, se Bruker- og systemfelt.

  • (Bare for Web-appleter for detaljsider for posttyper, og Web-koblinger) Hvis du vil inkludere et felt fra posttypen i en filterparameter, plasserer du markøren i feltet Parametre i den posisjonen der du vil legge til feltet, og deretter velger du feltet fra feltlisten for posttypen, der posttype er navnet på posttypen som du oppretter appleten for.

    Hvis du for eksempel velger feltet Rad-ID fra listen Felt for posttypen, blir %%%Row_Id%%% satt inn. Under kjøring blir %%%Row_Id%%% erstattet med rad-ID-en for den gjeldende posten.

MERKNAD: URL-adressen for en rapport eller et instrumentpanel genereres under kjøring. Lengden på URL-adressen for rapporten eller instrumentpanelet varierer, avhengig av verdiene som sendes til URL-adressen for filtrene under kjøring. Alle lesere har en maksimumslengde for URL-adresser. Hvis URL-adressen for en rapport eller et instrumentpanel overskrider denne lengden, kan brukere oppleve en ubestemmelig virkemåte i nettleseren når de prøver å vise rapporten eller instrumentpanelet.

MERKNAD: Du kan angi parametre for en rapport, et instrumentpanel eller en instrumentpanelside i en Send e-post-handling for en tidsplanlagt hendelse for analyse på samme måte som du angir parametrene for en innebygd rapport eller et innebygd instrumentpanel i en Web-applet, -fane eller -kobling. Du kan imidlertid ikke velge felt å angi som parameterverdier i en Send e-post-handling. Hvis du vil ha opplysninger om hvordan du setter opp tidsplanlagte hendelser for analyse, se Opprette tidsplanlagte hendelser for analyse.


Publisert August 2022 Copyright © 2005, 2022, Oracle og/eller tilknyttede selskaper. Legal Notices.