Open APIs

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

I looked further into this, there is an existing JIRA for this waiting to be executed.

https://projects.tmforum.org/jira/browse/AP-2928

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

I am coming back to my original question.

Thank you, @Jonathan Goldberg, for the information.

This JIRA (https://projects.tmforum.org/jira/browse/AP-2928) is indeed related, but seems to be more focused on the RelationshipCharacteristicSpecification in TMF620 than on the RelationshipCharacteristic in TMF637.

The only reference to TMF637 I can find there is this comment at the end:

But I find it confusing, because, as I wrote in my original post, the Swagger of TMF637 does NOT contain RelationshipCharacteristic.

@Matthieu Hattab - with regards to your message: "The inventory API already has references to the Product Offering and Product Specifications, so one could easily find the PS relationships from the product catalogue." I do not exactly understand what you mean. The way I understand it, the common pattern is to have all specifications in Catalog Management, and all instances in Inventory Management. For example, you can have RelatedEntitySpecification in some catalog, and RelatedEntity in the corresponding Inventory. Shouldn't it be the same with RelationshipCharacteristicSpecification/RelationshipCharacteristic?

I looked further into this, there is an existing JIRA for this waiting to be executed.

https://projects.tmforum.org/jira/browse/AP-2928

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

the product in the inventory has a reference to the Product Specification:

you can query that product spec with TMF620 V5 and then you can see the productspecificationrelationship and the characteristic that refines the
relationship.
I'm not sure the characteristic that refines the relationship should be instanciated in the product inventory. That characteristic is used to enforce a business rule.
if possible we should keep the api payload as lean as possible.
Why do you need it for?

I am coming back to my original question.

Thank you, @Jonathan Goldberg, for the information.

This JIRA (https://projects.tmforum.org/jira/browse/AP-2928) is indeed related, but seems to be more focused on the RelationshipCharacteristicSpecification in TMF620 than on the RelationshipCharacteristic in TMF637.

The only reference to TMF637 I can find there is this comment at the end:

But I find it confusing, because, as I wrote in my original post, the Swagger of TMF637 does NOT contain RelationshipCharacteristic.

@Matthieu Hattab - with regards to your message: "The inventory API already has references to the Product Offering and Product Specifications, so one could easily find the PS relationships from the product catalogue." I do not exactly understand what you mean. The way I understand it, the common pattern is to have all specifications in Catalog Management, and all instances in Inventory Management. For example, you can have RelatedEntitySpecification in some catalog, and RelatedEntity in the corresponding Inventory. Shouldn't it be the same with RelationshipCharacteristicSpecification/RelationshipCharacteristic?

I looked further into this, there is an existing JIRA for this waiting to be executed.

https://projects.tmforum.org/jira/browse/AP-2928

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

Hello Matthieu,

Instantiation of such a characteristic addresses your other question. In your example:

A CharacteristicSpecification of the ProdSpecRelationship defines the options of required bandwidth, and an instantiation will define the bandwidth that is actually selected for the specific instance of TVProd.

Does this make sense?

the product in the inventory has a reference to the Product Specification:

you can query that product spec with TMF620 V5 and then you can see the productspecificationrelationship and the characteristic that refines the
relationship.
I'm not sure the characteristic that refines the relationship should be instanciated in the product inventory. That characteristic is used to enforce a business rule.
if possible we should keep the api payload as lean as possible.
Why do you need it for?

I am coming back to my original question.

Thank you, @Jonathan Goldberg, for the information.

This JIRA (https://projects.tmforum.org/jira/browse/AP-2928) is indeed related, but seems to be more focused on the RelationshipCharacteristicSpecification in TMF620 than on the RelationshipCharacteristic in TMF637.

The only reference to TMF637 I can find there is this comment at the end:

But I find it confusing, because, as I wrote in my original post, the Swagger of TMF637 does NOT contain RelationshipCharacteristic.

@Matthieu Hattab - with regards to your message: "The inventory API already has references to the Product Offering and Product Specifications, so one could easily find the PS relationships from the product catalogue." I do not exactly understand what you mean. The way I understand it, the common pattern is to have all specifications in Catalog Management, and all instances in Inventory Management. For example, you can have RelatedEntitySpecification in some catalog, and RelatedEntity in the corresponding Inventory. Shouldn't it be the same with RelationshipCharacteristicSpecification/RelationshipCharacteristic?

I looked further into this, there is an existing JIRA for this waiting to be executed.

https://projects.tmforum.org/jira/browse/AP-2928

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

the modification you've done on my diagram would work for TMF620. (I'm hoping Jonathan can confim it because that would mean I need to split my TVProdSpec:

1. one 8KTVProdSpec for 8K channels, where I could add the CharSpec under the ProdSpecRelationship to restrict certain bandwidth values on the Fiber PS, as you updated on my diagram
2. another one for other resolutions (4K, HD and SD)

However my model was really for TMF620.
do you have a need ot see the characteristic under the productrelationship in TMF637?

Hello Matthieu,

Instantiation of such a characteristic addresses your other question. In your example:

A CharacteristicSpecification of the ProdSpecRelationship defines the options of required bandwidth, and an instantiation will define the bandwidth that is actually selected for the specific instance of TVProd.

Does this make sense?

the product in the inventory has a reference to the Product Specification:

you can query that product spec with TMF620 V5 and then you can see the productspecificationrelationship and the characteristic that refines the
relationship.
I'm not sure the characteristic that refines the relationship should be instanciated in the product inventory. That characteristic is used to enforce a business rule.
if possible we should keep the api payload as lean as possible.
Why do you need it for?

I am coming back to my original question.

Thank you, @Jonathan Goldberg, for the information.

This JIRA (https://projects.tmforum.org/jira/browse/AP-2928) is indeed related, but seems to be more focused on the RelationshipCharacteristicSpecification in TMF620 than on the RelationshipCharacteristic in TMF637.

The only reference to TMF637 I can find there is this comment at the end:

But I find it confusing, because, as I wrote in my original post, the Swagger of TMF637 does NOT contain RelationshipCharacteristic.

@Matthieu Hattab - with regards to your message: "The inventory API already has references to the Product Offering and Product Specifications, so one could easily find the PS relationships from the product catalogue." I do not exactly understand what you mean. The way I understand it, the common pattern is to have all specifications in Catalog Management, and all instances in Inventory Management. For example, you can have RelatedEntitySpecification in some catalog, and RelatedEntity in the corresponding Inventory. Shouldn't it be the same with RelationshipCharacteristicSpecification/RelationshipCharacteristic?

I looked further into this, there is an existing JIRA for this waiting to be executed.

https://projects.tmforum.org/jira/browse/AP-2928

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

@Jonathan Goldberg,
Using the characteristic relationship between ProductSpecificationRelationship and CharacteristicSpecification and the provided description, does it support creating relationship between charvalues of 2 different ProdSpec? Using the textual example in the API documentation, can we achieve this:

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,

Hi Matthieu

The way the characteristic relationship is currently defined for APIs, I don't think it meets your needs. It gives you a connection between characteristics, not between their values. The SID takes this one level further and gives you a relationship between characteristic spec values.

@Jonathan Goldberg,
Using the characteristic relationship between ProductSpecificationRelationship and CharacteristicSpecification and the provided description, does it support creating relationship between charvalues of 2 different ProdSpec? Using the textual example in the API documentation, can we achieve this:

It should probably be added to the inventory API, thanks for the catch Opher.

Hello,

The question is whether version 5 of the APIs intends to contain a Characteristic array under the Relationship pattern.

I reviewed one pair of APIs that already have version 5 in Production - TMF620 Product Catalog and TMF637 Product Inventory.

In the Swagger of TMF620 I find:

In particular, ProductSpecificationRelationship contains a "characteristic" attribute of type CharacteristicSpecification.

However, in the Swagger of TMF637 I find:

In particular, ProductRelationship does not contain a "characteristic" attribute.

The two specifications seem incompatible to me. Do I miss something? If not, which one of these 2 APIs is 'correct'?

Thank you and best regards,