Add attribute docstrings to cascade constants and replace hardcoded strings

Use attribute docstrings (""" after assignment) for cascade behavior constants
so Pylance/Pyright surfaces descriptions in IDE hover tooltips. Replace all
hardcoded cascade string literals with named constants in client.py and the
relationships example.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: tpellissier

examples/advanced/relationships.py

@@ -28,6 +28,10 @@
     LocalizedLabel,
     CascadeConfiguration,
 )
+from PowerPlatform.Dataverse.common.constants import (
+    CASCADE_BEHAVIOR_NO_CASCADE,
+    CASCADE_BEHAVIOR_REMOVE_LINK,
+)
 
 
 # Simple logging helper
@@ -216,9 +220,9 @@ def main():
         referencing_entity=emp_table["table_logical_name"],
         referenced_attribute=f"{dept_table['table_logical_name']}id",
         cascade_configuration=CascadeConfiguration(
-            delete="RemoveLink",  # When department is deleted, remove the link but keep employees
-            assign="NoCascade",
-            merge="NoCascade",
+            delete=CASCADE_BEHAVIOR_REMOVE_LINK,
+            assign=CASCADE_BEHAVIOR_NO_CASCADE,
+            merge=CASCADE_BEHAVIOR_NO_CASCADE,
         ),
     )
 
@@ -255,7 +259,7 @@ def main():
             display_name="Manager",
             description="The employee's direct manager",
             required=False,
-            cascade_delete="RemoveLink",
+            cascade_delete=CASCADE_BEHAVIOR_REMOVE_LINK,
         )
     )
 

src/PowerPlatform/Dataverse/client.py

@@ -19,6 +19,7 @@
     LocalizedLabel,
     CascadeConfiguration,
 )
+from .common.constants import CASCADE_BEHAVIOR_REMOVE_LINK
 
 
 class DataverseClient:
@@ -760,7 +761,7 @@ def create_one_to_many_relationship(
                     referencing_entity="new_employee",    # Child table (the "many" side)
                     referenced_attribute="new_departmentid",
                     cascade_configuration=CascadeConfiguration(
-                        delete="RemoveLink",  # When department deleted, unlink employees
+                        delete=CASCADE_BEHAVIOR_REMOVE_LINK,
                     ),
                 )
 
@@ -871,7 +872,7 @@ def create_lookup_field(
         display_name: Optional[str] = None,
         description: Optional[str] = None,
         required: bool = False,
-        cascade_delete: str = "RemoveLink",
+        cascade_delete: str = CASCADE_BEHAVIOR_REMOVE_LINK,
         solution: Optional[str] = None,
         language_code: int = 1033,
     ) -> Dict[str, Any]:
@@ -915,7 +916,7 @@ def create_lookup_field(
                     referenced_table="account",
                     display_name="Account",
                     required=True,
-                    cascade_delete="RemoveLink"
+                    cascade_delete=CASCADE_BEHAVIOR_REMOVE_LINK
                 )
 
                 print(f"Created lookup: {result['lookup_schema_name']}")

src/PowerPlatform/Dataverse/common/constants.py

@@ -16,7 +16,16 @@
 ODATA_TYPE_MANY_TO_MANY_RELATIONSHIP = "Microsoft.Dynamics.CRM.ManyToManyRelationshipMetadata"
 
 # Cascade behavior values for relationship operations
+# See: https://learn.microsoft.com/en-us/power-apps/developer/data-platform/configure-entity-relationship-cascading-behavior
+
 CASCADE_BEHAVIOR_CASCADE = "Cascade"
+"""Apply the action to all referencing table records associated with the referenced table record."""
+
 CASCADE_BEHAVIOR_NO_CASCADE = "NoCascade"
+"""Do not apply the action to any referencing table records associated with the referenced table record."""
+
 CASCADE_BEHAVIOR_REMOVE_LINK = "RemoveLink"
+"""Remove the value of the referencing column for all referencing table records associated with the referenced table record."""
+
 CASCADE_BEHAVIOR_RESTRICT = "Restrict"
+"""Prevent the action on the referenced table record if there are any referencing table records associated with it."""