Snabbstart och nedladdning

Ladda ned Network Project v1.0.1 (ZIP)
Paketet är uppdaterat till v1.0.1. Skapad av MBerling · Utgiven av LabOps IT.

Arbetsordning: Projekt → Hallar/rack → Utrustning → Kablar med A/B-märkning → Installera och dokumentera → Verifiera → Checklista → Exportera komplett ZIP.

Så läser du guiden: Menyer, fält och exportformat beskriver faktiska funktioner i v1.0.1. Arbetsflödet i avsnitt 5, backupförslagen och godkännandekriterierna är rekommenderade arbetsrutiner. Appen utför inga fysiska tester eller formella godkännanden.

Skapare och fasta programtexter

Skapad av MBerling. Appen distribueras av LabOps IT. NETWORK / PROJECT och skaparinformationen är fasta i programfilerna och ändras inte via projektuppgifterna. Projektets namn, ansvarig, register och dokumentation är fortsatt redigerbara.

En lokal HTML-app kan inte förhindra att någon med skrivåtkomst ändrar dess källfiler. Hårdkodning ger fasta standardtexter, inte ett tekniskt ändringsskydd. Paketets SHA256SUMS.txt används för att jämföra distributionsfiler mot en betrodd kopia. Hämta paketets SHA-256-kontrollsumma. Spara en fullständig projektbackup innan du uppdaterar appen eller ändrar öppningsadress.

1. Översikt och syfte

När nätverksutrustning flyttas, switchar byts, fiberförbindelser patchas om eller nya server- och storageanslutningar installeras är den fysiska dokumentationen minst lika viktig som konfigurationen. Utan ett gemensamt kabelregister är det lätt att tappa bort vilken kabel som går mellan två portar, vilken transceiver som används och om förbindelsen har testats.

Network Project är ett offline-orienterat, webbläsarbaserat dokumentationsverktyg för:

  • Projektinformation: kund, anläggning, ansvarig, revisionsnummer och journal.
  • Fysisk platsstruktur: hallar, teknikrum, byggnader, rack och zoner.
  • Utrustningsregister: switchar, routrar, servrar, hypervisorer, storage, patchpaneler och ODF.
  • Kablar och förbindelser: unikt kabel-ID, från-/till-port, märkning i A- och B-ände, medium, kabelväg, hastighet och optik.
  • Genomförande: checklista, kommentarer, avvikelser och tidsstämplade aktiviteter.
  • Bevismaterial: foton, skärmbilder, PDF-filer, text- och konfigurationsfiler kopplade till rätt post.
  • Leverans: automatisk schematisk topologi, CSV-listor, JSON-data och fullständig projektbackup i ZIP.

Avgränsning: Verktyget konfigurerar inte switchar, upptäcker inte enheter automatiskt, gör ingen automatisk fiber-/kabelmätning och är inte ett DCIM-, NMS- eller change-management-system. Testvärden och inställningar läggs in manuellt.

2. För vem är det avsett?

Lämpliga användningsfall omfattar ny- eller omdragning av kablage i datorhallar, förändringar mellan teknikrum, rack-till-rack-förbindelser, utbyte av nätverksswitchar, tillkommande ESXi-/Hyper-V-/Linux-hostar, NAS/SAN-anslutningar, ODF-patchning, PoE-installationer och dokumentation av mindre eller större labbmiljöer.

Förutsättningar

  • Windows, macOS eller Linux med en modern webbläsare, helst Microsoft Edge eller Google Chrome.
  • Det nedladdade installationspaketet NetworkProject_LabOpsIT_v1.0.1.zip.
  • Grundläggande kännedom om egna switchportar, rackplaceringar och kabeltyper.
  • En plats att lagra exporterade projektbackuper enligt organisationens rutiner.
  • Ingen installation av server, konto eller internetanslutning krävs normalt.

Öppna helst verktyget från en fast katalog och samma webbläsarprofil varje gång. Data sparas i webbläsaren och följer inte automatiskt med om du byter profil eller dator.

