Word-invoegtoepassing - berekeningsrapporten in Word

De Struct4U Word-invoegtoepassing zet een XFEM4U-berekeningsrapport rechtstreeks in een Word-document. Je sleept een opgeslagen model naar het deelvenster Berekeningen, XFEM4U 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 kruisverwijzingen naar het rapport blijven daarbij ongemoeid.

De invoegtoepassing wordt door de hele Struct4U-familie gedeeld. Naast XFEM4U-modellen (.xfem, en het oudere .xfr3) accepteert hij XFrame2D- (.xfr2), XBeam2D- (.xbe2) en XConstruct-modellen (.xcst), 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; XFEM4U-modellen werken op dezelfde manier.

Vereisten

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

Installatie

De invoegtoepassing hoort bij de XFEM4U-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 XFEM4U: XFrame2D, XBeam2D en XConstruct installeren daar precies dezelfde bestanden. Windows houdt één kopie aan, hoeveel Struct4U-programma's je 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. Je vindt hem terug in Word onder Bestand > Opties > Invoegtoepassingen.

Het tabblad Struct4U in Word

Na installatie heeft Word een extra lint-tabblad, Struct4U, met twee knoppen:

Berekeningen - toont of verbergt het deelvenster Berekeningen. Het deelvenster is bij elke start van Word verborgen; hiermee open je het.
Info - de versie van de invoegtoepassing, en een overzicht van de Struct4U-rekenprogramma's die op de machine zijn gevonden, met per programma of het rapporten kan maken. Dit is de snelste manier om te controleren of jouw XFEM4U 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 de naam te zien.

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.

XFEM4U 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 je een berekening die te lang duurt kunt stoppen. Stoppen verandert niets aan het document.

Meerdere modellen die je in één keer sleept worden meerdere blokken, in de volgorde waarin je ze hebt gesleept. Het invoegpunt is altijd de cursor, en niet de plek op de pagina waar je 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 XFEM4U zelf maakt, en bevat wat de uitvoerselectie van het model vraagt - koptekst en voettekst, inhoudsopgave, tekening, lagen, 3D-aanzichten en de resultatentabellen. Zie Uitvoerselectie.

De invoegtoepassing vraagt niet wat er in moet: hij gebruikt de selectie die in het model is opgeslagen. Wil je de inhoud van een rapport wijzigen, open dan het model in XFEM4U, stel de uitvoerselectie in zoals je hem wilt hebben, 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 je 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? Antwoord je Nee, dan blijft het document precies zoals het was. Er wordt nooit stilzwijgend bijgewerkt: een berekening die is gecontroleerd en ondertekend mag niet onder de handen van de opsteller veranderen.
Het model bewerken - zie hieronder.

Bij het bijwerken wordt de inhoud van hetzelfde blok vervangen, zodat bladwijzers en kruisverwijzingen naar een rapport intact blijven. Kan een bijwerking niet worden voltooid, dan blijft het bestaande rapport staan in plaats van dat het leeg achterblijft. Lukt het wel, dan meldt het deelvenster hoeveel blokken zijn bijgewerkt, en noemt het de blokken die het niet heeft kunnen bereiken.

Bewerken, verwijderen en ontkoppelen

Bewerken opent het model van het geselecteerde blok in XFEM4U. Sluit je XFEM4U weer af, dan wordt het blok opnieuw berekend als je het model hebt gewijzigd, en met rust gelaten als dat niet zo is. Dubbelklikken op een regel, of er Enter op geven, 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; je kunt het vrij bewerken.

Een ingevoegd rapport is beschermd: je kunt er niet in typen, omdat wat je typt bij de volgende bijwerking toch verloren zou gaan. Gebruik Ontkoppelen als je 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 XFEM4U zelf is ingesteld; het rapport in het blok komt van XFEM4U en volgt de taalinstelling van XFEM4U.

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.
Eén berekening tegelijk, per Word-sessie.
Een berekening die langer dan tien minuten duurt, wordt gestopt; het document blijft dan ongewijzigd.
Word op het web en Word voor Mac worden niet ondersteund.