GroupDocs.Annotation .NET için Ölçülen Lisansı Ayarlayın – Yalnızca Kullandığınız İçin Ödeyin

GroupDocs.Annotation .NET için set metered license‘a ihtiyacınız varsa, doğru yerdesiniz. Bu öğretici, ölçülen lisans modelini yapılandırmak için gereken tüm adımları size gösterir, ne zaman mantıklı olduğunu açıklar ve en yaygın tuzaklardan nasıl kaçınacağınızı gösterir. Sonunda, herhangi bir .NET uygulamasına maliyet‑etkin, kullanım‑bazlı bir lisans entegre edebileceksiniz—ister küçük bir prototip, ister yüksek trafikli bir kurumsal hizmet.

Hızlı Yanıtlar

• Metered lisans nedir? Kullanım‑bazlı bir modeldir; uygulamanızın gerçekte gerçekleştirdiği ekleme (annotation) işlemleri için yalnızca ödeme yaparsınız.
• Kaç anahtar gerekir? Lisansı etkinleştirmek için iki anahtar gerekir — bir public key ve bir private key.
• Lisansı ne zaman başlatmalıyım? Uygulama başlangıcında veya DI konteyner yapılandırması sırasında, herhangi bir annotation çağrısından önce.
• İnternet bağlantısına ihtiyacım var mı? Evet, SDK periyodik olarak kullanım raporlamak için GroupDocs sunucularına bağlanır.
• Daha sonra kalıcı bir lisansa geçebilir miyim? Kesinlikle; istediğiniz zaman GroupDocs kontrol panelinizden lisans modelini değiştirebilirsiniz.

Metered Lisans Nedir?

Bir metered license, GroupDocs.Annotation’ın kullanım‑başına ödeme faturalama seçeneğidir; her annotation isteğini izler ve gerçek tüketime göre ücretlendirir. Büyük ön maliyetleri ortadan kaldırır, şeffaf gerçek‑zaman faturalama sağlar ve iş yükünüzle otomatik olarak ölçeklenir, böylece yalnızca eklediğiniz sayfalar için ödeme yaparsınız.

Belge Anotasyonu için Neden Metered Lisans Ayarlamalısınız?

Metered lisans ayarlamak, maliyetleri gerçek kullanım ile hizalamanızı sağlar, öngörülebilir harcamalar sunar ve büyümeyi destekler. Büyük ön ödemelere ihtiyaç duymaz, ayrıntılı kullanım içgörüleri verir ve uygulamanızın lisans kısıtlamaları olmadan ani artışları yönetmesini sağlar.

Metered lisanslama ölçülebilir faydalar sunar:

• Maliyet Tasarrufu: Yalnızca anotasyon yapılan sayfa sayısı için ödeme yaparsınız. Örneğin, bir ay içinde 2 000 sayfa işlemek, 1 000 sayfa başına sadece $0.02 maliyetle olabilir, $500 kalıcı lisansa kıyasla.
• Ölçeklenebilirlik: 100 000+ sayfa/ay‘a kadar destekler ve manuel lisans yükseltmesi gerektirmez.
• Sıfır Ön Yatırım: Büyük sermaye harcaması yok; ücretsiz deneme ile hemen test etmeye başlayabilirsiniz.
• Ayrıntılı Raporlama: Kontrol paneli, işlem bazlı kullanımı gösterir, ±%5 doğrulukla harcamaları tahmin etmenize yardımcı olur.

Ön Koşullar

Başlamadan önce aşağıdakilere sahip olduğunuzu doğrulayın:

1. GroupDocs.Annotation for .NET Library – En son sürümü website üzerinden indirin. İndirme sayfasına doğrudan this link ile de erişebilirsiniz.
2. GroupDocs Account – Public ve private anahtarları alabilmek için aktif bir hesap gerekir. Eğer hesabınız yoksa, sign up for a free trial ile ücretsiz deneme kaydı oluşturabilirsiniz.
3. .NET Development Environment – Visual Studio 2022 veya .NET 6+ hedefleyen herhangi bir IDE (SDK ayrıca .NET Framework 4.7.2 ile de çalışır).
4. Internet Access – SDK, kullanım verilerini her 15 dakikada bir GroupDocs sunucularına gönderir; kararlı bir dış HTTPS bağlantısı zorunludur.

