Skip to content

docs(destinations): add .dest URL pattern for calling services directly#131

Merged
longieirl merged 3 commits intomainfrom
docs/destinations-dest-url-direct-service
Apr 8, 2026
Merged

docs(destinations): add .dest URL pattern for calling services directly#131
longieirl merged 3 commits intomainfrom
docs/destinations-dest-url-direct-service

Conversation

@longieirl
Copy link
Copy Markdown
Member

Summary

  • Adds a new section to misc/destinations/README.md covering how to use the https://<destination-name>.dest/<service-path> URL pattern to call an OData service directly when it is not listed in the OData V2 or V4 catalog of an odata_abap destination
  • Includes a working example using the northwind destination with odata-service-url.png showing the OData service URL field in the SAP Fiori tools generator
  • Documents the alternative approach of cloning the destination with WebIDEUsage=odata_gen to expose the Service Path field in the generator, with odata-system.png as a visual reference
  • Applied KM documentation standards throughout: title case headings, American English, back-end hyphenation, Service Centre spelling, em dash usage, and list style consistent with the existing document

Test Plan

  • Verify the new section renders correctly in GitHub markdown preview
  • Confirm both images (odata-service-url.png, odata-system.png) display correctly
  • Confirm all internal anchor links resolve (for example, [Configuration](#configuration))
  • Review KM rules: title case headings, back-end, Service Centre, American English spelling, no Steps: labels, list markers as -

When a destination uses odata_abap but the required OData service is not
listed in the V2 or V4 catalog, the .dest URL pattern allows the service
to be called directly without catalog discovery or a separate destination.

Adds a new section covering:
- When and why to use https://<destination>.dest/<service-path>
- Northwind example with odata-service-url.png
- Resolution table showing how the URL segments are mapped
- Important notes including the annotation warning behaviour
- Alternative: cloning the destination with odata_gen to expose the
  Service Path field in the generator (odata-system.png)
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 8, 2026

🔗 Link Check Results

The link checker has completed. This is an optional check and will not block the PR.

View workflow run for details

If broken links were found, please review them at your convenience.


Last updated: Run #163 at 2026-03-24T15:08:15Z

@longieirl longieirl self-assigned this Apr 8, 2026
@longieirl longieirl merged commit c99dd7a into main Apr 8, 2026
4 checks passed
@github-actions github-actions bot deleted the docs/destinations-dest-url-direct-service branch April 8, 2026 11:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant