Word-invoegtoepassing - berekeningsrapporten in Word

De Struct4U Word-invoegtoepassing zet een XFrame2D-berekeningsrapport rechtstreeks in een Word-document. U sleept een opgeslagen model naar het deelvenster Berekeningen, XFrame2D rekent het op de achtergrond door en het rapport wordt bij de cursor ingevoegd als een gekoppeld blok. Wijzigt het model later, dan kan het blok ter plekke worden bijgewerkt - de omringende tekst, de paginanummering en eventuele bladwijzers en kruisverwijzingen naar het rapportblok blijven daarbij ongemoeid.

De invoegtoepassing wordt door de hele Struct4U-familie gedeeld. Naast XFrame2D-modellen (.xfr2) accepteert hij XBeam2D- (.xbe2), XConstruct- (.xcst) en XFEM4U-modellen (.xfem, en het oudere .xfr3), zodat één Word-document rapporten uit meerdere programma's kan bevatten.

De korte video hieronder laat zien hoe een XFrame2D-model in Word wordt ingevoegd. Hij is opgenomen in een Engelstalige Word.

Vereisten

Microsoft Word voor Windows (de bureaubladversie; Word op het web en Word voor Mac kunnen hem niet laden).
XFrame2D 2027.8 of hoger. De batchmodus /report die de invoegtoepassing aanstuurt, is beschikbaar vanaf 2027.8. Een oudere XFrame2D wordt geweigerd met een melding die de benodigde versie noemt, in plaats van te worden gestart en in een time-out te lopen.
Een geldige XFrame2D-licentie. De berekening is een gewone XFrame2D-berekening en wordt als zodanig gelicentieerd.
.NET Framework 4.8 en de Visual Studio 2010 Tools for Office Runtime. Het installatieprogramma van XFrame2D installeert de Office-runtime als die ontbreekt. .NET Framework 4.8 zit in Windows 10 versie 1903 en later; op een oudere Windows-versie stopt het installatieprogramma en vraagt het u dat eerst te installeren.

Installatie

De invoegtoepassing hoort bij de XFrame2D-installatie, als onderdeel Word Add-in. Hij wordt geïnstalleerd in een gedeelde map, C:\Program Files (x86)\Struct4u\Word Add-in, en dus niet in de programmamap van XFrame2D: XBeam2D, XConstruct en XFEM4U installeren daar precies dezelfde bestanden. Windows houdt één kopie aan, hoeveel Struct4U-programma's u ook installeert, en verwijdert die pas bij het deïnstalleren van het laatste programma.

Word laadt hem voor elke gebruiker op de machine, onder de naam Struct4U Calculations. U vindt hem terug in Word onder Bestand > Opties > Invoegtoepassingen.

Het tabblad Struct4U in Word

Na installatie heeft Word een extra linttabblad, Struct4U, met twee knoppen:

Berekeningen - toont of verbergt het deelvenster Berekeningen. Het deelvenster is bij elke start van Word verborgen; hiermee opent u het.
Info - de versie van de invoegtoepassing, en de vier Struct4U-rekenprogramma's, met per programma of het is geïnstalleerd en of het rapporten kan maken. Dit is de snelste manier om te controleren of uw XFrame2D nieuw genoeg is.

Het deelvenster Berekeningen

Het deelvenster wordt rechts in het Word-venster verankerd en bevat drie dingen:

De sleepzone onderin - Sleep je modellen hierheen. Sleep hier één of meer modellen naartoe om hun rapporten in te voegen.
De blokkenlijst - één regel per rapportblok in het document, in documentvolgorde, met het Model waar het vandaan komt en de Status ervan.
De werkbalk - zes knoppen: Invoegen…, Bewerken, Verwijderen, Ontkoppelen, Bijwerken en Alles bijwerken. De knoppen tonen alleen pictogrammen; ga er met de muis overheen om te zien wat de knop doet.

Een rapport invoegen

Open of maak het Word-document en zet de cursor op de plaats waar het rapport moet komen.
Open het deelvenster met Struct4U > Berekeningen.
Sleep het modelbestand naar de sleepzone, of kies Invoegen… om het via een bestandsvenster te selecteren.

XFrame2D wordt op de achtergrond gestart, rekent het model door en schrijft het rapport; daarna wordt het rapport bij de cursor ingevoegd. Zolang dit loopt is een voortgangsvenster met een knop Annuleren zichtbaar, zodat u een berekening die te lang duurt kunt stoppen. Stoppen verandert niets aan het document.

Meerdere modellen die u in één keer sleept worden meerdere blokken, in de volgorde waarin u ze hebt gesleept. Het invoegpunt is altijd de cursor, en niet de plek op de pagina waar u de muisknop loslaat.

Er loopt maar één berekening tegelijk. Een tweede starten terwijl er al een bezig is, wordt geweigerd met Er wordt een berekening uitgevoerd. Wacht tot deze gereed is.

Wat er in het rapport staat

