API / MCP-palvelin

Omat tiedot. Lisää mahdollisuuksia.

Yhdistä resurssisuunnittelu jo käyttämiisi järjestelmiin ja tekoälytyökaluihin. Hae tietoja, rakenna omia näkymiä ja suorita tuettuja toimintoja hallituilla käyttöoikeuksilla.

Järjestelmillesi

REST API

Hae jäsenneltyä JSON-dataa raportointiin, integraatioihin ja omiin työnkulkuihin. Tuetuilla kirjoitustoiminnoilla voit luoda ja päivittää RessursAgentin tietoja.

  • Rakenna raportteja ja koontinäkymiä
  • Yhdistä projekti- ja resurssitietoja järjestelmien välillä
  • Automatisoi tuettuja tehtäviä
Tekoälytyökaluillesi

MCP-palvelin

Model Context Protocol mahdollistaa RessursAgentin käytön yhteensopivan tekoälyasiakkaan työkaluna. Kysy organisaatiosi tiedoista ja pyydä tuettuja toimintoja omalla tililläsi ja käyttöoikeuksillasi.

  • Kysy suunnitelmasta omin sanoin
  • Yhdistä kapasiteetti, tarpeet ja pätevyydet
  • Pyydä muutoksia käyttöoikeuksiesi rajoissa

Tieto-objektit, kentät ja toiminnot.

Katso, mitä järjestelmäsi ja tekoälytyökalusi voivat lukea, luoda ja muuttaa RessursAgentissa. Yleiskatsaus näyttää keskeiset tieto-objektit ja valikoiman REST API:n ja MCP:n tukemia kenttiä.

Kenttänimet ovat tietomallin todellisia nimiä. Kirjoitettavat kentät koskevat luomista, päivitystä tai erillistä toimintoa; kaikkia ei voi muuttaa luomisen jälkeen. Projektit ja resurssit yhdistetään yleensä tunnisteella.

Resurssit ja projektit

Henkilöstö, koneet, yhteystiedot, tehtävänimikkeet, alat, projektien ajanjaksot, asiakkaat ja sijainnit.

Resurssit: henkilöstö ja kalusto

  • Lue
  • Luo
  • Muokkaa

Luettavat kentät

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

Kirjoitettavat kentät

  • 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

Projektit

  • Lue
  • Luo
  • Muokkaa

Luettavat kentät

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

Kirjoitettavat kentät

  • 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-kortit

  • Lue
  • Muokkaa
  • Poista

Luettavat kentät

  • resource_id
  • card_id
  • expires_at

Kirjoitettavat kentät

  • card_number
  • expires_at

Korttinumeroa ei palauteta. Rekisteröinti edellyttää kirjautunutta käyttäjää, jolla on erillinen HMS-käyttöoikeus. Voimassaolon päättymispäivän voi uusia erikseen.

Suunnitelma, tarpeet ja kapasiteetti

Tehtävät, varaukset, resurssipyynnöt, poissaolot ja laskettu kapasiteetti resursseittain ja päivittäin.

Resurssivaraukset

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Resurssitarpeet

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Tarpeita voidaan myös lähettää, hylätä, perua ja täyttää erillisillä toiminnoilla.

Poissaolot ja esteet

  • Lue
  • Luo
  • Poista

Luettavat kentät

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Kirjoitettavat kentät

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Laskettu kapasiteetti

  • Lue

Luettavat kentät

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

Vain luku

Nämä ovat luettavia laskettuja tuloksia. Voit vaikuttaa niihin muuttamalla lähtötietoja, kuten varauksia, ajanjaksoja, sijainteja ja pätevyyksiä.

Pätevyydet ja työvuorot

Pätevyysluettelo, kirjatut pätevyydet ja voimassaolo, projektivaatimukset, työvuoromallit ja päiväkohtaiset poikkeukset.

Pätevyysluettelo

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Resurssin pätevyydet

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Ulkoisen lähdejärjestelmän omistamat pätevyydet on päivitettävä siellä. Todistusnumerot ja kommentit voidaan tallentaa, mutta niitä ei palauteta tässä lukuobjektissa.

