Aspose.Cells Cloud API kullanarak Excel çalışma sayfası ile adlandırılmış bir aralığı taşıma

Adlandırılmış bir aralığı taşımak, verileri programlı olarak yeniden düzenlemeniz gerektiğinde yaygın olarak karşılaşılan bir görevdir. Bu bölüm, bir tanımlanmış aralığı aynı çalışma sayfası üzerinde yeni bir konuma taşımayı Aspose.Cells Cloud REST API ile nasıl yapacağınızı açıklar.

Bu REST API, belirli bir aralığı bir Excel çalışma sayfasındaki hedef aralığa taşır.

REST API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/moveto

Kimlik Doğrulama

API, Aspose Cloud OAuth akışı aracılığıyla elde edilen bir Bearer JWT belirteci gerektirir. Belirteci Authorization başlığına ekleyin:

Authorization: Bearer <jwt token>

Belirtecin Cells kapsamına sahip olması gerekir.

Ön Gereksinimler

  • Çalışma kitabının Aspose Cloud deposunda depolanmış olması gerekir.
  • Dosya kök dizinde değilse depo adını (storageName) ve klasör yolunu (folder) sağlayın.
  • API sürümünü v3.0 destekleyen en son Aspose.Cells Cloud SDK sürümünü kullanın.

Güvenlik ve Kimlik Doğrulama

Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulamayı gerektirir.

İstek Parametreleri

Ad Tür Konum Açıklama
name string path Çalışma kitabının dosya adı
sheetName string path Çalışma sayfasının adı
destRow integer query Hedef aralığın başlangıç satır indeksi (0‑tabanlı)
destColumn integer query Hedef aralığın başlangıç sütun indeksi (0‑tabanlı)
range object body Taşınacak kaynak aralığın tanımı
folder string query Çalışma kitabının depolandığı klasör yolu
storageName string query Aspose Cloud deposunun adı

İstek Gövdesi

Alan Tür Gerekli Açıklama
ColumnCount integer Hayır Kaynak aralıktaki sütun sayısı
ColumnWidth integer Hayır Her sütunun genişliği (nokta cinsinden)
FirstColumn integer Hayır Kaynak aralığın ilk sütununun sıfır tabanlı indeksi
FirstRow integer Hayır Kaynak aralığın ilk satırının sıfır tabanlı indeksi
Name string Hayır Aralığın adı (adlandırılmış aralık ise)
RefersTo string Hayır Aralığı tanımlayan A‑1 stili başvuru
RowCount integer Hayır Kaynak aralıktaki satır sayısı
RowHeight integer Hayır Her satırın yüksekliği (nokta cinsinden)
Worksheet string Hayır Kaynak aralığı içeren çalışma sayfası

İş Akışı

  1. Çalışma kitabını Aspose Cloud deposuna yükleme (zaten mevcut değilse).
  2. OAuth uç noktası kullanarak bir JWT belirteci oluşturma.
  3. Kaynak aralığı tanımlayan JSON yükünü oluşturma.
  4. Gerekli yol, sorgu parametreleri ve JSON gövdesi ile moveto uç noktasını çağırma.
  5. Yanıtı doğrulama; başarılı çağrı 200 OK durum kodunu döndürür.

Örnek İstek / Yanıt

Hata oluşursa, yanıt başarısızlıkla ilgili ek ayrıntılar sağlayan isteğe bağlı bir ErrorMessage alanı içerir.

HTTP Durum Kodları

Kod Anlam Açıklama
200 OK Filtre başarıyla uygulandı; yanıt işlem ayrıntılarını içerir.
400 Bad Request Eksik veya geçersiz parametreler (örn., desteklenmeyen dosya türü).
401 Unauthorized Geçersiz veya eksik JWT belirteci.
413 Payload Too Large Yüklenen dosya boyut sınırını aşıyor.
500 Internal Server Error Beklenmeyen sunucu hatası.

Yanıt Şeması

Alan Tür Açıklama
Code integer API tarafından döndürülen HTTP benzeri durum kodu (örn., 200)
Status string Sonucun metinsel açıklaması (örn., “OK”)
ErrorMessage string (isteğe bağlı) Çağrı başarısız olduğunda insan okuyabilir hata ayrıntıları

Bulut SDK Ailesi

SDK kullanmak, geliştirme hızını en hızlı şekilde artırmak için en iyi yoldur. Bir SDK, düşük seviye ayrıntıları yöneterek proje görevlerinize odaklanmanızı sağlar. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub Deposu‘na bakın.

Aşağıdaki kod örnekleri, farklı SDK’lar kullanarak Aspose.Cells web hizmetlerine nasıl çağrı yapıldığını göstermektedir: