Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

The LSO Cantata SDK is the complete set of deliverables developed by the MEF membership in order to

  1. Enable market adoption of LSO Cantata APIs in the current release of the LSO API Framework.
  2. Support of development of additional features for the upcoming release of the LSO Cantata SDK.

The latest release of LSO Cantata SDK is in the LSO API Release 'Billie' and is available on GitHub (see Latest Release section for details).

Any MEF member can participate in the development of each new release of the LSO Cantata SDK:

  • Contact the LSO Developer Community Manager (Michał Łączyński ) either via GitHub or by email to let him know of your interest and to ask questions


Panel
borderColorblack
borderWidth1
titleTable of Contents

Table of Contents


Panel
titleLatest Release

MEF-LSO-Cantata-SDK - Billie Release (Production)

Download the entire repository by clicking
here

Introduction

This repository contains the MEF LSO Cantata SDK. It includes API definitions
for the following functional areas:

  • Serviceability
    • Address
    • Site Retrieval
    • Product Offering Qualification Management
  • Product Quote
  • Product Order
  • Product Inventory
  • Trouble Ticket

It also provides Product Schemas for:

  • EPL
  • EPLAN
  • EPTREE
  • EVPL
  • EVPLAN
  • EVPTREE

High-level release notes

With this release Cantata is reusing all of Sonata APIs. The theme of this
release is Ordering and Inventory: it delivers full coverage of Business
Requirements, API and API Developer Guides for all above mentioned Cantata API
functions.

  • All APIs have been reviewed and updated to follow their respective Business
    Requirements & Use Cases and Developer Guides documents
  • All API definitions are provided in OAS 3.0 standard.
  • New documents:
    • MEF W87 - LSO Cantata and LSO Sonata Product Offering Qualification API
      Developer Guide
    • MEF W115 - LSO Cantata and LSO Sonata Quote Management API Developer Guide
    • MEF W121 - LSO Cantata and LSO Sonata Address Management API Developer Guide
    • MEF W122 - LSO Cantata and LSO Sonata Site Management API Developer Guide
    • MEF W116 - LSO Cantata and LSO Sonata Product Inventory API - Developer
      Guide
    • MEF W123 - LSO Cantata and LSO Sonata Product Order Management API -
      Developer Guide
    • MEF W124 - LSO Cantata and LSO Sonata Trouble Ticketing API - Developer Guide
    • MEF W125 - LSO Cantata and LSO Sonata Product Specification - Subscriber
      Ethernet - Schema Guide

Maturity Level

The API files contained in this SDK are evolving and subject to change. They are
based on documents that are either ratified standards or draft standards that
have not yet completed the review cycles and approvals necessary to achieve the
status as a MEF standard. MEF is making these publicly available at this time to
invite wider industry review.

The maturity per functionality presents as follows:

  • Address Validation, Site Query:
    • Business Requirements
      • MEF 79 - Published Standard
      • MEF 79.0.2 - Draft Release 2, Letter Ballot pending
    • Developer Guide/API
      • MEF W121 - LSO Cantata and LSO Sonata Address Management API - Developer Guide - work in progress - CfC#1 reviewed
      • MEF W122 - LSO Cantata and LSO Sonata Site Management API - Developer Guide - work in progress - CfC#1 reviewed
  • Product Offering Qualification:
    • Business Requirements
      • MEF 79 - Published Standard
      • MEF 79.0.1 - Published Standard
    • Developer Guide/API - MEF W87 - work in progress - Draft Standard (R1), Ready for CfC#4
  • Quote:
    • Business Requirements - MEF W80 - Draft Release 6, Letter Ballot pending
    • Developer Guide/API- MEF W115 - LSO Cantata and LSO Sonata Quote Management API - Developer
      Guide - work in progress, CfC#1 reviewed
  • Order:
    • Business Requirements - MEF 57.2 - Draft Release 2
    • Developer Guide/API - work in progress - ready fo CfC#1
  • Inventory:
    • Business Requirements - MEF 81, MEF 81.0.1 Published Standard
    • Developer Guide/API - work in progress - ready for CfC#1
  • Trouble Ticket:
    • Business Requirements - MEF W113 - Draft Release 1
    • Developer Guide/API - work in progress - ready for CfC#1
  • Product Specifications:
    • Access E-Line - MEF W106 work in progress, CfC#2 reviewed
    • EPL, EPLAN, EPTREE, EVPL, EVPLAN, EVPTREE - work in progress

For details on the maturity map and the roadmap for future releases please refer
to
LSO Cantata SDK Home Page
on the MEF WIKI.

Contents

