Open APIs

 View Only
  • 1.  TMF620 - Product Specs (characteristicValueSpecification)

    TM Forum Member
    Posted 10 days ago

    I'm trying to understand fields inside this sub-resource fields characteristicValueSpecification. If for example I want to define a product spec characteristic of type Integer. And now I'm setting up the  IntegerCharacteristicValueSpecification

    "characteristicValueSpecification": [
     {
     "isDefault": true,
     "valueType": "number",
     "validFor": {
     "startDateTime": "2020-09-23T00:00:00Z", 
     "endDateTime": "2022-11-24T00:00:00Z"
     }, 
     "rangeInterval":"closed",
       "value": 1,      --> should be removed?
     "valueFrom": 1,  
     "valueTo": 10,  
       
     "@type": "NumberCharacteristicValueSpecification"
     }
    ]

    Question : If I want to set the range of the value to be 1-10  then does that mean I don't have to fill-up the field "value":1 , or do I have to create 10 characteristic values with values=1-10  like below:

     "characteristicValueSpecification": [
        {
          "isDefault": false,
          "valueType": "number",
          "validFor": {
            "startDateTime": "2020-09-23T00:00:00Z",
            "endDateTime": "2022-11-24T00:00:00Z"
          },
          "value": 1,
          "@type": "NumberCharacteristicValueSpecification"
        },
    .....
        {
          "isDefault": false,
          "valueType": "number",
          "validFor": {
            "startDateTime": "2020-09-23T00:00:00Z",
            "endDateTime": "2022-11-24T00:00:00Z"
          },
          "value": 10,
          "@type": "NumberCharacteristicValueSpecification"
        } 
      ]

    If I have Range 1-10 what does the range Interval type means, please confirm if correct understanding

    Open - valid values are 2-9

    Closed - valid values are 1-10

    ClosedBottom - any number <10

    ClosedTop - any number >1



    ------------------------------
    Mary Gene Tecson
    Globe Telecom Inc.
    ------------------------------



  • 2.  RE: TMF620 - Product Specs (characteristicValueSpecification)

    TM Forum Member
    Posted 10 days ago

    Hi Mary

    Bear in mind that when you are building a range of characteristic values in the Product catalog, this represents the valid values that can be assigned to the characteristic in the instantiated Product. So in the example of a range of integers 1-10, I would say that:

    • open - any integer between 1 and 10 is valid
    • closed - any integer between 2 and 9 is valid
    • closedBottom - any integer between 2 and 10 is valud
    • closedTop - any integer between 1 and 9 is valid

    I would also say that we clearly didn't do a very good job in the documentation or in the model - the rangeInterval should be an enum not an open string. And the text of the description is not clear.

    So you don't need to populate value if you are defining a range, and you don't need to create 10 discrete value specs.

    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: TMF620 - Product Specs (characteristicValueSpecification)

    TM Forum Member
    Posted 10 days ago

    Hello Jonathan,

    Yes this is very helpful. Thank you. Will inform our tech team how we can implement this concept correctly in our system. 



    ------------------------------
    Mary Gene Tecson
    Globe Telecom Inc.
    ------------------------------