API / MCP-server
Koppla resursplaneringen till de system och AI-verktyg du redan använder. Hämta information, bygg egna översikter och utför stödda åtgärder med styrd åtkomst.
Hämta strukturerade JSON-data för rapportering, integrationer och egna arbetsflöden. Stödda skrivoperationer kan skapa och uppdatera information i RessursAgent.
Model Context Protocol låter en kompatibel AI-klient använda RessursAgent som verktyg. Ställ frågor om organisationens data och begär stödda åtgärder med ditt konto och dina behörigheter.
Se vad dina system och AI-verktyg kan läsa, skapa och ändra i RessursAgent. Översikten visar centrala objekt och ett urval av fälten som stöds i REST API och MCP.
Fältnamnen är de faktiska namnen i datamodellen. Skrivfält gäller skapande, uppdatering eller en särskild åtgärd; alla kan inte ändras efter skapandet. Projekt och resurser kopplas normalt med ett ID.
Personal, maskiner, kontaktuppgifter, befattningar, fackområden, projektperioder, kunder och platser.
nameresource_typeownershipis_activedisciplinepositiondepartmentemailphoneequipment_typeequipment_modelsupplierwork_base_addressexternal_idnameresource_typeownershipis_activedisciplinepositiondepartmentemailphoneequipment_typeequipment_modelsupplieremployed_fromemployed_untilwork_base_addressexternal_idnotenameproject_numberstatusstart_dateend_datecustomer_namelocation_addressproject_typeis_templatenameproject_numberstatusstart_dateend_datecustomer_namelocation_addresslocation_postal_codeexternal_idworklist_codenoteproject_typeis_templateresource_idcard_idexpires_atcard_numberexpires_atKortnumret returneras inte. Registrering kräver en inloggad användare med särskild HMS-behörighet. Utgångsdatumet kan förnyas separat.
Tilldelningar, allokering, resursbehov, otillgänglighet och beräknad kapacitet per resurs och dag.
project_idresource_idstart_dateend_dateallocation_percentactivity_idproject_positionwork_schedule_template_idproject_idresource_idstart_dateend_dateallocation_percentwork_schedule_template_idwork_schedule_anchor_dateproject_idresource_typestatusquantitystart_dateend_dateallocation_percentpositionequipment_modelactivity_idproject_idresource_typequantitystart_dateend_dateallocation_percentdisciplinepositionequipment_typeequipment_modelwork_schedule_template_idBehov kan även skickas in, avvisas, avbrytas och uppfyllas med särskilda åtgärder.
resource_idstart_dateend_datereasonunavailable_percentresource_idstart_dateend_datereasonunavailable_percentresource_idcapacity_datescheduled_hoursscheduled_capacity_percentunavailable_percenteffective_capacity_percentDetta är beräknade resultat som kan läsas. Du påverkar dem genom att ändra underlaget, som tilldelningar, perioder, platser och kompetenser.
Kompetenskatalog, registrerad kompetens och giltighet, projektkrav, skiftmallar och dagsundantag.
namecodecategorydescriptionrequires_expirysource_systemnamecodecategorydescriptionis_hms_cardrequires_expiryresource_idcompetency_idlevelvalid_fromvalid_untildocumentation_statussource_systemresource_idcompetency_idlevelvalid_fromvalid_untilcertificate_numbercommentdocumentation_confirmedKompetenser som ägs av ett externt källsystem måste uppdateras där. Certifikatnummer och kommentarer kan registreras men returneras inte i detta läsobjekt.
scopeentity_idcompetency_idis_mandatoryresource_typevalid_fromscopeentity_idcompetency_idis_mandatoryresource_typevalid_fromcommentnameworkday_patternhours_patternstandard_hours_per_workdaystart_weekdayproject_scopeis_activeis_night_shiftnamedescriptionworkday_patternhours_patternstandard_hours_per_workdaystart_weekdayproject_scopeproject_idsis_activeis_night_shiftresource_idexception_dateexception_typeplanned_hoursresource_idexception_dateexception_typeplanned_hourscommentcompetency_idplansresource_idsplanned_onPlaneringsteam, projektteam och medlemmar, aktiviteter och projektroller. REST API och MCP kan även hämta geografiska kluster, samarbetspar och beräknade bytesförslag.
nameleader_resource_idend_datearchived_atnameleader_resource_idend_datecompetency_idsproject_idnamenotework_schedule_template_idplanned_start_dateplanned_end_dateproject_idnamenotework_schedule_template_idplanned_start_dateplanned_end_dateproject_team_idresource_idis_leadproject_team_idresource_idis_leadproject_idnamecodeparent_idsort_orderlead_resource_idplanned_start_dateplanned_end_dateproject_idnamedescriptioncodenotelead_resource_idplanned_start_dateplanned_end_dateparent_idpositionproject_idresource_idroleresponsibilityeffective_fromeffective_untilproject_idresource_idroleresponsibilityeffective_fromeffective_untilnameproject_idstart_dateend_datenotemembersnameproject_idstart_dateend_datenotemembersaxisradius_kmresource_categoryproject_countresource_countspan_kmprojectsmembersDetta är beräknade resultat som kan läsas. Du påverkar dem genom att ändra underlaget, som tilldelningar, perioder, platser och kompetenser.
resource_idpartner_idstrengthoverlap_daysshared_project_counthas_operator_linkhas_shared_project_teamDetta är beräknade resultat som kan läsas. Du påverkar dem genom att ändra underlaget, som tilldelningar, perioder, platser och kompetenser.
typescorestart_dateend_dateproject_idsincoming_resource_idsoutgoing_resource_idstravel_saving_kmown_production_gainmanual_planning_requiredDetta är beräknade resultat som kan läsas. Du påverkar dem genom att ändra underlaget, som tilldelningar, perioder, platser och kompetenser.
Anbud med status, sannolikhet och behov. Taggar, befattningar, yrkesområden, maskintyper och -modeller, leverantörer och maskinbaser.
namecustomer_namestatuswin_probabilitystart_dateend_dateestimated_valuecurrency_codesimulation_inclusionnamecustomer_namestatuswin_probabilitystart_dateend_dateestimated_valuecurrency_coderequirementssimulation_inclusionAnbudsbehov innehåller kategori, katalogreferens, antal och period (category, catalog_item_id, quantity, start_date, end_date). Status och deltagande i simulering ändras med särskilda åtgärder.
bid_opportunity_idresource_idresponsibilitybid_opportunity_idresource_idresponsibilitynamenameTaggar kan även kopplas till eller tas bort från projekt, resurser och resursbehov.
namenamenamepostal_codenamepostal_codekindhire_day_ratehire_currency_codehire_day_ratehire_currency_codeAviseringar, aviseringshändelser, kommentarer och ett begränsat utdrag ur ändringsloggen. Kräver åtkomst till aktuella dataområden.
notification_event_idrecipient_resource_idstatusread_atdismissed_atscheduled_forevent_typeentity_typeentity_idproject_idseveritytitlemessageoccurred_atentity_typeentity_idactionmessageactor_display_namesourcecreated_atentity_typeentity_idcommentapplies_fromapplies_untilversionentity_typeentity_idcommentapplies_fromapplies_untilexpected_versionProfil-användare kan hämta sin egen plan, kompetens och ändringar via personlig API/MCP-åtkomst. Anslutningen följer den inloggade användaren och kräver koppling till en personresurs.
namedisciplinepositionphoneemailsupplieremployed_fromLäser den inloggade medarbetarens egna uppgifter och kräver koppling till en personresurs.
projectNamestartDateendDateactivityNameprojectPositionmeetingPointmanagerNamemanagerPhoneallocationPercentmachineNamesscheduleLäser den inloggade medarbetarens egna uppgifter och kräver koppling till en personresurs.
registergapsmetcompetencyNamestatuslevelvalidFromvalidUntilLäser den inloggade medarbetarens egna uppgifter och kräver koppling till en personresurs.
resource_idchangesLäser den inloggade medarbetarens egna uppgifter och kräver koppling till en personresurs.
Exempel / arbetsflöden med API
Skapa personal eller utrustning och uppdatera kontaktuppgifter, avdelning, yrkesområde och externa referenser.
Uppdatera projektperioder och kunduppgifter. Skapa behov och justera tilldelningarnas datum, beläggning och skiftmall.
Kombinera kapacitet, kompetenser, kluster och anbud i egna rapporter. Läs beräknade resultat som beslutsunderlag.
Exempel / frågor till en AI-klient
Vilka resursbehov är öppna nästa vecka?
Visa nästa veckas kapacitet och hitta resurser med giltig maskinförarkompetens.
Skapa ett resursbehov på projektet med den befattning, period och allokering vi kommit överens om.
Exemplen är förslag på användning, inte utförda åtgärder. Resultatet beror på registrerade data, klienten och din åtkomst. Granska föreslagna ändringar innan du ber klienten genomföra dem.
Läsning och ändring beror på organisation, användarroll och beviljad åtkomst. Möjliga åtgärder beror även på objektets status och lösningens valideringsregler.
Kapacitet, kluster och optimeringsförslag beräknas från registrerade uppgifter. Resultaten skrivs inte direkt.
Aviseringar och logghändelser kan läsas. Kommentarer är separata objekt som kan ändras. Min sida visar den aktuella medarbetarens uppgifter.
Berätta vilka data och arbetsflöden du behöver. Vi hjälper dig med åtkomst, anslutning och stödda åtgärder.