Documentation –

Developer-Guide: Aspose.Cells Cloud AI – Kullanıcı Görevini Parçalama API’si (v4.0) | SMART Görev Planlama

Mon, 01 Jan 0001 00:00:00 +0000

DecomposeUserTask uç noktası, kullanıcı tarafından tanımlanan serbest metin görev açıklamasını, SMART kriterlerine uygun şekilde detaylı ve sıralı bir eylem planına dönüştüren bir REST uç noktasıdır. Saat bazlı süre tahminlerini otomatik olarak atar, çıktıyı Redmine ile uyumlu içe aktarma formatına dönüştürür ve proje aşamaları (milestone) düğümlerini oluşturur. Sadece ham görev listesi ve isteğe bağlı süre tahminlerini sağlarsanız, API doğrudan proje yönetim araçlarına aktarılabilir bir dosyayı (CSV, XLSX vb.) doğrudan döndürür; böylece görev分解’yi otomatikleştirir ve manuel çabayı azaltır.

Kullanıcı Görevini Parçalama API’si

Web API’si

PUT https://api.aspose.cloud/v4.0/cells/ai/task/decompose

Güvenlik ve Kimlik Doğrulama

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

İstek Parametreleri:

Parametre Adı	Tür	Konum	Gerekli / İsteğe Bağlı	Açıklama
TaskDescription	string	Gövde	Gerekli	Kullanıcının genel hedefinin düz metin olarak açıklaması. Hizmet açıklamayı ayrıştırır ve bireysel görevler oluşturur. Örnek: “3. çeyrek için pazarlama kampanyası başlatın, içerik oluşturma, e-posta gönderimi ve sosyal medya reklamlarını içerir.”

Yanıt

Başarılı yanıt (200 OK)
Content-Type: application/octet-stream (ikili dosya akışı)

Başlıklar:

Content-Disposition: attachment; filename="DecomposedTaskPlan.xlsx"
Content-Length: <bayt cinsinden boyut>

Aynı yapı XLSX/ODS formatları için de kullanılır; sütunlar ilk çalışma sayfasına yerleştirilir.

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ırnını aşıyor.
500	Internal Server Error	Beklenmeyen sunucu hatası.

Hata Yanıt Örneği (400 Bad Request)

{
  "code": "InvalidParameter",
  "message": "'TaskDescription' alanı gerekli olup boş bırakılamaz."
}

Örnek İstek Gövdesi (JSON)

{
  "TaskDescription": "Mevcut sistemde görev bölme özelliği için bir web API’si geliştirin."
}

Örnek Yanıt
API, oluşturulan dosyayı içeren ikili bir akış döndürür. Bir CSV yanıtının ilk birkaç satırını önizlemek için akışı çözümler ve başlık satırını görüntüleyebilirsiniz; örneğin:

ID,Subject,Trucker,Estimated Duration,Description
1	Görev bölme API’si için gereksinim toplama	Business Analyst	8	Yeni görev bölme uç noktası için işlevsel ve işlevsel olmayan gereksinimleri, kullanıcı hikayelerini ve kabul kriterlerini toplayın.
2	API spesifikasyonu (OpenAPI)	Business Analyst	6	POST /tasks/split için OpenAPI sözleşmesini tanımlayın; istek şemasını, yanıt formatlarını, hata kodlarını ve güvenlik gereksinimlerini içerir.
3	Bölme algoritması ve veri modeli tasarımı	Solution Architect	5	Bir üst görevi alt görevlere bölen temel algoritmayı tasarlayın ve hiyerarşiyi ve meta verileri depolamak için veri modelini (veritabanı tabloları / varlıkları) genişletin.
4	Mimari entegrasyon değerlendirmesi	Solution Architect	4	Mevcut hizmetler, olay akışları ve veritabanı geçişleri üzerindeki etkiyi analiz edin; entegrasyon planını oluşturun.
...

Kullanıcı Görevini Parçalama API’si nerede kullanılmalıdır?

Proje başlangıcı: Yüksek seviyeli proje tanımını, saat tahminleriyle birlikte Redmine ile uyumlu görev listesine dönüştürün; böylece hemen sprint planlaması yapılabilir.
Pazarlama otomasyonu: Kampanya hedeflerini yürütülebilir adımlara bölün, CSV olarak dışa aktarın ve ekipler arası koordinasyon için görev yönetim araçlarına aktarın.
Kaynak atama: Her alt görev için saat bazlı tahminler üretin; böylece proje başlamadan önce yöneticiler ekibin iş yükünü dengeleyebilir.
Aşama izleme: Otomatik olarak Gantt çizelgesi araçlarıyla senkronize edilebilecek aşamalar (milestone) düğümleri oluşturun; böylece her fazın net bir teslim edilebilir ürünü olur.

Kullanıcı Görevini Parçalama API’si neden kullanılmalıdır?

SMART uyumlu çıktı, oluşturulan her görevin Specific (Spesifik), Measurable (Ölçülebilir), Achievable (Ulaşılabilecek), Relevant (İlgili) ve Time-bound (Zaman sınırlı) kriterlerini karşılamasını sağlar.
Dahili saat bazlı süre tahmini, manuel hesaplama gereksinimini ortadan kaldırır ve tahmin doğruluğunu artırır.
Hemen içe aktarılabilir dosya formatları (CSV, XLSX vb.), Redmine, Jira, Azure DevOps ve diğer proje yönetim platformlarıyla entegrasyonu kolaylaştırır.
Tek istekli otomasyon, tek bir istekle görev分解 yaparak proje başlatmayı hızlandırır ve manuel çabayı en aza indirir.

Kullanıcı Görevini Parçalama API’si Nasıl SDK’larla Kullanılır?

Kullanıcı Görevini Parçalama API’si Spesifikasyonu

Kullanıcı Görevini Parçalama API’si Spesifikasyonu, REST etkileşimlerini doğrudan bir web tarayıcısından yürütmek için erişilebilir bir programlama arayüzü sağlar.

Excel API SDK’si

Aspose.Cells Cloud SDK’larını Kullanma

SDK kullanmak, düşük seviye detayları soyutlayarak Kullanıcı Görevini Parçalama API’si uç noktasını kısa kodla çağırmaya izin verdiğinden en hızlı gelişim yoludur.
Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna bakın.
Aşağıdaki kod örnekleri, çeşitli SDK’lar kullanarak Aspose.Cells web hizmetleriyle nasıl etkileşime girileceğini göstermektedir:

Developer-Guide: Aspose.Cells Cloud Web API – Elektronik Tabloyu Hedef dile Çevir

Mon, 01 Jan 0001 00:00:00 +0000

TranslateSpreadsheet uç noktası, Translate Spreadsheet API’sinin bir parçası olarak, bir defterdeki her metin öğesini okur, içeriği AI destekli bir çeviri hizmetine gönderir ve tüm metinsel verilerin belirtilen targetLanguage dilinde sunulduğu yeni bir elektronik tablo dosyası döndürür. İşlem, orijinal düzeni, hücre stillerini, formülleri ve çok sayfalı yapıyı aynen korur; bu da raporları, kontrol panellerini ve veri odaklı belgeleri küreselleştirme amacıyla ideal hale getirir. Desteklenen dosya formatları şunlardır: XLS, XLSX, XLSM, CSV ve ODS. Geçersiz dil kodları, kimlik doğrulama hataları veya çeviri hizmeti kesintileri durumunda hatalar döndürülür.

Translate Spreadsheet API

Web API

PUT https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet

İstek Parametreleri:

Parametre Adı	Tür	Konum	Gerekli / Opsiyonel	Açıklama
Spreadsheet	Dosya	Gerekli	FormData	Çevrilecek Excel defteri. Kabul edilen uzantılar: .xls, .xlsx, .xlsm, .csv, .ods. Maksimum dosya boyutu: 50 MB. Örnek: `budget.xlsx`.
targetLanguage	string	Gerekli	Sorgu	İstenen çıktı dili için ISO 639-1 dil kodu (örn., İspanyolca için “es”, Fransızca için “fr”, Almanca için “de”). Temel altyapıdaki AI hizmetinin desteklediği bir dil olmalıdır.
region	string	Opsiyonel	Sorgu	Tarih, sayı ve para birimi gibi yerel ayarla ilişkili formatlamayı etkileyen elektronik tablo bölgesi tanımlayıcısı. Yaygın değerler: “US”, “EU”, “CN”. Atlanırsa, defterin orijinal bölge ayarı kullanılır.
password	string	Opsiyonel	Sorgu	Korumalı bir defteri açmak için şifre. Dosya şifre korumalı değilse boş bırakın.

Yanıt

Başarılı yanıt (200 OK)
Başlıklar:
Content-Type: application/octet-stream // veya CSV çıktısı istenirse text/csv
Content-Disposition: attachment; filename=“translated.xlsx”
Content-Length:

Gövde:
<çevrilmiş elektronik tablo dosyasını içeren ikili akış>

Hatalı yanıtlar, code, message ve isteğe bağlı details alanlarını içeren standart Aspose.Cells Cloud hata modeline (application/json) uyar.

HTTP Durum Kodları

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

Translate Spreadsheet API nerede kullanılmalıdır?

Uluslararası Finansal Raporlama – Çeyreklik Excel raporlarını formülleri ve grafik düzenini koruyarak bölgesel ofisler için birden fazla dile çevirin.
Çok Dilli Pazarlama Kontrol Panelleri – Küresel ekipler için satış performansı kontrol panellerinin yerelleştirilmiş sürümlerini otomatik olarak oluşturun.
Eğitim İçerik Dağıtımı – Farklı ülkelerdeki öğrenciler için manuel kopyalama-yapıştırma yapmadan not defterlerini, ödev sayfalarını veya müfredata yönelik elektronik tabloları çevirin.
Düzenleyici Uyumluluk – Doğrulama kurallarını ve veri doğrulama listelerini koruyan, dil özgünlüğüne uygun uyumluluk elektronik tabloları oluşturun.

Translate Spreadsheet API’yi neden kullanmalısınız?

AI destekli doğruluk – Bağlamı anlayan, yüksek kaliteli dil dönüşümü için en gelişmiş nöral çeviri modellerini kullanır.
Düzen bozulması yok – Hücre formüllerini, koşullu formatlamayı, grafikleri ve sayfa sıralamasını kaynaktakiyle tamamen aynı şekilde korur.
Tek istekle çok sayfalı işleme – Sayfa başına döngü gerektirmeden tek bir istekte tüm çalışma sayfalarını çevirir.
Kolay bulut entegrasyonu – Aspose.Cells Cloud kimlik doğrulama ile uyumlu çalışır; CI/CD, sunucusuz işlevler veya kurumsal arka uçlarda otomatik akışlar oluşturmanıza olanak tanır.

SDK ile Translate Spreadsheet API Nasıl Kullanılır?

Translate Spreadsheet API Spesifikasyonu

Translate Spreadsheet API Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini gerçekleştirmek için herkese açık bir programlama arayüzü sağlar.

Excel API SDK

Aspose.Cells Cloud SDK Kullanın

SDK kullanmak, düşük seviye detayları ortadan kaldırarak, elektronik tabloyu başka bir elektronik tabloyla birleştirmek gibi işlemleri kısa kodla hızlıca geliştirmenin en hızlı yoludur.
Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna göz atın.
Aşağıdaki kod örnekleri, çeşitli SDK’larla Aspose.Cells web hizmetlerinin nasıl kullanılacağını göstermektedir:

Developer-Guide: Aspose.Cells Cloud Web API – Yapay Zekâ ile Metin Dosyası Çevirisi

Mon, 01 Jan 0001 00:00:00 +0000

TranslateTextFile uç noktası, Aspose.Cells Cloud yapay zekâ hizmetlerinden yararlanarak bir metin dosyasının içeriğini belirli bir hedef dile çevirir. İki işlem modunu destekler: (1) Dosya Yükleme Modu – metin dosyasını multipart/form-data ile gönderir ve çevrilmiş dosyayı alırsınız; (2) Doğrudan İçerik Modu – istek gövdesine ham metni gönderir ve çevrilmiş metni doğrudan alırsınız. Hizmet, orijinal satır sonlarını ve formatlamayı korur; dosya adına otomatik olarak “_translated” ekini ekler ve sonucu indirilebilir bir akış olarak döndürür. Belgelerin toplu çevirisi, çok dilli iş akışlarına entegrasyon veya kullanıcı tarafından oluşturulan içeriklerin anlık çevriliş işlemleri için idealdir.

Metin Dosyası Çevirisi API’si

Web API’si

PUT https://api.aspose.cloud/v4.0/cells/ai/translate/text-file

İstek Parametreleri:

