Open APIs

 View Only
  • 1.  Suspending inflight Service Order

    TM Forum Member
    Posted Oct 25, 2022 04:50
    Which TMP API should be used when we need to suspend in-flight Service Order?
    The scenario is as follows:
    1. A service order is in progress
    2. We need to place a Suspension on the Service Order while we are waiting for some details. The service Order moves to 'inactive' state
    3. Once we receive the required details, we 'Resume' the service order and it is then moved to 'Active' state and completes its lifecycle.

    As per TMF641, we can use Patch Service Order when we need to update a service order entity. Should we use Patch Service Order API for the Suspending and subsequently Resuming in-flight Service Order? Or do we have more appropriate API to support the Suspend and Resume operations of an inflight order?


    ------------------------------
    Arpita Gupta
    Tata Consultancy Services
    ------------------------------


  • 2.  RE: Suspending inflight Service Order

    TM Forum Member
    Posted Oct 25, 2022 08:43
    Hi Arpita
    It's a very good question. There is definitely a case for having a dedicated operation to make specific state changes on orders, rather than the generic PATCH. By doing this, you can:
    • Have finer security control - ABAC can be used to allow or block invocation of the specific operation
    • Better feedback from failures - you can have specific feedback related to suspending (or resuming) the order
    Hope it helps

    ------------------------------
    Jonathan Goldberg
    Amdocs Management Limited
    Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
    ------------------------------



  • 3.  RE: Suspending inflight Service Order

    TM Forum Member
    Posted Oct 28, 2022 06:20
    Thank you, Jonathan. This helps.

    Is there any TM Forum API already available which is specific to support suspension of inflight suspension on service orders?


    ------------------------------
    Arpita Gupta
    Tata Consultancy Services
    ------------------------------



  • 4.  RE: Suspending inflight Service Order

    TM Forum Member
    Posted Oct 28, 2022 09:30
    No, you could add the operation as an extension in your implementation of TMF641.

    ------------------------------
    Jonathan Goldberg
    Amdocs Management Limited
    Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
    ------------------------------



  • 5.  RE: Suspending inflight Service Order

    TM Forum Member
    Posted Mar 01, 2023 06:18

    Hi Jonathan,

    As part of TMF 641 extension to support suspend and resume of in-flight order, we are planning to create task resource (like cancelServiceOrder).

    Our use case is as follows :

    1. An inflight order needs to be suspended due to some blocker/reason
    2. Once the blocker is resolved, the suspended order should be resumed and the ServiceOrder should progress
    3. If the blocker cannot be resolved then the service order should be cancelled.

    We have thought about 2 approaches:

    Approach 1 : Create suspendServiceOrder resource to suspend the order. Create resumeServiceOrder to resume the suspended order. The problem with this approach is implementing the dependency between suspend operation and resume operation.

    Approach 2 : Create suspendResumeServiceOrder resource. The initial post request will suspend the ServiceOrder. A patch update can be send to resume the suspended ServiceOrder. This seems to be  bit complicated and we need to support additional patch operation on the resource.

    Could you please suggest which option will be more suitable or if there is any other better approach to implement this?

    Thanks,

    Arpita



    ------------------------------
    Arpita Gupta
    Tata Consultancy Services
    ------------------------------



  • 6.  RE: Suspending inflight Service Order

    TM Forum Member
    Posted Mar 01, 2023 15:00

    Keep it simple. A task resource per business operation.

    BTW you might want to reconsider the suspend and resume terminology as it applies to orders, since it can be confused with suspending and resuming a service (or product).

    Perhaps hold and continue would be more appropriate.



    ------------------------------
    Jonathan Goldberg
    Amdocs Management Limited
    Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
    ------------------------------



  • 7.  RE: Suspending inflight Service Order

    TM Forum Member
    Posted Mar 03, 2023 00:22

    Thank you so much Jonathan.



    ------------------------------
    Arpita Gupta
    Tata Consultancy Services
    ------------------------------