Open punten voor de engineer
Een goedgekeurde wijziging van een KPI kan betekenen dat een metriek ook in de bron moet veranderen: een Power BI-measure, de SQL van een dbt-model, een view in de database. Depositori wijzigt nooit een bron. In plaats daarvan krijgt de engineer van elk model een open punt: wat is afgesproken, hoe de metriek nu wordt berekend, en een voorgestelde query. De engineer voert de wijziging in de bron door.
Wanneer een punt ontstaat
Section titled “Wanneer een punt ontstaat”- Na een goedgekeurde wijziging. Keurt de laatste eigenaar een voorstel goed dat de toelichting bij de berekening van een KPI wijzigt (Eigenaars en wijzigingen van een KPI), dan maakt Depositori één punt aan voor elk model met een metriek die de KPI berekent. Een wijziging van alleen de woorden van de definitie maakt geen punt aan.
- Met de hand. Een bijdrager of hoger kan een punt aanmaken met Een open punt aanmaken voor de engineer. Op het tabblad Eigenaars en wijzigingen van een KPI maakt dat één punt aan voor elk model dat de KPI berekent. Op de pagina van een metriek maakt het een punt aan voor alleen die metriek. Schrijf wat er in de bron moet veranderen en waarom, en kies Aanmaken.
De engineer van een punt is wie de import van het model bezit. Een eigenaar van de organisatie kan het punt bij Engineer aan iemand anders geven.
Je punten vinden
Section titled “Je punten vinden”Je punten staan op Begrippenlijst, Open vragen, onder Mijn open punten. Het tabblad Eigenaars en wijzigingen van een KPI en de pagina van een metriek tonen hun punten ook.


Elk punt toont zijn staat, de KPI, de metriek en het model, voor wie het is, en de notitie. Kies Punt openen om alles te zien.
Wat een punt toont
Section titled “Wat een punt toont”

- Goedgekeurde definitie en Goedgekeurde berekening: de definitie van de KPI zoals die nu is afgesproken.
- Aangemaakt: door wie en wanneer, en of het uit een goedgekeurde wijziging kwam of met de hand is aangemaakt.
- De query: de query van de metriek zoals Depositori hem las toen het punt ontstond en zoals hij het laatst is gelezen, in zijn eigen taal: DAX, SQL of een expressie. Zolang die twee gelijk zijn, staat hij er één keer, onder Bij het aanmaken en nu; zodra ze verschillen, staan ze naast elkaar.
- Voorgestelde query: de query die de bron zou moeten hebben. Zie hieronder.
- Gebruikt door en Geschiedenis: wat de KPI gebruikt, zoals op het tabblad van de KPI, en elke stap van het punt.
Alleen wie het model kan zien, ziet zijn punten.
De voorgestelde query, en het concept van de AI
Section titled “De voorgestelde query, en het concept van de AI”Staat de AI van de organisatie aan en heeft die een sleutel, dan schrijft de AI op de achtergrond een concept van de voorgestelde query zodra het punt is aangemaakt. Na een goedgekeurde wijziging stelt hij hooguit 5 punten op; de andere krijgen pas een concept als iemand Opstellen met AI kiest. Alleen definities gaan naar de AI (de definitie, de toelichting bij de berekening en de query van de metriek), nooit data.
Een concept van de AI is gemarkeerd als AI-concept: Een concept van de AI: controleer het voordat je de bron ermee wijzigt. Het is een voorstel, geen geteste query. Lees het goed voordat je het gebruikt.
- Pas de query aan in het veld en kies Voorstel opslaan. Zodra je hem aanpast, is het jouw voorstel, niet meer dat van de AI.
- Opstellen met AI (of Opnieuw opstellen met AI) vraagt de AI om een nieuw concept. Dat vervangt het voorstel dat er staat.
- Query kopiëren kopieert hem, om in de bron te plakken.
Staat de AI uit, dan is er geen concept. Het veld is leeg en je schrijft de query zelf.
Depositori wijzigt nooit de bron. Het punt bewaart alleen de query. Je voert de wijziging zelf door in Power BI, dbt of de database.
Hoe een punt sluit
Section titled “Hoe een punt sluit”- Wijzig de metriek in de bron en kies Gedaan in de bron. Het punt wacht dan tot het model opnieuw wordt gelezen.
- Lees het model opnieuw (zie Een model lezen). Het punt toont dan de query bij het aanmaken en nu, naast elkaar als hij is gewijzigd, en zegt of hij is gewijzigd. Depositori beslist nooit of de nieuwe query bij de definitie past. Dat vergelijk je zelf.
- Kies Het klopt nu: sluiten. Zo sluiten kan pas als het model opnieuw is gelezen.
Of sluit het met Doen we niet en de reden. Een punt sluit ook vanzelf als het model wordt verwijderd. Is een metriek uit het model verdwenen, dan zegt het punt dat.
Wie mag wat
Section titled “Wie mag wat”| Kan | |
|---|---|
| Iedereen die het model kan zien | De punten ervan lezen (een API-sleutel ook) |
| Een bijdrager of hoger | Ook met de hand een punt aanmaken |
| De engineer van het punt, een eigenaar van de KPI, een eigenaar van de organisatie | Ook de voorgestelde query schrijven, hem met AI laten opstellen, het als gedaan markeren, het sluiten als het klopt, of het sluiten met doen we niet |
| Een eigenaar van de organisatie | Ook het punt aan een andere engineer geven |
Dit doet altijd een persoon. Via een AI-agent die je koppelt heb je dezelfde rechten. Een API-sleutel kan punten alleen lezen (zie Voor applicaties).