API / MCP-Server
Verbinden Sie die Ressourcenplanung mit Ihren Systemen und KI-Werkzeugen. Rufen Sie Informationen ab, erstellen Sie eigene Übersichten und führen Sie unterstützte Aktionen mit geregeltem Zugriff aus.
Rufen Sie strukturierte JSON-Daten für Berichte, Integrationen und eigene Abläufe ab. Unterstützte Schreiboperationen können Informationen in RessursAgent erstellen und aktualisieren.
Mit dem Model Context Protocol kann ein kompatibler KI-Client RessursAgent als Werkzeug nutzen. Fragen Sie nach Daten Ihrer Organisation und fordern Sie unterstützte Aktionen mit Ihrem Konto und Ihren Rechten an.
Erfahren Sie, was Ihre Systeme und KI-Werkzeuge in RessursAgent lesen, erstellen und ändern können. Die Übersicht zeigt zentrale Objekte und ausgewählte Felder, die REST API und MCP unterstützen.
Die Feldnamen entsprechen den tatsächlichen Namen im Datenmodell. Schreibfelder gelten für das Erstellen, Aktualisieren oder eine eigene Aktion; nicht alle lassen sich nach dem Erstellen ändern. Projekte und Ressourcen werden normalerweise über eine ID verknüpft.
Personal, Maschinen, Kontaktdaten, Positionen, Fachbereiche, Projektzeiträume, Kunden und Standorte.
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_atDie Kartennummer wird nicht zurückgegeben. Die Registrierung erfordert einen angemeldeten Benutzer mit besonderer HMS-Berechtigung. Das Ablaufdatum lässt sich separat verlängern.
Zuweisungen, Auslastung, Ressourcenbedarf, Nichtverfügbarkeit und berechnete Kapazität je Ressource und Tag.
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_idBedarfe können über eigene Aktionen auch eingereicht, abgelehnt, storniert und erfüllt werden.
resource_idstart_dateend_datereasonunavailable_percentresource_idstart_dateend_datereasonunavailable_percentresource_idcapacity_datescheduled_hoursscheduled_capacity_percentunavailable_percenteffective_capacity_percentDies sind berechnete Ergebnisse zum Lesen. Sie beeinflussen sie durch Änderungen an Grundlagen wie Zuweisungen, Zeiträumen, Standorten und Qualifikationen.
Qualifikationskatalog, erfasste Qualifikationen und Gültigkeit, Projektanforderungen, Schichtvorlagen und Tagesausnahmen.
namecodecategorydescriptionrequires_expirysource_systemnamecodecategorydescriptionis_hms_cardrequires_expiryresource_idcompetency_idlevelvalid_fromvalid_untildocumentation_statussource_systemresource_idcompetency_idlevelvalid_fromvalid_untilcertificate_numbercommentdocumentation_confirmedQualifikationen eines externen Quellsystems müssen dort aktualisiert werden. Zertifikatsnummern und Kommentare können erfasst werden, werden in diesem Leseobjekt aber nicht zurückgegeben.
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_onPlanungsteams, Projektteams und Mitglieder, Aktivitäten und Projektrollen. REST API und MCP liefern auch geografische Cluster, Zusammenarbeitspaare und berechnete Tauschvorschläge.
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_kmprojectsmembersDies sind berechnete Ergebnisse zum Lesen. Sie beeinflussen sie durch Änderungen an Grundlagen wie Zuweisungen, Zeiträumen, Standorten und Qualifikationen.
resource_idpartner_idstrengthoverlap_daysshared_project_counthas_operator_linkhas_shared_project_teamDies sind berechnete Ergebnisse zum Lesen. Sie beeinflussen sie durch Änderungen an Grundlagen wie Zuweisungen, Zeiträumen, Standorten und Qualifikationen.
typescorestart_dateend_dateproject_idsincoming_resource_idsoutgoing_resource_idstravel_saving_kmown_production_gainmanual_planning_requiredDies sind berechnete Ergebnisse zum Lesen. Sie beeinflussen sie durch Änderungen an Grundlagen wie Zuweisungen, Zeiträumen, Standorten und Qualifikationen.
Angebote mit Status, Wahrscheinlichkeit und Bedarf. Tags, Positionen, Fachgebiete, Maschinentypen und -modelle, Lieferanten und Maschinenstandorte.
namecustomer_namestatuswin_probabilitystart_dateend_dateestimated_valuecurrency_codesimulation_inclusionnamecustomer_namestatuswin_probabilitystart_dateend_dateestimated_valuecurrency_coderequirementssimulation_inclusionAngebotsbedarfe enthalten Kategorie, Katalogreferenz, Menge und Zeitraum (category, catalog_item_id, quantity, start_date, end_date). Status und Teilnahme an Simulationen werden über eigene Aktionen geändert.
bid_opportunity_idresource_idresponsibilitybid_opportunity_idresource_idresponsibilitynamenameTags lassen sich auch mit Projekten, Ressourcen und Ressourcenbedarfen verknüpfen oder daraus entfernen.
namenamenamepostal_codenamepostal_codekindhire_day_ratehire_currency_codehire_day_ratehire_currency_codeBenachrichtigungen, Ereignisse, Kommentare und ein begrenzter Auszug aus dem Änderungsprotokoll. Zugriff auf die jeweiligen Datenbereiche ist erforderlich.
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-Nutzer können ihren eigenen Plan, ihre Kompetenzen und Änderungen über einen persönlichen API/MCP-Zugang abrufen. Die Verbindung folgt den Rechten des angemeldeten Nutzers und erfordert eine verknüpfte Personenressource.
namedisciplinepositionphoneemailsupplieremployed_fromLiest die eigenen Daten der angemeldeten Person und erfordert eine Verknüpfung mit einer Personalressource.
projectNamestartDateendDateactivityNameprojectPositionmeetingPointmanagerNamemanagerPhoneallocationPercentmachineNamesscheduleLiest die eigenen Daten der angemeldeten Person und erfordert eine Verknüpfung mit einer Personalressource.
registergapsmetcompetencyNamestatuslevelvalidFromvalidUntilLiest die eigenen Daten der angemeldeten Person und erfordert eine Verknüpfung mit einer Personalressource.
resource_idchangesLiest die eigenen Daten der angemeldeten Person und erfordert eine Verknüpfung mit einer Personalressource.
Beispiele / Arbeitsabläufe mit API
Erstellen Sie Personal oder Geräte und aktualisieren Sie Kontaktdaten, Abteilung, Fachbereich und externe Referenzen.
Aktualisieren Sie Projektzeiträume und Kundendaten. Erstellen Sie Bedarfe und ändern Sie Zuweisungsdaten, Auslastung und Schichtvorlagen.
Kombinieren Sie Kapazität, Qualifikationen, Cluster und Angebote in eigenen Berichten. Nutzen Sie berechnete Ergebnisse als Entscheidungsgrundlage.
Beispiele / Fragen an einen KI-Client
Welche Ressourcenanfragen sind nächste Woche offen?
Zeige die Kapazität der nächsten Woche und finde Ressourcen mit gültiger Maschinenführerqualifikation.
Erstelle einen Ressourcenbedarf für das Projekt mit der vereinbarten Position, dem Zeitraum und der Zuweisung.
Die Beispiele zeigen mögliche Anwendungen, keine ausgeführten Aktionen. Ergebnisse hängen von erfassten Daten, Client und Zugriffsrechten ab. Prüfen Sie vorgeschlagene Änderungen, bevor Sie deren Ausführung anfordern.
Lesen und Ändern hängen von Organisation, Benutzerrolle und erteilten Rechten ab. Verfügbare Aktionen hängen auch vom Objektstatus und den Validierungsregeln der Anwendung ab.
Kapazität, Cluster und Optimierungsvorschläge werden aus erfassten Daten berechnet. Ergebnisse werden nicht direkt geschrieben.
Benachrichtigungen und Protokollereignisse lassen sich lesen. Kommentare sind eigene bearbeitbare Objekte. Meine Seite zeigt die Daten der jeweiligen Person.
Beschreiben Sie die benötigten Daten und Abläufe. Wir helfen Ihnen, Zugriff, Verbindung und unterstützte Aktionen zu klären.