Add plugin sample for service logistics stocking locations

Đang mở
#222 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
typescript
Lĩnh vực
api, full-stack

Hướng nghiên cứu

Start by examining existing sample plugin directories and their README and descriptor patterns, then compare their build and test instructions. Use the documented technicianSubinventories list, detail, and create endpoints to define the sample flow, including OFS technician context, secured parameters, permissions, and API limitations. Done means the new sample directory documents and demonstrates list, detail, and create behavior with tracing and error handling.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Is your feature request related to a problem? Please describe.
Oracle Field Service integrations need a concrete sample for managing service logistics stocking locations assigned to technicians. Today there is no sample plugin showing how to query and create technician stocking-location assignments against Fusion Service Logistics / Maintenance technician subinventories, which makes this integration harder to prototype and reuse.

Describe the solution you'd like
Add a new sample plugin that manages technician stocking locations using the Maintenance Technician Subinventories REST APIs.

Proposed scope:

  • retrieve technician stocking locations with GET /technicianSubinventories
  • view a specific assignment with GET /technicianSubinventories/{TechSubinventoryId}
  • create a new technician stocking-location assignment with POST /technicianSubinventories
  • support common fields exposed by the API such as PartyId, OrganizationCode, Subinventory, StockLocationName, DefaultFlag, EnabledFlag, and AllowPartsOrdersFlag
  • allow filtering/searching by technician and stocking-location attributes where the API supports it
  • document required secured parameters, expected Fusion permissions, and example payload mappings from OFS context to Fusion REST calls

Suggested UX for the sample plugin:

  • open from a resource/technician context in OFS
  • list existing stocking locations for the current technician
  • show default/enabled/allow-parts-orders flags clearly
  • provide a form to add a new stocking location assignment
  • include explicit console tracing and user-facing error handling for API failures

Acceptance criteria:

  • sample plugin directory added to the repo with README and descriptor
  • working list/detail/create flow against the documented REST endpoints
  • sample build/test instructions included
  • clear notes on current API limitations if update/delete are not supported by this API set

Describe alternatives you've considered
A generic REST sample could be adapted, but it would not demonstrate the specific technician subinventory payloads, filters, and OFS-to-Fusion context mapping needed for service logistics use cases.

Additional context
Reference API documentation:

  • Maintenance Technician Subinventories REST resource
  • list endpoint: GET /technicianSubinventories
  • detail endpoint: GET /technicianSubinventories/{TechSubinventoryId}
  • create endpoint: POST /technicianSubinventories
Ngôn ngữ chính
TypeScript
Star
6
Fork
5
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của oracle-samples/ofs-sample-plugins

Tất cả issue của oracle-samples/ofs-sample-plugins

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.