Hvad er NL funktionen i Jet Reports

Tabel

Navnet, nummeret eller caption på tabellen.

Når argumentet “What” er “Rows”, “Columns”, “Sheets” eller “Lookup”, kan du også bruge en Excel-array i tabelargumentet, som vil bruge arrayværdierne i stedet for databaseværdierne.

Excel-arrays kan oprettes på forskellige måder, herunder ved at skrive {“element1”, “element2”, “element3”}, bruge en række celler som f.eks. E8:E16 eller bruge en af Jet Reports Array-beregningerne. Dette vil medføre, at der oprettes rækker, kolonner eller ark for hver element i arrayet.

For at udføre en SQL-forespørgsel skal du starte tabelargumentet med SQL=. Hvis din tabel starter med SQL=, forventer Jet Reports, at resten af parameteren er en gyldig SQL-forespørgsel.

Hvis du vil indlæse et billede fra en fil, skal du lade tabelargumentet være tomt.

Felt

• Feltparameteren er navnet, nummeret eller caption på feltet, der skal returneres.For Dynamics NAV- og Business Central-brugere kan dette også være en Avanceret Dimension.
• Hvis du vil returnere en nøgle (til brug med NF-funktionen), skal du lade Feltparameteren være tom.
• En Feltopbevaring er påkrævet, når en tabel ikke har en primær nøgle. Hvis en Feltopbevaring bruges, skal hvert felt, der vil blive hentet med NF-funktioner, være i Feltopbevaringen.
  For at returnere en Feltopbevaring skal du angive en række af felter, f.eks. {“No.”,”Name”,”Balance”,”Address”,”City”,”County”,”Country/Region Code”}.
• En Feltopbevaring kan bruges med NL(Tabel), når du kun vil se nogle af felterne fra tabellen i stedet for alle. En NL-funktion med en Feltopbevaring vil kun returnere de unikke kombinationer af værdierne i felterne i Feltopbevaringen.
• Når argumentet “What” er “Picture”, bliver Feltparameteren fuld sti til filen eller navnet på Dynamics NAV- eller Business Central-binærfeltet (“Blob”) i den angivne tabel, der indeholder et billede.

 FilterFelt1

FilterField #1 er navnet på det første felt, hvormed der skal filtreres. For Dynamics NAV- og Business Central-brugere kan dette også være en Avanceret Dimension.

Følgende specielle værdier er tilladt som FilterField-argumenter:

• “Company=” eller 0
  Overskriver standardvirksomheden med den, der er angivet af Filter-argumentet.
• “DataSource=”
  Overskriver standarddatakilden med den, der er angivet af Filter-argumentet.

• “Filters=”
  Specificerer et sæt filtre til forespørgslen med en række filtre specificeret af Filter-argumentet. Typisk brugt, når du vil have mere end 10 filtre i din NL-funktion.
• “Headers=”
  Overskriver feltoverskrifter med rækken af overskrifter specificeret af Filter-argumentet. Til brug med en NL(Tabel) eller NL(Lookup)-funktion.
• “HideTotals=”
  Når værdien af Filter-argumentet er TRUE, skjuler den totale række, der er oprettet af NL(Table).
• “IncludeDuplicates=”
  værdien af Filter-argumentet er TRUE, angiver det, at alle matchende poster fra kilde-dataene vil blive inkluderet i NL(Tabel)-resultaterne.
• “InclusiveLink=”
  Linker primær tabellen til den, der er angivet af Filter-argumentet med henblik på at hente data.
• “Key=”
  Overskriver Dynamics NAV/Business Central-nøglen, der skal bruges til forespørgslen, med den, der er angivet af rækken af felter i Filter-parameteren.
• “Limit=”
  Begrænser antallet af poster eller værdier, der skal returneres til antallet angivet af Filter-argumentet.
• “Link=”
  Linker primær tabellen til den, der er angivet af Filter-argumentet med henblik på filtrering og hentning af data.
• “Measures=”
  I en Cube-datakilde specificerer den målinger, der skal bruges til at returnere kun de elementer, der indeholder måleværdien.
• “ScanLimit=”
  Specificerer antallet af poster, der skal scannes i en Dynamics NAV 2009R2 (eller tidligere) forespørgsel med antallet angivet af Filter-argumentet
• “Schema=”
  Overskriver databasens skema, der bruges i forespørgslen, med den, der er angivet af Filter-argumentet.Det specielle filter “Schema=” er designet til at blive brugt med NL()-funktioner, der returnerer specifikke felter. I NL()-funktioner, hvor “Field”-parameteren enten er tom eller indeholder en feltcache, vil funktionen returnere de korrekte data, men eventuelle NF()-funktioner, der refererer til den feltcache, vil ikke gøre det. Se vores artikel om Brug af “Schema=” til at returnere specifikke data.
• “ShowQuery=”
  Viser forespørgslen, der vil blive sendt til databasen.
• “TableName=”
  Angiver navnet, der skal bruges til Excel tabelobjektet, som er oprettet af NL(Table), ved at bruge navnet fra Filter parameteren. Dette kan være nyttigt, når man henviser til tabellen med navn fra en pivot-tabel.
• “Type=”
  Anvendes sammen med NL(Picture) funktionen for at angive typen af billede, der indsættes. Dette kan være nyttigt for at sikre, at billedet vises og formateres korrekt.
• “UseLocalFormulas=”
  Anvendes sammen med en NL(Table) funktion og specificerer, at eventuelle resulterende Excel-formler vil blive skrevet på sproget, der er indstillet i Windows, i stedet for engelske formler.
• “Width=” og “Height=”
  Anvendes sammen med NL(Picture) funktionen for at overskrive bredden og højden af det billede, der indsættes, med de værdier, der er angivet i Filter parameteren.

Filter #1

Værdien af filteret, der skal anvendes på FilterField1.

Hvis “Company=” er i det tilsvarende FilterField, skal du sætte virksomhedsnavnet her.

Hvis “DataSource=” er i det tilsvarende FilterField, skal du sætte forbindelsesnavnet som defineret i Jet Options her.

FilterField #n

Det samme som FilterField #1.

Op til 10 felt- og filterpar kan specificeres. Hvis du angiver flere filtre, kombineres de ved hjælp af et logisk OG.

Field #n

Det samme som Filter #1, men gælder for FilterField #n.

Eksempler på NL-funktionen

Hent saldoen for debitor “10000”:
=NL(“First”,”Debitor”,”Saldo”,”No.”,”10000″)
Funktionen fortæller Jet Reports at returnere Saldo-feltet i Debitor-tabellen for den post, der har en debitor-nr på “10000”.

Denne NL returnerer rekordnøglen for alle debitorer i Debitor-tabellen, der er i byen Boston med en saldo mindre end nul:
=NL(“Rows”,”Debitor”,,”Saldo”,”<0″,”By”,”Boston”)
Rekordnøgler henvises derefter af NF() funktioner til at hente individuelle feltværdier.

Denne NL returnerer debitor-navnet fra salgsordrenummer 10000.
Denne NL kan kun returnere en post, så ‘What’ parameteren “First” anvendes:
=NL(“First”,”Salgs Header”,”Navn”,”No.”,”10000″,”Dokumenttype”,”Tilbud”)

Denne NL returnerer oplysninger for et selskab (uanset det selskab, der vises som standard på Jet båndet):
=NL(“Rows”,”Debitor”,,”Company=”,”CRONUS USA, INC.”)

Denne NL returnerer oplysninger for et bestemt selskab og en datakilde (ignorerer standard selskab & datakilde):
=NL(“Rows”,”Debitor”,,”Company=”,”CRONUS USA, Inc.”,”DataSource=”,2)

Denne NL opretter ark kaldet “US”, “CANADA” og “MEXICO” ved hjælp af en array i tabelfeltet:
=NL(“Sheets”,”{“US”,”CANADA”,”MEXICO”})

Hvordan ville du få summen af saldoerne for alle debitorer i Georgia?
=NL(“Sum”,”Debitor”,”Saldo”,”Stat”,”GA”)
Denne funktion vil finde alle debitorer i Georgia og returnere summen af deres saldo.

Hvis du kun ønskede debitorer i Atlanta, kunne du bruge:
=NL(“Sum”,”Debitor”,”Saldo”,”Stat”,”GA”,”By”,”Atlanta”)

Kan du gætte, hvordan man skriver funktionen for summen af alle positive saldoer?
=NL(“Sum”,”Debitor”,”Saldo”,”Saldo”,”>0″)

Du kan angive op til ti filtre. Hvis du ønskede summen af saldoerne for alle debitorer med positive saldoer i Atlanta, GA, kunne du bruge:
=NL(“Sum”,”Debitor”,”Saldo”,”Saldo”,”>0″,”By”,”Atlanta”,”Stat”,”GA”)

Hvis du ville vide, hvor mange debitorer der havde positive saldoer i Atlanta, GA, kunne du bruge:
=NL(“Count”,”Debitor”,”Saldo”,”Saldo”,”>0″,”By”,”Atlanta”,”Stat”,”GA”)

Ugyldige funktioner

En NL(“Rows”), NL(“Columns”) eller NL(“Sheets”) funktion skal være den eneste funktion i en celle.

Således er disse funktioner ALLE ugyldige:

=-NL(“Rows”,”table1″,”field1″)
og

=NL(“Rows”,”table1″,”field1″)*-1
og

=IF($D$7>0,NL(“Rows”,”table1″,”field1″),””)