Ga naar hoofdinhoud

Projecten & Changes

Projects en Changes vormen het lifecycle management van Yres: je bundelt al het werk aan het datawarehouse (tabellen toevoegen of bijwerken, scripted objects, view-persistence) in beheersbare eenheden en transporteert die wijzigingen vervolgens gecontroleerd van dev via test naar prod. Zo blijven je omgevingen gelijk lopen en breng je nooit half werk naar productie.

Alleen bij meerdere omgevingen

De hele sectie Projects (en daarmee Changes) is verborgen en geblokkeerd voor organisaties met één omgeving. De icoon-balk toont Projects dan niet, en de backend weigert het aanmaken van een project of change met de melding "is not allowed for organizations with a single environment". Bij één omgeving is er geen dev → prod-transport nodig: wijzigingen worden direct toegepast en de wizard gebruikt intern automatisch ChangeId 1.

Alle schermen & routes

De volledige lijst schermen van de app met hun route en velden staat in Webapp-schermen.

De levenscyclus in het kort​

De vijf stappen die een wijziging doorloopt — alle acties voer je uit via het acties-menu (☰) van de change op het Changes-scherm; de kolom Waar geeft aan vanaf welke omgeving de actie loopt:

StapWatWaarAchterliggend
1Change aanmaken onder een project en er werk in boekenCreate change · dev—
2release change — change vergrendelen en vrijgeven om te installeren☰ → submenu dev · open change[Change].[spRelease]
3Install change — de change de eerste keer importeren én installeren op de doelomgeving, inclusief ADF-publish☰ → submenu prd · gereleasede changeendpoint /changes/install-and-import: [Change].[spImport] + [Change].[spInstall] + publish-datafactory
4Reimport / Reinstall change — daarna: opnieuw importeren (alleen DWH) óf opnieuw installeren (zonder import)☰ → submenu prd · geïnstalleerde change[Change].[spImport] resp. [Change].[spInstall] + publish-datafactory
5publish-datafactory — nieuwe pipelines landen in de doelfactorydoelomgeving (test/prod)Azure DevOps-pipeline

Projects​

Een project groepeert changes binnen een omgeving en geeft het werk een naam, een beschrijving en een einddatum.

Het Projects-scherm in de dev-omgeving: bovenaan de Status-keuzelijst op No filter, daaronder de projectentabel met de kolommen Id, Name, Description, DueDate, Status en Actions. Per rij staan de iconen voor bewerken, verwijderen en Close project; bij een gesloten project staat het open slotje van Reopen project. De muis staat op het slotje en de tooltip toont Close project.

Projects in de dev-omgeving (vanaf v1.57). De cijfers zijn toegevoegd ter uitleg en horen niet bij het scherm.

De cijfers (1)–(6) in de schermafbeelding verwijzen naar:

  1. Sub-links van de sectie: Projects en Changes.
  2. Status-filter: toont alleen projecten met de gekozen status. Zonder filter zie je alle projecten behalve de gereleasede.
  3. Create: opent het aanmaakformulier met de velden Name, Description en DueDate.
  4. Projectentabel met de kolommen Id, Name, Description, DueDate en Status.
  5. Status: de statuscode wordt naar tekst vertaald: 1 Open · 2 Closed · 3 released · 9 Deleted · 99 Discontinued.
  6. Rij-acties: de iconen voor bewerken en verwijderen. Op dev staat vanaf v1.57 bij een open project het slotje Close project en bij een gesloten project het open slotje Reopen project (zie Projectstatus bijwerken).

Een project aanmaken​

  1. Open in de sectie Projects de sub-link Projects.
  2. Klik op Create project.
  3. Vul Name, Description en DueDate in en bevestig.
Regels voor projecten
  • Een project kan niet verwijderd worden zolang het open changes bevat.
  • De DueDate van elke change onder het project moet op of vóór de DueDate van het project liggen.

Projectstatus bijwerken (vanaf v1.57)​

Is het werk in een project klaar, dan sluit je het project af. Klik in de dev-omgeving in de rij van het project op het slotje Close project en bevestig. Dat kan zodra alle changes van het project gesloten, gereleased of naar een ander project verplaatst zijn. Een gesloten project zet je met Reopen project weer open. Voor beide acties heb je het recht nodig om projecten bij te werken.

Boven de projectentabel staat een Status-keuzelijst (No filter, Open, Closed, released, Deleted, Discontinued), zodat je bijvoorbeeld alleen de open projecten ziet.

Changes​