This SDK contains the following items:

  • COPYRIGHT - Copyright 2020 MEF Forum
  • LICENSE - Contains a copy of the Apache 2.0 license
  • README - This file
  • productApi - Definitions of the API are found in this directory
    • inventory - Contains the API definitions necessary for inter-carrier
      retrieval of Product Inventory
    • order - Contains the API definitions for inter-carrier service ordering
      capability.
    • quote - Contains the API definitions for inter-carrier service quotation
      capability
    • serviceability - Contains the APIs that allow the Service Provider or
      Buyer to perform:
      • address - Retrieve Address information including exact formats for
        Addresses known to the Seller
      • offeringQualification - Determine whether it is feasible for the Seller
        to deliver a particular Product with a given configuration to a particular
        geographic location if applicable.
      • site - Retrieve Service Site information including exact formats for
        Service Sites known to the Seller
    • troubleTicket - Create and manage Trouble Tickets
  • documentation - All related standards and Developer Guides.
    • productApi - API related documentation - Developer Guides
      • inventory - MEF W116 Developer Guide
      • order - MEF W123 Developer Guide
      • quote - MEF W115 Developer Guide
      • serviceability/address - MEF W121 Developer Guide
      • serviceability/offeringQualification - MEF W87 Developer Guide
      • serviceability/site - MEF W122 Developer Guide
      • troubleTicket - MEF W124 Developer Guide
    • productSchema - product related documentation
      • carrierEthernet - MEF W106 and MEF W125 Product Schema Guides
    • supportingStandards - The rest of documents and standards.
  • ProductSchema - Product Specification schemas for:
    • carrierEthernet - Carrier Ethernet product Schemas
  • generated/staticBinding/full - contains automatically generated (with help
    of the open source
    Sonata Blending Tool), not
    normative static bindings of envelope APIs with all Product Specification
    payloadsSpecifications.

Issues, Questions, and Feedback

Issues should be reported with the use of GitHub issues. Questions and feedback
should be asked either at
Cantata SDK Community
or directly to community_manager@mef.net.

NOTE: All artifacts included in this repository have line numbers. When
referring to specific content in any of these artifacts, please quote the line
numbers to which you are referring.

The MEF LSO Cantata SDK is released under the Apache 2.0 license.


Panel
titleLSO Cantata SDK Releases

BR&UC - Business Requirements & Use Cases

Underlined item indicates a release deliverable that is a delta from the previous SDK release.

Published standard

Draft standard
(or at least 1 CfC resolved)

Work in progress

LSO Cantata SDK Billie (Production)

Version: billie-final

Date: 3rd June 2021

FunctionBR&UCLSO Sonata APIProduct specificationBlended envelope + payload (OAS 3.0)Tooling
Developer GuideMEF branded TMF envelope APIRequirementsJSON Schema
Address Validation

MEF 79

MEF 79.0.2 (Draft Standard R2)

