TableOperations Sınıf

Var olan bir tabloya bir veya daha fazla sütun ekleyin.

Example:

   created = client.tables.add_columns(
       "new_MyTestTable",
       {"new_Notes": "string", "new_Active": "bool"},
   )
   print(created)  # ['new_Notes', 'new_Active']

add_columns(table: str, columns: Dict[str, Any]) -> List[str]

Parametreler

Döndürülenler

Özel durumlar

Belirtilen sütunlarla özel bir tablo oluşturun.

create(table: str, columns: Dict[str, Any], *, solution: str | None = None, primary_column: str | None = None, display_name: str | None = None) -> TableInfo

Parametreler

Yalnızca Anahtar Sözcük Parametreleri

Döndürülenler

Özel durumlar

Örnekler

Basit sütunlar içeren bir tablo oluşturun:

   from enum import IntEnum

   class ItemStatus(IntEnum):
       ACTIVE = 1
       INACTIVE = 2

   result = client.tables.create(
       "new_Product",
       {
           "new_Title": "string",
           "new_Price": "decimal",
           "new_Status": ItemStatus,
       },
       solution="MySolution",
       primary_column="new_ProductName",
       display_name="Product",
   )
   print(f"Created: {result['table_schema_name']}")

Tabloda alternatif bir anahtar oluşturun.

Alternatif anahtarlar, upsert işlemlerinin kayıtları birincil GUID yerine bir veya daha fazla sütuna göre tanımlamasına olanak sağlar. Anahtar oluşturulduktan sonra dizin oluşturma için kuyruğa alınır; dizini status hazır olduktan sonra'dan "Pending""Active" geçiş yapacaktır.

create_alternate_key(table: str, key_name: str, columns: List[str], *, display_name: str | None = None, language_code: int = 1033) -> AlternateKeyInfo

Parametreler

Yalnızca Anahtar Sözcük Parametreleri

Döndürülenler

Özel durumlar

Örnekler

upsert için tek sütunlu bir alternatif anahtar oluşturun:

   key = client.tables.create_alternate_key(
       "new_Product",
       "new_product_code_key",
       ["new_productcode"],
       display_name="Product Code",
   )
   print(f"Key ID: {key.metadata_id}")
   print(f"Columns: {key.key_attributes}")

Basit bir arama alanı ilişkisi oluşturun.

Bu, var olan bir tabloya arama alanı eklemenin yaygın durumu için sarmalayan create_one_to_many_relationship bir kolaylık yöntemidir.

create_lookup_field(referencing_table: str, lookup_field_name: str, referenced_table: str, *, display_name: str | None = None, description: str | None = None, required: bool = False, cascade_delete: str = 'RemoveLink', solution: str | None = None, language_code: int = 1033) -> RelationshipInfo

Parametreler

Yalnızca Anahtar Sözcük Parametreleri

Döndürülenler

Özel durumlar

Örnekler

Basit bir arama alanı oluşturun:

   result = client.tables.create_lookup_field(
       referencing_table="new_order",
       lookup_field_name="new_AccountId",
       referenced_table="account",
       display_name="Account",
       required=True,
       cascade_delete=CASCADE_BEHAVIOR_REMOVE_LINK,
   )
   print(f"Created lookup: {result.lookup_schema_name}")

Tablolar arasında çoka çok ilişkisi oluşturun.

Bu işlem, ilişkiyi yönetmek için çoka çok ilişki ve kesişim tablosu oluşturur.

create_many_to_many_relationship(relationship: ManyToManyRelationshipMetadata, *, solution: str | None = None) -> RelationshipInfo

Parametreler

Yalnızca Anahtar Sözcük Parametreleri

Döndürülenler

Özel durumlar

Örnekler

Çoka çok ilişkisi oluşturma: Çalışan <-> Proje:

   from PowerPlatform.Dataverse.models import (
       ManyToManyRelationshipMetadata,
   )

   relationship = ManyToManyRelationshipMetadata(
       schema_name="new_employee_project",
       entity1_logical_name="new_employee",
       entity2_logical_name="new_project",
   )

   result = client.tables.create_many_to_many_relationship(relationship)
   print(f"Created: {result.relationship_schema_name}")

Tablolar arasında bire çok ilişkisi oluşturun.

Bu işlem, başvuran tabloda hem ilişkiyi hem de arama özniteliğini oluşturur.

create_one_to_many_relationship(lookup: LookupAttributeMetadata, relationship: OneToManyRelationshipMetadata, *, solution: str | None = None) -> RelationshipInfo

Parametreler

Yalnızca Anahtar Sözcük Parametreleri

Döndürülenler

Özel durumlar

Örnekler

Bire çok ilişkisi oluşturma: Departman (1) -> Çalışan (N):

   from PowerPlatform.Dataverse.models import (
       LookupAttributeMetadata,
       OneToManyRelationshipMetadata,
       Label,
       LocalizedLabel,
       CascadeConfiguration,
   )
   from PowerPlatform.Dataverse.common.constants import (
       CASCADE_BEHAVIOR_REMOVE_LINK,
   )

   lookup = LookupAttributeMetadata(
       schema_name="new_DepartmentId",
       display_name=Label(
           localized_labels=[
               LocalizedLabel(label="Department", language_code=1033)
           ]
       ),
   )

   relationship = OneToManyRelationshipMetadata(
       schema_name="new_Department_Employee",
       referenced_entity="new_department",
       referencing_entity="new_employee",
       referenced_attribute="new_departmentid",
       cascade_configuration=CascadeConfiguration(
           delete=CASCADE_BEHAVIOR_REMOVE_LINK,
       ),
   )

   result = client.tables.create_one_to_many_relationship(lookup, relationship)
   print(f"Created lookup field: {result.lookup_schema_name}")

Şema adına göre özel bir tabloyu silin.

Example:

   client.tables.delete("new_MyTestTable")

delete(table: str) -> None

Parametreler

Özel durumlar

Alternatif anahtarı meta veri kimliğine göre silin.

Example:

   client.tables.delete_alternate_key(
       "new_Product",
       "12345678-1234-1234-1234-123456789abc",
   )

delete_alternate_key(table: str, key_id: str) -> None

Parametreler

Özel durumlar

İlişkiyi meta veri kimliğine göre silin.

Example:

   client.tables.delete_relationship(
       "12345678-1234-1234-1234-123456789abc"
   )

delete_relationship(relationship_id: str) -> None

Parametreler

Özel durumlar

Tablo varsa, tablo için temel meta verileri alın.

Example:

   info = client.tables.get("new_MyTestTable")
   if info:
       print(f"Logical name: {info['table_logical_name']}")
       print(f"Entity set: {info['entity_set_name']}")

get(table: str) -> TableInfo | None

Parametreler

Döndürülenler

Tabloda tanımlanan tüm alternatif anahtarları listeleyin.

get_alternate_keys(table: str) -> List[AlternateKeyInfo]

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Alternatif anahtarları listeleyin ve durumlarını yazdırın:

   keys = client.tables.get_alternate_keys("new_Product")
   for key in keys:
       print(f"{key.schema_name}: {key.status}")

şema adına göre ilişki meta verilerini alma.

Example:

   rel = client.tables.get_relationship("new_Department_Employee")
   if rel:
       print(f"Found: {rel.relationship_schema_name}")

get_relationship(schema_name: str) -> RelationshipInfo | None

Parametreler

Döndürülenler

Özel durumlar

Dataverse ortamındaki özel olmayan tüm tabloları listeleyin.

Varsayılan olarak, içindeki IsPrivate eq falseher tabloyu döndürür. Sonuçları daha da daraltmak için isteğe bağlı bir OData $filter ifadesi sağlayın. ifadesi kullanılarak IsPrivate eq falsevarsayılan and yan tümcesiyle birleştirilir.

Example:

   # List all non-private tables
   tables = client.tables.list()
   for table in tables:
       print(table["LogicalName"])

   # List only tables whose schema name starts with "new_"
   custom_tables = client.tables.list(
       filter="startswith(SchemaName, 'new_')"
   )

   # List tables with only specific properties
   tables = client.tables.list(
       select=["LogicalName", "SchemaName", "EntitySetName"]
   )

list(*, filter: str | None = None, select: List[str] | None = None) -> List[Dict[str, Any]]

Parametreler

Yalnızca Anahtar Sözcük Parametreleri

Döndürülenler

Bir tablonun tüm öznitelik (sütun) tanımlarını listeleyin.

Example:

   # List all columns on the account table
   columns = client.tables.list_columns("account")
   for col in columns:
       print(f"{col['LogicalName']} ({col.get('AttributeType')})")

   # List only specific properties
   columns = client.tables.list_columns(
       "account",
       select=["LogicalName", "SchemaName", "AttributeType"],
   )

   # Filter to only string attributes
   columns = client.tables.list_columns(
       "account",
       filter="AttributeType eq 'String'",
   )

list_columns(table: str, *, select: List[str] | None = None, filter: str | None = None) -> List[Dict[str, Any]]

Parametreler

Yalnızca Anahtar Sözcük Parametreleri

Döndürülenler

Özel durumlar

Ortamdaki tüm ilişki tanımlarını listeleyin.

Example:

   # List all relationships
   rels = client.tables.list_relationships()
   for rel in rels:
       print(f"{rel['SchemaName']} ({rel.get('@odata.type')})")

   # Filter by type
   one_to_many = client.tables.list_relationships(
       filter="RelationshipType eq Microsoft.Dynamics.CRM.RelationshipType'OneToManyRelationship'"
   )

   # Select specific properties
   rels = client.tables.list_relationships(
       select=["SchemaName", "ReferencedEntity", "ReferencingEntity"]
   )

list_relationships(*, filter: str | None = None, select: List[str] | None = None) -> List[Dict[str, Any]]

Parametreler

Yalnızca Anahtar Sözcük Parametreleri

Döndürülenler

Özel durumlar

Belirli bir tablo için tüm ilişkileri listeleyin.

, EntityDefinitions({id})/ManyToOneRelationshipsve EntityDefinitions({id})/ManyToManyRelationshipssorgulayarak EntityDefinitions({id})/OneToManyRelationshipsverilen tablo için bire çok, çoka bir ve çoka çok ilişkilerini birleştirir.

Example:

   # List all relationships for the account table
   rels = client.tables.list_table_relationships("account")
   for rel in rels:
       print(f"{rel['SchemaName']} -> {rel.get('@odata.type')}")

list_table_relationships(table: str, *, filter: str | None = None, select: List[str] | None = None) -> List[Dict[str, Any]]

Parametreler

Yalnızca Anahtar Sözcük Parametreleri

Döndürülenler

Özel durumlar

Tablodan bir veya daha fazla sütunu kaldırma.

Example:

   removed = client.tables.remove_columns(
       "new_MyTestTable",
       ["new_Notes", "new_Active"],
   )
   print(removed)  # ['new_Notes', 'new_Active']

remove_columns(table: str, columns: str | List[str]) -> List[str]

Parametreler

Döndürülenler

Özel durumlar