Publishing to SAP Fieldglass

Triage decides which workforce or services route fits the need. composerID carries the resulting Intent ID into the agreed SAP Fieldglass workflow. Fieldglass remains the system that manages the procurement record and its delivery. This guide assesses a Decision Form handoff for contingent work and services via SoW. It follows the same structure as the Beeline guide, but uses Fieldglass’s own connector model rather than copying Beeline’s API calls.

​

The handoff at a glance

The design keeps the full assessment and decision evidence in Triage. Only approved operational values and the shared reference should cross this boundary. A field that can store an ID is not, by itself, a working integration.

​

The publish

​

Native connector requirements

SAP’s Decision Form Upload reference specifies CSV, version API-A-V1.0, the Integration-Decision Form plug-in and Upload Data/Download Data permissions. The owner needs Decision Form Submit permission. Additional legal-entity, location, purchase-unit, budget and custom-field requirements depend on configuration. Buyer Reference and External Decision Form ID each allow 100 characters. Decision Form ID is the native identifier required for updates. Questions, attachments and templates with Named Resource set to Yes are outside this upload’s scope. The Type and Submit headers are required. Submit=false saves a draft; Submit=true advances the configured workflow. Approval Required=false can skip approvals. Set these deliberately with the process owner, never as a shortcut around governance. Use the client’s accepted date, number and language formats.

​

Template selection is a separate acceptance test

SAP documents creating Decision Form templates through the administration interface, then creating forms from those templates. Procurement options and approval rules depend on the template and company configuration. See Decision Forms: setup and usage. This guide does not establish an API for creating Decision Form templates, or a deep link that opens the exact template in a signed-in user session. The template legal-entity association connector associates existing objects; it does not prove template creation. Our proposed acceptance test is explicit: the intended user must reach the intended workflow, with the correct reference and no unintended change of procurement route. A valid CSV upload alone does not satisfy that test.

​

Access and authentication

SAP’s REST API integration guide documents tenant-specific connector URLs and OAuth authentication. For the documented Basic client-credentials flow, the client ID is a Fieldglass username and the credential is its password or provisioned licence key. Send the resulting bearer token to the authorised API. Confirm application-key requirements and token handling with the client’s Fieldglass administrator. These are protocol shapes, not ready-to-run commands. Before implementation, record the actual test host, encoded connector name, accepted request format, required headers and permissions. Keep secrets in the approved secret store, not this guide or a support ticket. Request access for the specific upload, required validation data and agreed confirmation route. Reporting, work-order, time, invoice or approval-write permissions are separate decisions, not automatic parts of the handoff. No free developer sandbox or particular client test entitlement has been established by this review; the client and SAP must confirm access.

​

Carrying and confirming the reference

Use one shared business reference while retaining Fieldglass’s own record identifiers for technical correlation. Do not assume automatic propagation to every later record. Inspect the resulting Job Posting or SOW. Where the agreed carrier cannot be used, agree and separately prove a suitable alternative before releasing that workflow.

​

A receipt is not confirmation

SAP states that an upload response reports file receipt, not whether every record processed successfully. The Integration Audit Trail exposes record-level failures. See HTTP response codes, page 14. For this design, keep three distinct states: upload received, record processing checked, and reference read back. Only the last should count as a confirmed reference handoff. Agree a download, report or configured event payload that actually exposes the native record ID and the reference. This review does not verify a universal Decision Form read endpoint or an automatic Buyer Reference filter. Manual inspection can support an initial test, but it is not an automated return path.

​

Retry and update controls

Our proposed connector must preserve the Intent ID, attempted payload and processing outcome durably. After a timeout, reconcile the original attempt before sending another create. Do not assume that an external identifier provides atomic idempotency. Use the confirmed native identifier for an update. Treat duplicate matches, changed templates and partial failures as exceptions requiring an explicit decision. These controls are implementation requirements, not claims about what the current representative adapter already does.

​

Events back

SAP’s Publish/Subscribe wizard lets an administrator choose a base module, linked data and triggering activities. Its payload format defaults to JSON; empty selected fields may be omitted. An Approved activity can be qualified by approval level. This is an outbound event configuration, not permission to send arbitrary JSON into the Decision Form Upload connector. Nor should Beeline event names or its signature convention be reused here. For this design, configure the smallest payload that can identify the record and its Intent ID relationship. Confirm which modules and activities the client can expose. Test missing references, duplicate deliveries, changed approvals and receiver downtime before depending on the feed. Endpoint configuration supports Basic authentication and OAuth2 client credentials. The wizard documentation says OAuth2 availability depends on the IS_DYNAMIC_CLIENT_ENABLED environment setting. Agree an authenticated HTTPS receiver and have SAP confirm any required enablement. Endpoint connectivity and successful delivery of the correct business payload are separate tests.

​

What S, M, L and XL mean here

These connection sizes describe the desired outcome, not a claim that the client configuration already exists.

​

Implementation still needed

The next engineering deliverable is a tested CSV connector implementation and its confirmation path. Then run an authorised client test covering valid and invalid native values, approval behaviour, uncertain retries, update handling, reference propagation and recovery. Record the environment, date, redacted evidence and reviewer. This documentation change does not advance the connection to sandbox-proven or tenant-proven status.