Open APIs

 View Only
  • 1.  TMF673

    TM Forum Member
    Posted Apr 08, 2022 08:46
    Hi, 
    We have a monolithic address repository system, we are working towards exposing TMF Open APIs and modernize the application. We are looking TMF673 for address related operations.
    we are facing below issues and not sure how we cam modal address resources.
    1. In EU we have streets and municipalities names in multiple languages. These API provide these names as a string not an array so not sure how it should be taken up ideally. as a hack we can have concatenated stings like Brussels| Bruxells etc. but it doesn't seems ideal.
    2.  We need to expose operations for retrieving "Streets" / "Municipalities" here we can use geographic address without geograbhiclocation or geographicsubaddress but still we left out with problem of having multiple postcodes as a city/or municipality can have multiple postcode associated but in TMF673 has just one string for a post code.
    Can somebody guide for the above and give recommendations for these.
    Regards,
    Sachchit Sharma

    ------------------------------
    Sachchit Sharma
    Infosys
    ------------------------------


  • 2.  RE: TMF673

    TM Forum Member
    Posted Apr 11, 2022 07:46
    HI @Alexis de Peufeilhoux  @Jonathan Goldberg Can you Guys give any insights for above that can help me.

    ------------------------------
    Sachchit Sharma
    Infosys
    ------------------------------



  • 3.  RE: TMF673

    TM Forum Member
    Posted Apr 12, 2022 01:38
    Hi Sachchit
    The Open API design guidelines are rather light on multi-lingual support, unfortunately.
    For the v5 design guidelines, we have added some guidelines on how to manage support for multiple languages. Specifically for your type of use case, where there is a need for persistence and display of field values in multiple languages, the direction at API model level will probably be to add an optional separate sub-resource with an array of attribute names and a sub-array of values per language. Of course the API will say nothing about persistence, which you can manage any way you wish.
    In the meantime I advise you to extend your relevant APIs with such a structure.
    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.
    ------------------------------