Ga naar hoofdinhoud

Import / Export

OpSee ondersteunt massale import en export van apparatuurdata via Excel-bestanden (.xlsx). Dit is handig voor de eerste configuratie, migratie vanuit andere systemen, back-ups en bulkupdates.

Import / Export openen​

In de werkbalk van het apparatuurraster zijn twee knoppen beschikbaar:

KnopPictogramBeschrijving
ImporterenUploadenOpent het importdialoog om een Excel-bestand te uploaden
ExporterenDownloadenOpent het exportdialoog om apparatuur als Excel te downloaden

Import-/Export-knoppen in de werkbalk

Apparatuur exporteren​

Stappen​

  1. Klik op de knop Exporteren in de werkbalk
  2. Configureer in het exportdialoog de opties:
    • Bestandsnaam: de standaardnaam is voorgevuld met een vertaalde naam; pas aan indien nodig
    • Inactieve meenemen: schakelaar om inactieve apparatuur in de export op te nemen (standaard uit)
  3. Klik op Exporteren

Een Excel-bestand wordt gedownload met alle apparatuur die aan de gekozen opties voldoet.

Exportdialoog

Geëxporteerde kolommen​

Het Excel-bestand bevat de volgende kolommen:

KolomBeschrijving
IDApparatuur-ID (alleen-lezen, gebruikt voor updates)
NaamNaam van de apparatuur
BeschrijvingBeschrijving van de apparatuur
Ouder-IDID van de bovenliggende apparatuur
Type-IDID van het apparatuurtype
TypenaamNaam van het apparatuurtype (alleen-lezen, ter referentie)
PictogramPictogram-identificatie (bv. mdi:cog)
KleurKleurcode hex (bv. #1976d2)
IngeschakeldActieve status (true/false)
tip

Exporteer je huidige apparatuur voor je bulkwijzigingen doorvoert. Zo heb je een back-up om naar terug te zetten als dat nodig is.

Apparatuur importeren​

Stappen​

  1. Klik op de knop Importeren in de werkbalk
  2. Upload in het importdialoog een Excel-bestand (.xlsx)
  3. OpSee valideert het bestand en toont een voorbeeld van de data
  4. Controleer het voorbeeld en bevestig de import
  5. Apparatuuritems worden aangemaakt of bijgewerkt op basis van de data

Bestandsformaat​

Het importbestand moet dezelfde kolomstructuur hebben als de export. De eenvoudigste manier om het juiste formaat te krijgen is eerst exporteren, het bestand aanpassen en opnieuw importeren.

Importgedrag​

ScenarioGedrag
Rij zonder IDEen nieuw apparatuuritem wordt aangemaakt
Rij met bestaande IDDe bestaande apparatuur wordt bijgewerkt
Rij met onbekende IDEr wordt een fout gemeld voor die rij
Verplicht veld (Naam) leegEr wordt een fout gemeld voor die rij

Validatie​

Voor de verwerking controleert OpSee:

  • Verplichte velden: Naam moet aanwezig zijn
  • Ouder-referenties: Ouder-ID's moeten naar bestaande apparatuur verwijzen
  • Type-referenties: Type-ID's moeten naar bestaande apparatuurtypes verwijzen
  • Duplicaatdetectie: waarschuwt als de import duplicaten zou aanmaken
info

Importbewerkingen worden gelogd in het Audit Trail. Elke aangemaakte of bijgewerkte apparatuur genereert een audit-vermelding met gebruiker, tijdstempel en oude/nieuwe waarden.

Sjabloon​

Als je begint zonder bestaande apparatuur om te exporteren, kun je een leeg Excel-bestand met de juiste kolomkoppen aanmaken:

IDNaamBeschrijvingOuder-IDType-IDTypenaamPictogramKleurIngeschakeld
Vullijn 1Hoofdvullijn15Unitmdi:cog#1976d2true
Mixer APrimaire mixer15Unitmdi:mixer#2e7d32true
tip

Laat de kolom ID leeg voor nieuwe apparatuur. OpSee kent ID's automatisch toe. De kolom Typenaam wordt bij het importeren genegeerd, alleen Type-ID wordt gebruikt.

Duplicaten opschonen​

Als een import duplicaten aanmaakt (zelfde naam, ouder en type), gebruik dan de knop Duplicaten opschonen in de werkbalk. Deze tool:

  1. Groepeert apparatuur op naam, ouder-ID en type-ID
  2. Identificeert groepen met meer dan één vermelding
  3. Behoudt het oudste item (laagste ID) en verwijdert de rest definitief
  4. Rapporteert hoeveel duplicaten zijn verwijderd
waarschuwing

Duplicaten opschonen voert een harde verwijdering uit op duplicaatvermeldingen. Dit kan niet ongedaan worden gemaakt. Exporteer altijd eerst je apparatuur als back-up voor je deze tool uitvoert.

Beste praktijken​

  1. Exporteer voor het importeren: maak altijd een back-upexport voor een bulk-import.
  2. Gebruik export als sjabloon: exporteer bestaande apparatuur om de juiste bestandsstructuur te krijgen en voeg vervolgens nieuwe rijen toe.
  3. Kleine batches: importeer in grote fabrieken in batches (bv. per zone) om controle en troubleshooting eenvoudiger te maken.
  4. Controleer ouder-ID's: zorg dat ouder-apparatuur bestaat voor je child-items importeert. Importeer eerst de items op het hoogste niveau, daarna de kinderen.
  5. Opschonen na import: voer Duplicaten opschonen uit na bulk-imports om eventuele toevallige duplicaten op te vangen.

Vereisten​

Volgende stappen​

Gerelateerd​