Een change categoriseert bewerkingen aan het datawarehouse en is de eenheid die je later releaset en installeert. Changes horen altijd bij een project. Alle data-plane-edits in dev worden onder een change geboekt (zie het toevoegen van tabellen in Data sources), zodat ze samen door de omgevingen reizen. Het Changes-scherm is dé plek waar alles rond changes gebeurt: je filtert, bekijkt de changes-tabel en voert alle acties — releasen, (re)importeren en (re)installeren — uit via het acties-menu (☰) van een change. Welke acties beschikbaar zijn, hangt af van de status van de change.

Het Changes-scherm: links bovenaan de Project-keuzelijst en het vinkje Only show open projects, rechts de filterknop. Daaronder de changes-tabel met de kolommen Id, Name, Description, DueDate, ReleasedDate, Status overview, NextStep, Dependencies en Actions. Status overview toont per omgeving (dev, test, prod) een gekleurd blokje, NextStep een knop als Release → dev of Install → test.

Changes van een project (vanaf v1.57). De cijfers zijn toegevoegd ter uitleg en horen niet bij het scherm.

De genummerde elementen in de schermafbeelding:

  1. Project en open projecten: een Project-keuzelijst en het vinkje Only show open projects.
  2. Filterknop: filtert de changes op hun status per omgeving (zie Filteren op status per omgeving).
  3. Create: opent het formulier voor een nieuwe change (alleen bij een open project en met de juiste rechten).
  4. Changes-tabel met de kolommen Id, Name, Description, DueDate, ReleasedDate, Status overview, NextStep, Dependencies en Actions (zie hieronder).
  5. Status overview: per omgeving een blokje. Grijs is nog open, groen gelukt, oranje afgerond met waarschuwingen en rood mislukt. Het icoon in het blokje toont de laatste stap: een pijl naar rechts voor release, een pijl omlaag voor import en het wissel-icoon voor installatie.
  6. NextStep: de voorgestelde vervolgactie als knop, bijvoorbeeld Release → dev of Install → test. Vanaf v1.57 voer je die stap met één klik uit (zie De volgende stap met één klik).
  7. Dependencies: de tekst "N dependencies" met een info-icoon dat de dependency-graph opent (welke changes deze change nodig heeft, en hun status). Zonder dependencies blijft de cel leeg.
  8. Actions (☰): het acties-menu per rij met Update, Delete, een submenu per omgeving (release / install / reimport / reinstall), View dependencies en Logs (zie Releasen en Installeren).

De kolommen van de changes-tabel​

KolomWat het toont
IdHet nummer van de change.
Name / DescriptionNaam en omschrijving van de change.
DueDateStreefdatum (≤ de DueDate van het bovenliggende project).
ReleasedDateWanneer de change is gereleased (leeg zolang de change open is).
Status overviewPer omgeving een blokje: grijs = nog open, groen = gelukt, oranje = met waarschuwingen, rood = mislukt. Een klik op een blokje dat niet open is, opent de logs van die omgeving.
NextStepDe voorgestelde vervolgactie als knop, bijv. Release → dev of Install → test. Een klik start die actie.
DependenciesEen "N dependencies"-link die de dependency-graph opent.
ActionsHet acties-menu (☰) per change — zie het acties-menu.

Een change aanmaken​

  1. Open de sub-link Changes en kies bovenaan een project.
  2. Klik op Create change (alleen zichtbaar bij een Open project en met de juiste rechten).
  3. Geef de change een Name, Description en DueDate en bevestig.
Regel voor de due date

De DueDate van een change moet op of vóór de DueDate van het bovenliggende project liggen.

Snel een change of project aanmaken (vanaf v1.57)​

Wil je een tabel toevoegen of een object aan een change koppelen terwijl er nog geen geschikte change is, dan maak je die change ter plekke aan vanuit het scherm waar je bezig bent: de wizard voor used tables, used files en REST-tabellen, of het contextmenu in Database objects. Heb je ook nog geen project, dan maak je eerst het project aan en gaat het formulier direct door naar de nieuwe change.

Na het aanmaken gaat de webapp verder met de actie die je had gekozen. In de wizard staan het nieuwe project en de nieuwe change meteen geselecteerd. In Database objects wordt het object direct aan de nieuwe change toegevoegd.

Filteren op status per omgeving (vanaf v1.57)​

Met de filterknop rechtsboven de changes-tabel filter je op de status van een change per omgeving. Per regel kies je een omgeving (Env.) en een status (open, closed, succeeded, warning of failed). Je kunt meerdere regels combineren; een change moet dan aan alle regels voldoen. Met Apply pas je het filter toe. Het aantal actieve filters staat op de knop. Met het doorgestreepte filtericoon wis je ze in één keer.

