API / MCP-server

Dine data. Flere muligheder.

Forbind ressourceplanlægningen med de systemer og AI-værktøjer, du allerede bruger. Hent information, byg egne overblik og udfør understøttede handlinger med styret adgang.

Til dine systemer

REST API

Hent strukturerede JSON-data til rapportering, integrationer og egne arbejdsgange. Understøttede skriveoperationer kan oprette og opdatere information i RessursAgent.

  • Byg rapporter og overblik
  • Forbind projekt- og ressourcedata mellem systemer
  • Automatiser understøttede opgaver
Til dine AI-værktøjer

MCP-server

Model Context Protocol lader en kompatibel AI-klient bruge RessursAgent som værktøj. Spørg til organisationens data og bed om understøttede handlinger med din konto og dine rettigheder.

  • Spørg til planen med egne ord
  • Sammenstil kapacitet, behov og kompetencer
  • Bed om ændringer inden for din adgang

Objekter, felter og handlinger.

Se, hvad dine systemer og AI-værktøjer kan læse, oprette og ændre i RessursAgent. Oversigten viser centrale objekter og et udvalg af felter, som REST API og MCP understøtter.

Feltnavnene er de faktiske navne i datamodellen. Skrivefelter gælder oprettelse, opdatering eller en særskilt handling; ikke alle kan ændres efter oprettelse. Projekter og ressourcer forbindes normalt med et ID.

Ressourcer og projekter

Mandskab, maskiner, kontaktoplysninger, stillinger, fagområder, projektperioder, kunder og steder.

Ressourcer: medarbejdere og udstyr

  • Læse
  • Oprette
  • Ændre

Felter du kan læse

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

Felter 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

Projekter

  • Læse
  • Oprette
  • Ændre

Felter du kan læse

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

Felter 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

  • Læse
  • Ændre
  • Fjerne

Felter du kan læse

  • resource_id
  • card_id
  • expires_at

Felter du kan skrive

  • card_number
  • expires_at

Kortnummeret returneres ikke. Registrering kræver en indlogget bruger med særlig HMS-adgang. Udløbsdatoen kan fornyes separat.

Plan, behov og kapacitet

Tildelinger, allokering, ressourcebehov, utilgængelighed og beregnet kapacitet pr. ressource og dag.

Tildelinger

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Ressourcebehov

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter 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å indsendes, afvises, annulleres og opfyldes via særskilte handlinger.

Fravær og utilgængelighed

  • Læse
  • Oprette
  • Fjerne

Felter du kan læse

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Felter du kan skrive

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Beregnet kapacitet

  • Læse

Felter du kan læse

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

Kun læsning

Dette er beregnede resultater, som kan læses. Du påvirker dem ved at ændre grundlaget, såsom tildelinger, perioder, steder og kompetencer.

Kompetencer og skift

Kompetencekatalog, registrerede kompetencer og gyldighed, projektkrav, skiftskabeloner og dagsundtagelser.

Kompetencekatalog

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Ressourcens kompetencer

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Kompetencer, som ejes af et eksternt kildesystem, skal opdateres dér. Certifikatnumre og kommentarer kan registreres, men returneres ikke i dette læseobjekt.

Kompetencekrav

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Skabeloner til skiftehold

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Dagsundtagelser

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

  • resource_id
  • exception_date
  • exception_type
  • planned_hours

Felter du kan skrive

  • resource_id
  • exception_date
  • exception_type
  • planned_hours
  • comment

Kursusplaner

  • Læse
  • Ændre

Felter du kan læse

  • competency_id
  • plans

Felter du kan skrive

  • resource_ids
  • planned_on
Hold, samarbejde og analyser

Planlægningshold, projekthold og medlemmer, aktiviteter og projektroller. REST API og MCP kan også hente geografiske klynger, samarbejdspar og beregnede bytteforslag.

Planlægningsteams

  • Læse
  • Oprette
  • Ændre

Felter du kan læse

  • name
  • leader_resource_id
  • end_date
  • archived_at

Felter du kan skrive

  • name
  • leader_resource_id
  • end_date
  • competency_ids

Projektteams

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Teammedlemmer

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

  • project_team_id
  • resource_id
  • is_lead

Felter du kan skrive

  • project_team_id
  • resource_id
  • is_lead

Projektaktiviteter

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Projektroller

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Tilknyttede ressourcer

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Geografiske klynger

  • Læse

Felter du kan læse

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

Kun læsning

Dette er beregnede resultater, som kan læses. Du påvirker dem ved at ændre grundlaget, såsom tildelinger, perioder, steder og kompetencer.

Samarbejdsrelationer

  • Læse

Felter du kan læse

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

Kun læsning

Dette er beregnede resultater, som kan læses. Du påvirker dem ved at ændre grundlaget, såsom tildelinger, perioder, steder og kompetencer.

Optimeringsforslag

  • Læse

Felter du kan læse

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

Kun læsning

Dette er beregnede resultater, som kan læses. Du påvirker dem ved at ændre grundlaget, såsom tildelinger, perioder, steder og kompetencer.

Tilbud og registre

Tilbud med status, sandsynlighed og behov. Tags, stillinger, fag, maskintyper og -modeller, leverandører og maskinbaser.

Tilbud og simulering

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

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

Tilbudsbehov indeholder kategori, katalogreference, antal og periode (category, catalog_item_id, quantity, start_date, end_date). Status og deltagelse i simulering ændres via særskilte handlinger.

Nøglepersoner i tilbud

  • Læse
  • Oprette
  • Fjerne

Felter du kan læse

  • bid_opportunity_id
  • resource_id
  • responsibility

Felter du kan skrive

  • bid_opportunity_id
  • resource_id
  • responsibility

Tags

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

  • name

Felter du kan skrive

  • name

Tags kan også knyttes til eller fjernes fra projekter, ressourcer og ressourcebehov.

Stillinger, fag, udstyrstyper, udstyrsmodeller og leverandører

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

  • name

Felter du kan skrive

  • name

Udstyrsbaser

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

  • name
  • postal_code

Felter du kan skrive

  • name
  • postal_code

Lejepriser for stillinger og udstyrsmodeller

  • Læse
  • Ændre

Felter du kan læse

  • kind
  • hire_day_rate
  • hire_currency_code

Felter du kan skrive

  • hire_day_rate
  • hire_currency_code
Notifikationer og historik

Notifikationer, hændelser, kommentarer og et afgrænset udtræk af ændringsloggen. Kræver adgang til de relevante dataområder.

Notifikationer

  • Læse

Felter du kan læse

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

Kun læsning

Notifikationshændelser

  • Læse

Felter du kan læse

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

Kun læsning

Ændringslog

  • Læse

Felter du kan læse

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

Kun læsning

Kommentarer

  • Læse
  • Oprette
  • Ændre
  • Fjerne

Felter du kan læse

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

Felter du kan skrive

  • entity_type
  • entity_id
  • comment
  • applies_from
  • applies_until
  • expected_version
Dine egne oplysninger

Profil-brugere kan hente egen plan, kompetencer og ændringer via personlig API/MCP-adgang. Forbindelsen følger den indloggede bruger og kræver tilknytning til en personressource.

Din profil

  • Læse

Felter du kan læse

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

Kun læsning

Læser den indloggede medarbejders egne oplysninger og kræver tilknytning til en personressource.

Din plan

  • Læse

Felter du kan læse

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

Kun læsning

Læser den indloggede medarbejders egne oplysninger og kræver tilknytning til en personressource.

Dine kompetencer

  • Læse

Felter du kan læse

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

Kun læsning

Læser den indloggede medarbejders egne oplysninger og kræver tilknytning til en personressource.

Dine ændringer

  • Læse

Felter du kan læse

  • resource_id
  • changes

Kun læsning

Læser den indloggede medarbejders egne oplysninger og kræver tilknytning til en personressource.

Fra information til praktisk nytte.

Eksempler / arbejdsgange med API

  1. Hold ressourceregistret opdateret

    Opret medarbejdere eller udstyr, og opdater kontaktoplysninger, afdeling, fag og eksterne referencer.

  2. Lad projektdata følge planlægningen

    Opdater projektperioder og kundeoplysninger. Opret behov, og juster tildelingernes datoer, allokering og skabelon til skiftehold.

  3. Byg egne rapporter

    Kombiner kapacitet, kompetencer, klynger og tilbud i egne rapporter. Læs beregnede resultater som beslutningsgrundlag.

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

  • Hvilke ressourcebehov er åbne i næste uge?

  • Vis næste uges kapacitet, og find ressourcer med gyldige maskinførerkompetencer.

  • Opret et ressourcebehov på projektet med den stilling, periode og allokering, vi har aftalt.

Eksemplerne er forslag til brug, ikke udførte handlinger. Resultatet afhænger af registrerede data, klienten og din adgang. Gennemgå foreslåede ændringer, før du beder klienten udføre dem.

Adgang efter opgaven.

Rettigheder følger dataene

Læsning og ændring afhænger af organisationen, brugerrollen og den tildelte adgang. Mulige handlinger afhænger også af objektets status og løsningens valideringsregler.

Ændr grundlaget for indsigt

Kapacitet, klynger og optimeringsforslag beregnes fra registrerede data. Resultaterne skrives ikke direkte.

Historik og personlig visning

Notifikationer og loghændelser kan læses. Kommentarer er særskilte objekter, som kan ændres. Min side viser den aktuelle medarbejders data.

Hvad vil du forbinde?

Fortæl os, hvilke data og arbejdsgange du har brug for. Vi hjælper med adgang, tilslutning og understøttede handlinger.

Tal med os om API og MCP