miner:anvandning:update_uuid [Orbiq wiki]

Denna sida är skrivskyddad. Du kan titta på källkoden, men inte ändra den. Kontakta administratören om du anser att du bör kunna ändra sidan.
{{tag>miner systemdokumentation}}
====== Uppdatera UUID för att slå ihop datapunkter ======

Den här sidan beskriver hur ''update_uuid'' kan användas när datapunkter i ett nytt jobb behöver kopplas till tidigare UUID:n. Det innebär att en ny datapunkt kan bibehålla historiken från en äldre datapunkt.

Detta kan vara aktuellt när ett jobb eller ett källsystem har återskapats och samma fysiska datapunkter får nya UUID:n i Miner, eller om jobbdefinitionen från en Minerinstans behöver överföras till en annan instans med bibehållna unika ID:n för datapunkterna i Miner.

Du kan läsa om vad ett UUID är [[miner:referens:grundattribut|här]].

===== När används update_uuid? =====

Ibland händer det t.ex. att en [[https://sv.wikipedia.org/wiki/Dataundercentral|DUC]] går sönder och behöver bytas ut och installeras om på nytt. Det kan innebära att datapunkter som fanns på den gamla enheten får nya  ID'n eller annat som identifierar en datapunkt. Detta i sin tur kan göra att Miner får fel när den försöker fråga efter en viss datapunkt från centralen. Det kan förstås finnas andra scenarion som kan resultera i att behöva uppdatera UUID's för datapunkterna i ett jobb.

Använd ''update_uuid'' när:

  * ett jobb har återskapats
  * källsystemet har bytts eller ominstallerats
  * gamla och nya datapunkter behöver kopplas ihop
  * historik eller externa referenser ska bevaras

===== Grundprincip =====

''UUID'' identifierar datapunkten i det aktuella jobbet.

''update_uuid'' används för att ange vilket tidigare UUID den nya datapunkten ska kopplas till.

===== Rekommenderat arbetsflöde =====

För att kunna göra detta behöver du ha det gamla jobbet (med datapunkter från den gamla centralen) och ett nytt jobb (med datapunkter från den nya centralen).
**__Observera att du inte får starta det nya jobbet för att detta ska fungera.__** \\

  - Exportera datapunkter från det gamla jobbet, om det finns kvar.
  - Exportera datapunkter från det nya jobbet. **OBS!** Du får inte starta det nya jobbet för att ''update_uuid'' ska fungera.
  - Matcha gamla och nya datapunkter, exempelvis med källbeteckning.
  - Lägg till kolumnen ''update_uuid'' i importunderlaget.
  - Ange tidigare UUID i ''update_uuid'' för respektive ny datapunkt.
  - Importera CSV-filen i det nya jobbet.
  - Kontrollera resultatet.

===== Matchning =====

Matchning kan göras med exempelvis:

  * ''source_label''
  * systemspecifikt attribut
  * system och komponent
  * datapunktens funktion
  * annan stabil identifierare

Var försiktig om punktbeteckningar har ändrats. Kontrollera osäkra matchningar manuellt.

===== Viktigt =====

  * Ta backup innan import.
  * Ändra inte UUID:n utan tydligt syfte.
  * Kontrollera att varje ''update_uuid'' pekar på rätt tidigare datapunkt.
  * Dokumentera osäkra matchningar.

===== Användarguide med MS Excel =====
**__Observera att du inte får starta det nya jobbet för att detta ska fungera.__** \\
Börja med att ladda ned CSV-filen för bägge jobben. Detta gör du genom att gå in på jobbet och klicka på "Exportera CSV".
Starta sedan Excel, välj ett tomt dokument och klicka sedan på "From Text/CSV" för att importera en av CSV-filerna som du precis laddat ned från Miner.\\
{{:miner:guider:pasted:20250311-151034.png}}\\ \\
Välj valfri CSV-fil som du precis laddat ned. I rutan för granskningen väljer du "Transform Data". \\
{{:miner:guider:pasted:20250311-151047.png}}\ \\
Efter att ha valt "Transform Data" kommer du till PowerQuery. Mer om PowerQuery kan du läsa om [[https://learn.microsoft.com/en-us/power-query/power-query-what-is-power-query|här]]\\
I detta fönster behöver du ladda in CSV filen för det andra jobbet. Det gör du genom att klicka på "New Source" uppe i högra hörnet, välj sedan "File" -> "Text/CSV" och välj den andra filen. \\
{{:miner:guider:pasted:20250311-151056.png}} \\ \\
När filen är inläst behöver du markera det **nya** jobbet i listan till vänster, klicka sedan på "Merge Queries" enligt bilden nedan: \\
{{:miner:guider:pasted:20250311-151109.png}} \\ \\
I det nya fönstret är din fil förvald för hantering. Du behöver välja den andra filen enligt bilden nedan, se även till så att vi matchar på en kolumn vars rader är unika för varje datapunkt, exempelvis "**io_label**". I exemplet på bild lyckas vi matcha 280 datapunkter från det gamla jobbet till det nya jobbet, som har sammanlagt 3913 datapunkter. Klicka på OK om du är nöjd med matchningen.\\
{{:miner:guider:pasted:20250311-151121.png}} \\ \\
När du klickat på OK kommer Power Query matcha det gamla jobbet mot det nya jobbet och samla allt till en kolumn. Klicka på ikonen i den nya kolumnen för att välja de kolumner du vill ha med. I vårt fall är vi enbart intresserade av **UUID**. Se till att det ser ut enligt bilden nedan och klicka sedan på OK.\\
{{:miner:guider:pasted:20250311-151128.png}} \\ \\
Ändra sedan namn på kolumnen till "update_uuid", observera att det är väldigt viktigt att det blir rätt namn. Kolumnen ska se ut enligt nedanstående bild. \\
{{:miner:guider:pasted:20250311-151139.png}} \\ \\
Klicka sedan på "Close & Load". \\
{{:miner:guider:pasted:20250311-151149.png}}\\ \\
Nu borde du komma tillbaka till Excel, kontrollera att dina ändringar är gjorda och spara sedan filen/arket som CSV i UTF-8. \\
Ladda sedan in den till det nya jobbet via funktionen för "Importera datapunkter via CSV". Gå igenom alla steg tills du kommer tillbaka till jobb-vyn med alla datapunkter. Du kan kontrollera ifall ändringarna gått igenom genom att ladda ned CSV filen igen och jämföra "uuid" kolumnen med "update uuid" kolumnen från den filen som du läste in. 


===== Relaterade sidor =====

  * [[miner:anvandning:import-export|Import och export]]
  * [[miner:referens:grundattribut|Grundattribut]]
  * [[miner:faq|FAQ]]