Hoppa till huvudinnehåll

Lektion 1.4 Exportera och importera data med CSV

Ett av de enklaste sätten att exportera data ur Yggio är att exportera det som CSV. Detta kan göras både för vyer och tidsserier. Det kan också användas för att snabbt redigera namn på flera enheter och till och med ändra data (rekommenderas inte). Du kan använda detta för batchhantering.

Denna lektion går igenom hur man exporterar data till CSV-filer, ändrar dem och sedan importerar dem för att uppdatera enheter. Den sista delen av lektionen är ett exempel på hur man importerar tidsseriedata från en CSV till en befintlig enhet.

Exportera vydata med select many​

Gå till Devices:

  1. Välj eller skapa en vy med den data du vill exportera (under fliken Devices).

  2. Välj enheterna med Select Many.

  3. Klicka på Export to File i menyn Select Many.

    Yggio export with CSV

  4. I exportdialogen:

    • Se till att inkludera fältet _id - detta krävs för batchuppdateringar.
    • Fältet name inkluderas automatiskt.
    • Inkludera eventuellt andra fält du vill exportera eller uppdatera.
    • Du kan också lägga till nya fält senare direkt i CSV-filen - plattformen skapar dem vid uppladdning.
    • Om din vy innehåller översättarkolumner exporteras de med korta translatorX...-namn (t.ex. translator1.temperature) istället för den underliggande strukturen translatorPreferences.0.parameters.temperature - se Uppdatera översättarinställningar via CSV nedan.

  5. Välj ett filnamn och klicka på Export as CSV.

Du har nu en CSV-fil redo för redigering och återuppladdning via Batch Management.

Observera: CSV-filen använder , som kolumnavgränsare.

Om din dators språkinställning använder ; som standardavgränsare kan program som Excel eller Libre Office visa datan felaktigt i en tabell. Så här åtgärdar du det:

  1. Öppna CSV-filen i en enkel textredigerare, till exempel Anteckningar.
  2. Använd Ersätt alla för att ersätta alla , med ;.
  3. Spara filen och öppna den sedan i Excel.

Ändra CSV-fil​

När du laddar upp en CSV kommer plattformen antingen att uppdatera befintliga fält eller skapa nya baserat på kolumnerna:

  • Kolumner som matchar befintliga enhetsfält kommer att uppdatera dessa värden.
  • Nya kolumner kommer automatiskt att skapa dessa fält och tilldela värdena.

Att redigera CSV:n är valfritt men användbart för att ändra namn, metadata eller lägga till fält före uppladdning. Vanliga användningsområden inkluderar:

  • Döpa om enheter genom att redigera kolumnen name-detta är det vanligaste användningsfallet.
  • Uppdatera metadata som:
    • Installatörsinformation
    • Plats (byggnad, rum)
    • Installationsdatum eller taggar
  • Undvik att redigera sensordata (rekommenderas inte) manuellt-det rapporteras automatiskt av enheten.
  • Lägga till nya fält genom att helt enkelt lägga till kolumner med värden; plattformen skapar dem per enhet.
  • Ta bort blockerade fält, som reportedAt, som inte bör inkluderas.

Se alltid till att din CSV är korrekt formaterad innan uppladdning. Plattformen accepterar både , och ; som kolumnavgränsare.

Uppdatera översättarinställningar via CSV​

Översättarnamn, version, uppgraderingspolicy och parametrar kan också batch-uppdateras genom samma CSV-flöde. Kolumner använder den korta namngivningen translatorXName, translatorXVersion, translatorXUpgradePolicy och translatorX.[fältnamn] för parametrar, där X är ett nummer från 1 till 4 (samma namngivning som används för Batch Install). Inkludera endast kolumnerna för de översättare och fält du vill ändra - en enhets övriga översättare och parametrar lämnas oförändrade:

_id,name,translator1Name,translator1Version,translator1UpgradePolicy,translator1.protocol
6707091c22a62e0cf1713d15,People-Counter-1,my-translator,1.0.0,minor,lorawan

Ladda tillbaka CSV till IoT-plattformen​

När CSV-filen har ändrats, gå till Devices → Batch Update och dra-och-släpp CSV:n i uppladdningsrutan.

  1. Om du uppdaterar fältet contextMap kommer systemet att fråga om du vill lägga till de nya kontextkartorna eller ersätta de befintliga.
  2. Starta uppdateringen. Beroende på hur många enheter du uppdaterar kan denna process ta lite tid.