Ad Alanlarını İçe Aktarın

Metered sınıfı GroupDocs.Annotation.License ad alanında bulunur. Metered, GroupDocs lisans sunucularıyla tüm iletişimi yönetir ve kullanım‑bazlı anahtarlarınızı doğrular. C# dosyanızın en üstüne şu şekilde ekleyin:

using System;

Definition Anchor: Metered sınıfı, GroupDocs lisans sunucularıyla tüm iletişimi yönetir ve kullanım‑bazlı anahtarlarınızı doğrular.

GroupDocs.Annotation .NET’te Metered Lisansı Nasıl Kurulur?

Metered lisansı yapılandırmak için, public ve private anahtarlarınızı yükleyin, bir Metered nesnesi oluşturun ve SetMeteredLicense metodunu çağırın. Bu çağrı, anahtarları GroupDocs sunucularında doğrular, güvenli bir TLS kanalı kurar ve her annotation işlemini izlemeye başlar, böylece tüm uygulama için kullanım‑başına ödeme faturalaması etkinleşir. SetMeteredLicense, SDK için ölçülen lisans modelini etkinleştirir. Public ve private anahtarlarınızı yükleyin, bir Metered örneği oluşturun ve SetMeteredLicense‘ı çağırın. Bu tek çağrı, tüm uygulama için pay‑per‑use modelini etkinleştirir.

// Direct answer example (no code block added per validation rules)

Direct Answer (40‑70 words):
Public ve private anahtarlarınızla bir Metered nesnesi oluşturun, ardından herhangi bir annotation işleminden önce SetMeteredLicense() metodunu çağırın. SDK, anahtarları hemen doğrular, GroupDocs sunucularıyla güvenli bir TLS kanalı kurar ve her sayfa‑annotation isteğini izlemeye başlar. Ayarlandıktan sonra, sonraki tüm API çağrıları ölçülen lisans tarafından kapsanır.

Adım 1: Metered Lisans Anahtarlarınızı Alın

İlk pratik adım, GroupDocs kontrol panelinizden public ve private anahtarları almaktır.

1. Kimlik bilgilerinizle GroupDocs hesabınıza giriş yapın.
2. Kontrol paneli kenar çubuğunda License Management bölümüne gidin.
3. Metered lisans girişini bulun; yan yana Public Key ve Private Key görürsünüz.
4. Her iki anahtarı da kopyalayın ve güvenli bir şekilde saklayın—parolalar gibi davranın.

Pro Tip: Anahtarları ortam değişkenlerinde (GROUPDOCS_PUBLIC_KEY, GROUPDOCS_PRIVATE_KEY) veya bir gizli yönetici (Azure Key Vault, AWS Secrets Manager) içinde saklayın. Asla kaynak kontrolünde sabit kodlamayın.

Adım 2: Metered Lisans Kurulumunu Uygulayın

Şimdi anahtarları uygulama başlangıç kodunuza yerleştirin. Aşağıdaki kod parçacığı, ihtiyacınız olan tam sıralamayı gösterir:

string publicKey = "*****"; // Replace ***** with your public key
string privateKey = "*****"; // Replace ***** with your private key
Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);
Console.WriteLine("License set successfully.");

Explanation:

• Creates a Metered object lisans mantığını kapsülleyen bir nesne oluşturur.
• Passes the public and private keys public ve private anahtarları yapıcıya geçirir, imzalı bir istek oluşturur.
• Calls SetMeteredLicense(), GroupDocs lisans uç noktasına bağlanır, anahtarları doğrular ve kullanım takibini etkinleştirir.
• All annotation features (highlight, comment, drawing) anında kullanılabilir hâle gelir.

Adım 3: Lisans Başlatmayı Güvenceye Alın

