Ana içeriğe geç

Belgeleri Oluşturma ve Yayımlama

Bu küçük örnekleri test alanadında yetkili sunucu tarafı komut dizileri olarak çalıştırın. Hedef dizinleri ve belge güvenlik profilini bir yöneticiyle kararlaştırın. Her örnek yazma işlemleri yapar; yeniden çalıştırılması başka bir kayıt veya revizyon oluşturur. Yeniden denenebilir bir iş akışında kullanmadan önce hata ve yeniden deneme işlemlerine bakın.

Yeni Belge Yayımlama

Ön koşul: etkili kuralları hedef okuyuculara erişim izni veren, şu adlı alanadı güvenlik profili Contract Access olmalıdır. Şu Contract içerik türünü Number ve EffectiveDate alanlarıyla, şu belgede açıklandığı şekilde oluşturun: İçerik Türleri ve Profiller. Dizin şudur: Documentation → Contracts; tüm adlar örnek yapılandırmadır, yerleşik nesneler değildir.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
var document = $Documents.New('Sample contract');
document.Description = 'Contract EXAMPLE-001 and its supporting schedule';
document.ContentType = 'Contract';
document.AddProfile(
    '<Contract><Number>EXAMPLE-001</Number><EffectiveDate>2026-01-01</EffectiveDate></Contract>'
);
document.SetSecurityProfile('Contract Access');
document.Files.AddString('Sample contract text', 'contract.txt');
document.Files.AddString('Supporting schedule', 'schedule.txt');
document.Publish('Documentation\\Contracts');

var versionId = document.Id;
var branchId = document.BranchId;

Her iki kimliği de uygulamanızın kalıcı sonucuna kaydedin. Dizinde sürümün listelendiğini 1.0.0doğrulayın; her iki dosyanın da indirilebildiğini ve profilin EXAMPLE-001 ile 2026-01-01görüntülendiğini kontrol edin. İzin verilen bir okuyucunun belgeyi açabildiğini, reddedilen bir hesabın ise açamadığını doğrulayın. Save() belgeyi yayımlamadan bir taslağı kalıcı olarak kaydederdi.

Yeni Bir Sürüm Yayımlama

Ön koşullar: süreç alanında mevcut bir belge sürümü kimliği DocumentIdve bu belge ailesini değiştirmek için uygulama yetkilendirmesi. Yukarıda oluşturulan Örnek sözleşmeyi kullanın. Bu örnek, kopyalanan profil ve dosyaları özellikle korur, yeni revizyonun yürürlük tarihini günceller ve bir revizyon notu ekler.

1
2
3
4
5
6
7
8
9
var current = $Documents.Get($Xml.Evaluate('DocumentId'));
if (!current) {
    throw new Error('The source document was not found.');
}
var revision = $Documents.NewVersion(current.BranchId, current.Title);
revision.Profile.SetValue('Contract/EffectiveDate', '2026-02-01');
revision.Files.AddString('Revision notes', 'revision-notes.txt');
revision.Publish();
$Xml.SetValue('ResultVersionId', revision.Id);

Bu kod parçasını kullanmadan önce süreç modelinde ResultVersionId tanımlayın. Publish() mevcut aile dizin ilişkilerini korur ve yenilerini eklemez; ailenin dizin ilişkisi yoksa gözden geçirilmiş bir yolu açıkça belirtin. Yerine yenisi konacak kopyalanmış dosya, yenisini eklemeden önce yeni taslaktan revision.Files.Delete(copiedFileId) ile kaldırılmalıdır. Yeni revizyondaki bir kimliği kullanın; şu kayıttaki kimliği değil current.Files.

Yeni sürümün dizinde göründüğünü, Geçmiş'in yayımlanmış her iki revizyonu da açtığını ve özgün dosyalarla yürürlük tarihinin değişmediğini doğrulayın. Burada gösterilen sonuç alanı işlemin sonucunu kaydeder; tek başına atomik bir yeniden deneme koruması değildir.

Profille Belge Yayımlama

Ön koşullar: şu adlı yayımlanmış bir içerik türü Contract ve şu veri köküyle Contract, dize Numberve tarih alanları EffectiveDate ; ayrıca gözden geçirilmiş Contract Access güvenlik profili. Örneği çalıştırmadan önce içerik türünü bir form şablonundan yayımlayın.

Profilin seçili türün formunu ve şemasını kullanması için AddProfile çağrısından önce ContentType değerini ayarlayın. Aynı iş sözleşmesini iki kez oluşturmamak için bu örneği ayrı bir test verisi üzerinde çalıştırın.

1
2
3
4
5
6
7
8
9
var document = $Documents.New('Sample contract');
document.ContentType = 'Contract';
document.AddProfile(
    '<Contract><Number>EXAMPLE-001</Number><EffectiveDate>2026-01-01</EffectiveDate></Contract>'
);
document.SetSecurityProfile('Contract Access');
document.Files.AddString('Sample contract text', 'contract.txt');
document.Files.AddString('Supporting schedule', 'schedule.txt');
document.Publish('Documentation\\Contracts');

İçerik Contract türü profil formunu iliştirir ve Number ile EffectiveDate; AddProfile öğelerini tanımlar; verilerini sağlar. XML'yi ad alanları da dahil olmak üzere gerçek içerik türünün şemasına uyarlayın. Belgeyi yeniden açın ve profil formunun EXAMPLE-001 ile 2026-01-01görüntülendiğini doğrulayın. Ardından yayımlanmış sürümün profilini güncelleyin:

1
2
document.Profile.SetValue('Contract/EffectiveDate', '2026-02-01');
document.Save();

Profil değerinin değiştiğini; buna karşın Id, Version, durumun ve dosya içeriklerinin aynı kaldığını doğrulayın. Bu, profil düzenlemenin ve içerik revizyonunun neden farklı işlemler olduğunu gösterir.

Sonraki Adımlar