Получение области диаграммы из рабочего листа — Aspose.Cells Cloud API

Этот REST API возвращает информацию об области диаграммы.

Необходимые условия: Для вызова этого эндпоинта необходим действующий JWT-токен доступа, целевая рабочая книга должна быть загружена в облачное хранилище Aspose, а формат файла должен поддерживаться Aspose.Cells.

Введение: Область диаграммы определяет внешний ограничивающий прямоугольник диаграммы Excel, включая заголовки, легенды и область построения. Получение её свойств позволяет программно настраивать макет и оформление.

API GetChartArea

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/chartArea

Безопасность и аутентификация

API Aspose.Cells Cloud защищены и требуют аутентификации на основе JWT-токена.

Параметры запроса

Имя параметра Тип Расположение Описание
name string path Имя файла рабочей книги.
sheetName string path Имя рабочего листа, содержащего диаграмму.
chartIndex integer path Индекс диаграммы (начинается с нуля).
folder string query Папка, в которой хранится рабочая книга.
storageName string query Имя сервиса хранилища.

Ответ

{
  "ChartArea": {
    "Area": {
      "BackgroundColor": { "A": "0", "R": "0", "G": "0", "B": "0" },
      "FillFormat": { "Type": "Automatic" },
      "ForegroundColor": { "A": "0", "R": "0", "G": "0", "B": "0" },
      "Formatting": "Automatic",
      "InvertIfNegative": false,
      "Transparency": 0.0
    },
    "AutoScaleFont": false,
    "BackgroundMode": "Automatic",
    "Border": {
      "BeginArrowLength": "Medium",
      "BeginArrowWidth": "Medium",
      "BeginType": "None",
      "CapType": "Flat",
      "Color": { "A": "0", "R": "0", "G": "0", "B": "0" },
      "CompoundType": "Single",
      "DashType": "Solid",
      "EndArrowLength": "Medium",
      "EndArrowWidth": "Medium",
      "EndType": "None",
      "IsAuto": false,
      "IsAutomaticColor": false,
      "IsVisible": false,
      "JoinType": "Round",
      "Style": "Solid",
      "Transparency": 0.0,
      "Weight": "HairLine",
      "WeightPt": 0.0
    },
    "Font": {
      "Color": { "A": "255", "R": "0", "G": "0", "B": "0" },
      "DoubleSize": 10.0,
      "IsBold": false,
      "IsItalic": false,
      "IsStrikeout": false,
      "IsSubscript": false,
      "IsSuperscript": false,
      "Name": "Arial",
      "Size": 10,
      "Underline": "None"
    },
    "IsAutomaticSize": false,
    "IsInnerMode": false,
    "Shadow": false,
    "Width": 0,
    "Height": 0,
    "X": 0,
    "Y": 0,
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet5/charts/0/chartArea",
      "Rel": "self"
    }
  },
  "Code": "200",
  "Status": "OK"
}

Коды HTTP-статусов

Код Значение Описание
200 OK (ОК) Фильтр применён успешно; ответ содержит данные о выполнении операции.
400 Bad Request (Неверный запрос) Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла).
401 Unauthorized (Неавторизовано) Недействительный или отсутствующий JWT-токен.
413 Payload Too Large (Слишком большой payload) Загруженный файл превышает лимит размера.
500 Internal Server Error (Внутренняя ошибка сервера) Непредвиденная ошибка сервера.

Как использовать API GetChartArea с SDK

Спецификация API GetChartArea

Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Пример ниже показывает, как выполнить вызов облачного API с помощью cURL.

Использование SDK Aspose.Cells Cloud

Использование SDK — это лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя вам сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.

Ниже приведены примеры кода, демонстрирующие вызов веб-сервисов Aspose.Cells с использованием различных SDK:

Общий HTTP-запрос (например, с использованием fetch):

fetch('https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet5/charts/0/chartArea', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Bearer <jwt token>'
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
Aspose.Cells Cloud API – Обновление оси значений диаграммы (POST /valueaxis) Получить формат заливки области диаграммы – Aspose.Cells Cloud API (v3.0)