Detta är en gammal version av dokumentet!
Komma igång
Den här guiden beskriver hur du skapar din första integration i Miner.
En typisk integrationsprocess består av följande steg:
- Skapa en anslutning till datakällan
- Skapa ett jobb
- Välj vilka datapunkter som ska ingå
- Komplettera datapunkterna med metadata
- Starta dataöverföringen
till datakälla"] B["2. Skapa jobb"] C["3. Välj datapunkter"] D["4. Komplettera med metadata"] E{"Behövs provisionering?"} F["5. Provisionera metadata eller objekt"] G["6. Starta dataöverföring"] A --> B B --> C C --> D D --> E E -->|Ja| F F --> G E -->|Nej| G
Provisionering är endast aktuellt i vissa integrationsflöden, exempelvis när metadata ska laddas upp till en grafdatabas eller när Miner används för att provisionera data till ProptechOS.
För en mer detaljerad beskrivning av onboarding och metadatahantering, se Onboardingprocess.
Översikt
När Miner startas läses samtliga anslutningar och jobb in automatiskt.
På startsidan visas:
- konfigurerade jobb
- anslutningar
- statusinformation
- loggar
- systemfunktioner
Via toppmenyn kan du:
- administrera anslutningar
- administrera jobb
- hantera grundinställningar
- ladda ned loggfiler
- skapa backup av konfigurationen
Backup
Vi rekommenderar att backup skapas regelbundet, särskilt innan större förändringar görs.
Backupfunktionen skapar en zip-fil som innehåller Miner-instansens konfiguration.
Steg 1 – Skapa en anslutning
En anslutning beskriver hur Miner kommunicerar med ett externt system.
För att skapa en ny anslutning:
- Klicka på plusknappen längst ned till höger
- Välj
Anslutning - Välj anslutningstyp
- Ange nödvändiga parametrar
Olika anslutningstyper kräver olika uppgifter beroende på protokoll, API eller datakälla.
Läs mer på sidan Systemintegration.
Steg 2 – Skapa ett jobb
När anslutningen är skapad kan ett jobb konfigureras.
Ett jobb definierar:
- vilken data som ska hämtas
- vilka datapunkter som ska användas
- hur data ska behandlas
- vart data ska skickas
Nya jobb skapas via plusknappen på översiktssidan.
Steg 3 – Välj datapunkter
Efter att jobbet skapats identifieras de datapunkter som ska ingå i integrationen.
Beroende på anslutning kan Miner:
- läsa in datapunkter automatiskt
- importera datapunktlistor
- låta användaren konfigurera datapunkter manuellt
Steg 4 – Lägg till metadata
För att göra datapunkterna användbara över flera system rekommenderas att de kompletteras med metadata.
Metadata kan användas för att beskriva:
- byggnader
- system
- utrustning
- funktioner
- mätvärdestyper
Läs mer på sidan Metadata.
Steg 5 – Provisionering
När datapunkterna har klassificerats och kompletterats med metadata kan de provisioneras till mottagande system.
Provisioneringen skapar den struktur som behövs för att datapunkterna ska kunna användas i målplattformen.
Läs mer på sidan Provisionering.
Steg 6 – Starta dataöverföringen
När konfigurationen är klar kan jobbet startas.
Miner börjar då läsa, bearbeta och distribuera data enligt jobbets inställningar.
Nästa steg
När den första integrationen är igång rekommenderas följande sidor: