models Paket

Alternativa nyckelmetadata för en Dataverse-tabell.

Svar från en enskild åtgärd i en batchbegäran.

Svar returneras i sändningsordning. För åtgärder som läggs till i en ändringsuppsättning visas svar i ändringsuppsättningens position i den ordningen.

Example:

   for item in result.responses:
       if item.is_success:
           print(f"[OK] {item.status_code} entity_id={item.entity_id}")
       else:
           print(f"[ERR] {item.status_code}: {item.error_message}")

Resultatet av att köra en batchbegäran.

Innehåller en BatchItemResponse per HTTP-åtgärd som skickats. Åtgärder som expanderar till flera HTTP-begäranden (t.ex. add_columns med tre kolumner) bidrar med tre poster.

Example:

   result = client.batch.new().execute()
   print(f"Succeeded: {len(result.succeeded)}, Failed: {len(result.failed)}")
   for guid in result.entity_ids:
       print(f"[OK] entity_id: {guid}")

Definierar kaskadbeteende för relationsåtgärder.

Giltiga värden för varje parameter:

• "Cascade": Utför åtgärden på alla relaterade poster

• "NoCascade": Utför inte åtgärden på relaterade poster

• "RemoveLink": Ta bort relationslänken men behåll posterna

• "Begränsa": Förhindra åtgärden om relaterade poster finns

Kolumnmetadata från en Dataverse-tabelldefinition.

Fluent-proxy för att skapa OData-filteruttryck från ett kolumnnamn.

Returneras av col. Operatoröverlagringar och metoder skapar FilterExpression instanser som kan skickas till QueryBuilder.where().

Example:

   from PowerPlatform.Dataverse.models.filters import col

   expr = col("statecode") == 0               # equality
   expr = col("revenue") > 1_000_000          # comparison
   expr = col("name").like("Contoso%")        # startswith
   expr = col("name").is_null()               # null check
   expr = col("statecode").in_([0, 1])        # in

Strukturellt protokoll som gör att typinstanser av entiteter kan skickas till records.create() och records.update().

Implementera det här protokollet på alla entitetsklasser (dataklass, pydantisk modell, handvalsade) så att det kan skickas direkt till CRUD-åtgärder utan att ange tabellnamnet eller konvertera till diktering manuellt.

Obligatoriska klassvariabler:

• __entity_logical_name__ — Namn på logisk entitet i Dataverse (t.ex. "account")

• __entity_set_name__ — Namn på OData-entitetsuppsättning (t.ex. "accounts")

Obligatoriska instansmetoder:

• to_dict() — returnera postnyttolast som dict

• from_dict(data) — classmethod att rekonstruera från ett svar dict

Example:

   from dataclasses import dataclass
   from PowerPlatform.Dataverse import DataverseModel

   @dataclass
   class Account:
       __entity_logical_name__ = "account"
       __entity_set_name__ = "accounts"
       name: str = ""
       telephone1: str = ""

       def to_dict(self) -> dict:
           return {"name": self.name, "telephone1": self.telephone1}

       @classmethod
       def from_dict(cls, data: dict) -> "Account":
           return cls(
               name=data.get("name", ""),
               telephone1=data.get("telephone1", ""),
           )

   # isinstance() works today — Protocol is runtime_checkable:
   assert isinstance(Account(), DataverseModel)

   # Type your own helpers against the Protocol now:
   def save(entity: DataverseModel) -> None:
       data = entity.to_dict()
       client.records.create(entity.__entity_logical_name__, data)

Strukturerade alternativ för en $expand navigeringsegenskap.

Tillåter att kapslade $select, $filter, $orderbyoch $top alternativ för en enda navigeringsegenskap utökas enligt OData-syntaxen $expand .

Example:

   # Expand Account_Tasks with nested options
   opt = (ExpandOption("Account_Tasks")
          .select("subject", "createdon")
          .filter("contains(subject,'Task')")
          .order_by("createdon", descending=True)
          .top(5))

   query = (client.query.builder("account")
            .select("name")
            .expand(opt)
            .execute())

Inert FetchXML-frågeobjekt. Ingen HTTP-begäran görs förrän execute eller execute_pages anropas.

Hämtas via client.query.fetchxml(xml).

Basklass för skrivbara OData-filteruttryck.

Stöder Python operatoröverlagringar för logisk sammansättning:

• expr1 & expr2 Producerar (expr1 and expr2)

• expr1 | expr2 Producerar (expr1 or expr2)

• ~expr Producerar not (expr)

Representerar en etikett som kan ha flera lokaliserade versioner.

Representerar en lokaliserad etikett med en språkkod.

Metadata för ett uppslagsattribut.

Giltiga required_level värden:

• "Ingen": Attributet är valfritt

• "Rekommenderas": Attributet rekommenderas

• "ApplicationRequired": Attributet krävs

Metadata för en många-till-många-entitetsrelation.

Metadata för en entitetsrelation en-till-många.

Fluent-gränssnitt för att skapa och köra OData-frågor mot en synkroniseringsklient.

Tillhandahåller metodlänkning för att konstruera komplexa frågor med skrivbara filteruttryck. Kan användas fristående (via build()) eller bindas till en klient (via execute).

Skriven ordlista som returneras av QueryBuilder.build().

Tillhandahåller automatisk komplettering av IDE när byggresultat skickas till client.records.list() manuellt.

Iterbar omslutning runt en lista över Record objekt.

Returneras av execute (platt läge) och list.

Bakåtkompatibel: for r in result fortsätter att fungera utan ändringar.

Typad returmodell för relationsmetadata.

Returneras av create_one_to_many_relationship, create_many_to_many_relationship, get_relationshipoch create_lookup_field.

Example:

   result = client.tables.create_one_to_many_relationship(lookup, relationship)
   print(result.relationship_schema_name)
   print(result.lookup_schema_name)

Tabellmetadata med dictliknande bakåtkompatibilitet.

Stöder både ny attributåtkomst (info.schema_name) och äldre dikteringsnyckelåtkomst (info["table_schema_name"]) för bakåtkompatibilitet med kod som skrivits mot api:et för rå diktering.

Example:

   info = client.tables.create("new_Product", {"new_Price": "decimal"})
   print(info.schema_name)              # new attribute access
   print(info["table_schema_name"])     # legacy dict-key access

Representerar en enda upsert-åtgärd som riktar sig mot en post med dess alternativa nyckel.

Används med upsert till upsert en eller flera poster som identifieras av alternativa nycklar i stället för primära GUID.

Example:

   item = UpsertItem(
       alternate_key={"accountnumber": "ACC-001", "address1_postalcode": "98052"},
       record={"name": "Contoso Ltd", "telephone1": "555-0100"},
   )