Pätevyysvaatimukset

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Vuoromallit

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Päiväkohtaiset poikkeukset

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

  • resource_id
  • exception_date
  • exception_type
  • planned_hours

Kirjoitettavat kentät

  • resource_id
  • exception_date
  • exception_type
  • planned_hours
  • comment

Kurssisuunnitelmat

  • Lue
  • Muokkaa

Luettavat kentät

  • competency_id
  • plans

Kirjoitettavat kentät

  • resource_ids
  • planned_on
Tiimit, yhteistyö ja analyysit

Suunnittelutiimit, projektitiimit ja jäsenet, tehtävät ja projektiroolit. REST API ja MCP voivat hakea myös maantieteellisiä klustereita, yhteistyöpareja ja laskettuja vaihtoehdotuksia.

Suunnitteluryhmät

  • Lue
  • Luo
  • Muokkaa

Luettavat kentät

  • name
  • leader_resource_id
  • end_date
  • archived_at

Kirjoitettavat kentät

  • name
  • leader_resource_id
  • end_date
  • competency_ids

Projektiryhmät

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Ryhmän jäsenet

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

  • project_team_id
  • resource_id
  • is_lead

Kirjoitettavat kentät

  • project_team_id
  • resource_id
  • is_lead

Projektin työvaiheet

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Projektiroolit

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Yhdistetyt resurssit

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Maantieteelliset klusterit

  • Lue

Luettavat kentät

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

Vain luku

Nämä ovat luettavia laskettuja tuloksia. Voit vaikuttaa niihin muuttamalla lähtötietoja, kuten varauksia, ajanjaksoja, sijainteja ja pätevyyksiä.

Yhteistyösuhteet

  • Lue

Luettavat kentät

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

Vain luku

Nämä ovat luettavia laskettuja tuloksia. Voit vaikuttaa niihin muuttamalla lähtötietoja, kuten varauksia, ajanjaksoja, sijainteja ja pätevyyksiä.

Optimointiehdotukset

  • Lue

Luettavat kentät

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

Vain luku

Nämä ovat luettavia laskettuja tuloksia. Voit vaikuttaa niihin muuttamalla lähtötietoja, kuten varauksia, ajanjaksoja, sijainteja ja pätevyyksiä.

Tarjoukset ja rekisterit

Tarjoukset tiloineen, todennäköisyyksineen ja tarpeineen. Tunnisteet, tehtävänimikkeet, alat, konetyypit ja -mallit, toimittajat sekä konetukikohdat.

Tarjoukset ja simulointi

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

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

Tarjouksen tarpeet sisältävät luokan, luetteloviitteen, määrän ja ajanjakson (category, catalog_item_id, quantity, start_date, end_date). Tila ja simulointiin osallistuminen muutetaan erillisillä toiminnoilla.

Tarjousten avainhenkilöt

  • Lue
  • Luo
  • Poista

Luettavat kentät

  • bid_opportunity_id
  • resource_id
  • responsibility

Kirjoitettavat kentät

  • bid_opportunity_id
  • resource_id
  • responsibility

Tunnisteet

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

  • name

Kirjoitettavat kentät

  • name

Tunnisteita voidaan myös liittää projekteihin, resursseihin ja resurssitarpeisiin tai poistaa niistä.

Tehtävänimikkeet, ammattialat, kalustotyypit, kalustomallit ja toimittajat

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

  • name

Kirjoitettavat kentät

  • name

Kalustotukikohdat

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

  • name
  • postal_code

Kirjoitettavat kentät

  • name
  • postal_code

Tehtävänimikkeiden ja kalustomallien vuokrahinnat

  • Lue
  • Muokkaa

Luettavat kentät

  • kind
  • hire_day_rate
  • hire_currency_code

Kirjoitettavat kentät

  • hire_day_rate
  • hire_currency_code
Ilmoitukset ja historia

Ilmoitukset, ilmoitustapahtumat, kommentit ja rajattu ote muutoslokista. Edellyttää kyseisten tietoalueiden käyttöoikeutta.

