TM Forum Community

 View Only
  • 1.  TMF641 - Best practice for representing a common operation type for all ServiceOrderItems

    Posted yesterday

    Hi TM Forum Team,

    I am implementing TMF641 Service Ordering API (v4.1) for a telecom provisioning use case.

    In our implementation, a single Service Order can contain multiple ServiceOrderItems. However, all ServiceOrderItems within the same request always represent the same business operation. Mixed operation types are not allowed in a single request.

    For example:

    - PRE_PROVISION
    - ASSIGN
    - PEERING_NUMBER

    A request may contain multiple numbers, but they all belong to the same operation type.

    Example:

    {
      "operationType": "PRE_PROVISION",
      "serviceOrderItem": [
        {
          ...
        },
        {
          ...
        }
      ]
    }

    Instead of repeating the same value in every ServiceOrderItem, we would like to represent this operation only once at the ServiceOrder level.

    My questions are:

    1. Is there a standard TMF641 attribute that should be used for this purpose (for example, category or another existing attribute)?
    2. Is it recommended to use a custom top-level attribute such as "operationType" or "type"?
    3. If a custom attribute is added to the ServiceOrder resource, will it still be considered TMF641 compliant and pass CTK validation, or should custom business information be modelled using service/serviceCharacteristic instead?

    Our goal is to remain as close as possible to the TMF641 standard while avoiding redundant data in every ServiceOrderItem.

    Thank you for your guidance.


    #AIandData
    #BusinessAssurance
    #CustomerExperience
    #OpenDigitalArchitecture
    #General

    ------------------------------
    Gopal Bera
    TO BE VERIFIED
    ------------------------------


  • 2.  RE: TMF641 - Best practice for representing a common operation type for all ServiceOrderItems

    Posted yesterday
    1. Standard attribute in TMF641?
    No. TMF641 does not provide a standard attribute for business operation types like PRE_PROVISION or ASSIGN. Fields like category or action are not intended for this purpose and should not be repurposed.

    2. Use custom top-level attribute?
    Yes. A custom attribute like operationType at the ServiceOrder level is appropriate. Prefer using extension patterns (e.g., @type or x-operationType) to remain aligned with TMF extensibility guidelines.

    3. Compliance & CTK validation?
    Yes, still compliant. TMF APIs allow extensions. CTK will pass if standard schema is intact. Do not overload serviceCharacteristic; your use case fits better as a ServiceOrder-level orchestration attribute.


    ------------------------------
    Chirag Raval
    Lead Consultant
    Infosys Ltd
    ------------------------------