Sammansatta datatyper som stöds för elektroniska rapporteringsformler
Detta ämne ger information om de sammansatta datatyper som stöds i elektroniska rapporteringsuttryck (ER-uttryck). Sammansatta datatyper är klass, behållare, post, postlista och objekt.
Klass
Datatypen klass avser en offentlig programklass. I ER representeras den som en post som innehåller ett separat fält för samtliga offentliga metoder för den refererade klassen. När anropet för metoden är parametriserat måste du även ange de argument som krävs för lämpliga typer i ett ER-uttryck som är konfigurerat för att anropa metoden.
I komponenterna för ER-mappning och -format kan du lägga till datakällan Klass, som presenteras som en datakälla och som returnerar ett värde för typen klass. Denna datakälla visar offentliga metoder för den klass som kan anropas vid körning.
Notering
Det är bara metoder som returnerar ett värde som kan anropas från ER-uttryck.
Det är bara metoder med intervallet noll till åtta argument som kan anropas från ER-uttryck.
Standardvärdet för en klass är null.
I följande bild anges hur datakällan System information(xInfo) för typen Klass läggs till i syfte att skapa instansen för programklassen xInfo och anropa dess productName()-metod i syfte att erhålla namnet på aktuellt program. Namnet på det aktuella programmet hämtas i samband med körning genom körning av den xInfo.productName-bindning som konfigurerats för fältet Programvarunamn (SoftwareName) i ER-datamodellen. Denna bindning kallas productName()-metoden för den xInfo-programklass som representeras i aktuell modellmappning som datakällan System information(xInfo).
Följande bild visar hur ER-formatet är konfigurerat för att placera det angivna programnamnet i genererade dokument. Fältet Programvarunamn (SoftwareName) i använd datamodell var bundet till den Sträng-komponent kapslats under XML-elementet softwareUsed för ER-formatet. I så fall placeras namnet på det aktuella programmet vid körning i XML-elementet softwareUsed för ett genererat dokument i XML-format.
Behållare
Datatypen behållare innehåller binärt innehåll. Ett värde för behållare kan användas för att överföra specifik information från lagring till ett genererat dokument. Inom ER-ramverket används denna datatyp ofta för att placera medieinnehåll som t.ex. en företagslogotyp i genererade dokument.
Notering
Även om alla mediaobjekt kan representeras som ett behållarvärde representerar inte alla behållar-värden en medieartikel. Om du konfigurerar ett ER-format så att det använder en behållare för att placera en bild i genererade dokument, men den refererade behållaren inte returnerar medieinnehåll, kan ett undantag som liknar följande exempel visas: "Ett fel uppstod i samband med körning av kod: Binär (objekt), metoden constructFromContainer anropad med ogiltiga parametrar."
Standardvärdet för en behållare är null.
I följande bild visas hur fältet Bitmap (bild) av typen Behållare är knutet till datamodellfältet Logo av typen Behållare i modellmappningen Försäljningsfaktura. Med den här bindningen blir företagslogotypen tillgänglig för alla ER-format som har utformats för rotdefinitionen SalesInvoice och som använder denna modellmappning vid körning.
Registrera
En post är en samling namngivna fält som vart och ett är kopplat till ett värde av antingen en primitiv datatyp eller en sammansatt datatyp. Vanligtvis används en post för att representera en enda post i en postlista. I det här fallet representerar varje artikel enskilda fält, metoder och relationer.
Standardvärdet för en post är tom.
Notering
När du får värdet för ett fält med en tom post returneras standardvärdet för lämplig datatyp.
En post erhålles med hjälp av följande funktioner:
Mer information om omvandlingen av postvärden finns i Lista över ER-funktioner i listkategorin.
Postlista
En postlista är en lista över artiklar av typen post. En postlista används vanligtvis för att representera listan med poster som har hämtats från en databastabell.
Som standard ges åtkomst sekventiellt till poster i en postlista. Du kan komma åt en specifik post genom att använda funktionen INDEX och ange heltalsindex.
Standardvärdet för en postlista är tom. Du kan använda funktionen SEMPTY för att utvärdera om en postlista är tom.
Notering
Om en postlista är tom kommer alla försök att hämta ett fältvärde för en post i densamma att förorsaka ett undantag i samband med körning. Information om hur du kan förhindra undantag av det här slaget i samband med körning finns i Beaktanden i samband med tomma listor.
En postlista kan initieras med hjälp av följande funktioner:
Mer information om omvandlingen av värden för postlistor finns i Lista över ER-funktioner i listkategorin. För information om hur du presenterar artiklar i en postlista, fyller dessa med programdata och sedan använder denna data för att generera affärsdokument, se Designa en ny ER-lösning för att skriva ut en anpassad rapport.
Objekt
Ett objekt avser en godkänd instans av en klass. Normalt initieras ett objekt i källkoden. Det överförs sedan till en ER-modellmappning och ger information om körningskontexten.
Standardvärdet för ett objekt är null.
I följande bild visas hur datakällan ReportDataContract av typen Objekt läggs till för att överföra information om en genererad faktura från källkoden till modellmappningen Projektfaktura. Fakturainstanstexten skickas till exempel som en del av körningskontexten. Denna text tas från källkoden vid körning genom körning av den ReportDataContract.parmInvoiceInstanceText-bindning som konfigurerats för fältet Anteckning i ER-datamodellen. Denna bindning kallas för parmInvoiceInstanceText()-etoden för den PSAProjInvoiceContract-programklass som finns representerad i aktuell modellmappning som datakällan ReportDataContract.
Mer information om hur du vidarebefordrar detaljer från körningskontexten från källkod till den ER-lösning som köls Ta fram programartefakter för att anropa designad rapport.
Ytterligare resurser
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för