3. Installera och starta

  1. Ladda ned installations-ZIP från LabOpsIT-guideartikeln eller projektets distribution.
  2. Packa upp hela ZIP-filen. Flytta inte bara index.html; den behöver filerna i assets/.
  3. Öppna NetworkProject_Dokumentation/index.html i Edge eller Chrome.
  4. Kontrollera att startsidan Översikt öppnas och att lokal sparning fungerar.
  5. Klicka på Redigera projektuppgifter och ange ett projektnamn.
  6. Exportera gärna en första projekt-ZIP när uppsättningen är klar.

Om webbläsaren inte tillåter bilagelagring via file://, kan projektmappen visas via en lokal HTTP-server, t.ex. om Python finns installerat:

cd NetworkProject_Dokumentation
python -m http.server 8000 --bind 127.0.0.1

Öppna därefter http://127.0.0.1:8000 i samma dator. Flaggan --bind 127.0.0.1 begränsar servern till den egna datorn. Stoppa den med Ctrl+C när arbetet är klart. Använd samma adress och port varje gång. Adresserna file:// och http://127.0.0.1:8000 är skilda lagringsursprung, vilket gör att tidigare webbläsarsparade projektdata inte automatiskt dyker upp när du växlar mellan dem. Exportera ZIP från den gamla öppningsmetoden och importera på den nya.

Katalogstruktur och första start

NetworkProject_Dokumentation/
  index.html                 Startfil
  assets/app.js              Programfunktioner
  assets/style.css           Utseende
  assets/                    Även medföljande exempelbilder
  exempel/exempelprojekt.json  Fiktivt demoprojekt
  backuper/README.md         Information om backup
  README.md                  Programbeskrivning
  STARTA_HAR.txt              Startinstruktion

Spara en första ändring, kontrollera texten Sparat lokalt längst ned i sidomenyn och ladda om sidan. Projektet ska finnas kvar. Katalogen backuper/ är ingen automatisk lagringsplats: exporter hamnar där webbläsaren sparar hämtade filer.

Tom mall i v1.0.1: NETWORK / PROJECT, 13 standardaktiviteter och den fasta skaparraden Skapad av MBerling.

4. Förstå huvudmenyn

MenyFunktionResultat
ÖversiktProjektuppgifter, nyckeltal, kvalitetskontroll, projektanteckningar och journalGemensam projektstatus
Hallar & rackByggnad, hall, teknikrum, rack, zon och rackhöjdFysisk placeringsstruktur
Utrustning & portarInventering och sökning på enhetsnamn, typ, modell och platsRegister över ändpunkter
Kablage & förbindelserA/B-ändar, unika kabel-ID:n, media, moduldata, märkning och verifieringKabellista och schematisk topologikarta
ChecklistaArbetsmoment, egna punkter, kommentarer och tidsstämplad avprickningSpårbar genomförandestatus
BildbilagorSamlad visning av filer kopplade till enheter, kablar och aktiviteterDokumentationsbibliotek
Export & backupFullständig ZIP, JSON, CSV samt återimportProjektöverlämning och säkerhetskopiering

5. Rekommenderat arbetssätt – från beställning till överlämning

Fas A – Skapa projekt

  1. Ange ett tydligt projektnamn (exempel: DC1 – Rack R01 till R04 – 10G fiberutbyggnad).
  2. Fyll i organisation/kund, anläggning/ort, projektansvarig, revision och startdatum.
  3. Skriv projektets omfattning, förutsättningar, eventuellt servicefönster, kontaktvägar och återställningsplan i projektanteckningarna.
  4. Använd Projektjournal för tidsstämplade beslut, ändringar och överenskommelser.

Det medföljande demoprojektet kan importeras från exempel/exempelprojekt.json. Det har egna exempelaktiviteter; ett nytt tomt projekt har de 13 standardaktiviteterna i avsnitt 7. Exportera alltid ditt aktuella projekt först.

