Dosya¶

File bileşeni tek bir dosyayı seçer, yükler, dosyaya bağlantı verir ve destekleniyorsa düzenler. Bağlı değeri skaler bir dosya başvurusu olarak kalır. Koleksiyon için FileList kullanın; görsel onayı ve düzenleme için ImageUpload kullanın.

XML Alanları¶

XPath Seçilen dosya başvurusunu saklar. NameXPath Görüntülenen dosya adı için isteğe bağlı olarak ayrı bir alan tanımlar.
Accept virgülle ayrılmış bir picker/client uzantı veya MIME türü filtresidir; örneğin .pdf,image/*. Sunucu dosya politikasının veya yetkilendirmenin yerini almaz.
AllowEdit Desteklenen dosya düzenleme entegrasyonunu etkinleştirir; SetEditingRevision kaynak revizyonları desteklediğinde düzenlemeleri revizyon olarak kaydeder. RequiredForGroup Bu doğrulama grubu işaretlendiğinde dosya zorunlu olur.
DataSources dosya şablonlarını sağlar. MonitoredXPaths bağımlı veriler değiştiğinde bunları yeniden yükler; CacheDataSources yüklenen şablon seçeneklerinin yeniden kullanımını denetler.
Hints Yardım metni sağlar ve Rules koşullu davranışı denetler. Dosya izinleri, form tanımından bağımsız olarak uygulanır.

Veri Modeli¶

File bileşeni, dosya kimliğini bağlı veri modeli öğesinde saklar. Görüntüleme amacıyla dosya adıyla otomatik olarak oluşturulan ve doldurulan bir Caption özniteliği vardır. Dosya adını belirli bir veri modeli öğesine eşlemek için, bağlı dosya öğesinin üst öğesine göre değerlendirilen NameXPath özelliğini kullanın.

Çalışma zamanı ayrıca Url, Revisionve HasFileRevision özniteliklerini de yazabilir. Mevcut bir uygulama dosyası değiştirilirken kurallı kimliği korunabilir ve yeni yüklemenin kimliği Revisionözniteliğine yazılabilir. Form verilerini dönüştürürken bu öznitelikleri koruyun.

Dosya Yükleme Kaynakları¶

File widget'ı, dosya yüklemek veya çeşitli sistemlerdeki mevcut dosyalara bağlantı vermek için birden çok veri kaynağını destekler. Bu veri kaynakları Sistem Yönetimi Paneli'nde.

Masaüstünden Yükleme¶

Kullanıcılar dosyaları yerel dosya sistemlerinden yükleyebilir. Yüklenen dosyalar, aşağıdaki bölümde yapılandırılan güvenlik kısıtlamalarına tabidir: Host Administration Panel; örneğin allowed/denied dosya türleri. Yapılandırılmışsa virüsten koruma taraması yapılır.

Kameradan Yükleme¶

Destek ve izin olduğunda dosyalar doğrudan cihazın kamerasıyla yakalanabilir. browser/device ImageUpload kendi onay ve görsel işleme ayarlarını ekler; bkz. ImageUpload.

Bulut Depolama Entegrasyonu (Google Drive, Office 365)¶

Yapılandırılmışsa kullanıcılar Google Drive veya Office 365 OneDrive'daki dosyalara bağlantı verebilir. Yalnızca dosya bağlantısı saklanır; dosyanın gerçek içeriği Emakin içinde çoğaltılmaz.

Panodan Yapıştırma ve Bırakma¶

Dosya alanı ve Desktop yükleme alanı, tarayıcının sunduğu dosya bırakma ve dosya yapıştırma olaylarını kabul eder. Panodan Yapıştır komutu, tarayıcının desteklediği durumlarda panodaki görselleri okur. File tek değerli bir alan olmaya devam eder ve yerel çoklu dosya seçimini reddeder; toplu işlemler için FileList kullanın.

Son Kullanılanlar¶

Kaynak penceresinde aranabilir bir Son Kullanılanlar sekmesi bulunur. Bu sekmede geçerli alanadında mevcut kullanıcının yüklediği en fazla 20 dosya yer alır. Başvurular, son kayıtlı kullanımlarından 30 gün sonra sona erer. Yeniden kullanım bağımsız bir kopya oluşturur; geçmiş girdisinin kaldırılması kaynak dosyayı etkilemez. Bu kaynak dosya okuma izni gerektirir; yeniden kullanım için ayrıca dosya yazma izni gerekir. Yalnızca yerel çalışma kipinde kullanılamaz.

Normal bir kaynak penceresi ilk olarak Son Kullanılanlar'ı açar. Yerel dosyalar önceden seçilmiş veya bırakılmışsa, aktarım ilerlemesini ve hataları görünür tutmak için Desktop açılır. Kullanıcıya yönelik adımlar için bkz. Dosya ve Görsel Ekleme .

Dosya Şablonları¶

File bileşeni, önceden tanımlanmış içeriğe dayalı yeni dosyalar oluşturmak için dosya şablonlarını destekler. Bir şablon uygulama dosyası kimliğinden seçildiğinde yeni bir kopya oluşturulur ve formla ilişkilendirilir. Değeri HTTP URL'si olan bir şablon ise bağlantı olarak eklenir. Şablonlar veri kaynağı yapılandırmasıyla belirtilir; Value dosya kimliğini veya URL'yi sağlar; Text görüntülenecek adı sağlar.

Şablon Veri Kaynakları Örneği¶

<File XPath="MyFile" NameXPath="" RequiredForGroup="" CacheDataSources="True" AllowEdit="True" SetEditingRevision="False">
    <DataSources>
        <ListItemDataSource TextFormat="" ValueFormat="" Enabled="True">
            <Items>
                <Item>
                    <Text><![CDATA[word]]></Text>
                    <Value><![CDATA[8ede8093-fb87-4f6a-85c0-4fca354f5af4]]></Value>
                </Item>
                <Item>
                    <Text><![CDATA[excel]]></Text>
                    <Value><![CDATA[b1a82c67-670d-411e-bc60-5483786ff41f]]></Value>
                </Item>
            </Items>
        </ListItemDataSource>
    </DataSources>
    <MonitoredXPaths />
    <Hints><![CDATA[]]></Hints>
    <Rules />
</File>

Dosya Düzenleme¶

Yapılandırmaya bağlı olarak File bileşeni, dosyaları indirip düzenleyerek yeniden yükleme gereksinimini ortadan kaldıran, WOPI uyumlu bir düzenleyiciyle yerinde belge düzenlemeyi destekleyebilir. Düzenleyici entegrasyonu şu bölümden yönetilir: Host Administration Panel. Desteklenen dosya düzenleme entegrasyonunu devre dışı bırakmak için AllowEdit="False" olarak ayarlayın.