# Starta Raptor på jobbdatorn

1. Ladda ner Raptor från https://kvalneslabs.com/projects/raptor/. Kontrollera filens SHA-256 mot värdet på sidan, till exempel med `Get-FileHash .\Raptor-0.35.9-windows.zip -Algorithm SHA256` i PowerShell.
2. Om SmartScreen visas: välj **Mer information → Kör ändå**.
3. Packa upp hela zip-filen i en egen mapp och kör **Installera Raptor.cmd**.
4. Under **Inställningar → Huvudtidplan → Byt eller anslut planfil**, klistra in den fullständiga lokala sökvägen från Utforskaren till antingen en synkroniserad `Huvudtidplan.xlsx` eller en `Huvudtidplan.xlsx.url`-genväg. Genvägen öppnas via Excel-appen med din jobbinloggning och måste provas på din dator. **Välj Excel-fil** läser in en separat kopia. Raptor skriver aldrig till originalfilen.
5. Raptor försöker hitta rätt blad och projektrader automatiskt. Om det inte går: välj **Mappa planfil manuellt** och kontrollera förhandsvisningen. Ingen separat JSON-profil behövs för att börja.
6. Under **Inställningar → Fler verktyg och inställningar → Delad projektdata**, ange sökvägen till en mapp som OneDrive synkar från SharePoint. Använd samma mapp på de andra datorerna. Raptor sparar varje ändring som en separat fil under `Raptor-data/events` och behåller en lokal kopia. Statusen visar att mappen har lästs, inte att OneDrive har levererat filerna till alla datorer.
7. Exportera Visma-vyerna **Produktion Planering** (båda flikarna), **Orderrader**, **Strukturer**, **G111 Effektuering**, **G112 Inköpsorder med Lagersaldo**, **Varumottag** och **orderbekräftelse**. Filtrera på **Ext. Projekt**. Exportera till Excel om valet finns. Annars markera och kopiera tabellen och använd **Klistra in ERP-tabell** under Inställningar i Raptor. Kontrollera identifierad vy eller **OKLART** efter import.
8. Öppna **Kontroll**. Sätt status på avvikelsen och skriv en kommentar i samma rad. Ändringarna sparas i lokal historik.
9. Välj **Exportera diagnostikpaket** under **Inställningar → Fler verktyg och inställningar → Data**. Standardläget innehåller bara rubriker och statistik. Riktiga rader och originalfiler följer endast med om du aktivt kryssar i **Ta med riktiga rader och originalfiler**.

## Uppdatera Raptor

Version 0.35.9 samlar filbyte, mappning, delad mapp, import/export och diagnostik under utfällbara avsnitt i Inställningar. Planfilens status och programuppdatering syns direkt. Version 0.35.8 gjorde Plan mer läsbar: projekt och läge ligger kvar till vänster, datum får fast bredd och övriga Excel-kolumner öppnas med **Visa Excel-kolumner**. Den rättar även en upprepad dialog om osparade ändringar vid automatisk omladdning. Den sparade sökvägen till huvudtidplanen och Raptors lokala projektdata ligger kvar vid uppdatering.

Version 0.35.7 kan läsa en lokal SharePoint-genväg (`.url`) via inloggad Excel-app och behåller senast fungerande plan när anslutningen inte svarar.

Version 0.35.4 gör projektöversikten tätare och visar öppna avvikelser, saknad verifiering och nästa daterade planpunkt direkt. Den låter också kalendern fylla det lediga fönstret och behåller veckoläget när du återvänder från ett projekt. Ritnings-BOM och orderbekräftelser med läsbart PDF-textlager kan importeras, men PDF-rader markeras för granskning. En PDF utan entydiga rader ersätter inte tidigare import. Skannade PDF-filer behöver OCR eller tabell-export. Conveyor öppnas lokalt i Raptor och sparade layouter ligger i Edges lokala webbläsarprofil; exportera en projektbackup från Conveyor för en separat kopia. Installera 0.35.4 från ZIP enligt stegen ovan om den äldre uppdateringsknappen visar `Failed to fetch`. Din Excel-fil och Raptors projektdata ligger separat från programmet.

För OCS-uppdateringar efter 0.35.4: välj den gemensamma OneDrive-mappen under **Inställningar → Fler verktyg och inställningar → Delad projektdata**. Raptor söker då endast i `Raptor-data/updates/latest.json` i den mappen. Den som publicerar en intern uppdatering lägger dit ZIP-paketet och ett manifest med `version`, `file`, `sha256`, `size` och `changes`. Varje dator använder sedan **Inställningar → Sök efter uppdatering**. Saknas mappen eller manifestet installeras inget automatiskt. En OCS-profil använder aldrig den publika uppdateringskanalen. Kontrollera att OneDrive har synkat paketet innan installation; Raptor verifierar storlek och SHA-256, tar säkerhetskopia och behåller Excel-filen orörd.

För den som publicerar nästa interna version finns `publish_ocs_update.py` i utvecklingsmappen. Kör `python publish_ocs_update.py --package dist\Raptor-X.Y.Z-windows.zip --folder "SÖKVÄG-TILL-DELAD-MAPP" --change "Kort beskrivning"`. Skriptet lägger paket och manifest i rätt mapp i rätt ordning.

Om du har 0.27.0, 0.34.0 eller 0.34.1: ladda ner 0.34.2, packa upp hela ZIP-filen i en ny mapp och kör **Installera Raptor.cmd** där. Starta sedan den nya genvägen. Användardata ligger separat och bevaras. Från 0.34.2 kan du använda **Inställningar → Sök efter uppdatering** för kommande versioner.

Från 0.33 öppnar Raptor snabbare efter att planen har lästs in en gång. Om OneDrive eller nätverket dröjer visas den senast inlästa planen med varning och tidpunkt. Raptor försöker läsa Excel igen automatiskt. Kontrollera varningen innan du fattar beslut utifrån planen. Den valda Excel-filen ändras aldrig av Raptor.

Om startfönstret bara visar `Filen finns inte` och den gamla `runtime`-mappen är låst körs troligen en äldre Raptor-process. Kör `Invoke-RestMethod -Method Post -Uri http://127.0.0.1:8766/api/stop -ContentType 'application/octet-stream' -Body ''` i PowerShell, vänta några sekunder och starta genvägen igen. I 0.33.1 upptäcker startskriptet en sådan äldre process automatiskt. Packa alltid upp hela ZIP-filen i en vanlig mapp innan du kör installeraren.

I 0.34 finns **Hem** i toppmenyn. **Läs om planfil** läser Excel och delade ändringar; **Sök efter uppdatering** under Inställningar avser själva Raptor-programmet. Under Inställningar kan du klistra in den lokala sökvägen till en OneDrive-synkroniserad Excel-fil. En SharePoint-webblänk kan inte användas utan separat Microsoft-inloggning. **Exportera förenklad plan** skapar en ny fil `Raptor-planexport.xlsx` med projekt och milstolpar; den ändrar inte originalplanen.

## Engångsbyte från 0.34.0 eller 0.34.1

Uppdateringsknappen i dessa versioner kan avbrytas när Windows håller installationsmappen låst. Ladda då ner 0.34.2 som ZIP och packa upp i en **ny mapp**. Kör `Installera Raptor.cmd` i den nya mappen och starta den nya genvägen. Startskriptet stänger den gamla Raptor-processen. Radera inte den gamla mappen förrän den nya versionen fungerar. Projektdata ligger separat och bevaras. Från 0.34.2 startar uppdateringshjälpen utanför installationsmappen.
