Open APIs

 View Only
  • 1.  The role of logicalResource entity in TMF677 Usage Consumption API?

    Posted Jul 10, 2023 05:42
    Edited by Anton Tsapko Jul 11, 2023 03:29
    Hi all, 
     
    I ask myself how logicalResource and bucketRefOrValue entitites are related (or not related) to each other in TMF677 Usage Consumption API?
     
    Both entities are palced below "UsageConsumption" entity. Both can have consumptionSummary objects, regarding the spec.
    .
    In the spec logicalResource  is defined as "A list of usage consumption logical resource references"
    In the example in the spec document (TMF677_Usage_Consumption_Management_API_REST_Specification_v4.0.0.pdf) SMS usage data is put in logicalResource  entity. On the contrary MMS usage modeled out as bucket in bucketRefOrValue structure. Does the fact that sms is flat-rate ("unlimited") and mms is not has something to do with it?
    .
    Concrete use-case:
    In my case I have a cable-segment object of certain length which consists of 144 fibers (in fact we "use" 5000 of such cable-segments). In a time period (a month) 10,20 or N < 145 fibers can be used. So it is a "UsageVolumeProduct". I am not sure if "usage" of fibers in one cable-segment should be modeled as a consumptionSummary within logicalResource or bucketRefOrValue? One could define  each cable segment as a "bucket" with 144 fiber objects. But that does appear like the right way of modeling to me.
    .
    I have also consulted GB922_Product_v22.5.pdf (pages 53++) but could not clearly figure when logicalResource with consumptionSummary should be used.
    .
    Best Regards
    Anton



    ------------------------------
    Anton Tsapko
    conology
    ------------------------------



  • 2.  RE: The role of logicalResource entity in TMF677 Usage Consumption API?

    Posted Jul 10, 2023 10:36

    Let's see what the experts have to say on this. @Vance Shipley , @Elisabeth Andersson do you want to weigh in here?



    ------------------------------
    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: The role of logicalResource entity in TMF677 Usage Consumption API?

    Posted Jul 12, 2023 06:45

    Hi @Anton Tsapko, @Jonathan Goldberg 

    @Elisabeth Andersson is out on vacation at the moment. Reviewing this in her absence I would say this may come down to how the cable segment object is modelled more widely in your solution. 

    If the cable segment is defined as a logical resource (has a resource specification, recorded in your resource inventory) then using logicalResource in TMF677 would make sense. If not, then using the bucket object to track the consumable assets (fibers) would make sense and therefore you would use BucketRefOrValue.

    Hope that's useful.



    ------------------------------
    Phil Moss
    MATRIXX Software
    ------------------------------