Exportera ett diagram​

Att exportera ett diagram i IoT-plattformen är väldigt enkelt. Detta är utmärkt för att exportera tidsserier för enheter. Tidsseriediagramrapporterna är inte avsedda att laddas tillbaka in i plattformen, de är avsedda att exportera tidsserier av data. Det finns två sätt att göra detta på, antingen gör du det på diagram i enheten eller i den avancerade vyn i diagram i enhetsmenyn. Dessa är inte avsedda att laddas tillbaka in i plattformen

Chart

  1. Klicka på enheten du vill använda
  2. Gå till "Charts"
  3. Använd antingen den avancerade vyn eller standardvyn för diagram och anpassa den för att visa den data du vill exportera, klicka sedan på "Download data"
  4. Välj ett namn och tryck på "Download as CSV"

Importera tidsseriedata​

Det är möjligt att importera tidsseriedata till plattformen från externa textfiler via API:et. Denna process kan också använda en översättare för att avkoda inkommande data. Eftersom detta är ett ovanligt användningsfall finns det för närvarande inget UI-stöd. Dessutom kan det, beroende på enhetsinställningarna, krävas särskilda åtgärder för att ta bort skydd för oföränderlig historisk data.

En kort översikt av processen:

  1. Lägg till en tillfällig "secret" på iotnoden via API:et.
  2. Läs textfilen som innehåller din data med ett lämpligt verktyg (t.ex. Postman) och konvertera den till JSON.
  3. Se till att varje mätvärde eller kodad data innehåller ett timestamp-fält i UTC. Eventuell kodad data bör formateras enligt vad enhetens översättare förväntar sig.
  4. Använd HTTP POST med "secret" i payloadens body för att skicka varje tidsstämplat värde ett i taget till IoT-plattformen.
  5. Plattformen kommer att lägga till mätvärdena och avkoda inkommande data till tidsserien enligt de angivna tidsstämplarna.

Exempel på body efter konvertering till JSON:

{
   "secret": "UQBN7DRWXU65U59C2NED",
   "timestamp": "2025-09-14T13:58:04.558Z",
   "encodedData": {
      "hexEncoded": "AABE2F2C78",
      "port": 1
   },
   "rssi": -87,
   "snr": 3,
   "dr": 4,
   "spreadingFactor": 8
}
  1. När tidsseriedatan har importerats, ta bort den tillfälliga secret via API:et:

PUT /iotnodes/[_id] Content-Type: application/json

{
   "secret": "$unset"
}

Exempel: Uppdatera enhetens tidsseriedata med Postman

Följ stegen nedan för att ladda upp och avkoda tidsseriedata för en enhet med Postman.

  1. Installera Postman Ladda ner och installera Postman.

  2. Förbered din CSV-fil Skapa en CSV-fil med följande kolumner: timestamp, port, hexEncoded, spreadingFactor, fCntUp, rssi, snr

    • hexEncoded bör innehålla den råa hex-kodade payloaden från enheten.
    • Översättaren i plattformen kommer automatiskt att avkoda detta till mätvärden.
    • Om du har andra kolumner, ändra fliken Body i skriptet i enlighet med detta.

  3. Importera Postman-samlingen Ladda ner Import Timeseries Example Collection och importera den till Postman.

  4. Konfigurera samlingen

    • Uppdatera URL:en så att den matchar din plattformsserver (om den skiljer sig).
    • Använd Swagger API-endpointen PUT /iotnodes/{_id} för att lägga till ett "secret"-fält till din målnod
    • På fliken Body i HTTP POST-anropet, ändra fältet "secret" så att det matchar den målenhet vars tidsserie du vill uppdatera.

  5. Kör samlingen Kör samlingen för att skicka tidsseriedatan till plattformen.

  6. Städa upp Använd Swagger API-endpointen för att ta bort fältet "secret".

⚠️ Varning: När tidsseriedata väl har importerats kan den inte ändras eller tas bort. Fortsätt med försiktighet innan du laddar upp stora datamängder.

Detta skript kan effektivt importera och avkoda över 100 000 tidsserievärden på några minuter, med varje uppdatering på ungefär 10 ms.