Open APIs

Expand all | Collapse all

Why RelatedParty and not RelatedPartyRefOrValue?

  • 1.  Why RelatedParty and not RelatedPartyRefOrValue?

    TM Forum Member
    Posted Oct 21, 2020 08:34
    Hi guys,
    I have a question regarding the use of "RelatedParty".

    For example in the TMF641 Service Order Management API and elsewhere an array of RelatedParties is often used.

    I wonder why RelatedPartyRefOrValue is not allowed here? Couldn't you also include the party directly in the Service Order instead of using HREF and ReferredType?

    In our specific case we need a party and its contact medium in the ServiceOrder, but we don't have a party management system available.

    ------------------------------
    Jan Lemmermann
    OSS Lead Architect
    EWE TEL GmbH
    ------------------------------


  • 2.  RE: Why RelatedParty and not RelatedPartyRefOrValue?

    TM Forum Member
    Posted Oct 21, 2020 08:49
    RelatedPartyRefOrValue is not used (currently) anywhere in the Open API, except internally within PartyRole management itself, so that a PartyRole can be created along with embedded related party roles.
    I think that the (reasonable) assumption is that parties will always exist before creating any entities that are owned by or relate to Party/PartyRole.
    You can of course extend the ServiceOrder model to add the information that you need, you need to consider whether to embed Party or perhaps directly ContactMedium.
    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: Why RelatedParty and not RelatedPartyRefOrValue?

    TM Forum Member
    Posted Oct 27, 2020 03:31
    Hi,

    I fully agree with Jonathan. A party should exist before an order is placed which contains products/services/resources that are owned by this party.

    The same holds for Product Ordering API (TMF 622) where RelatedParty is also a reference on an existing party. Otherwise product ordering would have to maintain the party lifecycle (e.g. create a party during the course of order management process) which is clearly far beyond the "product" domain scope of product order management.

    Regards
    Thomas

    ------------------------------
    Thomas Dupré
    Deutsche Telekom AG
    ------------------------------