Fas B – Inventera fysisk miljö

  1. Gå till Hallar & rack och skapa berörda platser. Exempel: Hall A, Hall B, Teknikrum Nord.
  2. Lägg till rack för varje plats, exempelvis R01, R04 eller ODF-A.
  3. Välj Ny hall / plats, ange namn, byggnad/ort, platstyp och kommentar. Klicka Spara uppgifter.
  4. Välj Nytt rack, ange rackbeteckning, välj Tillhör plats, fyll i zon/rad och rackhöjd, exempelvis 42U, och spara. Skapa R01 i Hall A och R04 i Hall B. Kontrollera själv att enhetens hall och rack hör ihop; rackvalet visar hela registret.
  5. Fotografera nuläget innan någon befintlig kabel kopplas ur.

Bra princip: Använd samma racknamn som i befintliga märksystem, inventarielistor och lokala driftinstruktioner.

Fas C – Registrera utrustning

Gå till Utrustning & portar och välj Lägg till enhet. Registrera relevanta ändpunkter innan kabelregistret fylls i.

FältVad ska anges?Exempel
EnhetsnamnEgentligt hostname eller fysisk utrustningsbeteckningDC1-SW-LEAF01
EnhetstypSwitch, server, storage, patchpanel/ODF, router m.m.Switch
Tillverkare och modellFör igenkänning och teknisk kompatibilitetDell / PowerSwitch
Inventarie-ID / serienummerOm organisationens policy medger detINV-0041
Management-IP eller DNSFrivillig referens, om lämpligt att dokumenterasw-leaf01.example.local
Hall/plats och rackFysisk placeringHall A / R01
RackpositionU-platsU17–U18
Roll/funktionVad enheten används tillServer access, Aggregation, SAN
KommentarFirmware, installationsegenskaper, beroendenUplink 49–50 reserverad

Verktyget är ett enhetsregister med portangivelser per kabel, inte ett separat automatiskt portinventeringssystem. Portinformation kopplas till varje skapad förbindelse. Fyll exempelvis i DC1-SW-LEAF01, typen Switch, Hall A, R01 och U17–U18, och välj Spara uppgifter. Skapa sedan DC1-NAS-01 i Hall B/R04. Välj Ändra för att rätta en post och Öppna för enhetens kommentarer och bilagor.

Fas D – Dokumentera kablar och fysiska förbindelser

Gå till Kablage & förbindelser → Ny förbindelse. En länk dokumenteras från A-ände till B-ände. Välj först de två registrerade enheterna, skriv deras exakta portar och fyll därefter i märkning och teknik. Avsluta med Spara uppgifter. Båda enheter och båda portfält krävs; appen stoppar också en förbindelse som börjar och slutar på samma enhet och samma port.

Identitet och märkning

FältBetydelse
Unikt kabel-IDProjektets unika identitet för förbindelsen; dubletter blockeras
StatusPlanerad / Installerad / Verifierad / Avvikelse / Ur drift
A: Från enhetRegistrerad enhet där A-änden terminerar
A: Port/interfaceFaktiskt portnummer, interface eller panelposition
A: Fysisk kabelmärkningTexten på etiketten vid A-änden
B: Till enhetRegistrerad enhet där B-änden terminerar
B: Port/interfaceFaktiskt portnummer, interface eller panelposition
B: Fysisk kabelmärkningTexten på etiketten vid B-änden

Kabelmedium och teknik

FältTillgängliga val / användning
AnslutningstypFiber, Koppar / RJ45, DAC, AOC, Övrigt
Länkhastighet100M, 1G, 2.5G, 5G, 10G, 25G, 40G, 100G, 200G, 400G, Annat
FiberklassOS1, OS2, OM1, OM2, OM3, OM4, OM5, Annat
KopparkategoriCat5e, Cat6, Cat6A, Cat7, Cat8, Annat
Kabelns längdUppskattad eller uppmätt längd i meter
Fibrer/par/kärnorExempel: 2 fibrer, 1 par, 12F
A-/B-kontaktExempelvis LC/UPC, LC/APC, SC/UPC, SC/APC, MPO/MTP, RJ45, DAC
A-/B-modultypExempelvis SFP+ 10G SR, SFP+ 10G LR, SFP28 25G LR, QSFP28 100G SR4, 10GBASE-T SFP+, DAC/AOC
A-/B-modellModulens exakta tillverkare och artikelbeteckning, separat i vardera ände
KabelvägMellanliggande ODF-/patchpanelportar och kabelrutt
Funktion/trafikExempelvis Uplink, Storage, Management, vMotion, Backup
Verifierad avUtförarens namn eller initialer
TestdatumDatum för verkligt utförd kontroll
Mätresultat/länkstatusFaktisk länkstatus, felräknare, optiknivå, testprotokollreferens
KommentarAvvikelse, konfigurationsutdrag eller arbetsanteckning

Viktigt vid patchpaneler/ODF: Om varje fysisk kabelsektion behöver separat spårbarhet, registrera patchpaneler eller ODF som enheter och skapa en post per fysisk kabel/patchsegment. En enda post mellan switch och server genom flera paneler ger en förenklad ändpunktsöversikt, inte en fullständigt separat märkt kabelinventering över varje segment.

Fas E – Märkning vid båda ändar

Organisationens egen märkstandard gäller. Applikationen tvingar inte fram ett visst prefix. En god princip är att en kabel har ett gemensamt unikt kabel-ID, men att etiketttexten kan skilja sig mellan A- och B-änden.

Exempel:

Kabel-ID:    DC1-FO-0027
A-ände:      DC1-FO-0027 | R01 SW-LEAF01 Eth1/49 → R04 NAS-01 SFP1
B-ände:      DC1-FO-0027 | R04 NAS-01 SFP1 → R01 SW-LEAF01 Eth1/49
Kabelväg:   Hall A ODF-01/12 → Hall B ODF-03/08

För långa etiketter kan kortare lokala märkningar användas, så länge båda ändar kan spåras till samma unika ID i registret. Läsbarhet, vatten-/värmetålighet och organisationens lokala märksystem avgör faktisk etikettutformning.

Fas F – Installera och dokumentera

  1. Kontrollera att beställd kabel/optik passar gränssnitt, fiberklass, avstånd och kontaktstandard.
  2. Märk kablarna innan de dras eller direkt vid terminering.
  3. Följ godkänd kabelväg och dokumentera avsteg.
  4. Patcha rätt port på rätt enhet i båda ändar.
  5. Uppdatera postens status till Installerad.
  6. Öppna kabelns Detaljer och bifoga fotografi eller skärmbild.
  7. Ange en kort bildtext, exempelvis R01 – port 49 – märkning efter installation.
  8. Skriv kommentar om något skiljer sig från planeringen.

Fas G – Verifiera

Kontrollera förbindelsen med metoder anpassade till mediet och utrustningen. Dokumentera observerade värden, inte tänkta hastigheter.

Fiber: Kontrollera bl.a. modulkompatibilitet, kontakttyp/polaritet, faktisk länkhastighet, länkstatus, optikens Rx-/Tx-värden om tillgängliga och eventuell mät-/dämpningsrapport.

Koppar/RJ45: Kontrollera parterminering, kategori, kabeltest/certifiering där det krävs, PoE-behov vid tillämpliga förbindelser, förhandlad hastighet och portfel.

DAC/AOC: Kontrollera längd, kompatibilitet med båda ändpunkter, portläge, länkstatus och felräknare.

För varje verifierad länk dokumenteras minst:

  • Namn/initialer på tekniker.
  • Testdatum.
  • Uppnådd hastighet och länkstatus.
  • Eventuella felräknare/mätvärden eller referens till testprotokoll.
  • Avvikelser och åtgärder.
  • Bilaga som underlag när sådant finns.

Byt därefter manuellt status till Verifierad. Om problem kvarstår används Avvikelse och konkret beskrivning av felet.

Fas H – Överlämna

  1. Kontrollera att varje förbindelse har enhet och port i båda ändar.
  2. Kontrollera att kabel-ID och A/B-märkning är ifyllda.
  3. Kontrollera kvarvarande poster med status Planerad, Installerad eller Avvikelse.
  4. Uppdatera bilder och kommentarer så att de avspeglar färdig installation.
  5. Exportera Märklista CSV, Kabellista CSV och Utrustningsregister CSV vid behov.
  6. Exportera topologikarta som PNG eller SVG.
  7. Exportera fullständig ZIP-backup och lagra den enligt organisationens rutin.
  8. Sätt ett lämpligt revisionsnummer i projektet och dokumentera överlämning i journalen.

6. Kabelteknik och tre praktiska exempel

Dokumentera medium, kontaktdon och transceivrar

Programfunktion: Listorna är dokumentationsval. De räknar inte ut räckvidd, optikbudget eller kompatibilitet. Vald länkhastighet innebär ingen kontroll av att utrustningen stöder den.

GruppVad du registrerarPraktisk kontroll utanför appen
FiberklasserOS1, OS2, OM1, OM2, OM3, OM4, OM5 eller AnnatLäs verklig kabelmärkning och installationsunderlag; välj rätt klass för vald optik.
Koppar/RJ45Cat5e, Cat6, Cat6A, Cat7, Cat8 eller AnnatRegistrera kabelns faktiska kategori och terminering. Ett menyval är inget certifieringsresultat.
DACMedium DAC, längd, SFP+ DAC eller QSFP DAC; DAC passiv/aktiv som modultypNotera kabelns artikelnummer i respektive modellfält och kontrollera stöd i båda ändpunkter.
AOCMedium AOC, längd och modultyp AOCDokumentera den färdiga kabelns modell och portformat i modell-/kommentarsfälten.
KontaktdonLC/UPC, LC/APC, SC/UPC, SC/APC, MPO/MTP, RJ45, SFP+ DAC, QSFP DAC, Annat eller —Registrera varje ände separat. Bekräfta kontakttyp och polaritet mot faktisk installation.
SFP-familjerSFP 1G SX/LX; SFP+ 10G SR/LR/LRM/ER; SFP28 25G SR/LRVälj typ och skriv exakt fabrikat/artikelnummer separat för A och B.
QSFP-familjerQSFP+ 40G SR4; QSFP28 100G SR4/LR4Kontrollera vald modul, portläge och kabelsystem mot hårdvarans dokumentation.
Övriga moduler10GBASE-T SFP+, DAC passiv, DAC aktiv, AOC eller Annat (beskriv i modellfält)Använd Annat om den exakta typen saknas; beskriv den i modellfältet.

Rekommenderad arbetsrutin: Behandla hastighet, fiberklass, kontakt och modultyp som separata uppgifter. Fyll inte i fiberklass för en vanlig kopparlänk. Använd — för modul när porten är inbyggd RJ45. Kontrollera leverantörens kompatibilitetsunderlag inför inkoppling; guiden är ingen dimensioneringstabell.

Exemplens mätresultat är fiktiva och visar hur ett utfört test kan dokumenteras. Kopiera dem aldrig som resultat för en oprövad länk. Börja med Planerad, byt till Installerad efter patchning och först till Verifierad efter verklig kontroll.

Exempel 1 – Fiber mellan switch och storage

ParameterExempelvärde
Kabel-IDDC1-FO-0027
A-enhet / portSW-LEAF01 / Eth1/49
B-enhet / portNAS-01 / SFP1
MediumFiber
FibertypOS2
KontakterLC/UPC i båda ändar
OptikSFP+ 10G LR i båda ändar
Hastighet10G
StatusVerifierad när test klarats
TestresultatLänk 10G up; inga CRC-fel; optikvärden enligt bilaga

Exempelvärdena illustrerar dokumentationsformatet; faktisk kompatibilitet och optikbudget ska kontrolleras mot vald hårdvara.

Exempel 2 – Koppar mellan switch och ESXi-host

ParameterExempelvärde
Kabel-IDDC1-CU-0104
A-enhet / portSW-ACCESS02 / Port 7
B-enhet / portESXI-03 / vmnic1
MediumKoppar / RJ45
KabeltypCat6A
KontaktRJ45 i båda ändar
Optik/modul— där vanlig RJ45 används
Hastighet2.5G
Testresultat2.5G full duplex, felräknare 0

Exempel 3 – DAC mellan två switchar

ParameterExempelvärde
Kabel-IDDC1-DAC-0008
Från / tillSW-AGG01 SFP+ 1 → SW-LEAF02 SFP+ 49
MediumDAC
Kontakt och modulSFP+ DAC, passiv/aktiv enligt faktiskt kablage
Längd1 m
Hastighet10G
TestresultatLänk up 10G, inga portfel

7. Checklistan – 13 fördefinierade aktiviteter

Verktyget levereras med följande checklista. Varje aktivitet kan markeras klar, kompletteras med kommentar och få bilagor:

Förberedelse

  1. Definiera omfattning, ansvar och eventuell avbrottstid.
  2. Inventera befintliga portar och anslutningar.
  3. Fotografera nuvarande installation före ändring.

Märkning

  1. Märk båda ändarna av samtliga berörda kablar.
  2. Kontrollera kabel-ID mot dokumenterad portlista.

Installation

  1. Verifiera typ och kompatibilitet för transceivrar.
  2. Kontrollera fiberklass, patchkablage och kontaktdon.
  3. Installera och patcha förbindelser enligt plan.

Verifiering

  1. Kontrollera fysisk länkhastighet och felräknare.
  2. Verifiera host- och storageanslutningar.
  3. Dokumentera testresultat samt eventuella avvikelser.

Överlämning

  1. Ta foton av färdig installation och stäm av märklappar.
  2. Exportera projektbackup och spara slutlig märklista.

Du kan lägga till egna aktiviteter via Checklista → Ny aktivitet, exempelvis Godkännande från driftansvarig, Kontroll av redundanta vägar eller Återställningstest. Vid avprickning sparas en tidsstämpel. Avprickningen är en manuell arbetsmarkering och ingen automatisk verifiering.

8. Bilder och dokument som bevismaterial

För en kabel väljer du Detaljer, för en enhet Öppna och för en aktivitet Dokumentera. I detaljvyn lägger du till kommentarer och bilagor. Det går att välja filer, dra och släppa filer och klistra in skärmbilder med Ctrl+V i detaljvyn.

Stödda användningsfall: fotografier av rack och kabelmärkning, skärmbilder på portstatus, optikvärden och testresultat, PDF-protokoll, text/loggar, CSV, JSON, XML, YAML och vanliga konfigurationsutdrag. En fil kan vara högst 20 MB; flera bilagor kan kopplas till samma post inom webbläsarens lagringskapacitet.

Skriv en bildtext som berättar vad bilden visar, vilken enhet/kabel/port som avses och när bilden togs. Exempel: 2026-10-09 – DC1-SW-LEAF01 Eth1/49 – 10G LR, link up.

Publiceringssäkerhet: Skärmbilder kan innehålla IP-adresser, DNS-namn, serienummer, interna topologier, kontouppgifter och andra skyddsvärda data. Maskera eller uteslut känslig information innan material delas utanför den behöriga gruppen. Lägg aldrig lösenord, privata nycklar eller hemliga tokens i dokumentationsfält eller bilagor.

9. Topologikartan

När enheter och kablar registrerats skapas automatiskt en schematisk nätverkskarta under Kablage & förbindelser. Enheterna grupperas efter plats och linjer visar dokumenterade förbindelser. Färgen särskiljer fiber/AOC, koppar/RJ45, DAC, övrigt samt avvikelse. Kartan kan exporteras som PNG eller SVG.

Kartans syfte är att ge snabb överblick över dokumenterade ändpunkter. Den är inte en skalenlig kabelritning, visar inte automatiskt exakta rackpositioner, fysisk kabelstege eller alla mellanliggande patchsektioner som inte dokumenterats separat.

10. Sökning och kvalitetskontroll

  • Sök i utrustningsregistret på namn, modell, kategori och rack.
  • Sök i kabelregistret på kabel-ID, port, ändpunkt, optik och kabelväg.
  • Filtrera förbindelser efter status: Planerad, Installerad, Verifierad, Avvikelse, Ur drift.
  • Översikten visar antal registrerade enheter, förbindelser, verifierade förbindelser och avklarade checklistesteg.
  • Kvalitetsindikatorer uppmärksammar ofullständig kabelmärkning och saknad port i någon ände.
  • Dubbletter av kabel-ID stoppas. Om en port redan förekommer på en annan förbindelse visas en varning som kan godkännas. Detta är inte en garanti mot alla felaktiga kabeldragningar.

11. Export, backup och återläsning – mycket viktigt

ExportVad ingår?Typisk användning
Fullständig ZIP-backupdata/projekt.json, register som CSV och alla originalbilagor i separata katalogerArkivering, flytt och återställning
JSONProjektets strukturerade uppgifter och referenser, inte själva bilagefilernaMaskinell vidarebearbetning och versionshantering
Kabellista CSVDokumenterade förbindelserExcel och teknisk överlämning
Märklista CSVTvå märkningsrader per kabel, A- och B-ändeMärksystem och fysisk uppmärkning
Utrustning CSVRegister över enheterInventering och kompletterande dokumentation
Topologi PNG / SVGSchematisk kartaGuide, arbetsorder och dokumentationsbilaga

CSV-filerna använder semikolon och UTF-8 med BOM för att fungera väl i svensk Excel-miljö.

Skillnad mellan två ZIP-filer:

  1. Installations-ZIP: Den distribuerade applikationen med index.html, assets/ och eventuellt demoexempel. Behåll detta paket.
  2. Projektbackup-ZIP: Skapas när du väljer Exportera fullständig ZIP inne i applikationen. Innehåller aktuellt projekts data, register och bilagor, men inte själva applikationsfilerna.

Säkerhetskopiering – föreslagen rutin

  • Gör en komplett ZIP-export före en större omkoppling.
  • Gör en ny backup efter varje avslutad arbetsetapp.
  • Gör en slutlig exporterad ZIP vid överlämning.
  • Förvara exporter i ett behörighetsstyrt arkiv med versions-/datuminformation.
  • Testa återimport av en kopia innan kritiska originaldata tas bort.

Import och återställning

Öppna Export & backup → Importera ZIP / JSON. Endast projekt-ZIP som verktyget självt skapat stöds för direkt ZIP-import. Importen ersätter det aktuella projektet, inklusive tidigare bilagor. Exportera därför en backup innan du importerar demo eller ett annat projekt.

Viktig detalj: Verktygets ZIP-format är okomprimerat (ZIP store). Om någon packar upp och sedan omkomprimerar backupen med en annan ZIP-metod kan återimport misslyckas. Använd originalexporten för återställning.

Återställ steg för steg

  1. Exportera det aktuella projektet som fullständig ZIP innan du byter projekt.
  2. Välj Importera ZIP / JSON och öppna den orörda projektbackupen. CSV, PNG och SVG kan inte importeras som projekt.
  3. Läs bekräftelsen med projektnamnet: befintliga data och bilagor ersätts. Godkänn först när din nuvarande backup är sparad.
  4. Kontrollera projektnamn, revision, antal enheter och förbindelser. Öppna några bilagor och kontrollera att de följt med.
  5. Exportera en ny fullständig ZIP efter att återställningen verifierats.

JSON-import återställer strukturerade uppgifter men inte bilagornas innehåll, och ersätter också den tidigare lokala bilagelagringen. Importera inte JSON som ersättning för en fullständig återställning. Demofilen under exempel/ importeras med samma knapp och ersätter även den det aktuella projektet.

Starta nytt projekt

Via Export & backup → Starta nytt projekt kan användaren rensa registrerad information och börja om. Detta raderar den aktuella lokala projektinformationen och bilagorna från den webbläsarprofilen; gör först en fullständig backup. Efter bekräftelsen måste du skriva NYTT för att genomföra rensningen.

