Sparkline در تصویر اکسل

نمودارها یکی از مکانیسم‌های عالی برای نمایش بصری داده‌ها هستند و هنگام برخورد با داده‌های محاسباتی در داخل فایل‌های اکسل، نمودارها و نمودارها نقش اساسی در نمایش داده‌ها دارند. با این حال، گاهی اوقات به موقعیتی برخورد می کنیم که نمی توانیم نمودار/نمودارها را در صفحه گسترده اکسل قرار دهیم. در نتیجه، ما به یک روش هوشمندتر برای نشان دادن روند داده نیاز داریم، و در اینجا زمانی است که خطوط جرقه وارد عمل می شوند.

مزایای استفاده از Sparklines در اکسل

Sparklines در Excel شما را قادر می سازد تا با استفاده از حداقل املاک و مستغلات در داشبورد خود، روندها و الگوهای موجود در داده های خود را در یک نگاه مشاهده کنید. اغلب اوقات، احتمالاً گروهی از خطوط جرقه ایجاد می‌کنید – یکی برای هر ردیف یا ستون داده. یک کاربرگ می تواند هر تعداد گروه sparkline را در خود جای دهد. Excel هر گروه را به خاطر می آورد، و شما می توانید با گروه به عنوان یک واحد کار کنید.

گروه های sparkline مکانیزم بسیار مناسبی را برای مقابله با مجموعه ای از خطوط جرقه در گروه های خاص ارائه می دهند. به عنوان مثال، می توانید یک خط جرقه را در یک گروه انتخاب کنید و سپس قالب بندی تمام خطوط جرقه در گروه را تغییر دهید. به منظور تسهیل برنامه‌ریزی کاربران در برخورد با کاربرگ‌های اکسل، کار با گروه‌های sparkline در آخرین نسخه انتشار Aspose.Cells Cloud API بهینه‌سازی شده است.

نحوه دریافت توضیحات گروه sparkline

سریع‌ترین و ساده‌ترین راه برای مقابله با اسناد، استفاده از [فضای ذخیره‌سازی ابری5 است. هنگامی که کاربرگ اکسل حاوی گروه sparkline را آپلود کردید، ممکن است به راحتی جزئیات مربوط به گروه را دریافت کنید.

دریافت کد احراز هویت وب JSON

Cloud API و Cloud Storage ما ایمن هستند و فقط توسط کاربران مجاز قابل دسترسی هستند. پس از کسب مجوز، می‌توانید به راحتی عملیات خواندن، آپلود، به‌روزرسانی یا حذف را در اسناد موجود در فضای ذخیره‌سازی ابری یا موجود در یک سیستم محلی انجام دهید. برای دریافت توکن JWT،

  • اولین ثبت نام برای یک حساب کاربری از طریق داشبورد ابری
  • سپس وارد داشبورد Cloud شوید و از سمت چپ روی منوی برنامه‌ها کلیک کنید
  • به طور پیش فرض، اولین برنامه را در صفحه خواهید داشت. برای باز کردن جزئیات کلیک کنید
  • در صفحه جزئیات برنامه اول، شناسه مشتری شخصی و راز مشتری خود را پیدا خواهید کرد
  • دستور زیر را در خط فرمان وارد کنید تا توکن JWT خود را بازیابی کنید.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=xxxx-xxx-xxx-xxx-xxxx&client_secret=xxxxxxx" \
-H "Accept: application/json"

برای جزئیات بیشتر، لطفاً به JSON Web Token Authentication مراجعه کنید.

دستور cURL

curl -X GET "https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

سعی کنید از API Reference استفاده کنید

  • API Reference page را برای Aspose.Cells Cloud باز کنید.
  • با استفاده از شناسه مشتری و کلیدهای Client-Server احراز هویت.
  • به GetWorksheetSparklineGroups API دسترسی پیدا کنید و روی دکمه Try it out کلیک کنید.
  • نام کتاب کار اکسل را در برابر فیلد نام (که در مورد ما Sparkline.xlsx است) ارائه دهید.
  • نام کاربرگ حاوی گروه Sparkline را در مقابل قسمت sheetName وارد کنید (در مورد ما Sheet1).
  • روی دکمه Execute کلیک کنید. جزئیات واکشی شده و در بخش پاسخ ها نمایش داده می شود.

درخواست URL

https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups

پاسخ تمام جزئیات مربوط به رنگ، از پیش تعیین شده، سبک، نوع، LowPointColor، MarkersColor و غیره را نمایش می دهد. لطفاً به تصاویر زیر نگاهی بیندازید که پیش نمایش یک کاربرگ اکسل حاوی گروه های sparkline و همچنین اطلاعات ارائه شده در پاسخ را نشان می دهد.

پیش نمایش ویژگی های Sparkline

شکل 1: - پیش نمایش ویژگی های مرتبط با گروه Sparkline.

محدوده داده برای گروه sparkline عمودی

شکل 2: - پیش نمایش محدوده داده برای گروه sparkline عمودی.

محدوده داده افقی sparkline

شکل 3: - پیش نمایش محدوده داده برای گروه افقی sparkline.

نوع گروه Sparkline

شکل 4: - پیش نمایش نوع گروه sparkline.

توضیحات گروه Sparkline را اضافه کنید

Aspose.Cells Cloud همچنین قابلیت هایی را برای اضافه کردن توضیحات گروه Sparkline در کاربرگ Excel فراهم می کند. PostWorksheetSparklineGroup برای انجام این نیاز به پارامترهای name، sheetName، sparklineGroupIndex، sparklineGroup نیاز دارد.

توضیحات گروه Sparkline را در اکسل به روز کنید

برای به‌روزرسانی یک sparkline در اکسل، لطفاً از PutWorksheetSparklineGroup API استفاده کنید. API برای برآوردن این نیاز به پارامترهای زیر نیاز دارد

  • نام: - نام کتاب کار ذخیره شده در فضای ذخیره سازی ابری
  • sheetName: - کاربرگ که در آن باید sparkline را اضافه کنید
  • نوع: - نوع Sparkline (خط، ستون، برد / باخت)
  • dataRange: - محدوده داده ای که باید به عنوان منبع برای sparkline استفاده کنیم
  • isVertical: - آیا خط جرقه عمودی است یا خیر
  • LocationRange: - مکانی که باید خط جرقه را ترسیم کنیم

دستور cURL

curl -X PUT "https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups?type=Column&dataRange=B3%3AF9&isVertical=false&locationRange=G3%3AG9" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

در سناریوی فوق، نوع sparkline به صورت Column (به روز رسانی از Line به Column)، dataRange به صورت B3:F9، isVertical به صورت False و LocationRange به عنوان G3:G9 مشخص شده است.

درخواست URL

https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups?type=Column&dataRange=B3%3AF9&isVertical=false&locationRange=G3%3AG9
پیش نمایش به روز رسانی نوع Sparkline

شکل 5: - پیش نمایش نوع sparkline به روز شد.

مراحل حذف توضیحات گروه sparkline

Aspose.Cells Cloud همچنین مکانیزمی سریع برای حذف خطوط جرقه موجود در اکسل فراهم می کند. برای حذف همه گروه‌های sparkline، لطفاً از DeleteWorksheetSparklineGroups API استفاده کنید. در حالی که، اگر نیاز به حذف گروه sparkline بر اساس شناسه شاخص خاص داشته باشیم، باید از DeleteWorksheetSparklineGroup استفاده کنیم.

دستور cURL

curl -X DELETE "https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups/1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

درخواست URL

https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups/1

پس از اجرای موفقیت آمیز، 200 کد پاسخ در بدنه پاسخ نمایش داده می شود. تصویر زیر گروه sparkline عمودی حذف شده از کاربرگ Excel را نشان می دهد. در حالی که دیگر گروه افقی sparkline در کاربرگ باقی می ماند زیرا فقط گروه فهرست 1 حذف می شود.

گروه sparkline عمودی حذف شد

شکل 6: - پیش نمایش گروه sparkline عمودی پس از حذف.

در این مقاله مراحل دریافت، ایجاد، به روز رسانی و حذف خطوط sparkline در اکسل با استفاده از REST API توضیح داده شده است. همچنین ممکن است مطالعه یک وبلاگ مرتبط با [Manipulate Charts Pivot Tables and Sparklines with Cloud API] را در نظر داشته باشید13. در صورت داشتن هرگونه سوال مرتبط، لطفاً از طریق [تالار گفتمان پشتیبانی رایگان14 تماس بگیرید.

کد منبع API را می توان در مخزن کد رایگان GitHub نیز یافت.

مقالات مرتبط

توصیه می کنیم برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید: