Word-invoegtoepassing - berekeningsrapporten in Word

De Struct4U Word-invoegtoepassing zet een XConstruct-berekeningsrapport rechtstreeks in een Word-document. U sleept een opgeslagen model naar het deelvenster Berekeningen, XConstruct 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 XConstruct-modellen (.xcst) accepteert hij XFrame2D- (.xfr2), XBeam2D- (.xbe2) 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 rapport wordt ingevoegd. Hij is opgenomen in een Engelstalige Word met een XFrame2D-model; XConstruct-modellen werken op dezelfde manier.

Vereisten

Microsoft Word voor Windows (de bureaubladversie; Word op het web en Word voor Mac kunnen hem niet laden).
XConstruct 2027.5 of hoger. De batchmodus /report die de invoegtoepassing aanstuurt, is beschikbaar vanaf 2027.5. Een oudere XConstruct 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 XConstruct-licentie. De berekening is een gewone XConstruct-berekening en wordt als zodanig gelicentieerd.
.NET Framework 4.8 en de Visual Studio 2010 Tools for Office Runtime. Het installatieprogramma van XConstruct 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 XConstruct-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 XConstruct: XFrame2D, XBeam2D 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 XConstruct 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.

XConstruct 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 XConstruct zelf voor het model maakt, en bevat altijd alle berekeningen in het model: de Uitvoerselectie wordt niet toegepast.

De invoegtoepassing vraagt niet wat erin moet. Wilt u de inhoud van een rapport wijzigen, pas dan het model in XConstruct aan, sla het 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 XConstruct. Sluit u XConstruct 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 XConstruct zelf is ingesteld; het rapport in het blok komt van XConstruct en volgt de taalinstelling van XConstruct.

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.