İçerik Türleri ve Profiller¶

Bir profile formunu ve veri modelini belgeye eklemek için içerik türü kullanın. Profil, belgeyle ilgili yapılandırılmış iş bilgilerini kaydeder; belgenin dosyalarının, standart meta verilerinin veya erişim kurallarının yerini almaz.

Bu sayfada Örnek sözleşme başlığı Belge Yönetimi'nde tanıtılan örnek kullanılır. Aşağıdaki örnek adlar, kullanmadan önce test alanadınızda oluşturulmalıdır.

Profile Nelerin Ait Olduğuna Karar Verin¶

Sözleşme başlığını belgenin standart Title alanında, sözleşme metnini ise ekli bir dosyada tutun. Kullanıcıların yapılandırılmış alanlar olarak girebilmesi ve gözden geçirebilmesi için sözleşme numarasını ve yürürlük tarihini Contract profile ekleyin.

Şablon adı, yeniden kullanılabilir form tasarımını tanımlar. İçerik türü adı, belgede seçilen veya $Documents.New'e aktarılan ilişkilendirmedir. Veri kökü, profil XML yapısını tanımlar. Burada içerik türü ve veri kökü için aynı adı kullanmak bu örneğe özgü bir kuraldır; üç adın da aynı olması gerekmez.

Profil Formunu Tasarlayın¶

Ön koşullar: kaynak süreç tanımını düzenleme ve yayımlama erişimi, şu konuda bilgi sahibi olma: Form Şablonlarıve adın kullanılabilir olduğu bir test alanadı Contract . İçerik türleri alanadında yayımlanır; adları diğer süreç tasarımcılarıyla koordine edin.

1. Kaynak süreç tanımında şu adla bir form şablonu oluşturun: ContractProfile
2. Veri kökünü şu şekilde tanımlayın: Contract ve veri modeline Number dizesi olarak, ayrıca EffectiveDate tarih olarak ekleyin. Form şablonu veri modeli kurallarına uyun; yeniden kullanılabilir bir şablonda adlandırılmış şema türü kullanılabilir.
3. Şuna bağlı bir metin denetimi ekleyin: Number ve şuna bağlı bir tarih denetimi ekleyin: EffectiveDate. Bu yollar şablonun veri köküne göredir; bu nedenle şablon denetimlerinde Contract/ önekini yinelemeyin.
4. İşletmenin gerektirdiği etiketleri ve doğrulama kurallarını ekleyin. Form doğrulamasını hedeflenen belge ekranında kontrol edin; tarayıcı form kurallarının sunucu tarafındaki her içe aktarma işlemini doğruladığını varsaymayın.
5. Formu önizleyin ve her iki değerin de girilip görüntülenebildiğini kontrol edin.

Profil formu sözleşmeyle ilgili bilgileri toplar. Sözleşme dosyasını kendi başına yüklemez veya oluşturmaz.

İçerik Türünü Yayımlayın¶

1. Kaynak süreç tanımındaki Content Typesbölümünde Add New Content Type.
2. Şunu Name olarak ayarlayın. Contract ve Caption olarak ayarlayın. Contract.
3. Şunu ContractProfile Templateiçinde seçin. Seçili şablonun istenen veri köküne ve alanlara sahip olduğunu doğrulayın.
4. İçerik türünün alanadında sağlanması için kaynak süreç tanımını doğrulayıp yayımlayın.
5. Bu alanadında yeni bir belge açın ve Content Type seçeneğinin Contract seçeneğini sunduğunu ve seçildiğinde iki profil alanını görüntülediğini kontrol edin. Bu kontrol için belgeyi kaydetmek gerekmez.

Yayımlanan içerik türü, seçili form şablonunu gereken şemasıyla birlikte paketler. Tasarımı korumak için kaynak tanımını kullanın. Başka bir kaynak sürecin sahip olduğu çakışan ad, yayımlama sırasında reddedilir; mevcut kullanıcılarını kontrol etmeden yalnızca çakışmayı aşmak için türü yeniden adlandırmayın.

Profili Bir Belgeyle İlişkilendirin¶

Belge ekranında Contract öğesini Content Type bölümünde seçin ve sözleşme numarasıyla yürürlük tarihini Profilealtına girin. Belge formu seçili içerik türünü barındırır; kullanıcının ayrıca profil bileşeni eklemesi gerekmez. Bkz. Sözleşme Kaydetme.

Sunucu tarafında çalışan bir komut dizisinde, AddProfile çağrısından önce yayımlanmış içerik türünü taslağa ayarlayın:

1
2
3
4
5

var document = $Documents.New('Sample contract');
document.ContentType = 'Contract';
document.AddProfile(
    '<Contract><Number>EXAMPLE-001</Number><EffectiveDate>2026-01-01</EffectiveDate></Contract>'
);

ContentType ataması, sonraki AddProfile çağrısının kullanacağı profil formunu ve şemayı iliştirir. Türün geçerli alanadında önceden var olması gerekir. Belge Taslak durumundayken atayın; yayımlanmış bir sürümün içerik türü komut dizisi API'si aracılığıyla salt okunurdur.

AddProfile sağlanan verileri içerik türünün şemasına göre kopyalar. Bu örnekte XML ad alanı boştur; şablonunuz bir ad alanı kullanıyorsa verilerde aynı ad alanını kullanın ve verileri okurken veya yazarken XPath ad alanlarını yapılandırın. Alan adlarının büyük/küçük harflerini ve veri türlerini eşleştirin; gelişigüzel XML, içerik türü ilişkilendirmesinin yerini tutmaz.

Yukarıdaki kod parçacığı yalnızca bir taslak hazırlar. Dosyaları eklemek, gözden geçirilmiş güvenlik profilini ayarlamak ve belgeyi şu konuma yayımlamak için Belgeleri Oluşturma ve Yayımlama adımlarını izleyin → . Documentation → Contracts.

Profili Okuma ve Güncelleme¶

Örnek içerik türüyle ilişkilendirilmiş bir belgede Profile özelliği, bir XML sarmalayıcısındaki Contract verileri sunar. Örneğin ad alanı içermeyen şemasında yollar bu sarmalayıcıya göredir:

1
2
3

var number = document.Profile.Evaluate('Contract/Number');
document.Profile.SetValue('Contract/EffectiveDate', '2026-02-01');
document.Save();

Bu işlem, profil verilerini aynı sürümde günceller. Bir eki değiştirmez veya yeni bir revizyon oluşturmaz. Sözleşme dosyasında yapılan değişiklik önceki içeriği korumalıysa yeni bir belge sürümü oluşturun; bu taslak, mevcut profilin ve dosyaların kopyalarıyla başlar. Bkz. yaşam döngüsü ve dosya davranışı.

İçerik türü olmayan bir belgenin ilişkili profil formu yoktur. Profil erişiminin beklenen içerik türünün ve verilerin mevcut olmasına bağlı olduğunu göz önünde bulundurun; genel amaçlı komut dizileri, ilişkilendirmeyi kontrol etmeli ve şu tür alanları kullanmadan önce profil verilerinin eksik olmasını ele almalıdır: Contract/Number.

Profil Tasarımıyla Erişimi Ayrı Tutun¶

Contract iş alanlarını tanımlar. Yöneticinin Contract Access güvenlik profili belge erişimini tanımlar. İçerik türü seçmek, okuyuculara belgelerini açma izni vermez. Şunları gözden geçirin: koleksiyonun erişim ayarları ve komut dizisi yetkilendirmesi belge otomasyonunu kullanıcılara sunmadan önce.

Mevcut Profil Tasarımını Değiştirme¶

Form şablonunu ve şemayı kaynak tanımında koruyun, ardından güncellenmiş tanımı normal süreç sürümü iş akışıyla yayımlayın. İçerik türü, onu kullananlar arasında paylaşıldığından yeni belgelerin yanı sıra mevcut belgeleri de gözden geçirin.

Alan adlarını, ad alanlarını, türleri veya zorunlu alanları değiştirmeden önce bu yolları kullanan örnek mevcut profil verilerini ve komut dizilerini test edin. Bir formu yeniden yayımlamanın saklanan profil değerlerini taşıdığını, ekleri yeniden yazdığını veya yeni belge sürümleri oluşturduğunu varsaymayın. Gerekli veri geçişini ayrıca planlayın ve kurtarma için önceki kaynak tanımını koruyun.

Sorun Giderme¶

İlgili Sayfalar¶

• İçerik Türü Tanımı
• Form Şablonları
• Sözleşme Komut Dizisi Örnekleri