Open APIs

  • 1.  TMf 641 - Information Required Event

    TM Forum Member
    Posted Sep 25, 2020 08:18
    Hi

    Looking at the Service Ordering Management API User Guide for v20.5 it states

    'The Pending state is used when an order/item is currently in a waiting stage for an action/activity to be completed before the order/item can progress further, pending order amend or cancel assessment. In situations where Access Seeker action is required, an "information required" notification will be issued on transition into this state. '

    Looking at the JSON body for the event it states
    { "eventId":"00001", "eventTime":"2015-11-16T16:42:25-04:00", "eventType":"ServiceOrderInformationRequiredEvent", "event": { "serviceOrder" : {-- SEE ServiceOrder RESOURCE SAMPLE --} } }

    How does the Service Order defined within the event - "event": { "serviceOrder" : {-- SEE ServiceOrder RESOURCE SAMPLE --} }  communicate what information is required so that the information can be procured and the service order patched moving the service Order from Pending to InProgress. It would be useful to be able to send a 'code' that indicates what information is required.

    Thoughts on how this can be implemented



    ------------------------------
    Lance
    ------------------------------


  • 2.  RE: TMf 641 - Information Required Event

    TM Forum Member
    Posted Sep 29, 2020 02:48
    Hello Lance,

    Specifically in the structure of the event 'xxxInformationRequired' and 'xxxAttributeValueChangeEvent' you'll find an attribute fieldPath: The path identifying the object field concerned by this notification. This will allow you to specify the path to the field requiring some information (something like this for example if we are waiting  service characteristic valued for service order item 2 ..."fieldPath": "serviceOrder/456/serviceOrderItem/2/service/serviceCharacteristic/3").

    Hope it helps,
    Ludovic


    ------------------------------
    Ludovic Robert
    Orange
    My answer are my own & don't represent necessarily my company or the TMF
    ------------------------------



  • 3.  RE: TMf 641 - Information Required Event

    TM Forum Member
    Posted Sep 29, 2020 04:33
    Hello Ludovic

    Thank you very much for the response. That has definitely addressed my question.

    Regards
    Lance

    ------------------------------
    Lancy Mendonca
    ------------------------------



  • 4.  RE: TMf 641 - Information Required Event

    TM Forum Member
    Posted Feb 03, 2021 18:07
    Hi Ludovic

    Thanks for providing the response on field path. Noticed that the field path is a string and so can be used to flag that multiple fields have been updated or mutiple information is needed as part of the AttributeChange and InformationRequiredEvent. I could use some form of separator to separate the multiple field paths I assume

    ------------------------------
    Lancy Mendonca
    ------------------------------



  • 5.  RE: TMf 641 - Information Required Event

    TM Forum Member
    Posted Mar 09, 2021 22:04
    Hi @Ludovic Robert,

    There was two fields for resourceType and filedPath in 641 ​v3( as shown below) , but in 641 v4 there is only fieldPath. Was there some decision made for removing the resourcePath in v4?

    Thanks for your support.
    Rati Mehrotra
    @Uma Lakshman​​

    ------------------------------
    Rati Mehrotra
    Telstra Corporation
    ------------------------------



  • 6.  RE: TMf 641 - Information Required Event

    TM Forum Member
    Posted Mar 10, 2021 03:28
    Hello Rati,
    This is an already identify  defect (see https://projects.tmforum.org/jira/browse/AP-2240 )
    resourceType and filedPath attributes must be present in xxxxxAttributeValueChange & xxxxxInformationRequired notification structure.

    I will check internally in our team progress on this Jira.

    Thanks for the head up.
    Ludovic

    ------------------------------
    Ludovic Robert
    Orange
    My answer are my own & don't represent necessarily my company or the TMF
    ------------------------------



  • 7.  RE: TMf 641 - Information Required Event

    TM Forum Member
    Posted Mar 10, 2021 04:55
    Thanks @Ludovic Robert, appreciate your quick response ​

    ------------------------------
    Rati Mehrotra
    Telstra Corporation
    ------------------------------



  • 8.  RE: TMf 641 - Information Required Event

    TM Forum Member
    Posted 16 days ago

    Hey @Ludovic Robert, do you know if this has got fixed as it seems that the swagger and user guide still doesnt contain this?

    On another point where by there is more than one field which requires an update how is this communicated by the information required event?​



    ------------------------------
    David Whitfield
    TalkTalk Group
    ------------------------------