Støttede sammensatte datatyper for formler i elektronisk rapportering
Denne artikkelen inneholder informasjon om de sammensatte datatypene som støttes i uttrykk i Elektronisk rapportering (ER). De sammensatte datatypene er klasse, beholder, post, postliste og objekt.
Klasse
Datatypen klasse refererer til en offentlig programklasse. I ER representeres den som en post som inneholder et eget felt for hver offentlige metode i den refererte klassen. Når oppkallet av metoden er parameterisert, må du også angi de nødvendige argumentene for de aktuelle typene i et ER-uttrykk som er konfigurert slik at det kaller opp metoden.
I komponenter for ER-tilordning og ER-format kan du legge til datakilden Klasse som presenteres som en datakilde og returnerer en verdi av typen klasse. Denne datakilden viser offentlige metoder for klassen som kan kalles ved kjøretid.
Notat
Bare metoder som returnerer en verdi, kan kalles opp fra ER-uttrykk.
Bare metoder som har et område på null til åtte argumenter, kan kalles opp fra ER-uttrykk.
Standardverdien for en klasse er null.
Illustrasjonen nedenfor viser hvordan datakilden Systeminformasjon(xInfo) for Klasse-typen legges til for å lage forekomsten av xInfo-programklassen og kalle opp productName()-metoden for den for å motta navnet på det gjeldende programmet. Navnet på gjeldende program hentes ved kjøretid ved å kjøre bindingen xInfo.productName, som ble konfigurert for feltet Programvarenavn(SoftwareName) i ER-datamodellen. Denne bindingen kaller opp metoden productName() for xInfo-programklassen som er representert i den gjeldende modelltilordningen som datakilden Systeminformasjon(xInfo).
Illustrasjonen nedenfor viser hvordan ER-formatet er konfigurert slik at det legger det angitte programnavnet i genererte dokumenter. Feltet Programvarenavn(SoftwareName) i den brukte datamodellen var bundet til Streng-komponenten som er nestet under XML-elementet softwareUsed i ER-formatet. Navnet på det gjeldende programmet legges til ved kjøretid i XML-elementet softwareUsed i et generert dokument i XML-format.
Container
Datatypen beholder består av binært innhold. En verdi for beholder kan brukes til å sende bestemt informasjon fra et lager til et generert dokument. I ER-rammeverket brukes denne datatypen ofte til å legge til medieinnhold, for eksempel en firmalogo, i genererte dokumenter.
Notat
Selv om ethvert medieelement kan representeres som en verdi for beholder, representeres ikke alle verdier for beholder som et medieelement. Hvis du konfigurerer et ER-format slik at det bruker en beholder til å legge til et bilde i genererte dokumenter, men den refererte beholderen ikke returnerer medieinnhold, kan det derfor oppstå et unntak som ligner på følgende eksempel: «Feil under kjøring av kode: Binær (objekt), metoden constructFromContainer ble kalt opp med ugyldige parametere.»
Standardverdien for en beholder er null.
Følgende illustrasjon viser hvordan feltet Punktgrafikk(Image) for typen Beholder er bundet til Logo-feltet for datamodell av typen Beholder i modelltilordningen Salgsfaktura. Denne bindingen gjør firmalogoen tilgjengelig for ethvert ER-format som er utformet for rotdefinisjonen SalesInvoice og bruker denne modelltilordningen ved kjøretid.
Ta opp
En post er en samling av navngitte felt, der hvert av dem er knyttet til en verdi av enten en primitiv datatype eller en sammensatt datatype. En post brukes vanligvis til å representere én post i en postliste. Hvert element representerer i dette tilfellet individuelle felter, metoder og relasjoner.
Standardverdien for en post er tom.
Notat
Når du henter verdien til et felt i en tom post, returneres standardverdien til den aktuelle datatypen.
En post kan hentes ved hjelp av følgende funksjoner:
Hvis du vil ha mer informasjon om transformasjonen av postverdier, kan du se Liste over ER-funksjoner i listekategorien.
Postliste
En postliste er en liste over elementer av typen post. En postliste brukes vanligvis til å representere listen over poster som er hentet fra en databasetabell.
Tilgang til poster i en postliste skjer som standard sekvensielt. Du kan bruke INDEX-funksjonen og angi indeksen heltall for å få tilgang til en bestemt post.
Standardverdien for en postliste er tom. Du kan bruke ISEMPTY-funksjonen til å evaluere om en postliste er tom.
Notat
Hvis en postliste er tom, oppstår det et unntak ved kjøretid ved ethvert forsøk på å hente en feltverdi for en post. Hvis du vil vite hvordan du kan bidra til å forhindre kjøretidsunntak av denne typen, kan du se Vurdering ved saker med tomme lister.
En postliste kan startes ved hjelp av følgende funksjoner:
Hvis du vil ha mer informasjon om transformasjonen av verdier for postliste, kan du se Liste over ER-funksjoner i listekategorien. Hvis du vil vite hvordan du innfører postlisteelementer, fyller du dem ut med programdata og deretter bruker dataene til å generere forretningsdokumenter, kan du se Utforme en ny ER-løsning for å skrive ut en egendefinert rapport.
Objekt
Et objekt refererer til en tilstandsfull forekomst av en klasse. Et objekt startes vanligvis i kildekoden. Det sendes deretter til en ER-modelltilordning og gir detaljer om kjøringskonteksten.
Standardverdien for et objekt er null.
Illustrasjonen nedenfor viser hvordan datakilden ReportDataContract for typen Objekt legges til for å sende informasjon om en generert faktura fra en kildekode til modelltilordningen Prosjektfaktura. Teksten i fakturaforekomsten sendes for eksempel som en del av kjøringskonteksten. Denne teksten tas fra kildekoden ved kjøretid ved å kjøre bindingen ReportDataContract.parmInvoiceInstanceText, som ble konfigurert for Merknad-feltet i ER-datamodellen. Denne bindingen kaller opp metoden parmInvoiceInstanceText() for programklassen PSAProjInvoiceContract som er representert i den gjeldende modelltilordningen som datakilden ReportDataContract.
Hvis du vil vite hvordan du sender detaljer om kjøringskonteksten fra kildekode til ER-løsningen som kjører, kan du se Utarbeide appartefakter for å kalle den utformede rapporten.