Zo vind je bijvoorbeeld alles wat op dev gesloten is en op prod nog openstaat: kies dev = closed en prod = open. closed betekent hier elke status behalve open, dus ook gereleased of geïnstalleerd.

Het geopende filterpaneel van de Changes-pagina: kopjes Env. en Status, de regels dev = closed en prod = open met elk een kruisje, een lege regel om een omgeving toe te voegen, rechtsboven het rode icoon om alle filters te wissen en onderaan de knop Apply.

Het filterpaneel met twee regels die nog niet zijn toegepast.

De volgende stap met één klik (vanaf v1.57)​

De kolom NextStep toont per change de logische vervolgstap als knop, bijvoorbeeld Release → dev, Install → test of Reinstall → test. Een klik opent direct het bevestigingsvenster van die actie voor de juiste omgeving. Je hoeft de actie dus niet meer zelf in het acties-menu op te zoeken.

Yres bepaalt de stap aan de hand van de status per omgeving:

SituatieNextStep
De change is op dev nog openRelease op dev
Release of import op de vorige omgeving is geluktInstall op de volgende omgeving
Installatie mislukt of met waarschuwingen afgerondReinstall op die omgeving
Import mislukt of met waarschuwingen afgerondReimport
Release mislukt of met waarschuwingen afgerondRerelease op dev
De change staat overal geïnstalleerdgeen knop

Een change naar een ander project verplaatsen (vanaf v1.57)​

Hoort een open change eigenlijk bij een ander project, dan verplaats je hem. Open in de dev-omgeving het acties-menu van de change en kies Move to project. Kies het open project waar de change naartoe moet en bevestig met Move. Je kunt alleen open changes verplaatsen, uitsluitend naar een ander open project. Voor deze actie heb je het recht nodig om changes bij te werken.

Scripted Objects​

Custom SQL-objecten die niet door Yres zijn gegenereerd — je eigen tabellen, views, stored procedures en functions — beheer je vanuit Database objects: de database-objectboom onder Data Engineering. Daar blader je door je DWH-objecten en voeg je een eigen object — of een bestaand database-object — rechtstreeks vanuit de explorer toe aan een change. Daarnaast bestaat er een apart Scripted objects-scherm (/loadmanagement/scriptedObjects, via de sidebar-link onder Projects); in beide gevallen reizen scripted/custom objecten via de change mee bij het releasen en installeren naar test en prod.

  • Open onder Data Engineering het Database objects-scherm en rechtsklik een object om het — met of zonder dependencies, en eventueel met content — aan een change toe te voegen. Zie Objecten aan een change toevoegen.
  • Bij een custom tabel kies je of de inhoud van de tabel meegaat (achterliggend: [Change].[spCopyTableContent]).

Het acties-menu (☰)​

Releasen, installeren, (re)importeren en (re)installeren doe je via het acties-menu (☰) dat elke change-rij in de tabel heeft. Daarnaast staan in de Projects-sidebar ook de aparte schermen Release change (/changes/release) en Install change (/changes/install); het acties-menu bundelt dezelfde acties per change-rij. Welke items het menu toont, hangt af van de status van de change en van de omgeving.

Het acties-menu (☰) van een change, geopend: bovenaan Update en Delete, daaronder een submenu per omgeving (dev ▸ en prd ▸) met release / reimport / reinstall, en onderaan View dependencies en Logs.

Het menu bevat:

  • Update — de change bewerken (alleen zinvol zolang de change open is).
  • Delete — de change verwijderen.
  • Move to project — vanaf v1.57, alleen op dev en bij een open change: de change naar een ander open project verplaatsen.
  • Een submenu per omgeving (bijv. dev ▸, prd ▸):
    • Op dev biedt een open change release change aan — dit vergrendelt de change en geeft hem vrij om te installeren (achterliggend [Change].[spRelease], met een dependency-check).
    • Op een doelomgeving (bijv. prd) biedt een gereleasede change eerst Install change aan — dit importeert én installeert de change en publiceert de ADF-factory (endpoint /changes/install-and-import). Pas nadat de change op die omgeving geïnstalleerd is, verschijnen Reimport change (alleen opnieuw importeren, [Change].[spImport]) en Reinstall change (opnieuw installeren zónder import: [Change].[spInstall] + de publish-datafactory-pipeline).
  • View dependencies — opent de dependency-graph: welke changes deze change nodig heeft en hun status.
  • Logs — opent het stap-voor-stap import-/install-log (zie Logs).

Een change releasen​

