Naar de hoofdinhoud

Het gebruik van 'Regular Expressions' oftewel RegEx

Meer dan een week geleden bijgewerkt

Let op: Dit artikel is een AI-gegenereerde vertaling.

In BIMcollab krijgen documenten een code toegewezen. De structuur van zo'n code kan worden vastgelegd via een 'Document Naming Convention'. Het kan echter voorkomen dat deze gestandaardiseerde methode niet de gewenste codestructuur kan samenstellen. In die gevallen kunnen 'Reguliere Expressies', of kortweg RegEx, worden gebruikt.

Reguliere Expressies

Een 'Reguliere Expressie' is een manier om patronen te beschrijven waarmee computersoftware tekst kan herkennen (bron: Wikipedia). Omdat hier een formele syntax voor bestaat en reguliere expressies gezien kunnen worden als een soort programmeertaal, is het niet de bedoeling om dit in dit artikel uitgebreid uit te leggen. Wil je meer weten over hoe je een reguliere expressie kunt samenstellen, kijk dan op Wikipedia, gespecialiseerde websites zoals Regexr of op YouTube, waar veel goede uitleg te vinden is.

Taak van de beheerder

Net als het vastleggen van de 'Document Naming Convention' is het invoeren van een RegEx een taak voor de beheerder. Reguliere expressies worden per project ingesteld.

  1. Open BIMcollab als beheerder.

  2. Ga vanuit de Beheerpagina naar het CDE-tabblad.

  3. Klik in de linker kolom op Projecten.

  4. Selecteer het gewenste project.

  5. Selecteer vervolgens NIET de optie 'Reguliere Expressies', maar klik op de knop Bewerken om het project te bewerken.

  6. Op de pagina 'Edit project' kun je de expressies aanmaken.

Het RegEx-voorbeeld

In ons voorbeeld wordt de RegEx gebruikt met de volgende structuur:

[A-Z]{3}-[A-Z]{3}-[0-9]{4}

Uitleg van de syntax:

  • De officiële notatie is /[A-Z]{3}-[A-Z]{3}-[0-9]{4}/ maar de backslashes worden door de BIMcollab-software genegeerd en kunnen dus worden weggelaten.

  • [A-Z]{3} geeft aan dat hier drie hoofdletters komen. Van A tot Z, zonder uitzonderingen.

  • [0-9]{4} geeft aan dat hier vier cijfers van 0 tot 9 komen.

  • In totaal bestaat de gedefinieerde code uit twee sets van drie hoofdletters en vier cijfers, gescheiden door een koppelteken. Bijvoorbeeld: ABC-DEF-1234

Document toevoegen

De hierboven besproken RegEx is toegevoegd aan 'Document', de andere vier documenttypes zoals 'Drawing' of 'Model' zijn niet voorzien van een RegEx.

Een document wordt als volgt aan een project toegevoegd in BIMcollab:

  1. Selecteer het gewenste project in 'Mijn Projecten'.

  2. Klik bovenaan in de blauwe balk op het onderdeel 'Documenten'.

  3. Je ziet nu de overzichtspagina van de documenten. Klik rechtsboven op de knop [Toevoegen aan project] om een document toe te voegen.

  4. Selecteer het document dat je aan het project wilt toevoegen en [Upload] dit document.

  5. Voeg nu de benodigde metadata toe aan de geüploade documenten door te klikken op [Informatie toevoegen aan geüploade bestanden].

  6. Vul alle verplichte velden in (velden met een asterisk en eventuele andere velden die je wilt invullen). Vul in het veld 'Documentnummer' het documentnummer in volgens de RegEx-definitie.

  7. Sla de metadata op. Als het documentnummer voldoet aan de RegEx, wordt het geaccepteerd; anders verschijnt er een waarschuwing naast het veld.

  8. Het overzicht van de projectdocumenten wordt getoond.

RegEx en Workflows

Een workflow kan worden gestart op basis van een DocumentCode. Stel dat alleen tekeningen gestempeld moeten worden met ‘Bestemd voor de bouwplaats’ en andere documenten niet, dan kan een RegEx worden opgenomen in de voorwaarden waaronder de workflow wordt gestart, waarin de documentcode van een tekening wordt vastgelegd.

Wanneer de RegEx-structuur overeenkomt met de DocumentCode van de nieuw toegevoegde tekening, wordt de voorgestelde stempel aan de tekening toegevoegd.

Was dit een antwoord op uw vraag?