Het rapport is exact de DOCX-uitvoer die XFrame2D zelf maakt. Het bevat wat de uitvoerselectie van het model (het venster Uitvoerselectie) vraagt, maar de keuze van belastingscombinaties wordt niet toegepast: staan er combinaties in, dan altijd allemaal. De tekeninggrootte komt uit de instellingen Uitvoer op de computer die de berekening uitvoert.

De invoegtoepassing vraagt niet wat erin moet: hij gebruikt de uitvoerselectie die in het model is opgeslagen. Wilt u de inhoud van een rapport wijzigen, open dan het model in XFrame2D, pas de uitvoerselectie aan, sla het model op en werk het blok bij.

Rapporten actueel houden

Elk blok onthoudt van welk model het afkomstig is, plus een vingerafdruk van de inhoud van dat model. Of een rapport nog actueel is, wordt aan die vingerafdruk afgelezen en nooit aan een bestandsdatum - een model kan worden opgeslagen zonder dat er iets in is veranderd, en een model kan veranderen zonder dat de datum daarover iets zinnigs zegt.

De kolom Status geeft aan hoe elk blok ervoor staat:

Status	Betekenis
Actueel	Het rapport komt overeen met het model zoals het nu is.
Verouderd	Het model is gewijzigd sinds het rapport werd ingevoegd.
Model ontbreekt	Het modelbestand staat niet meer op de plaats die het blok heeft vastgelegd.
Model vergrendeld	Het modelbestand is er wel, maar kan niet worden gelezen - het staat elders open, of u hebt er geen toegang toe.
Vereist aandacht	Het blok en de bijbehorende gegevens horen niet meer bij elkaar. Vrijwel altijd een rapportblok dat binnen Word is gekopieerd en geplakt: alleen het origineel kan worden bijgewerkt, en de kopie houdt de waarden waarmee hij is geplakt.

Een blok wordt op drie manieren bijgewerkt:

Bijwerken berekent het geselecteerde blok opnieuw; Alles bijwerken berekent in één keer elk verouderd blok in het document opnieuw.
Het document openen - staan er verouderde rapporten in, dan vraagt Word het één keer, met de naam van het bestand en het aantal blokken erbij: 1 berekening in hal.docx is verouderd. Nu bijwerken? Antwoordt u Nee, dan blijft het document precies zoals het was. Er wordt nooit stilzwijgend bijgewerkt: een berekening die is gecontroleerd en ondertekend mag niet buiten medeweten van de opsteller veranderen.
Het model bewerken - zie hieronder.

Bij het bijwerken wordt de inhoud van hetzelfde blok vervangen, zodat bladwijzers en kruisverwijzingen naar het blok intact blijven. Kan het bijwerken niet worden voltooid, dan blijft het bestaande rapport staan in plaats van dat het leeg achterblijft. Lukt dat voor alle blokken, dan meldt het deelvenster hoeveel er zijn bijgewerkt; anders noemt een melding elk mislukt blok met de reden.

Bewerken, verwijderen en ontkoppelen

Bewerken opent het model van het geselecteerde blok in XFrame2D. Sluit u XFrame2D weer af, dan wordt het blok opnieuw berekend als u het model hebt gewijzigd, en met rust gelaten als dat niet zo is. Dubbelklikken op een regel, of een regel selecteren en op Enter drukken, doet hetzelfde.
Verwijderen haalt het blok en het rapport uit het document.
Ontkoppelen behoudt het rapport maar maakt er gewone tekst van. Het staat dan niet meer in het deelvenster en wordt nooit meer bijgewerkt; u kunt het vrij bewerken.

Een ingevoegd rapport is beschermd: u kunt er niet in typen, omdat wat u typt bij het volgende bijwerken toch verloren zou gaan. Gebruik Ontkoppelen als u de tekst van een rapport met de hand wilt aanpassen.

Taal

De invoegtoepassing volgt de interfacetaal van Word, niet die van Windows. Een Nederlandse Word toont een Nederlandse invoegtoepassing, een Engelse Word een Engelse. Dit staat los van de taal waarop XFrame2D zelf is ingesteld; het rapport in het blok komt van XFrame2D en volgt de taalinstelling van XFrame2D.

Beperkingen

Blokken kunnen niet vanuit het deelvenster worden verplaatst. Verplaats een rapport door het blok te verwijderen en op de nieuwe plaats opnieuw in te voegen.
Een rapportblok binnen Word kopiëren en plakken levert een tweede blok op dat niet kan worden bijgewerkt. Het wordt vermeld als Vereist aandacht, met de naam van het origineel waarvan het een kopie is. Voeg het model in dat geval een tweede keer in.
Word 97-2003-documenten (.doc) kunnen geen rapporten bevatten. Converteer het document eerst (Bestand > Info > Converteren) of sla het op als .docx.
Eén berekening tegelijk, per Word-sessie.
Duurt één model langer dan tien minuten, dan wordt de berekening gestopt: er wordt niets van ingevoegd, en blokken die nog niet opnieuw berekend waren, behouden hun bestaande rapport.
Word op het web en Word voor Mac worden niet ondersteund.