FileOperations Sınıf

Dosya işlemleri için ad alanı.

client.files aracılığıyla erişilir. Dataverse dosya sütunları için dosya karşıya yükleme işlemleri sağlar.

Example:


   client = DataverseClient(base_url, credential)

   client.files.upload(
       "account", account_id, "new_Document", "/path/to/file.pdf"
   )

Oluşturucu

FileOperations(client: DataverseClient)

Parametreler

Name	Description
client Gerekli	DataverseClient Üst DataverseClient örnek.

Yöntemler

upload

Dataverse dosya sütununa dosya yükleyin.

upload

Dataverse dosya sütununa dosya yükleyin.

upload(table: str, record_id: str, file_column: str, path: str, *, mode: str | None = None, mime_type: str | None = None, if_none_match: bool = True) -> None

Parametreler

Name	Description
table Gerekli	str Tablonun şema adı (ör. `"account"` veya `"new_MyTestTable"`).
record_id Gerekli	str Hedef kaydın GUID'i.
file_column Gerekli	str Dosya sütunu özniteliğinin şema adı (ör. `"new_Document"`). Sütun yoksa, otomatik olarak oluşturulur.
path Gerekli	str Dosyanın yerel dosya sistemi yolu. Depolanan dosya adı bu yolun temel adı olacaktır.
mode Gerekli	str Karşıya yükleme stratejisi: `"auto"` (varsayılan), `"small"`veya `"chunk"`. Otomatik mod, dosya boyutuna göre küçük veya öbekli karşıya yüklemeyi seçer.
mime_type Gerekli	str Dosyayla birlikte depolamak için açık MIME türü (ör. `"application/pdf"`). Sağlanmazsa, varsayılan olarak olur `"application/octet-stream"`.
if_none_match Gerekli	bool True (varsayılan) olduğunda, üst bilgiyi yalnızca sütun şu anda boşsa başarılı olacak şekilde gönderir `If-None-Match: null` . Kullanarak `If-Match: *`her zaman üzerine yazacak şekilde False değerini ayarlayın.

Yalnızca Anahtar Sözcük Parametreleri

Name	Description
mode	Default value: None
mime_type	Default value: None
if_none_match	Default value: True

Özel durumlar

Tür	Description
HttpError	Karşıya yükleme başarısız olursa veya dosya sütunu boş değilse `if_none_match=True`
FileNotFoundError	Belirtilen dosya yolu yoksa.

Örnekler

PDF dosyasını karşıya yükleme:


   client.files.upload(
       "account",
       account_id,
       "new_Contract",
       "/path/to/contract.pdf",
       mime_type="application/pdf",
   )

Otomatik mod seçimiyle karşıya yükleme:


   client.files.upload(
       "email",
       email_id,
       "new_Attachment",
       "/path/to/large_file.zip",
   )