Kommandon och guide för rapportmallar

• Allmänt
  • Rapportformulär
  • Uppladdning av mallar
  • Valideringar
• Omslagssida
• Sidhuvud och sidfot
• Ogrupperad instans-/objektrapport
  • Tabellrapport
  • Bilder
  • Bilder i grupperade rapporter
• Grupperade rapporter
  • Sortering i grupperade rapporter:
  • Rapport grupperad i två nivåer
  • Rumsrapporter med material och objekt (ogrupperade)
  • Material
  • Objekt
  • Grupprapporter för Rum och Krav
  • Ändringslogg
  • Rapport inklusive ändringar
  • Innehållsförteckning

Allmänt

I Interaxo BIM Data finns många möjligheter att anpassa olika typer av rapporter för att stödja varje kunds behov.

Rapportmallarna skapas i Word och sparas som ett Word-dokument (*.docx). Olika kommandon används för att stödja olika behov av ogrupperade eller grupperade rapporter.

En grupperad rapport används för att skapa olika typer av mängd- eller destinationsrelaterade rapporter. Ogrupperade rapporter används mest för att skapa individuella dörrkort, rumsprogrammeringsrapporter etcetera. Bilder kan automatiskt laddas upp och kopplas till instanser i Revit (som dörrhöjder, rumsritningar) eller så kan du manuellt ladda upp och koppla alla bilder som behövs för att presentera objektet och data i en rapport.

Textens format och layouten på tabeller ärvs från de format och layouter som används i mallen. Som exempel styrs teckensnitt, textstorlek och färger på texterna av formatet på kommandona.

Layouten av tabeller som fyllningar, ramar, inlines styrs av tabellayouten och designen i mallen.

Exempel på en mängdlista:

Exempel på kommandon, formatering och layout som används i mallfilen:

Observera! I rapportmallen, använd tabeller som är låsta i position till sidan eller marginaler och har fasta radhöjder, tabellbredd etcetera för att undvika oväntade sidbrytningar eller kraschade rapporter

Observera! I rapportmallen när du använder tabeller Endast ett kommando med parameter i en cell för att kunna göra Rapporter inklusive ändringar

Rapportformulär

I formuläret Skapa rapport väljer du vilken typ av rapport som ska skapas, Rapport (ogrupperade eller grupperade rapporter utan markerade ändringar), Ändringslogg eller Rapport inklusive ändringar.

En namn ska anges, välj anpassad mall och välj utskriftstyp. (Upprepning för tabeller och flera objekt som presenteras flytande över sidor eller Sida för att presentera ett objekt per sida).

Uppladdning av mallar

För att ladda upp en mall, gå till välj Rapportmallar från verktygsfältet och i mallvyn välj Skapade och lägg till ett namn, välj typ, (Rapport, Rapport inklusive ändringar eller Ändringslogg), ange om rapporten är grupperad eller inte och välj och ladda upp mallfilen.

Valideringar

När en mall skapas körs ett par valideringar för att hjälpa användarna att förstå om mallen har några felaktigt skrivna kommandon eller om en grupperad mall laddas upp som en ogrupperad rapport eller om mallen innehåller parametrar som inte finns i projektet etcetera etcetera.

Omslagssida

Rapporten kan börja med en eller flera omslagssidor. 

Lägg till en tom sida som första sidan i rapportmallen och för att definiera att rapporten ska börja från nästa sida kan en sidbrytning läggas till. Om det behövs flera omslagssidor, lägg till upprepande text utan sidbrytning och då startar rapporten på första sidan efter sidbrytningen.

På en omslagssida är det möjligt att lägga till texter och bilder eller använda kommandon för att hämta information från Företags-, Projekt-sidor eller från fälten i formuläret Skapa rapport.

Exempel på kommandon att använda på omslagssidor:

Företagsinformation:

${companyinfo.company}

Projektsmetadata:

${projectinfo.name of label}
${projectinfo.name of label}
${projectinfo.name of label}

Rapportformulär:

${reportinfo.createdBy}
${reportinfo.documentationDate}
${reportinfo.revision}
${reportinfo.revisionDate}
${reportinfo.status}
${reportinfo.description}

Sidhuvud och sidfot

Design och layout av rapportsidhuvud och sidfot kan definieras i mallen genom att lägga till tabeller, texter, bilder, tillgängliga fält/word-makron samt företags- och projektsmetadata.

Exempel på kommandon att använda i sidhuvud och sidfot:

Företagsinformation:

${companyinfo.company}

Projektsmetadata:

${projectinfo.name of label}
${projectinfo.name of label}
${projectinfo.name of label}

Rapportformulär:

${reportinfo.createdBy}
${reportinfo.documentationDate}
${reportinfo.revision}
${reportinfo.revisionDate}
${reportinfo.status}
${reportinfo.description}

Om du behöver ha ett parametervärde i sidhuvud eller sidfot, lägg kommandot i en separat tabell och lås det i position i brödtextområdet ovanpå sidhuvudets eller sidfotslayouten

Ogrupperad instans-/objektrapport