Parametre Adı	Tür	Konum	Zorunlu / Opsiyonel	Açıklama
Spreadsheet	Dosya	Gerekli	FormData	Çevrilecek kaynak metin dosyası. Düz metin (.txt) veya desteklenen bir elektronik tablo formatında olmalıdır. Örnek: “file” adlı multipart/form-data alanı üzerinden `document.txt` dosyasını yükleyin.
targetLanguage	Dize	Gerekli	Sorgu	İstenilen çıktı dili için ISO-639-1 dil kodu (örneğin, İspanyolca için “es”, Fransızca için “fr”, Almanca için “de”). Kod büyük/küçük harfe duyarsızdır.
region	Dize	Opsiyonel	Sorgu	Tarih, sayı ve para birimi gibi yerel ayarla ilişkili formatlamayı etkileyen elektronik tablo bölge tanımlayıcısı. Yaygın değerler: “US”, “EU”, “CN”. Atlanırsa, çalışma kitabının orijinal bölge ayarı kullanılır.
password	Dize	Opsiyonel	Sorgu	Şifrelenmiş elektronik tablo dosyalarını açmak için gereken şifre. Düz metin dosyaları için gerekli değildir.

Yanıt

Başarılı yanıt (200 OK) Başlıklar: Content-Type: application/octet-stream // Çevrilmiş dosyanın ikili akışı Content-Disposition: attachment; filename="<orijinal_ad>_translated.txt" Content-Length:

Gövde: Orijinal satır sonlarını ve formatlamayı koruyan çevrilmiş metni içeren ikili akış.

HTTP Durum Kodları

Kod	Anlamı	Açıklama
200	OK (Tamam)	Filtre başarıyla uygulandı; yanıt işlem detaylarını içerir.
400	Bad Request (Hatalı İstek)	Eksik veya geçersiz parametreler (örneğin, desteklenmeyen dosya türü).
401	Unauthorized (Yetkisiz)	Geçersiz veya eksik JWT belirteci.
413	Payload Too Large (Yük Çok Büyük)	Yüklenen dosya boyut sınırını aşıyor.
500	Internal Server Error (İç Sunucu Hatası)	Beklenmeyen sunucu hatası.

Metin Dosyası Çevirisi API’si Nerede Kullanılmalıdır?

Çok Dilli Belge Portalı – Kullanıcı kılavuzlarını veya yardım dosyalarını metin belgesi olarak yükleyerek otomatik olarak çevirir, istendiğinde yerelleştirilmiş sürümleri sunar.
İçerik Yönetim Sistemleri (CMS) – Blog yazılarını veya makaleleri uluslararası kitlelere karşı yayınlamadan önce çevirmek için CMS iş akışına entegre edilir.
Kurumsal Veri Boru Hatları – Büyük miktarda CSV veya TXT raporu işleyen toplu işlerde kullanılır; orijinal formatlamayı koruyarak bölgesel ofislerin diline çevirir.
Müşteri Desteği Platformları – Farklı dillerde çalışan destek temsilcilerini desteklemek için gelen düz metin destek taleplerini veya sohbet kayıtlarını gerçek zamanlı olarak çevirir.

Metin Dosyası Çevirisi API’si Neden Kullanılmalıdır?

Yapay Zekâ Tabanlı Doğruluk – Doğal ve bağlama uyumlu çıktı için en gelişmiş sinirsel çeviri modellerinden yararlanır.
Çift Giriş Esnekliği – Hem dosya yükleme hem de ham metin yüklemesini kabul eder; çeşitli istemci uygulamalarıyla entegrasyonu basitleştirir.
Orijinal Düzeni Korur – Satır sonlarını, girintileri ve özel karakterleri korur; sonrası temizlik gereksinimini ortadan kaldırır.
Sorunsuz Dosya İşleme – Otomatik oluşturulan “_translated” ekli indirilebilir dosyayı döndürür; istemci tarafı kod karmaşıklığını azaltır.

SDK’larla Metin Dosyası Çevirisi API’sini Nasıl Kullanılır?

Metin Dosyası Çevirisi API Spesifikasyonu

Metin Dosyası Çevirisi API Spesifikasyonu, web tarayıcısından doğrudan REST etkileşimlerini gerçekleştirmek için erişilebilir bir programlama arayüzü sağlar.

Excel API SDK’sı

Aspose.Cells Cloud SDK’larını Kullanma

SDK kullanımı, düşük seviye detayları soyutlayarak, bir elektronik tabloyu başka bir elektronik tabloya birleştirmenin kısa kodla yapılmasını sağlayarak geliştirme yapmanın en hızlı yoludur. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna göz atın. Aşağıdaki kod örnekleri, farklı SDK’lar kullanılarak Aspose.Cells web servisleriyle nasıl etkileşime geçileceğini göstermektedir: