Open APIs

 View Only
Expand all | Collapse all

TMF635 -- Usage Management API

  • 1.  TMF635 -- Usage Management API

    Posted Jun 01, 2020 05:58
    Hi Team,

    We are developing the TMF635 ( Usage Management API) for certification .

    But CTK is not available for testing.

    Kindly suggest how can we share the test result and perform the testing for the above API.

    Thanks & Regards,
    Akansha Agarwal


    ------------------------------
    Akansha Agarwal
    Comviva
    ------------------------------


  • 2.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jun 01, 2020 10:04
    Hi Akansha

    I raised this with the Open API team leads.

    The current version of the Usage Management API is very old (release 14.5), and a new version is in preparation. Perhaps it will be worth your while waiting for the new version, in terms of business value (certifying an up-to-date version would seem to be more effective than a version released some 5 years ago).

    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: TMF635 -- Usage Management API

    Posted Jun 08, 2020 07:51
    Hello Jonathan

    Regarding updated TMF635 specification, any timelines available around its release? Possible to share highlights of anticipated changes?

    Thank you

    ------------------------------
    Braam van Heerden
    Openet
    ------------------------------



  • 4.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jun 19, 2020 08:35
    I would like to know about this new release too. Is there a draft that can be shared so that we can see what the changes/additions are ?

    ------------------------------
    Richard Loo
    Telstra Corporation
    ------------------------------



  • 5.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jun 22, 2020 05:29
    Hi
    Without making any promises, the current discussions in the Open API team are towards releasing API definition (Swagger) and CTK at around the end of the month for this API.
    Suggest you watch this space for more updates.

    ------------------------------
    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.
    ------------------------------



  • 6.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jun 29, 2020 04:22
    Hi,

    Just to say that an updated version v4.0.0 of the TMF635-Usage Management swagger file was put on the public GitHub last week:
    https://github.com/tmforum-apis/TMF635_UsageManagement

    The UserGuide is being worked on now, followed by Conformance Profile - leading to the CTK!

    ------------------------------
    Stephen Harrop
    Principal Integration Architect
    Vodafone Group
    ------------------------------



  • 7.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jun 29, 2020 19:39
    Thanks for that. May I ask what the major differences are from the previous version?

    ------------------------------
    Richard Loo
    Telstra Corporation
    ------------------------------



  • 8.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jun 30, 2020 01:31
    Best to ask @Kevin King, the lead for this API, for a full list of changes. Apart from specific functional enhancements, it includes alignment with the ​updated TMF630 design guidelines (recently published for member approval).

    ------------------------------
    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.
    ------------------------------



  • 9.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jul 06, 2020 22:18
    Edited by Richard Loo Jul 06, 2020 22:20
    Thanks Jonathan, I have sent a message to Kevin King.

    While we are on this subject, in the existing TMF635 REST API spec, it looks like the only way that I can related a usage data instance as being related to a TMF638 service instance is via the relatedParty . Can anyone shed some light on whether this is correct, or is there a more correct way of doing this? Does the new TMF635 spec have an explicit way to this by design?

    Thanks for your help everyone.

    ------------------------------
    Richard Loo
    Telstra Corporation
    ------------------------------



  • 10.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jul 07, 2020 02:44
    Hi Richard and all

    So sorry, I incorrectly sent you to @Kevin King, he's doing prepay balance, not usage management. @Steve Harrop, who replied earlier on this thread, is doing usage management.

    Regarding your query, in the latest schema, we have a reference from RatedProductUsage to ProductRef, thus I can know which Inventory Product caused the usage item. Product has references to its implementing services and resources, but this does not give you the specific service that was "responsible" (somehow) for the product usage (and there may be multiple services).

    I suggest you take a look at the SID model for usage, which is more extensive than what we have done in the Open API, you can see there that the different types of usage are related to each other, and so it would be possible to navigate to the "responsible" service(s) or resource(s). I tried to upload an image but got an error message.

    Needs more discussion if it would be required to bring this into the Open API model.

    Hope it helps and again sorry for the confusion.


    ------------------------------
    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.
    ------------------------------



  • 11.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jul 07, 2020 03:04
    Thanks Jonathan for that. What if the usage is unrated and there is RatedProductUsage present? In my use case, I need to retrieve the unrated usage, relate it to a service instance, and rate it according to the service instance that the usage belongs to. In addition, in theory I can relate then service to a product to work out the rating.

    ------------------------------
    Richard Loo
    Telstra Corporation
    ------------------------------



  • 12.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jul 10, 2020 01:24
    Furthermore, on bottom of page 13 of the SID mapping document from https://www.tmforum.org/resources/best-practice/tmf635a-usage-management-sid-mapping-r17-5-0/  , there is a table labelled "SID relationships without correspondence in the API"  .  I am wondering if the new API has the capability to idenify the 'entity' (product/service/resource) for which the usage has been collected? I am interested to know how others in this community have handled this using the the existing API spec?



    ------------------------------
    Richard Loo
    Telstra Corporation
    ------------------------------



  • 13.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Jul 13, 2020 10:06
    Hi Richard
    The SID mapping documents are rather old, I suggest you reach out to the SID leaders @Cecile Ludwichowski and @Dirk Rejahl to see what the plans are for updating these mappings.
    In any case usage in the Open API is currently product-oriented, you are welcome to suggest enhancements, or even to contribute, in order to meet your use cases.

    ------------------------------
    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.
    ------------------------------



  • 14.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Sep 09, 2020 11:13
    Hi Richard,

    Unfortunately the mapping activity has stopped for several years. That's why the mapping documents have not been updated.
    I hope we will soon be able to restart this activity.

    I take the oppertunity to tell you that only ProductUsages (related to Products) can be rated, not ServiceUsages (related to Services).

    See you,
    Cécile

    ------------------------------
    Cecile Ludwichowski
    Orange
    ------------------------------



  • 15.  RE: TMF635 -- Usage Management API

    Posted Nov 12, 2021 10:42
    Stephen, 
    imagine mobile internet usage event, it came by DIAMETER and informed me that device wants to start consuming mobile internet services of Facebook.
    Equipment expects a response "how much bytes it is OK to consume".
    Later it will come with information "I've consumed <this much> and want more".

    I can't seem to find anything relevant here.
    TMF636 is about fait accompli, and does not apply per se.

    I'm sure you've considered this and have some good pointer for me.
    Thanks in advance,

    Alex from Russia, early winter here ;)

    ------------------------------
    ALEXANDER PETROSSIAN
    TO BE VERIFIED
    ------------------------------



  • 16.  RE: TMF635 -- Usage Management API

    TM Forum Member
    Posted Nov 14, 2021 02:12
    Hi Alex from Russia
    In my opinion, the TMF Open API will not attempt to replace or wrap existing network protocols. So indeed the case you described, which might be handled by an OCS or PCF, would be done by Gx, Gy, Sy, and friends.
    Once the usage events have been processed, there is a need to get queries and reporting, and this is what is covered by the Open APIs in this domain (635 and 677)
    Hope it helps

    P.S. Keep warm there

    ------------------------------
    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.
    ------------------------------



  • 17.  RE: TMF635 -- Usage Management API

    Posted Nov 14, 2021 10:51
    Jonathan, 
    I was not after wrapping exactly. 
    Was thinking along "generalization" lines. 
    To convert different network protocols into some descendant class of Usage (maybe NetworkUsage) and have some reasonable generalised response. 
    Not just "ok, usage recorded", but "ok, grant d this much". 

    So we'd have SID inside, external protocols outside. With general core, that cares little for incoming protocols. 
    Be it mobile internet, calls, SMS or some VAS. 

    Alex from Russia
    P.S. reading into CatalogueONE right now. 
    Watching tons of presentions and meetings with Amdocs people. 
    Looks like UI side complexity was addressed pretty good!


    ------------------------------
    ALEXANDER PETROSSIAN
    TO BE VERIFIED
    ------------------------------