12. Lagring, integritet och samarbete

  • Projektets strukturerade data sparas i webbläsarens localStorage.
  • Bilagor lagras i IndexedDB i samma profil/ursprung.
  • Uppgifterna skrivs inte automatiskt tillbaka till index.html eller programmappen.
  • Ingen extern molnlagring ingår och ingen inloggning behövs.
  • Om webbläsardata rensas, profilen byts eller lagringskvoten överskrids kan lokala projektdata gå förlorade.
  • Projektet är inte byggt för samtidig redigering av flera personer; olika datorer/profiler får separata kopior. Samordna genom bestämd projektägare och importerade/exporterade backupversioner.
  • Programmet gör ingen automatisk versionskonflikthantering, behörighetsadministration eller kryptering av exporterade filer.
  • Skydda projektbackuper och konfigurera behörigheter i det system där filerna lagras.

13. Vanliga frågor och felsökning

Sidan öppnas, men mina uppgifter finns inte kvar. Kontrollera att du använder samma dator, webbläsarprofil och öppningsadress. Projekt lagras lokalt, inte inuti HTML-filen. Importera sparad projekt-ZIP om du bytt miljö.

Det går inte att lägga till bilder. Prova Edge/Chrome och kontrollera om IndexedDB är tillgängligt. Öppna vid behov sidan via http://127.0.0.1:8000 som ovan. Exportera från eventuellt tidigare ursprung innan byte.

Topologin är tom. Lägg först till minst två enheter och en förbindelse mellan dem.

Jag får varning om upptagen port. Kontrollera om porten redan är upptagen av en dokumenterad länk. Varningen kan godkännas, så den kräver teknisk granskning.

En kabel saknas i märklistan. Kontrollera att posten sparats under Kablage & förbindelser och att ett giltigt kabel-ID finns.

Import av ZIP misslyckas. Använd ett orört projektbackup-ZIP skapat av samma applikation. Ett godtyckligt ZIP-arkiv, installationspaketet eller en ompackad backup stöds inte som projektimport.

Projektet behöver delas mellan två tekniker. Bestäm vem som gör uppdateringar i originalet. Exportera och överlämna projektpaketet vid övergång; parallella ändringar går inte automatiskt ihop.

14. Exempel på godkännandekriterier vid hall-dragning

En förbindelse kan betraktas som dokumentationsmässigt godkänd när:

Observera: Det är ett rekommenderat arbetssätt för denna guide, inte en automatisk godkännandekontroll i appen eller en ersättning för organisationens formella mottagningskontroll.

15. Rekommenderad dokumentation att överlämna

Vid färdigt projekt kan projektledaren överlämna:

  1. Reviderad kabel- och märkningslista (CSV).
  2. Utrustningsregister (CSV).
  3. Schematisk fysisk topologi (PNG eller SVG).
  4. Komplett projektbackup (ZIP) med registrerade bilagor.
  5. Eventuella certifieringsrapporter från externa mätinstrument.
  6. En sammanfattning av öppna avvikelser och vem som ansvarar för dem.

Undvik att publicera fullständiga interna produktionsregister öppet. Skärmbilder och demoexempel som delas offentligt ska innehålla endast fiktiva uppgifter.

16. Checklista för slutleverans

Rekommenderad arbetsrutin – bockas av av projektets ansvariga. Rutorna är ett lässtöd på den här guidesidan och sparas inte när sidan laddas om. Registrera projektets utförda kontroller i appens egen checklista.

17. Underlag och versionsgräns

Guiden gäller Network Project v1.0.1 i det medföljande installationspaketet. Huvudkälla är det bifogade masterdokumentet; menyer, fält, validering, lagring, bilagor, export och import har kontrollerats mot originalets index.html och assets/app.js. Skärmbilderna visar den uppdaterade appen v1.0.1 med en tom projektmall. Version 1.0.1 ändrar profilering och skaparinformation; projektformat, lagringsnycklar och dokumentationsfunktioner är oförändrade från v1.0. Revidera guiden när applikationen ändras.