API / MCP-server

Dine data. Flere muligheter.

Koble ressursplanleggingen til systemene og AI-verktøyene du allerede bruker. Hent informasjon, bygg egne oversikter og utfør støttede handlinger med styrt tilgang.

For systemene dine

REST API

Hent strukturerte JSON-data til rapportering, integrasjoner og egne arbeidsflyter. Støttede skriveoperasjoner kan opprette og oppdatere informasjon i RessursAgent.

  • Bygg rapporter og oversikter
  • Koble prosjekt- og ressursdata mellom systemer
  • Automatiser støttede oppgaver
For AI-verktøyene dine

MCP-server

Model Context Protocol lar en kompatibel AI-klient bruke RessursAgent som verktøy. Spør om data fra organisasjonen din og be om støttede handlinger med innlogging og dine rettigheter.

  • Still spørsmål om planen med egne ord
  • Sammenstill kapasitet, behov og kompetanse
  • Be om endringer innenfor din tilgang

Objekter, felt og handlinger.

Se hva egne systemer og AI-verktøy kan lese, opprette og endre i RessursAgent. Oversikten viser sentrale objekter og et utvalg av feltene som støttes i REST API og MCP.

Feltnavnene er de faktiske navnene i datamodellen. Skrivefeltene gjelder oppretting, oppdatering eller en egen handling; ikke alle kan endres etter oppretting. Et prosjekt eller en ressurs kobles normalt med en ID.

Ressurser og prosjekter

Mannskap, maskiner, kontaktopplysninger, stillinger, fag, prosjektperioder, kunder og steder.

Ressurser: mannskap og utstyr

  • Lese
  • Opprette
  • Endre

Felt du kan lese

  • name
  • resource_type
  • ownership
  • is_active
  • discipline
  • position
  • department
  • email
  • phone
  • equipment_type
  • equipment_model
  • supplier
  • work_base_address
  • external_id

Felt du kan skrive

  • name
  • resource_type
  • ownership
  • is_active
  • discipline
  • position
  • department
  • email
  • phone
  • equipment_type
  • equipment_model
  • supplier
  • employed_from
  • employed_until
  • work_base_address
  • external_id
  • note

Prosjekter

  • Lese
  • Opprette
  • Endre

Felt du kan lese

  • name
  • project_number
  • status
  • start_date
  • end_date
  • customer_name
  • location_address
  • project_type
  • is_template

Felt du kan skrive

  • name
  • project_number
  • status
  • start_date
  • end_date
  • customer_name
  • location_address
  • location_postal_code
  • external_id
  • worklist_code
  • note
  • project_type
  • is_template

HMS-kort

  • Lese
  • Endre
  • Fjerne

Felt du kan lese

  • resource_id
  • card_id
  • expires_at

Felt du kan skrive

  • card_number
  • expires_at

Kortnummeret returneres ikke. Registrering krever en innlogget bruker med særskilt HMS-tilgang. Utløpsdatoen kan fornyes separat.

Plan, behov og kapasitet

Tildelinger, allokering, ressursbehov, utilgjengelighet og beregnet kapasitet per ressurs og dag.

Tildelinger

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • project_id
  • resource_id
  • start_date
  • end_date
  • allocation_percent
  • activity_id
  • project_position
  • work_schedule_template_id

Felt du kan skrive

  • project_id
  • resource_id
  • start_date
  • end_date
  • allocation_percent
  • work_schedule_template_id
  • work_schedule_anchor_date

Ressursbehov

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • project_id
  • resource_type
  • status
  • quantity
  • start_date
  • end_date
  • allocation_percent
  • position
  • equipment_model
  • activity_id

Felt du kan skrive

  • project_id
  • resource_type
  • quantity
  • start_date
  • end_date
  • allocation_percent
  • discipline
  • position
  • equipment_type
  • equipment_model
  • work_schedule_template_id

Behov kan også sendes inn, avvises, kanselleres og dekkes gjennom egne handlinger.

Fravær og utilgjengelighet

  • Lese
  • Opprette
  • Fjerne

Felt du kan lese

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Felt du kan skrive

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Beregnet kapasitet

  • Lese

Felt du kan lese

  • resource_id
  • capacity_date
  • scheduled_hours
  • scheduled_capacity_percent
  • unavailable_percent
  • effective_capacity_percent

Kun lesing

Dette er beregnede resultater som kan leses. Du påvirker dem ved å endre grunnlaget, som tildelinger, perioder, lokasjoner og kompetanse.

Kompetanse og skift

Kompetansekatalog, registrert kompetanse og gyldighet, prosjektkrav, skiftmaler og dagsunntak.

Kompetansekatalog

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • name
  • code
  • category
  • description
  • requires_expiry
  • source_system

Felt du kan skrive

  • name
  • code
  • category
  • description
  • is_hms_card
  • requires_expiry

Kompetanse på ressursen

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • resource_id
  • competency_id
  • level
  • valid_from
  • valid_until
  • documentation_status
  • source_system

Felt du kan skrive

  • resource_id
  • competency_id
  • level
  • valid_from
  • valid_until
  • certificate_number
  • comment
  • documentation_confirmed

Kompetanse eid av et eksternt kildesystem må oppdateres der. Sertifikatnummer og kommentar kan registreres, men returneres ikke i dette leseobjektet.

Kompetansekrav

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • scope
  • entity_id
  • competency_id
  • is_mandatory
  • resource_type
  • valid_from

Felt du kan skrive

  • scope
  • entity_id
  • competency_id
  • is_mandatory
  • resource_type
  • valid_from
  • comment

Skiftmaler

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • name
  • workday_pattern
  • hours_pattern
  • standard_hours_per_workday
  • start_weekday
  • project_scope
  • is_active
  • is_night_shift

Felt du kan skrive

  • name
  • description
  • workday_pattern
  • hours_pattern
  • standard_hours_per_workday
  • start_weekday
  • project_scope
  • project_ids
  • is_active
  • is_night_shift

Dagsunntak

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • resource_id
  • exception_date
  • exception_type
  • planned_hours

Felt du kan skrive

  • resource_id
  • exception_date
  • exception_type
  • planned_hours
  • comment

Kursplaner

  • Lese
  • Endre

Felt du kan lese

  • competency_id
  • plans

Felt du kan skrive

  • resource_ids
  • planned_on
Lag, samarbeid og analyser

Planleggingslag, prosjektlag og medlemmer, aktiviteter og prosjektroller. REST API og MCP kan også hente geografiske klynger, samarbeidspar og beregnede bytteforslag.

Planleggingslag

  • Lese
  • Opprette
  • Endre

Felt du kan lese

  • name
  • leader_resource_id
  • end_date
  • archived_at

Felt du kan skrive

  • name
  • leader_resource_id
  • end_date
  • competency_ids

Prosjektlag

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • project_id
  • name
  • note
  • work_schedule_template_id
  • planned_start_date
  • planned_end_date

Felt du kan skrive

  • project_id
  • name
  • note
  • work_schedule_template_id
  • planned_start_date
  • planned_end_date

Lagmedlemmer

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • project_team_id
  • resource_id
  • is_lead

Felt du kan skrive

  • project_team_id
  • resource_id
  • is_lead

Prosjektaktiviteter

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • project_id
  • name
  • code
  • parent_id
  • sort_order
  • lead_resource_id
  • planned_start_date
  • planned_end_date

Felt du kan skrive

  • project_id
  • name
  • description
  • code
  • note
  • lead_resource_id
  • planned_start_date
  • planned_end_date
  • parent_id
  • position

Prosjektroller

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • project_id
  • resource_id
  • role
  • responsibility
  • effective_from
  • effective_until

Felt du kan skrive

  • project_id
  • resource_id
  • role
  • responsibility
  • effective_from
  • effective_until

Koblede ressurser

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • name
  • project_id
  • start_date
  • end_date
  • note
  • members

Felt du kan skrive

  • name
  • project_id
  • start_date
  • end_date
  • note
  • members

Geografiske klynger

  • Lese

Felt du kan lese

  • axis
  • radius_km
  • resource_category
  • project_count
  • resource_count
  • span_km
  • projects
  • members

Kun lesing

Dette er beregnede resultater som kan leses. Du påvirker dem ved å endre grunnlaget, som tildelinger, perioder, lokasjoner og kompetanse.

Samarbeidsrelasjoner

  • Lese

Felt du kan lese

  • resource_id
  • partner_id
  • strength
  • overlap_days
  • shared_project_count
  • has_operator_link
  • has_shared_project_team

Kun lesing

Dette er beregnede resultater som kan leses. Du påvirker dem ved å endre grunnlaget, som tildelinger, perioder, lokasjoner og kompetanse.

Optimaliseringsforslag

  • Lese

Felt du kan lese

  • type
  • score
  • start_date
  • end_date
  • project_ids
  • incoming_resource_ids
  • outgoing_resource_ids
  • travel_saving_km
  • own_production_gain
  • manual_planning_required

Kun lesing

Dette er beregnede resultater som kan leses. Du påvirker dem ved å endre grunnlaget, som tildelinger, perioder, lokasjoner og kompetanse.

Tilbud og registre

Tilbud med status, sannsynlighet og behov. Tagger, stillinger, fag, maskintyper og -modeller, leverandører og baser for maskiner.

Tilbud og simulering

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • name
  • customer_name
  • status
  • win_probability
  • start_date
  • end_date
  • estimated_value
  • currency_code
  • simulation_inclusion

Felt du kan skrive

  • name
  • customer_name
  • status
  • win_probability
  • start_date
  • end_date
  • estimated_value
  • currency_code
  • requirements
  • simulation_inclusion

Behov i tilbudet har kategori, katalogreferanse, antall og periode (category, catalog_item_id, quantity, start_date, end_date). Status og deltakelse i simulering endres med egne handlinger.

Nøkkelpersoner i tilbud

  • Lese
  • Opprette
  • Fjerne

Felt du kan lese

  • bid_opportunity_id
  • resource_id
  • responsibility

