Drafting Requirements and Design Documents for On-site Outsourced Operations and Maintenance Services: Forms and Interactions

Core data for on-site outsourced operations and maintenance services comes from customer ITSM, monitoring platforms, asset inventory, and on-duty

What this category’s data looks like

Core data for on-site outsourced operations and maintenance services comes from customer ITSM, monitoring platforms, asset inventory, and on-duty records. Update cycles fall into two categories: daily updates (such as on-site daily reports, service desk tickets) and monthly updates (such as SLA monthly reports). Daily produced documents include on-site daily reports, service desk tickets, inspection reports, and SLA monthly reports. Document fields cover duty periods, inspection equipment numbers, ticket numbers, service completion status, and more. Some fields must match standardized formats filed by the customer. The overall data structure is built around on-site service delivery and contract performance requirements.

What constraints these characteristics impose on forms and interactions

The diversity of data sources requires external business systems to implement data source association and automatic backfill logic. The formInput/userSelect nodes only collect and pass user input or selection information to reduce duplicate data entry. The classification of daily and monthly updated documents requires external business systems or subsequent workflows to configure field grouping logic. The formInput node only collects input information for corresponding fields, adapting to different entry scenarios for daily inspection records and monthly SLA statistics. The completeness of core business fields directly affects service performance evaluation. External business systems or subsequent workflows must configure mandatory verification rules to avoid missed entries. The formInput node only collects input information for corresponding fields. The requirement to associate on-site personnel with service records requires external business systems to provide standardized option data sources. The userSelect node only loads and displays corresponding options, ensuring entered information matches customer-filed data and avoids discrepancies.

How to configure settings

The following configurations are based on the Forms and Interactions module of FastGPT v4.17.0.

Configuration ItemRecommended ApproachRationale
Form Input Node formInputTest example: Select 3 fields from on-site outsourced operations and maintenance service fields as mandatory inputs; actual fields are determined by the taskThis node collects user input; missing mandatory items require checking interaction status to prevent subsequent nodes from receiving incomplete input
User Selection Node userSelectTest example: Set 2 business options, check the corresponding branch item by itemThis node handles user selection; querying and filtering records related to on-site outsourced operations and maintenance services must be implemented by subsequent interfaces or external systems
Field Passing After SubmissionTest example: Prepare 10 input samples for on-site outsourced operations and maintenance services, covering complete entries, missing mandatory items, and canceled operationsCompare input and node output to verify whether subsequent nodes receive corresponding fields; result thresholds are determined by actual tasks
External Implementation Item: Mandatory Field Verification LogicMust be implemented separately by external systems; provide verification rules for inspection equipment numbers and ticket numbers via external business systems or subsequent workflowsAvoid business risks caused by missing core information
External Implementation Item: Bulk Import Data ProcessingMust be implemented separately by external systems; external business systems generate standard import templates for on-site daily reports and SLA monthly reports; the formInput node only supports receiving imported dataMatch the fixed structure of daily documents
External Implementation Item: Form Submission Timeout SettingMust be implemented separately by external systems; set duration via FastGPT workflow configuration items; 600 seconds is recommended as a test starting pointAdapt to data loading and verification durations for multi-system integration

Three Common Configuration Mistakes

  • Phenomenon: When configuring form docking for notification channels, the system prompts "Receiving message address verification failed (please ensure the address is accessible via public network)". Verification steps: Check whether the form callback address is configured as a publicly accessible path, and check whether external docking parameters related to SSL certificate verification are configured correctly.
  • Phenomenon: The formInput node does not display any prompt when input content exceeds the preset length. Verification steps: Check whether text input length verification logic is configured in the external business system or subsequent workflows.
  • Select configured options item by item in the User Selection Node userSelect, verify whether the workflow enters the corresponding branch; filtering records related to on-site outsourced operations and maintenance services must additionally verify the input, permissions, and return values of the external interface.

How to confirm successful configuration

  • Manually enter a test ticket number and inspection equipment number, check whether the external business system or subsequent workflow triggers a mandatory field interception prompt.
  • Select configured options item by item in the User Selection Node userSelect, verify whether the workflow enters the corresponding branch; filtering records related to on-site outsourced operations and maintenance services must additionally verify the input, permissions, and return values of the external interface.
  • Submit the test form, check whether the preset external notification process is triggered, and the receiving message address verification passes.
  • Import the on-site daily report template provided by the external party, check whether the imported data fields received by the formInput node match the document structure, with no missing or misaligned fields.

The values provided are common starting points and should be measured against the reader's own samples.

Question material comes from public community discussions. Configuration values are common starting points and should be measured against your own samples. Verified on 2026-10-19.