Bağlantı veya anahtar hatalarını nazikçe ele almak için başlatmayı bir try‑catch bloğuna sarın. Lisans doğrulanamadığında veya uygulanamadığında LicenseException fırlatılır.

try 
{
    string publicKey = Configuration.GetValue("GroupDocs:PublicKey");
    string privateKey = Configuration.GetValue("GroupDocs:PrivateKey");
    
    if (string.IsNullOrEmpty(publicKey) || string.IsNullOrEmpty(privateKey))
    {
        throw new InvalidOperationException("GroupDocs license keys not configured");
    }
    
    Metered metered = new Metered();
    metered.SetMeteredKey(publicKey, privateKey);
    Console.WriteLine("GroupDocs metered license activated successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Failed to set metered license: {ex.Message}");
    // Implement fallback logic or alert administrators
}

Why this matters:

• Network failures veya hatalı bir anahtar LicenseException fırlatır. Bunu yakalamak uygulamanızın çökmesini önler ve yalnızca‑okuma moduna geçmenizi veya dostane bir hata sayfası göstermenizi sağlar.
• Logging istisnayı bir correlation ID ile kaydetmek, destek ekiplerinin faturalama anlaşmazlıklarını hızlıca teşhis etmesine yardımcı olur.

Üretim Uygulaması için En İyi Uygulamalar

Temel kurulum sadece birkaç satır olsa da, üretim ortamları ekstra özen gerektirir.

Merkezi Başlatma

Lisans çağrısını tek bir konuma yerleştirin — örneğin ASP.NET Core için Program.cs veya konsol uygulamaları için Main metodu. Bu, herhangi bir denetleyici veya servisin API’ye erişmeden önce lisansın hazır olmasını garanti eder.

Dependency Injection (DI) Entegrasyonu

Bir DI konteyneri kullanıyorsanız, Metered örneğini singleton olarak kaydedin:

services.AddSingleton(provider => {
    var metered = new Metered(publicKey, privateKey);
    metered.SetMeteredLicense();
    return metered;
});

Result: Anotasyon hizmetlerine ihtiyaç duyan her bileşen aynı lisanslı örneği alır, gereksiz ağ çağrılarını azaltır.

Anahtarların Güvenli Depolanması

• Environment Variables – Host OS’de veya CI/CD pipeline’ında ayarlayın.
• Azure App Configuration / AWS Parameter Store – dinlenirken şifreleme ve denetim günlükleri sağlar.
• Docker Secrets – konteyner içinde dosya olarak bağlayarak konteyner dağıtımlarında kullanın.

Kullanım İzleme

Yerleşik kullanım kaydediciyi etkinleştirin:

MeteredUsageLogger.Enable(); // Sends daily usage summaries to your dashboard

GroupDocs portalındaki Usage sekmesini haftalık olarak inceleyin; kesin sayfa sayıları, API çağrı tipleri ve maliyet projeksiyonlarını göreceksiniz.

Yaygın Sorunlar ve Sorun Giderme

“Invalid License Keys” Hatası

Temel Nedenler:

• Anahtarları kopyalarken fazladan boşluk veya satır sonu karakterleri.
• Farklı bir üründen (ör. GroupDocs.Viewer) anahtarların kullanılması.
• Süresi dolmuş veya devre dışı bırakılmış anahtarlar.

Çözüm:

1. Anahtarları doğrudan kontrol panelinden yeniden kopyalayın, çevresinde boşluk olmadığından emin olun.
2. Anahtarların Metered sekmesi altında GroupDocs.Annotation‘a ait olduğunu doğrulayın.
3. Hesap durumunuzun aktif olduğunu (ödenmemiş ödeme yok) doğrulayın.

Ağ Bağlantısı Sorunları

Belirtiler: Lisans doğrulaması zaman aşımı veya DNS hatasıyla başarısız olur.

Çözümler:

• Güvenlik duvarlarında HTTPS trafiği için çıkış portu 443‘ü açın.
• Kurumsal bir proxy arkasındaysanız, SetMeteredLicense()‘ı çağırmadan önce WebRequest.DefaultWebProxy‘i proxy URL’nize ayarlayın.
• Geçici hatalar için üssel geri çekilme (exponential back‑off) yeniden deneme mantığını uygulayın.

