Contributors
Contributors |
---|
References
2018-10-17 AAI Meeting Notes - open for agenda items
https://wiki.onap.org/download/attachments/44467093/AAI_Schema_Service_ONAP.pptx
User Story
- As a developer of the CCVPN Use Case in ONAP, I would like to change the AAI schema to support all the new data and relationships as needed. It would be nicer to use an API to dynamically update the schema, rather than using a static configuration file.
Glossary
Description | OXM terminology | XSD terminology | Java terminology |
---|---|---|---|
"schema element" "java-type" "class" | "java-type" XML tag | "xs:element" XML tag as outer container | Java class |
"attribute" "java-attribute" | "xml-element" XML tag inside "java-attributes" XML tag
| "xs:element" XML tag as inner container
| Java field/member variable |
"relationship" | "xml-element" XML tag inside "java-attributes" XML tag
| "xs:element" XML tag as inner container
| Java field/member variable |
"metadata" "xml-property" | "xml-property" XML tag inside "xml-properties" XML tag | "xs:annotation" XML tag containing "annox:annotate" metadata | N/A. There are various hard-coded behaviours for each individual item of metadata. |
"namespace" | special "java-type" that
| "xs:element" XML tag as outer container
| N/A. There is special hard-coded behaviour for a specific set of "namespaces". |
"top-level" | a "relationship" of a "namespace" | N/A. There is special hard-coded behaviour that prevents "top-level" classes from also being used as "sub-components". | |
"sub-component" | a "relationship" of a "java-type" that is not a "namespace" | N/A. There is special hard-coded behaviour that prevents "top-level" classes from also being used as "sub-components". | |
"EdgeRule" | a separate JSON configuration file that regulates the behaviour of the "relationship" | N/A. There is special hard-coded behaviours for each individual item of metadata. | |
"cousin edge" |
| N/A. There is special hard-coded behaviour that handles the "relationship-list" for "cousin edges". |
Analysis from CCVPN Schema Changes in Casablanca Release
See also also:
- AAI-CCVPN Schema Proposal for Casablanca Release
Jira server ONAP JIRA serverId 425b2b0a-557c-3c0c-b515-579789cceedb key AAI-1353
Schema Change Description | CCVPN Example | Other Examples | |
---|---|---|---|
1 | Add new top-level |
"java-type"
| AAI-1353-1 ("Network" and "Business" namespaces) AAI-1353-3 ("connectivity" |
) AAI-1353-5 ("sp-partner" |
) AAI-1353-7 ("lan-port-config" |
) AAI-1353-8 ("site-resource" |
) AAI-1353-10 ("network-resource" |
) AAI-1353-12 ("ext-aai-networks" |
) AAI-1353-13 ("sdwan-vpn" |
) AAI-1353-14 ("device" |
) AAI-1353-15 ("wan-port-config" |
) | |
2 | Add new |
"attribute" to existing |
"java-type" | AAI-1353-2 ("service-instance" |
) AAI-1353-4 ("vpn-binding" |
) AAI-1353-6 ("allotted-resource" |
) AAI-1353-9 ("complex" |
) AAI-1353-11 ("p-interface" |
) AAI-1353- |
16 ("pnf" |
)
| |||||||||
3 | Add new sub-component |
"java-type"
| AAI-1353-7b ("dhcp-service" |
) "lan-port-config" to "dhcp-service" | |
4 |
Add new "cousin edge"
| "vpn-binding" to "p-interface" "sp-partner" to "service-instance" "connectivity" to "service-instance" "connectivity" to "vpn-binding" "lan-port-config" to "service-instance" "network-resource" to "vpn-binding" "pnf" to "network-resource" "site-resource" to "service-instance" "site-resource" to "allotted-resource" "site-resource" to "complex" "sdwan-vpn" to "service-instance" "sdwan-vpn" to "tenant" "sdwan-vpn" to "vpn-binding" "device" to "service-instance" "device" to "generic-vnf" "wan-port-config" to "service-instance" "logical-link" to "ext-aai-network" "vpn-binding" to "ext-aai-network" "pnf" to "ext-aai-network" "connectivity" to "ext-aai-network" "lan-port-config" to "ext-aai-network" "network-resource" to "ext-aai-network" "site-resource" to "ext-aai-network" "sdwan-vpn" to "ext-aai-network" "device" to "ext-aai-network" "wan-port-config" to "ext-aai-network" | ||||||||||
5 | Change existing "EdgeRule", e.g. cardinality |
| |||||||||
6 | Add new "namespace" |
AAI-1353-12 ("ext-aai" |
), see workaround "ext-aai-networks" |
7 | Add new sub-component relationship using existing top-level |
"java-type" | AAI-1353-12 ("ext-aai"), see workaround "ext-aai-networks" "logical-link" to "ext-aai-network" "vpn-binding" to "ext-aai-network" "pnf" to "ext-aai-network" "connectivity" to "ext-aai-network" "lan-port-config" to "ext-aai-network" "network-resource" to "ext-aai-network" "site-resource" to "ext-aai-network" "sdwan-vpn" to "ext-aai-network" "device" to "ext-aai-network" "wan-port-config" to "ext-aai-network" | |
8 |
Add new top-level relationship using existing |
sub-component "java-type" | AAI-1353-12 ("ext-aai"), see workaround "ext-aai-networks" | ||||||||||
9 | Expose previously hidden "java-type" as sub-component relationship | AAI-1353-12 ("esr-system-info") "ext-aai-network" to "esr-system-info"
| |||||||||
10 | Add new metadata to existing "java-type" |
| "uriTemplate" "privateEdge" "defaultValue" | ||||||||
11 | Update existing metadata in "java-type" | "indexedProps" "uniqueProps" "dependentOn" | "defaultValue" |