Nyckeltalsinläsning via API

Vad är en nyckeltalsintegration och vilka nyckeltalsintegrationer erbjuder Stratsys?

Nyckeltal används på flera olika ställen i Stratsys, exempelvis som grund till jämförelser där de olika måtten kan jämföras med resultat från förgående period. Nyckeltal kan även användas som beslutsunderlag för ekonomiska förändringar och analys. Många Stratsyskunder nyttjar idag integrationer för att automatiserat föra över data från externa system till Stratsys. Den vanligaste data som förs över till Stratsys är utfallsdata från nyckeltal och ekonomisiffror. Med hjälp av en nyckeltalsintegration kan ni spara tid genom att inte behöva skriva in manuell data i Stratsys. På så sätt undviker även risken för fel, minskar personberoendet och ni får även ett bättre analysunderlag.

Stratsys erbjuder inläsning via API eller via fil - läs mer om filinläsning här.

Komma igång med Stratsys APIer

För att kunna nyttja Stratsys API:er krävs att en klient har skapas upp i utvecklarportalen för autentisering. 

Läs mer här.

Inläsning av data till nyckeltal via KpiData-API

Länk till utvecklaportalen dokumentation för KpiData:
https://api.stratsys.com/docs/kpisv1

API:et har stöd för att:

• Hämta KPI:er
• Hämta KPI-data
• Hämta KPI-kolumner
• Uppdatera KPI-data

GET /v1/kpis returnerar KPI:er filtrerat på ett antal valbara parametrar. Det är därmed möjligt att hämta KPI:er för en eller alla enheter. Med GET /v1/kpis/{nodeId}/data är det möjligt att hämta KPI-data för ett KPI med NodeId. Det är också möjlighet att kontrollera vilken dimension av nyckeltalet som ska returneras eftersom det är uppsatt med flera dimensioner (för exempel "Utfall", "Utfall män" och "Utfall kvinnor") genom att använda anropet GET /v1/kpis/{nodeId}/columns.

PUT /v1/kpis/data uppdaterar KPI-data för ett givet:

• NodeId (nyckeltal)
• DepartmentId (organisationsenhet)
• ColumnName (dimensionskolumn i nyckeltalet)
• PeriodDate (Tilltänkt period)
• Data (värdet som ska läsas in)

Viktigt att notera:

Anropet måste innehålla tillräckligt med information för en unik identifierbar cell. NodeId och date är obligatoriska, ColumnName är obligatorisk. DepartmentId är obligatorisk om KPI:et är konsoliderat i flera enheter.

Stratsys datamodell

NodeId - Unik identifierare för en nod, exempelvis ett nyckeltal (KPI). Hittas lättast genom att anropa GET /v1/kpis.

DepartmentId - Unik identifierare på en organisationsenhet. Hittas antingen genom att anropa GET /v1/departments eller genom att gå in i administrationen i Stratsysdatabasen --> Organisation --> klicka på enheten där ni hittar "Stratsys internal id".

ScorecardId - Unik identifierare på en styrmodell i Stratsys. Hittas genom att göra anropet GET /v1/scorecards eller i Stratsysdatabasen genom att gå in till administrationen --> Styrmodeller --> aktuell stymodell. Id hittas där i URL:en i webbläsaren.

Stratsys-Version - active eller planning beroende på om anropet ska gå mot aktuell version i Stratsys eller planeringsversion.

PeriodDate - Perioden för vilken data ska uppdateras för. Anges i formatet YYYY-MM-DD:

KPI using External Ids

Extern kod i Stratsys är ett fält du kan koppla till objekt som mått, mål eller aktiviteter som används för integration med externa system. Det fungerar som en unik identifierare som gör det möjligt att matcha data mellan Stratsys och andra system (t.ex. ekonomisystem, BI-system eller andra källor) när du importerar eller synkroniserar data automatiskt.

Extern kod gör det enklare att hitta rätt objekt i Stratsys när data kommer från eller ska skickas till ett annat system.

Genom att använda anropen för External Ids kan ni använda era egna Id:n för NodeId och DepartmentId istället för Stratsys interna Id:n.