Releasen maakt een change beschikbaar om te installeren op een andere omgeving. Je doet dit via het acties-menu (☰) van de change, in het submenu van de dev-omgeving.

  1. Open de sub-link Changes en filter eventueel op het project en de omgeving.
  2. Controleer de inhoud (zie Change-inhoud bekijken hieronder).
  3. Open op de open change het acties-menu (☰), ga naar dev ▸ en kies release change; bevestig.

Wat er gebeurt:

  • Na het releasen kan de change niet meer bewerkt worden — de change wordt vergrendeld en ReleasedDate wordt ingevuld.
  • Yres voert eerst een dependency-check uit en blokkeert het releasen wanneer déze change zelf afhangt van changes die nog niet gereleased zijn; de foutmelding noemt de change(s) waarvan deze change afhangt.
  • Achterliggend draait Yres [Change].[spRelease] voor de betreffende ChangeId.

Een change installeren​

Installeren brengt een gereleasede change naar de volgende omgeving (bv. dev → test, of test → prod). Ook dit doe je via het acties-menu (☰), nu in het submenu van de doelomgeving (bijv. prd ▸).

  1. Open de sub-link Changes en zorg dat de change gereleased is (zie de kolom Status overview en de NextStep-suggestie, bijv. "Install on prd").
  2. Open op de change het acties-menu (☰) en ga naar het submenu van de doelomgeving (bijv. prd ▸).
  3. Kies de actie die bij de situatie past:
    • Install change — de eerste keer op deze omgeving. Importeert de change- en projectdata (inclusief dependencies en content), installeert de change met [Change].[spInstall] en publiceert de ADF-factory door de Azure DevOps-pipeline publish-datafactory te draaien, zodat nieuwe data-source-pipelines mee landen in de doelfactory (endpoint /changes/install-and-import).
    • Reimport change — pas zichtbaar nadat de change op deze omgeving geïnstalleerd is. Roept alleen [Change].[spImport] aan: haalt de change- en projectdata opnieuw op. Dit is alleen DWH en publiceert de ADF-factory niet.
    • Reinstall change — eveneens pas zichtbaar ná installatie. Installeert opnieuw met [Change].[spInstall] en publiceert de ADF-factory, maar doet géén import.
  4. Volg de voortgang in de Logs (zie hieronder) en in het Status overview van de change.
Versies moeten overeenkomen

De eerste Install change (import-and-install) controleert eerst of de DWH-versies van bron- en doelomgeving overeenkomen. Verschillen ze, dan krijg je "Environment versions do not match, please update" en moet je eerst de omgeving bijwerken via Update environments. Reimport en Reinstall voeren deze versiecheck niet uit.

Dependencies bekijken (dependency-graph)​

Vanuit de kolom Dependencies (de "N dependencies"-link) of via View dependencies in het acties-menu open je de dependency-graph. Die toont welke changes deze change nodig heeft en wat hun status is, zodat je vóór een release of install ziet of de afhankelijke changes al op de doelomgeving staan.

Logs​

Logs in het acties-menu opent een stap-voor-stap tijdlijn van het import-/install-proces, elk met een status en de origin. De stappen lopen in deze volgorde:

  1. INIT
  2. ADD CHANGES
  3. ADD PROJECT
  4. ADD CHANGE CONTENT
  5. ADD CHANGE DEPENDENCIES
  6. END OF PROCESS

Change-inhoud bekijken​

Selecteer een change om het content-paneel te openen; daarin zie je de objecten van de change als boomstructuur (source → schema → table → properties). Per object lees je eigenschappen zoals LoadType, DeltaColumn en ifExists. Met de toggle "View as table" wissel je tussen:

  • Als boom — een uitklapbare structuur per bron (source → schema → table); handig bij veel objecten.
  • View as table — per object de details in een tabel: het LoadType, de DeltaColumn bij een delta-load en het ifExists-gedrag wanneer het object al bestaat.
Dependencies meenemen (sinds v1.53)

Sinds v1.53 kun je bij het toevoegen aan een change kiezen om dependencies en/of content mee te nemen, en kun je bestaande database-objecten direct vanuit de object-tree in een change opnemen.

Acties-menu (☰) én aparte schermen

Releasen, installeren, (re)importeren en (re)installeren voer je uit via het acties-menu (☰) van de change op het Changes-scherm: op dev biedt een open change release change, op een doelomgeving biedt een gereleasede change Install change en — ná installatie — Reimport change en Reinstall change. Daarnaast staan in de Projects-sidebar ook de aparte schermen Release change (/changes/release) en Install change (/changes/install).