Specify format for fullyQualifiedName

[tritemio]

Summary

With this PR I propose to use the common convention for fullyQualifiedName to be a dot-separated path, aligning this field value with the Open Metadata specifications.

Context

The field fullyQualifiedName occurs in many entities in the Data Product specifications and it is currently a free-form string "description". This somewhat overlaps with fields name (that is the human-readable display name) and description (that should be a long-form description). The current purpose of the field is unclear IMHO.

Proposal

In SWE, a "fully qualified name" represents a string representation that includes a path like identifier package.module.class_name, as opposed to the simple name that would be class_name.

In the Open Metadata Specifications, the field fullyQualifiedName is specified following the above convention across many entities. Here a few examples:

• table: serviceName.databaseName.tableName
• database: ServiceName.DatabaseName
• pipeline: ServiceName.PipelineName

The Open Metadata specifications don't have the concept of Data Products, Output Ports and other entities related to the Data Mesh paradigm, but nonetheless the purpose of the field is similar.

I propose to align the field fullyQualifiedName in the Data Product specifications to follow the common convention followed by Open Metadata.

Here I report an example of the fields with the proposed convention:

• dataproduct fullyQualifiedName: domain_name.dataproduct_name
• outputport fullyQualifiedName: domain_name.dataproduct_name.outputport_name
• workload fullyQualifiedName: domain_name.dataproduct_name.workload_name
• storage_area fullyQualifiedName: domain_name.dataproduct_name.storage_area_name
• observability fullyQualifiedName: domain_name.dataproduct_name.observability_name