Изображение спарклайна в Excel

Диаграммы являются одним из замечательных механизмов визуального представления данных, и при работе с вычислительными данными внутри файлов Excel графики и диаграммы играют ключевую роль в представлении данных. Однако иногда мы сталкиваемся с ситуацией, когда мы не можем разместить диаграмму/графики в таблице Excel. Следовательно, нам требуется более умный способ представления тенденции данных, и вот тут-то в дело вступают искрографики.

Преимущества использования спарклайнов в Excel

Спарклайны в Excel позволяют вам быстро увидеть тенденции и закономерности в ваших данных, используя минимум места на панели мониторинга. Чаще всего вы, вероятно, создаете группу спарклайнов — по одному для каждой строки или столбца данных. Рабочий лист может содержать любое количество групп спарклайнов. Excel запоминает каждую группу, и вы можете работать с группой как с единым целым.

Группы спарклайнов предоставляют очень удобный механизм для работы с набором спарклайнов в определенных группах. Например, вы можете выбрать один спарклайн в группе, а затем изменить форматирование всех спарклайнов в группе. Чтобы облегчить нашим пользователям программную работу с листами Excel, работа с группами спарклайнов была дополнительно оптимизирована в последней версии Aspose.Cells Cloud API.

Как получить описание группы спарклайнов

Самый быстрый и простой способ работы с документами — использовать Облачное хранилище. После загрузки листа Excel, содержащего группу спарклайнов, вы можете легко получить сведения, относящиеся к группе.

Получение JSON-токена веб-аутентификации

Наши облачные API и Cloud Storage защищены и доступны только авторизованным пользователям. После авторизации вы можете легко выполнять операции чтения, загрузки, обновления или удаления документов, доступных через облачное хранилище или доступных в локальной системе. Чтобы получить токен JWT,

  • Первая регистрация учетной записи через Cloud dashboard
  • Затем войдите в панель управления облаком и щелкните меню «Приложения» слева.
  • По умолчанию у вас на странице будет First App. Нажмите, чтобы открыть подробности
  • На странице сведений о приложении First вы найдете свой персональный идентификатор клиента и секретный код клиента.
  • Введите следующую команду в командной строке, чтобы получить токен 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

команда 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 для Aspose.Cells Cloud.
  • Аутентификация с использованием идентификатора клиента и ключей клиент-сервер.
  • Откройте API GetWorksheetSparklineGroups и нажмите кнопку «Попробовать».
  • Введите имя книги Excel в поле имени (в нашем случае это Sparkline.xlsx).
  • Введите имя рабочего листа, содержащего группу Sparkline, напротив поля sheetName (в нашем случае Sheet1).
  • Нажмите кнопку «Выполнить». Подробности извлекаются и отображаются в разделе ответов.

Запросить URL-адрес

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

В ответе будут отображены все сведения, касающиеся цвета, предустановки, стиля, типа, LowPointColor, MarkersColor и т. д. Пожалуйста, взгляните на следующие изображения, на которых показан предварительный просмотр листа Excel, содержащего группы спарклайнов, а также информацию, отображаемую в ответе.

Предварительный просмотр свойств Sparkline

Рис. 1: Предварительный просмотр свойств, связанных с группой Sparkline.

Диапазон данных для вертикальной группы спарклайнов

Рис. 2: Предварительный просмотр диапазона данных для вертикальной группы спарклайнов.

Диапазон данных горизонтальной спарклайн-графика

Рис. 3: Предварительный просмотр диапазона данных для группы горизонтальных спарклайнов.

Тип группы спарклайнов

Рис. 4: Предварительный просмотр типа группы спарклайнов.

Добавить описание группы Sparkline

Aspose.Cells Cloud также предоставляет возможности добавлять описание группы Sparkline в рабочий лист Excel. Для выполнения этого требования PostWorksheetSparklineGroup требуются параметры name, sheetName, sparklineGroupIndex, sparklineGroup.

Обновить описание группы Sparkline в Excel

Чтобы обновить спарклайн в Excel, попробуйте использовать API PutWorksheetSparklineGroup. API требует следующие параметры для выполнения требования

  • имя:- Имя рабочей книги, хранящейся в облачном хранилище.
  • sheetName :- Рабочий лист, куда нужно добавить спарклайн
  • тип:- Тип спарклайна (линия, столбец, выигрыш/проигрыш)
  • dataRange :- Диапазон данных, который нам нужно использовать в качестве источника для спарклайна.
  • 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>"

В приведенном выше сценарии тип спарклайна указан как 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
Предварительный просмотр обновления типа спарклайна

Рис. 5:- Предварительный просмотр обновленного типа спарклайна.

Действия по удалению описания группы спарклайнов

Aspose.Cells Cloud также предоставляет быстрый механизм для удаления существующих спарклайнов в Excel. Чтобы удалить все группы спарклайнов, попробуйте использовать API DeleteWorksheetSparklineGroups. В то же время, если нам нужно удалить группу спарклайнов на основе определенного идентификатора индекса, нам нужно использовать 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. На следующем изображении показана удаленная вертикальная группа спарклайнов из листа Excel. В то время как другая горизонтальная группа спарклайнов остается на листе, поскольку удалена только группа индекса 1.

Вертикальная группа спарклайнов удалена

Рис. 6: Предварительный просмотр группы вертикальных спарклайнов после удаления.

В статье объясняются шаги по получению, созданию, обновлению и удалению спарклайнов в Excel с использованием REST API. Вы также можете прочитать связанный блог Manipulate Charts Pivot Tables and Sparklines using Cloud API. Если у вас есть какие-либо связанные вопросы, пожалуйста, свяжитесь с нами через Free support forum.

Исходный код API также можно найти в репозитории бесплатного кода GitHub.

Похожие статьи

Мы настоятельно рекомендуем посетить следующие ссылки, чтобы узнать больше о: