ASP.NET Core web uygulamasına entegrasyon, web portalınız içinde sorunsuz belge düzenleme imkanı sağlar. GroupDocs.Editor Cloud SDK for .NET sunucu üzerinde DOCX dosyalarını yüklemenize, düzenlemenize ve kaydetmenize olanak tanıyan güçlü bir API sunar. Bu kılavuz, gerekli kurulumu adım adım gösterir, kod örneklerini sunar ve dakikalar içinde çalıştırabileceğiniz tam bir örnek sağlar. Sonunda, bir ASP.NET Core uygulamasına belge düzenleme ekleyebileceksiniz.

Önkoşullar ve Kurulum

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • .NET 6.0 SDK veya daha yeni bir sürüm yüklü
  • Visual Studio 2022 veya VS Code gibi bir IDE
  • GroupDocs Cloud hesabı, Client Id ve Client Secret almak için
  • Windows, Linux veya macOS geliştirme makinesine erişim

ASP.NET Core web uygulamasına entegrasyon, tüm belge işleme uzaktan gerçekleştiği için GroupDocs Cloud uç noktalarına güvenilir bir ağ bağlantısı gerektirir. Dağıtım ortamınızı buna göre planlayın.

SDK’yı NuGet aracılığıyla kurun:

dotnet add package GroupDocs.editor-Cloud

Resmi sürüm sayfasından en son paketi indirin: GroupDocs.Editor Cloud SDK for .NET İndir.

Kimlik bilgilerinizle bir yapılandırma nesnesi oluşturun (tam örnekten alıntı):

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

Paket yüklendi ve kimlik bilgileri hazır olduğunda, uygulamaya geçebilirsiniz. Sonraki bölümler, kodun her parçasını ayrıntılı olarak açıklar, böylece kütüphanenin bir ASP.NET Core web uygulamasının genel mimarisine nasıl uyduğunu anlayabilirsiniz.

ASP.NET Core Web Uygulamasına Entegrasyon İçin Adım Adım Kılavuz

Bu bölüm, bir ASP.NET Core web uygulamasına entegrasyon sürecini ayrı, yönetilebilir adımlara ayırır. Her adım, referans uygulamadan doğrudan alınan kısa bir kod parçacığını içerir.

Adım 1: API Kimlik Bilgilerini Yapılandırın

İlk olarak, istemci ayrıntılarınızla Configuration nesnesini örnekleyin ve EditorApi istemcisini oluşturun.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

EditorApi sınıfı, API referansı içinde belgelenmiştir. Çoğu senaryo için istemciyi istek başına bir kez başlatmak yeterlidir; daha iyi performans için ASP.NET Core bağımlılık enjeksiyon konteynerine tek bir örnek (singleton) olarak da kaydedebilirsiniz.

Adım 2: Yükleme Seçeneklerini Tanımla

Kaynak dosyayı ve istenen çıktı konumunu LoadOptions kullanarak belirtin. Bu nesne, hizmete hangi belgeyi açacağını ve oluşturulan HTML’nin nerede saklanacağını söyler.

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

LoadOptions, FileInfo ve RenderOptions belgeyi düzenleme için nasıl işleneceğini kontrol etmenizi sağlar. Örneğin, RenderOptions‘ı görüntüleri dahil edecek, özgün stilleri koruyacak veya işlenen sayfa sayısını sınırlayacak şekilde ayarlayabilirsiniz.

Adım 3: LoadDocument’ı Çağır

API’yi belgeyi yüklemek ve dönüştürmek için çağırın. Bu örnekte çağrı eşzamanlıdır, ancak denetleyici eyleminiz async ise eşzamansız sürümü de kullanabilirsiniz.

var loadResult = editorApi.LoadDocument(loadOptions);

LoadDocument yöntemi, oluşturulan HTML ve diğer meta verilerine URL’ler içeren bir sonuç nesnesi döndürür. loadResult‘ı daha sonra almak için saklayabilir veya HTML’i doğrudan ön‑uca geçirebilirsiniz.

Adım 4: Yükleme Sonucunu İşle

Yükleme işleminden sonra, HTML’yi ön‑uca sunabilir veya daha sonra kullanmak üzere depolayabilirsiniz. Bu adım, ASP.NET Core web uygulamasına belge düzenleyicisini entegre etme iş akışını tamamlar ve belgeyi kullanıcı etkileşimi için hazırlar.

Gerçek bir senaryoda, genellikle HTML içeriğini bir denetleyici eyleminden döndürürsünüz:

return Content(loadResult.HtmlContent, "text/html");

Aynı belgeyi tekrar tekrar yeniden yüklemeyi önlemek için önbelleğe almayı da uygulamak isteyebilirsiniz, bu da bir ASP.NET Core web uygulamasına entegrasyon yaparken ölçekli olarak yanıt sürelerini iyileştirebilir.

ASP.NET Core Web Uygulamasına Belge Düzenleyiciyi Entegre Etme - Tam Kod Örneği

Aşağıdaki kod, yapılandırmadan bir DOCX dosyasını yüklemeye kadar olan tüm süreci gösterir.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

var loadResult = editorApi.LoadDocument(loadOptions);

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyon adresine bakın veya destek ekibi ile iletişime geçin.

ASP.NET Core Belge Düzenleme Entegrasyonu için cURL Kullanımı

Doğrudan bir REST yaklaşımını tercih ediyorsanız, aynı işlem cURL komutlarıyla gerçekleştirilebilir. Bu yöntem, hızlı prototipleme için veya editörü .NET dışındaki bir hizmete entegre etmeniz gerektiğinde faydalıdır.

1. Kimlik Doğrulama ve Erişim Token’ı Al

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Yanıt, sonraki çağrılarda kullanılan bir access_token içerir.

2. Kaynak Dosyayı Yükleyin

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/storage/upload?path=/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx"

3. Belgeyi Düzenleme İçin Yükle

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.docx" },
           "renderOptions": { "outputPath": "output.html" }
         }'

4. Render Edilen HTML’yi İndir

curl -X GET "https://api.groupdocs.cloud/v2.0/editor/storage/download?path=/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

Bu komutlar, ASP.NET Core uygulamasına belge düzenleme eklemeyi C# kodu yazmadan gösterir; hızlı testler veya diğer hizmetlerle entegrasyon için faydalıdır. Daha fazla ayrıntı için resmi API belgelerine bakın.

Hem .NET kütüphanesini hem de ham REST API’yi ustalaşarak, ASP.NET Core web uygulamasına entegrasyon sırasında esneklik kazanırsınız, böylece mimarinize en uygun yaklaşımı seçebilirsiniz.

SSS

Daha Fazla Okuma