Ilmoitukset

  • Lue

Luettavat kentät

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

Vain luku

Ilmoitustapahtumat

  • Lue

Luettavat kentät

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

Vain luku

Muutosloki

  • Lue

Luettavat kentät

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

Vain luku

Kommentit

  • Lue
  • Luo
  • Muokkaa
  • Poista

Luettavat kentät

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

Kirjoitettavat kentät

  • entity_type
  • entity_id
  • comment
  • applies_from
  • applies_until
  • expected_version
Omat tietosi

Profiili-käyttäjät voivat hakea oman suunnitelmansa, osaamisensa ja muutoksensa henkilökohtaisella API/MCP-yhteydellä. Yhteys noudattaa kirjautuneen käyttäjän oikeuksia ja edellyttää linkitystä henkilöresurssiin.

Oma profiili

  • Lue

Luettavat kentät

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

Vain luku

Lukee kirjautuneen työntekijän omat tiedot ja edellyttää linkitystä henkilöresurssiin.

Oma suunnitelma

  • Lue

Luettavat kentät

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

Vain luku

Lukee kirjautuneen työntekijän omat tiedot ja edellyttää linkitystä henkilöresurssiin.

Omat pätevyydet

  • Lue

Luettavat kentät

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

Vain luku

Lukee kirjautuneen työntekijän omat tiedot ja edellyttää linkitystä henkilöresurssiin.

Omat muutokset

  • Lue

Luettavat kentät

  • resource_id
  • changes

Vain luku

Lukee kirjautuneen työntekijän omat tiedot ja edellyttää linkitystä henkilöresurssiin.

Tiedosta käytännön hyötyä.

Esimerkkejä / API-työnkulut

  1. Pidä resurssirekisteri ajan tasalla

    Luo henkilöitä tai kalustoa ja päivitä yhteystietoja, osastoa, ammattialaa ja ulkoisia viitteitä.

  2. Pidä projektitiedot suunnittelun mukana

    Päivitä projektien ajanjaksoja ja asiakastietoja. Luo tarpeita ja muuta varausten päivämääriä, kuormitusta ja vuoromallia.

  3. Luo omia raportteja

    Yhdistä kapasiteetti, pätevyydet, klusterit ja tarjoukset omiin raportteihin. Käytä laskettuja tuloksia päätöksenteon tukena.

Esimerkkejä / kysymyksiä tekoälyasiakkaalle

  • Mitkä resurssipyynnöt ovat avoinna ensi viikolla?

  • Näytä ensi viikon kapasiteetti ja etsi resurssit, joilla on voimassa oleva koneenkuljettajan pätevyys.

  • Luo projektille resurssipyyntö sopimallamme tehtävänimikkeellä, ajanjaksolla ja varauksella.

Esimerkit ovat käyttöehdotuksia, eivät suoritettuja toimintoja. Tulos riippuu kirjatuista tiedoista, asiakkaasta ja käyttöoikeuksistasi. Tarkista ehdotetut muutokset ennen niiden suorittamista.

Tehtävään sopivat käyttöoikeudet.

Oikeudet seuraavat tietoja

Lukeminen ja muokkaaminen riippuvat organisaatiosta, käyttäjäroolista ja myönnetyistä oikeuksista. Käytettävissä olevat toiminnot riippuvat myös objektin tilasta ja sovelluksen validointisäännöistä.

Muuta analyysin lähtötietoja

Kapasiteetti, klusterit ja optimointiehdotukset lasketaan tallennetuista tiedoista. Tuloksia ei kirjoiteta suoraan.

Historia ja henkilökohtainen näkymä

Ilmoituksia ja lokitapahtumia voidaan lukea. Kommentit ovat erillisiä muokattavia objekteja. Oma sivu näyttää kyseisen työntekijän tiedot.

Mitä haluaisit yhdistää?

Kerro tarvitsemasi tiedot ja työnkulut. Autamme käyttöoikeuksien, yhteyden ja tuettujen toimintojen määrittelyssä.

Keskustele APIsta ja MCP:stä