Remove AssociatedMenuConfiguration for minimal API surface

Remove the AssociatedMenuConfiguration class and related parameters from
relationship metadata types. This is a niche UI customization that most
users don't need, and can still be achieved via additional_properties.

Changes:
- Remove AssociatedMenuConfiguration class from metadata.py
- Remove associated_menu_configuration from OneToManyRelationshipMetadata
- Remove entity1/2_associated_menu_configuration from ManyToManyRelationshipMetadata
- Update example and tests accordingly

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: tpellissier

examples/advanced/relationships.py

@@ -27,7 +27,6 @@
     Label,
     LocalizedLabel,
     CascadeConfiguration,
-    AssociatedMenuConfiguration,
 )
 
 
@@ -221,12 +220,6 @@ def main():
             assign="NoCascade",
             merge="NoCascade",
         ),
-        associated_menu_configuration=AssociatedMenuConfiguration(
-            behavior="UseLabel",
-            group="Details",
-            label=Label(localized_labels=[LocalizedLabel(label="Employees", language_code=1033)]),
-            order=10000,
-        ),
     )
 
     # Create the relationship
@@ -285,16 +278,6 @@ def main():
         schema_name="new_employee_project",
         entity1_logical_name=emp_table["table_logical_name"],
         entity2_logical_name=proj_table["table_logical_name"],
