models Csomag

Alternatív kulcs metaadatai egy Dataverse-tábla esetében.

Egyetlen művelet válasza egy kötegkérelemen belül.

A válaszok beküldési sorrendben jelennek meg. A változáskészlethez hozzáadott műveletek esetében a válaszok a változáskészlet pozíciójában jelennek meg ebben a sorrendben.

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}")

Batch-kérés végrehajtásának eredménye.

Http-műveletenként egy BatchItemResponse elküldött műveletet tartalmaz. A több HTTP-kérésre (például add_columns három oszlopra) kiterjesztő műveletek három bejegyzést adnak hozzá.

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}")

Kaszkádolt viselkedést határoz meg a kapcsolati műveletekhez.

Az egyes paraméterek érvényes értékei:

• "Kaszkád": A művelet végrehajtása az összes kapcsolódó rekordon

• "NoCascade": Ne hajtsa végre a műveletet a kapcsolódó rekordokon

• "RemoveLink": Távolítsa el a kapcsolati hivatkozást, de tartsa meg a rekordokat

• "Korlátozás": A művelet megakadályozása kapcsolódó rekordok esetén

Oszlop metaadatai dataverse tábladefinícióból.

Fluent proxy OData-szűrőkifejezések oszlopnévből való létrehozásához.

Visszaadta: col. Az operátorok túlterhelései és metódusai olyan példányokat hoznak létre FilterExpression , amelyek átadhatók a rendszernek 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

Szerkezeti protokoll, amely lehetővé teszi a gépelt entitáspéldányok átadását és records.create()records.update()a .

Implementálja ezt a protokollt bármely entitásosztályon (dataclass, Pydantic model, kézzel hengerelt), hogy közvetlenül a CRUD-műveleteknek átadhassa a táblanév megadása vagy a diktálás manuális konvertálása nélkül.

Kötelező osztályváltozók:

• __entity_logical_name__ — Dataverse logikai entitás neve (pl. "account")

• __entity_set_name__ — OData entitáskészlet neve (pl. "accounts")

Szükséges példánymódszerek:

• to_dict() — a rekord hasznos adatait adja vissza a dict

• from_dict(data) — osztálymethod rekonstruálása válaszból 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)

Navigációs tulajdonság strukturált $expand beállításai.

Az OData $expand szintaxist követve lehetővé teszi a beágyazott$select, $filtera , $orderbyés $top a beállítások megadását egyetlen navigációs tulajdonságbővítéshez.

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 lekérdezési objektum. A http-kérések nem lesznek megadva, amíg meg nem hívják vagy execute_pages meg execute nem hívják.

A lekért adatok client.query.fetchxml(xml): .

Alaposztály írható OData-szűrőkifejezésekhez.

Támogatja Python operátorok túlterhelését a logikai összetételhez:

• expr1 & expr2 Termel (expr1 and expr2)

• expr1 | expr2 Termel (expr1 or expr2)

• ~expr Termel not (expr)

Olyan címkét jelöl, amely több honosított verzióval rendelkezhet.

Nyelvi kóddal ellátott honosított címkét jelöl.

Keresési attribútum metaadatai.

Érvényes required_level értékek:

• "Nincs": Az attribútum nem kötelező

• "Ajánlott": Az attribútum használata javasolt

• "ApplicationRequired": Az attribútum megadása kötelező

Több-a-többhöz entitáskapcsolat metaadatai.

Egy-a-többhöz entitáskapcsolat metaadatai.

Fluent felület OData-lekérdezések szinkronizálási ügyfélen történő létrehozásához és végrehajtásához.

Metódusláncolást biztosít összetett lekérdezések összeállításához összeállítható szűrőkifejezésekkel. Használható önállóan (keresztül build()) vagy ügyfélhez kötve (keresztül execute).

A függvény által QueryBuilder.build()visszaadott gépelt szótár.

Ide automatikus kiegészítést biztosít, amikor manuálisan adja át a builderedményeket client.records.list() .

Iterable burkoló az objektumok listája Record körül.

A visszaadott érték execute (sík mód) és list.

Visszamenőlegesen kompatibilis: for r in result változatlanul működik.

A kapcsolat metaadatainak beírt visszatérési modellje.

A visszaadott érték: create_one_to_many_relationship, create_many_to_many_relationship, get_relationshipés create_lookup_field.

Example:

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

Tábla metaadatai diktálásszerű visszamenőleges kompatibilitással.

Támogatja az új attribútumhozzáférést (info.schema_name) és az örökölt diktáláskulcs-hozzáférést (info["table_schema_name"]) a nyers dict API-n írt kóddal való visszamenőleges kompatibilitás érdekében.

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

Egyetlen upsert műveletet jelöl, amely egy rekordot a másodlagos kulccsal céloz meg.

Egy vagy több, másodlagos kulcsok által azonosított rekord frissítésére upsert szolgál az elsődleges GRAFIKUS AZONOSÍTÓk helyett.

Example:

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