MEF 121
(CfC#1 resolved)
geographicAddressManagement (1.0.0-RC)
N/AN/A

Site Query

MEF 79

MEF 122
(CfC#1 resolved)
geographicSiteManagement (1.0.0-RC)N/AN/A

Product Offering Qualification (POQ)

MEF 79

MEF 79.0.1

MEF 87
(CfC#3 resolved)

productOfferingQualificationManagement (1.0.0-RC)

productOfferingQualificationNotification (1.0.0-RC)

MEF W125 (working draft)

Subscriber Ethernet

(tick)SonataBlendingTool
Quoting
MEF 80 (Draft Standard R6)
MEF W115
(CfC#1 resolved)

quoteManagement (1.0.0-RC)

quoteNotification (1.0.0-RC)

MEF W125 (working draft)

Subscriber Ethernet(tick)
Product Inventory

MEF 81

MEF 81.0.1

MEF W116 (CfC#1 working draft)productInventoryManagement (1.0.0-RC)MEF W125 (working draft)
Subscriber Ethernet(tick)
Product Order
MEF W57.2 (Draft Standard R2)MEF W123 (CfC#1 working draft)

productOrderManagement (2.0.0-RC)

productOrderNotification (2.0.0-RC)

MEF W125 (working draft)Subscriber Ethernet(tick)
Trouble Ticketing
MEF W113
(Draft Standard R1)

MEF W124

(working-draft, CfC#1 ready)

troubleTicketManagement (1.0.0-RC)

troubleTicketNotification (1.0.0-RC)

N/AN/A

Billing







Test RequirementsMEF W92.1
(Draft Standard R1)







Release Billie Deliverables

Bolded Deliverables are part of the release's theme: "Ordering and Inventory"

DeliverableMaturityComment
MEF W57.2 Order BR&UCDraft Standard (R2)
MEF W116 Inventory DevGuide+APIWorking Draft (CfC#1 ready)
MEF 123 Order DevGuide+API
Working Draft (CfC#1 ready)
MEF W125 - Subscriber Ethernet Schemas and Product Schema GuideWorking DraftEPL, EVPL, EP-LAN, EVP-LAN, EP-TREE, EVP-TREE Subscriber UNI

MEF 79.0.2

79 Address amendment

Draft Standard (R2), (LB pending)

MEF 80

Quote BR&UC

Draft Standard (R6), (LB pending)

MEF 115

Quote DevGuide+API

CfC#1 resolved, (CfC#2 ready)lots of changes in MEF 80
MEF 87 POQ DevGuide + APICfC#3 resolved, (CfC#4 ready)
MEF 121 Address Dev Guide + APIWorking Draft (CfC#1 ready)
MEF 122 Site Dev Guide + APIWorking Draft (CfC#1 ready)
MEF W113 Trouble TicketingDraft Standard (R1)
MEF W124 Sonata API & Developer Guide - Trouble TicketingWorking Draft (CfC#1 ready)
MEF W92.1: LSO Sonata Test RequirementsDraft Standard (R1)



LSO Cantata SDK Celine (November 2021)

Git tag:


FunctionBR&UCLSO Cantata APIProduct specificationBlended envelope + payload (OAS 3.0)Tooling
Developer GuideMEF branded TMF envelope APIRequirementsJSON Schema
Address Validation

MEF 79

MEF 79.0.2 (Draft R2)

MEF 121
GeographicAddressManagementN/AN/A

Site Query

MEF 79

MEF 122
GeographicSiteManagementN/AN/A

Product Offering Qualification (POQ)

MEF 79

MEF 79.0.1

MEF 87

ProductOfferingQualificationManagement

ProductOfferingQualificationNotification

MEF 125

Subscriber Ethernet

(tick)SonataBlendingTool
Quoting
MEF 80
MEF 115

QuoteManagement

QuoteNotification

MEF 125Subscriber Ethernet(tick)
Product Inventory

MEF 81

MEF 81.0.1

MEF 116ProductInventoryManagementMEF 125Subscriber Ethernet(tick)
Product Order
MEF 57.2MEF W123 Draft Standard (R1)

ProductOrderManagement

ProductOrderNotification

MEF 125Subscriber Ethernet(tick)
Trouble Ticketing
MEF 113
MEF W124
Draft Standard (R1)

N/AN/A

Billing







Test RequirementsMEF W92.1
Draft Standard (R2)







Release Celine Deliverables


DeliverableMaturity
MEF 57.2 Order BR&UCStandard
MEF 116 Inventory DevGuide+APIStandard
MEF 123 Order DevGuide+APICfC#1 resolved
MEF 125 - Subscriber Ethernet Schemas and Product Schema GuideStandard
MEF 121 Address Dev Guide + APICfC#2 resolved
MEF 122 Site Dev Guide + APICfC#2 resolved
MEF 113 Trouble TicketingStandard
MEF 124 Sonata API & Developer Guide - Trouble TicketingCfC#1 resolved
MEF W92.1: LSO Sonata Test RequirementsDraft Standard (R2)



Panel
titleHistorical

LSO Cantata SDK Aretha

Version: aretha

Date: 22nd December 2020

FunctionBR&UCLSO Cantata APIProduct specificationBlended envelope + payload (OAS 3.0)
Developer GuideMEF branded TMF envelope APIRequirementsJSON Schema
Address Validation



N/AN/A
Site Query



N/AN/A
Product Offering Qualification (POQ)






Quoting






Product Inventory






Product Order

MEF W57.2

(Draft Standard R2)


ProductOrderManagement1.0.0-RC

ProductOrderNotification - 1.0.0-RC


EPL(tick)
Trouble Ticketing



N/AN/A
Billing



N/AN/A


Release Aretha Deliverables

Bolded Deliverables are part of the release's theme "Pre-order"

DeliverableMaturity
Order APIWorking Draft
updated to 57.2 Draft Standard (R2) (basic scope)
MEF W57.2 Order BR&UCDraft Standard R2 (basic scope)
EPL Product SchemaWorking draft




Panel
titleStatus

Status
colourGreen
titlePUBLIC


Panel
titleLSO Developer Community

LSO Cantata SDK Community

LSO Developer Community Home Page


Panel
titleLSO Developer Community Manager

Michał Łączyński

Contact: community_manager@mef.net


Panel
titleLSO Legato SDK @ GitHub

Core (public):

https://github.com/MEF-GIT/MEF-LSO-Cantata-SDK

Extensions (MEF Members only):

https://github.com/MEF-GIT/MEF-LSO-Cantata-SDK-extended

Note

If you are a MEF Member, update your wiki profile with your GitHub account name. Access to the LSO Cantata SDK Extensions repository is periodically updated with provided GitHub accounts. Additionally contact the LSO Developer Community Manager to request the immediate access.



Panel
titleCore Contributors

Karthik Sethuraman

Jack Pugaczewski


Note

Are you a core contributor to this LSO SDK but not mentioned here? Please let the LSO Developer Community Manager know and we will add you!