-        entity1_associated_menu_configuration=AssociatedMenuConfiguration(
-            behavior="UseLabel",
-            group="Details",
-            label=Label(localized_labels=[LocalizedLabel(label="Projects", language_code=1033)]),
-        ),
-        entity2_associated_menu_configuration=AssociatedMenuConfiguration(
-            behavior="UseLabel",
-            group="Details",
-            label=Label(localized_labels=[LocalizedLabel(label="Team Members", language_code=1033)]),
-        ),
     )
 
     result3 = backoff(

src/PowerPlatform/Dataverse/models/metadata.py

@@ -185,58 +185,6 @@ def to_dict(self) -> Dict[str, Any]:
         return result
 
 
-@dataclass
-class AssociatedMenuConfiguration:
-    """
-    Configuration for how the relationship appears in the associated menu.
-
-    :param behavior: Display behavior in the menu.
-    :type behavior: str
-    :param group: The menu group where the item appears.
-    :type group: str
-    :param label: Display label for the menu item.
-    :type label: Optional[Label]
-    :param order: Display order within the group.
-    :type order: int
-    :param additional_properties: Optional dict of additional properties to include
-        in the Web API payload (e.g., "Icon", "ViewId", "AvailableOffline").
-        These are merged last and can override default values.
-    :type additional_properties: Optional[Dict[str, Any]]
-
-    Valid behavior values:
-        - "UseCollectionName": Use the collection name
-        - "UseLabel": Use the specified label
-        - "DoNotDisplay": Do not display in the menu
-    """
-
-    behavior: str = "UseLabel"
-    group: str = "Details"
-    label: Optional[Label] = None
-    order: int = 10000
-    additional_properties: Optional[Dict[str, Any]] = None
-
-    def to_dict(self) -> Dict[str, Any]:
-        """
-        Convert to Web API JSON format.
-
-        Example::
-
-            >>> menu = AssociatedMenuConfiguration(behavior="UseLabel", group="Details")
-            >>> menu.to_dict()
-            {'Behavior': 'UseLabel', 'Group': 'Details', 'Order': 10000}
-        """
-        result = {
-            "Behavior": self.behavior,
-            "Group": self.group,
-            "Order": self.order,
-        }
-        if self.label:
-            result["Label"] = self.label.to_dict()
-        if self.additional_properties:
-            result.update(self.additional_properties)
-        return result
-
-
 @dataclass
 class LookupAttributeMetadata:
     """
@@ -323,8 +271,6 @@ class OneToManyRelationshipMetadata:
     :type referenced_attribute: str
     :param cascade_configuration: Cascade behavior configuration.
     :type cascade_configuration: CascadeConfiguration
-    :param associated_menu_configuration: Optional menu display configuration.
-    :type associated_menu_configuration: Optional[AssociatedMenuConfiguration]
     :param referencing_attribute: Optional name for the referencing attribute (usually auto-generated).
     :type referencing_attribute: Optional[str]
     :param additional_properties: Optional dict of additional properties to include
@@ -339,7 +285,6 @@ class OneToManyRelationshipMetadata:
     referencing_entity: str
     referenced_attribute: str
     cascade_configuration: CascadeConfiguration = field(default_factory=CascadeConfiguration)
-    associated_menu_configuration: Optional[AssociatedMenuConfiguration] = None
     referencing_attribute: Optional[str] = None
     additional_properties: Optional[Dict[str, Any]] = None
 
@@ -373,8 +318,6 @@ def to_dict(self) -> Dict[str, Any]:
             "ReferencedAttribute": self.referenced_attribute,
             "CascadeConfiguration": self.cascade_configuration.to_dict(),
         }
-        if self.associated_menu_configuration:
-            result["AssociatedMenuConfiguration"] = self.associated_menu_configuration.to_dict()
         if self.referencing_attribute:
             result["ReferencingAttribute"] = self.referencing_attribute
         if self.additional_properties:
@@ -395,10 +338,6 @@ class ManyToManyRelationshipMetadata:
     :type entity2_logical_name: str
     :param intersect_entity_name: Name for the intersect table (defaults to schema_name if not provided).
     :type intersect_entity_name: Optional[str]
-    :param entity1_associated_menu_configuration: Menu configuration for entity1.
-    :type entity1_associated_menu_configuration: Optional[AssociatedMenuConfiguration]
-    :param entity2_associated_menu_configuration: Menu configuration for entity2.
-    :type entity2_associated_menu_configuration: Optional[AssociatedMenuConfiguration]
     :param additional_properties: Optional dict of additional properties to include
         in the Web API payload. Useful for setting inherited properties like
         "IsValidForAdvancedFind", "IsCustomizable", "SecurityTypes", or direct
@@ -411,8 +350,6 @@ class ManyToManyRelationshipMetadata:
     entity1_logical_name: str
     entity2_logical_name: str
     intersect_entity_name: Optional[str] = None
-    entity1_associated_menu_configuration: Optional[AssociatedMenuConfiguration] = None
-    entity2_associated_menu_configuration: Optional[AssociatedMenuConfiguration] = None
     additional_properties: Optional[Dict[str, Any]] = None
 
     def to_dict(self) -> Dict[str, Any]:
@@ -444,10 +381,6 @@ def to_dict(self) -> Dict[str, Any]:
             "Entity2LogicalName": self.entity2_logical_name,
             "IntersectEntityName": intersect_name,
         }
-        if self.entity1_associated_menu_configuration:
-            result["Entity1AssociatedMenuConfiguration"] = self.entity1_associated_menu_configuration.to_dict()
-        if self.entity2_associated_menu_configuration:
-            result["Entity2AssociatedMenuConfiguration"] = self.entity2_associated_menu_configuration.to_dict()
         if self.additional_properties:
             result.update(self.additional_properties)
         return result
@@ -457,7 +390,6 @@ def to_dict(self) -> Dict[str, Any]:
     "LocalizedLabel",
     "Label",
     "CascadeConfiguration",
-    "AssociatedMenuConfiguration",
     "LookupAttributeMetadata",
     "OneToManyRelationshipMetadata",
     "ManyToManyRelationshipMetadata",

tests/unit/models/test_metadata.py

@@ -7,7 +7,6 @@
     LocalizedLabel,
     Label,
     CascadeConfiguration,
-    AssociatedMenuConfiguration,
     LookupAttributeMetadata,
     OneToManyRelationshipMetadata,
     ManyToManyRelationshipMetadata,
@@ -130,44 +129,6 @@ def test_to_dict_with_additional_properties(self):
         assert result["RollupView"] == "NoCascade"
 
 
-class TestAssociatedMenuConfiguration:
-    """Tests for AssociatedMenuConfiguration."""
-
-    def test_to_dict_defaults(self):
-        """Test default values."""
-        menu = AssociatedMenuConfiguration()
-        result = menu.to_dict()
-
-        assert result["Behavior"] == "UseLabel"
-        assert result["Group"] == "Details"
-        assert result["Order"] == 10000
-        assert "Label" not in result
-
-    def test_to_dict_with_label(self):
-        """Test with a label."""
-        menu = AssociatedMenuConfiguration(
-            label=Label(localized_labels=[LocalizedLabel(label="Related Items", language_code=1033)])
-        )
-        result = menu.to_dict()
-
-        assert result["Label"]["LocalizedLabels"][0]["Label"] == "Related Items"
-
-    def test_to_dict_with_additional_properties(self):
-        """Test additional properties like Icon and ViewId."""
-        menu = AssociatedMenuConfiguration(
-            additional_properties={
-                "Icon": "custom_icon",
-                "ViewId": "00000000-0000-0000-0000-000000000000",
-                "AvailableOffline": True,
-            }
-        )
-        result = menu.to_dict()
-
-        assert result["Icon"] == "custom_icon"
-        assert result["ViewId"] == "00000000-0000-0000-0000-000000000000"
-        assert result["AvailableOffline"] is True
-
-
 class TestLookupAttributeMetadata:
     """Tests for LookupAttributeMetadata."""
 
@@ -263,23 +224,6 @@ def test_to_dict_with_custom_cascade(self):
         assert result["CascadeConfiguration"]["Delete"] == "Cascade"
         assert result["CascadeConfiguration"]["Assign"] == "Cascade"
 
-    def test_to_dict_with_menu_configuration(self):
-        """Test with associated menu configuration."""
-        rel = OneToManyRelationshipMetadata(
-            schema_name="new_account_orders",
-            referenced_entity="account",
-            referencing_entity="new_order",
-            referenced_attribute="accountid",
-            associated_menu_configuration=AssociatedMenuConfiguration(
-                behavior="UseLabel",
-                label=Label(localized_labels=[LocalizedLabel(label="Orders", language_code=1033)]),
-            ),
-        )
-        result = rel.to_dict()
-
-        assert "AssociatedMenuConfiguration" in result
-        assert result["AssociatedMenuConfiguration"]["Label"]["LocalizedLabels"][0]["Label"] == "Orders"
-
     def test_to_dict_with_referencing_attribute(self):
         """Test with explicit referencing attribute."""
         rel = OneToManyRelationshipMetadata(
@@ -344,26 +288,6 @@ def test_to_dict_with_explicit_intersect_name(self):
 
         assert result["IntersectEntityName"] == "new_account_contact_assoc"
 
-    def test_to_dict_with_menu_configurations(self):
-        """Test with associated menu configurations for both entities."""
-        rel = ManyToManyRelationshipMetadata(
-            schema_name="new_account_contact",
-            entity1_logical_name="account",
-            entity2_logical_name="contact",
-            entity1_associated_menu_configuration=AssociatedMenuConfiguration(
-                label=Label(localized_labels=[LocalizedLabel(label="Contacts", language_code=1033)])
-            ),
-            entity2_associated_menu_configuration=AssociatedMenuConfiguration(
-                label=Label(localized_labels=[LocalizedLabel(label="Accounts", language_code=1033)])
-            ),
-        )
-        result = rel.to_dict()
-
-        assert "Entity1AssociatedMenuConfiguration" in result
-        assert "Entity2AssociatedMenuConfiguration" in result
-        assert result["Entity1AssociatedMenuConfiguration"]["Label"]["LocalizedLabels"][0]["Label"] == "Contacts"
-        assert result["Entity2AssociatedMenuConfiguration"]["Label"]["LocalizedLabels"][0]["Label"] == "Accounts"
-
     def test_to_dict_with_additional_properties(self):
         """Test additional properties like navigation property names."""
         rel = ManyToManyRelationshipMetadata(