Felt du kan skrive

  • bid_opportunity_id
  • resource_id
  • responsibility

Merker (tagger)

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • name

Felt du kan skrive

  • name

Merker kan også knyttes til eller fjernes fra prosjekter, ressurser og ressursbehov.

Stillinger, fag, utstyrstyper, utstyrsmodeller og leverandører

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • name

Felt du kan skrive

  • name

Utstyrsbaser

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • name
  • postal_code

Felt du kan skrive

  • name
  • postal_code

Innleiepriser for stillinger og utstyrsmodeller

  • Lese
  • Endre

Felt du kan lese

  • kind
  • hire_day_rate
  • hire_currency_code

Felt du kan skrive

  • hire_day_rate
  • hire_currency_code
Varsler og historikk

Varsler, varselhendelser, kommentarer og et avgrenset uttrekk av endringsloggen. Krever tilgang til de aktuelle dataområdene.

Varsler

  • Lese

Felt du kan lese

  • notification_event_id
  • recipient_resource_id
  • status
  • read_at
  • dismissed_at
  • scheduled_for

Kun lesing

Varselhendelser

  • Lese

Felt du kan lese

  • event_type
  • entity_type
  • entity_id
  • project_id
  • severity
  • title
  • message
  • occurred_at

Kun lesing

Endringslogg

  • Lese

Felt du kan lese

  • entity_type
  • entity_id
  • action
  • message
  • actor_display_name
  • source
  • created_at

Kun lesing

Kommentarer

  • Lese
  • Opprette
  • Endre
  • Fjerne

Felt du kan lese

  • entity_type
  • entity_id
  • comment
  • applies_from
  • applies_until
  • version

Felt du kan skrive

  • entity_type
  • entity_id
  • comment
  • applies_from
  • applies_until
  • expected_version
Din egen informasjon

Profil-brukere kan hente egen plan, kompetanse og endringer gjennom personlig API/MCP-tilgang. Tilkoblingen følger innlogget bruker og krever kobling til en personressurs.

Egen profil

  • Lese

Felt du kan lese

  • name
  • discipline
  • position
  • phone
  • email
  • supplier
  • employed_from

Kun lesing

Leser den innloggede medarbeiderens egne opplysninger og krever kobling til en personressurs.

Egen plan

  • Lese

Felt du kan lese

  • projectName
  • startDate
  • endDate
  • activityName
  • projectPosition
  • meetingPoint
  • managerName
  • managerPhone
  • allocationPercent
  • machineNames
  • schedule

Kun lesing

Leser den innloggede medarbeiderens egne opplysninger og krever kobling til en personressurs.

Egen kompetanse

  • Lese

Felt du kan lese

  • register
  • gaps
  • met
  • competencyName
  • status
  • level
  • validFrom
  • validUntil

Kun lesing

Leser den innloggede medarbeiderens egne opplysninger og krever kobling til en personressurs.

Egne endringer

  • Lese

Felt du kan lese

  • resource_id
  • changes

Kun lesing

Leser den innloggede medarbeiderens egne opplysninger og krever kobling til en personressurs.

Fra informasjon til praktisk nytte.

Eksempler / arbeidsflyter med API

  1. Hold ressursregisteret oppdatert

    Opprett medarbeidere eller utstyr, og oppdater kontaktinformasjon, avdeling, fag og eksterne referanser.

  2. La prosjektdata følge planleggingen

    Oppdater prosjektperioder og kundeinformasjon. Opprett behov og juster tildelinger med datoer, allokering og skiftmal.

  3. Bygg egne oversikter

    Kombiner kapasitet, kompetanse, klynger og tilbud i egne rapporter. Beregnede resultater kan leses og brukes som beslutningsgrunnlag.

Eksempler / spørsmål til en AI-klient

  • Hvilke mannskapsbehov er åpne neste uke?

  • Vis kapasiteten neste uke, og finn ressurser med gyldig maskinførerkompetanse.

  • Opprett et ressursbehov på prosjektet med stilling, periode og allokering vi har avtalt.

Eksemplene er forslag til bruk, ikke utførte handlinger. Resultatet avhenger av registrerte data, klienten og tilgangen din. Se gjennom foreslåtte endringer før du ber klienten utføre dem.

Tilgang som følger oppgaven.

Rettigheter følger dataene

Lesing og endring avhenger av organisasjonen, brukerrollen og tilgangen som er gitt. Mulige handlinger avhenger også av objektets status og valideringsreglene i løsningen.

Endre grunnlaget for innsikten

Kapasitet, klynger og optimaliseringsforslag beregnes fra registrerte data. Resultatene skrives ikke direkte.

Historikk og personlig visning

Varsler og logghendelser kan leses. Kommentarer er egne objekter som kan endres. Min side viser den aktuelle medarbeiderens data.

Hva vil du koble til?

Fortell oss hvilke data og arbeidsflyter du trenger. Vi hjelper deg å avklare tilgang, tilkobling og støttede handlinger.

Snakk med oss om API og MCP