Ogrupperade rapporter används mest för att skapa individuella dörrkort, rumsbeskrivningar etc där varje objekt ska presenteras individuellt på en sida eller i en rad i en tabell.

Exempel på en Dörrkortslayout:

Exempel på mallayout:

Exempel på kommandon att använda i ogrupperad objekt-/instansrapportmall:

${Parameter name}

Tabellrapport

Om du vill skapa en tabell där varje objekt/instans presenteras på en rad, lägg till en tabell i rapporten med korrekt formatering för design och layout och lägg sedan till kommandon för att skriva ogrupperade objektparametervärden i cellerna.

Exempel på hur man skriver kommandon i en tabell i en mall:

Exempel på en ogrupperad tabellrapport över alla dörrar i ett projekt:

Exempel på mallayout och formatering:

Bilder

Exempel på olika bildkommandon för ogrupperade och grupperade rapporter,

${image:tagName} 

Bilden kommer att sättas i originalstorlek i rapporten:

${image unit="percent" width="100":tagName}

Bilden kommer att sättas till 3 cm bredd och 2 cm höjd centrerad i dokumentet.

${image alignment="center" unit="cm" width="3" height="2":tagName}

Bredden på bilden i rapporten kommer att sättas till 3 cm och bildens höjd kommer att ändras från originalvärdet med samma procentandel som bredden för att bibehålla bildens proportioner.

${image unit="cm" width="3":tagName}

Maxbredd och maxhöjd i bildkommandot

${image alignment=”center” unit=”cm” maxWidth=”3” maxHeight=”2”:top_view}

I detta fall, om bildens originalbredd är större än höjden, kommer bilden i rapporten att ha bredd lika med värdet maxWidth och värdet för höjd kommer att bero på procentuell ändring av bredd.
Om bildens originalhöjd är större än bredden, kommer bilden i rapporten att ha höjd lika med värdet maxHeight och värdet för bredd kommer att bero på procentuell ändring av höjd.
Egenskapen unit kan ha värden som i klassiskt bildkommando (cm, procent, tum, punkt).

 Egenskaper för bildkommandot:

• tagName - För manuellt uppladdade bilder kan namn på taggar definieras på fliken Bild/Taggar. Bilder synkroniserade från Revit taggas automatiskt med standardsystemtaggar som top_view, front_view, view_3d etc.

• alignment- center, left eller right (i alla ovanstående exempel kan du lägga till egenskapen alignment, standardvärde är left)
• unit- cm, point, inc eller percent (standardvärde är cm, unit-egenskapen kan inte användas utan width- eller height-egenskap)
• width och height- dimensioner i mätenheten från unit-egenskapen

Bilder i grupperade rapporter

I grupperade rapporter ska alla bilder på den grupperade urvalet av objekt/instanser ha samma bild bifogad, annars kommer en informations-/varningsbild att skrivas ut istället.

Exempel på en grupperad rapport med matchande bild på alla grupperade objekt/instanser.

Exempel på layout och använda mallkommandon

Grupperade rapporter

Grupperade rapporter används för att skapa olika typer av mängd- eller destinationsrelaterade rapporter, för att till exempel presentera antal objekt grupperade efter artikelkod eller alla rum som tillhör samma avdelning eller en destinationstabell som visar i vilka rum en specifik produkt förekommer.

När en ny grupperad mall laddas upp till projektet måste alternativet Grupperad ställas in på ja.

Exempel på en rapportmall och resultatet:

Layout och formatering styrs på samma sätt som i en ogrupperad rapport, "vad du ser är vad du får". Men för att kunna definiera i mallen om ett värde ska grupperas eller inte använder vi ett annat kommando, @{Parameter name}.

Du kan också använda en kombination av grupperade och ogrupperade kommandon i rapporten för att presentera olika värden om andra värden är grupperade. Du kan också gruppera data på olika nivåer. Till exempel är första nivån grupperad på Rumsnamn och nummer och nästa nivå är på objektnamn, för att få en rumslista med antal olika objekt i varje rum.

Exempel på kommandon att använda i grupperade mallar:

• @{Parameter name} - data kommer att grupperas efter parameter med Parameter name från detta kommando.
• ${Parameter name} - parametern med Parameter name från detta kommando påverkar inte gruppering. Med detta kommando visas i rapporten alla värden för Parameter name för viss grupp. Dessa värden för de grupperade instanserna separeras med kommatecken.
• $_T{Parameter name} - parametern med Parameter name från detta kommando påverkar inte gruppering. Med detta kommando visas i rapporten alla värden för Parameter name för viss grupp. Dessa värden visas i en tabell som har lika många rader som parametrarna.
• @{Quantity} - Antal instanser för viss grupp.

Detta är exempel på de grupperade kommandona i en mall:

och ett exempel på en rapport genererad från den mallen:

Sortering i grupperade rapporter:

Med sorteringskommandon är det möjligt att kontrollera sorteringen i dina tabeller, stigande eller fallande i en eller flera nivåer.

@{sortDirection="ASC" sortOrder="1":Parameter Name}

Data sorteras och grupperas efter Parameter Name från detta kommando.

Egenskaper för sorteringskommandot:

• sortDirection - har bara ett av två värden: ASC eller DESC och det är sorteringsriktningen (stigande eller fallande).
• sortOrder - måste vara ett nummer och det är prioriteten (ordningen) för sorteringen eftersom vi kan sortera data efter flera parametrar. 1 är högsta prioritet.

Vi kan använda flera sorteringskommandon i en mall och vi får data sorterad efter alla dessa parametrar.

Exempel på en tabell grupperad på några instans-/objektparametrar för att få en mängdlista, sorterad efter Nivå och Namn.

Rapport grupperad i två nivåer

I vissa fall behöver du gruppera data i två nivåer, till exempel skapa en mängdlista med destinationer eller en rumspecifikation med antal objekt per rum.

Exempel på kommandon:

Exempel på en produktbeskrivning grupperad på första nivån efter objekt och på andra nivån efter rumsnamn och nummer.

Exempel på ett dörrkort grupperat i två nivåer för att få antal vänster- eller högerhängda dörrar av varje dörrtyp:

Rumsrapporter med material och objekt (ogrupperade)

Första tabellen i mallen kan ha klassiska kommandon med parameternamn relaterade till rum (Rumsnamn, Rumsnummer, Yta, Bilder etc) och den tabellen kan ha rader och kolumner.

Material

För att rapportera olika material i ditt projekt behöver du ha minst en post skapad för varje undertyp i rapportmallen (i detta exempel "Golv"). För att rapportera olika materialparametrar kan vi använda följande kommandoformat

${type=”materials” subtype=”Floor”:Material Code}

I egenskapen type kan du skriva antingen materials eller objects. Om i egenskapen type står materials, skriver du i egenskapen subtype typen av material (Golv, Vägg, etc).

Objekt

För att rapportera olika objekt i ditt projekt behöver du ha minst en post skapad för varje undertyp i rapportmallen (i detta exempel "Möbler"). För att rapportera olika objektparametrar kan vi använda följande kommandoformat

${type=”objects” subtype=”Furniture”:Object Code}

I egenskapen type kan du skriva antingen materials eller objects. Om i egenskapen type står object, skriver du i egenskapen subtype typen av objekt. (Möbler, Medicinsk utrustning, etc).

För mängd (~Quantity-parameter i datarutnätet) av objekt använder du parameternamnet qty efter ":"

För kommentarer (~Comment-parameter i datarutnätet) tillagda till objekt använder du parameternamnet comment efter ":"

Grupprapporter för Rum och Krav

Exempel på kommandon för grupprapporter för Rum och Krav:

1. @{Parameter Name} - Data kommer att grupperas efter parameter med Parameter name från detta kommando. Till exempel, om vi lägger kommandot @{Room Name} på en rapport sida får vi gemensam information om alla rum med samma namn.
2. ${Parameter Name} - Med detta kommando visas i rapporten alla värden för Parameter name för viss grupp. Dessa värden kommer att separeras med kommatecken. Till exempel, om vi lägger ${Room Number} (efter @{Room Name}) får vi numren på alla rum med samma Rumsnamn.
3. @{type=”materials” subtype=”Floor”:Material Code}/@{type=”objects” subtype=”Furniture”:Object Code} - Vi använder dessa kommandon för att visa material/objekt för viss grupp. Till exempel, om vi lägger kommandon som dessa (efter @{Room Name}) på en sida får vi alla material/objekt som är kopplade till alla rum med samma Rumsnamn. Om du har flera rum med samma namn och ett av dem har ett annat antal objekt eller material, får vi en separat sida för det rummet och dess information.

Ändringslogg

Ändringsloggen används för att jämföra ändringar som gjorts på instanser mellan två snapshots och alla värden på parametrar som ingår i den valda bokmärket jämförs.
Sorteringen blir som i rutnätet. Alla ändrade objekt presenteras i rapporten oavsett filtrering eller urval.

Gäller inte för Material & Objekt i Rum.

När en ny ändringsloggfil laddas upp ska typen ställas in på Ändringslogg:

När en ändringslogg skapas måste det finnas minst två snapshots sparade mellan vilka alla ändringar i projektet kan spåras.

Sortering av data i Ändringsloggsrapporter som i Datarutnätet.

1.

2.

3.

4.

Exempel på formatering och kommandon:

${new}
${changed}
${deleted}
${space}
${line}

Exempel på resultat:

Rapport inklusive ändringar

Om du laddar upp en vanlig rapport som en Rapport inklusive ändringar kan du använda den för att presentera ändringarna som gjorts mellan två snapshots.

Gäller inte för rapporter grupperade i två nivåer.

Observera! I rapportmallen när du använder tabeller Endast ett kommando med parameter i en cell för att kunna göra ändringsrapporter

Innehållsförteckning

Om du lägger till minst ett kommando på varje sida inställt på Rubrik får du en innehållsförteckning i slutet av din rapport.

Övrigt

Hur man skapar mallkommandon

Ett sätt att skapa kommandon för mallarna är att exportera parametrarna från parametergriden till Excel och sedan använda formler i Excel för att slå samman cellvärden till ett kommando.

Andra exempel på mallar

QR kod i rapporter