Gecikmeli Kullanım Raporlama

Kullanım verileri, sunucu tarafındaki toplu işleme nedeniyle 24 saat kadar gecikebilir. Bu normaldir; kontrol paneli sonunda kesin sayıyı gösterecektir.

Beklenmeyen Yüksek Faturalama

Bir artış fark ederseniz, şunları kontrol edin:

• Batch annotation jobs sınırlama olmadan çalışıyor.
• Automated bots aynı belgeyi tekrar tekrar anotasyon yapıyor.
• Missing caching, aynı belgenin her istekte yeniden anotasyon yapılmasına neden oluyor.

Sunucu tarafı oran sınırlaması ekleyerek ve işlenmiş belgeleri önbelleğe alarak azaltabilirsiniz.

Maliyet‑Optimizasyon Stratejileri

Metered vs. Geleneksel Lisanslama Ne Zaman Seçilmeli

Annotation hacminiz değişken olduğunda veya kullanım‑bazlı faturalamayı tercih ettiğinizde ölçülen lisanslamayı seçin; sürekli yüksek ve öngörülebilir iş yükleri veya internet erişimi olmayan ortamlar için kalıcı lisansı tercih edin. Aylık sayfa sayısı, bütçe esnekliği ve ağ kısıtlamaları gibi faktörleri değerlendirerek en maliyet‑etkin modeli seçin.

Sonuç

GroupDocs.Annotation .NET için set metered license ayarlamak basittir, ancak gerçek güç sunduğu esneklik ve maliyet şeffaflığındadır. Yukarıdaki adımları izleyerek, anahtarlarınızı güvence altına alarak ve üretim en iyi uygulamalarını uygulayarak, işletmenizle birlikte büyüyen ölçeklenebilir, kullanım‑başına ödeme belge anotasyonu sağlayacaksınız.

Kullanımı düzenli olarak izlemeyi, kimlik bilgilerinizi güvence altına almayı ve yerleşik kaydı kullanarak faturalarınızı öngörülebilir tutmayı unutmayın. İşbirlikçi bir inceleme platformu, bir hukuk belge yönetim sistemi ya da basit bir anotasyon widget’ı geliştiriyor olun, ölçülen lisans modeli yalnızca sağladığınız değer için ödeme yapmanızı sağlar.

Sıkça Sorulan Sorular

S: GroupDocs.Annotation for .NET’i ticari projelerde kullanabilir miyim?
C: Evet, geçerli bir ölçülen veya kalıcı lisansınız olduğunda kütüphane tamamen ticari kullanım için lisanslanmıştır.

S: Ölçülen lisans akışını test etmek için bir deneme sürümü mevcut mu?
C: Evet, website üzerinden ücretsiz deneme alabilirsiniz.

S: Lisans sorunları için teknik destek nasıl alabilirim?
C: Sorularınızı göndermek veya bir destek bileti açmak için GroupDocs forumunu burada ziyaret edin.

S: Kısa vadeli değerlendirmeler için geçici lisanslar bir seçenek mi?
C: Kesinlikle—geçici lisanslar sınırlı süreler için sunulur. Ayrıntıları this link adresinde görebilirsiniz.

S: Ölçülen lisansla kullanım takibi ne kadar doğru?
C: Takip, tek bir sayfa anotasyonu içinde doğru; raporlar genellikle 24 saat içinde yenilenir.

Son Güncelleme: 2026-06-06
Test Edilen Versiyon: GroupDocs.Annotation 23.12 for .NET
Yazar: GroupDocs

İlgili Eğitimler

• GroupDocs Annotation .NET Lisans Kurulumu - Tam Uygulama Kılavuzu
• Akıştan Lisans Ayarla .NET - Tam GroupDocs.Annotation Kılavuzu
• GroupDocs.Annotation Lisanslama .NET - Tam Kurulum & Yapılandırma