Sparkline na imagem do Excel

Os gráficos são um dos grandes mecanismos para representar dados visualmente e, ao lidar com dados computacionais dentro de arquivos do Excel, gráficos e tabelas desempenham um papel fundamental na representação de dados. No entanto, às vezes nos deparamos com uma situação em que não podemos acomodar um gráfico/gráficos em uma planilha do Excel. Consequentemente, precisamos de uma maneira mais inteligente de representar a tendência dos dados, e é aqui que os sparklines entram em ação.

Vantagens de usar Sparklines no Excel

Sparklines no Excel permitem que você veja tendências e padrões dentro dos seus dados rapidamente usando o mínimo de espaço no seu painel. Na maioria das vezes, você provavelmente criará um grupo de sparklines — um para cada linha ou coluna de dados. Uma planilha pode conter qualquer número de grupos de sparklines. O Excel lembra de cada grupo, e você pode trabalhar com o grupo como uma única unidade.

Os grupos sparkline fornecem um mecanismo muito conveniente para lidar com um conjunto de sparklines em certos grupos. Por exemplo, você pode selecionar um sparkline em um grupo e então modificar a formatação de todos os sparklines no grupo. Para facilitar que nossos usuários lidem programaticamente com planilhas do Excel, o trabalho com grupos sparkline foi otimizado ainda mais na versão de lançamento mais recente do Aspose.Cells Cloud API.

Como obter a descrição do grupo Sparkline

A maneira mais rápida e fácil de lidar com documentos é usar Armazenamento em nuvem. Depois de carregar a planilha do Excel contendo o grupo sparkline, você pode obter facilmente detalhes pertinentes ao grupo.

Obtendo token de autenticação da web JSON

Nossas APIs de Cloud e Armazenamento em Cloud são protegidas e podem ser acessadas somente por usuários autorizados. Uma vez autorizado, você pode facilmente executar operações de leitura, upload, atualização ou exclusão em documentos disponíveis no armazenamento em nuvem ou disponíveis em um sistema local. Para obter o token JWT,

  • Primeiro, inscreva-se para uma conta no Painel da nuvem
  • Em seguida, faça login no Painel da nuvem e clique no menu Aplicativos à esquerda
  • Por padrão, você terá o First App na página. Clique para abrir os detalhes
  • Na página de detalhes do First App, você encontrará seu ID de cliente personalizado e seu segredo de cliente
  • Digite o seguinte comando no prompt de comando para recuperar seu token 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"

Para mais detalhes, visite Autenticação de token da Web JSON

comando 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>"

Tente usar a referência da API

  • Abra Página de referência da API para Aspose.Cells Cloud.
  • Autentique usando um ID de cliente e chaves cliente-servidor.
  • Acesse a API GetWorksheetSparklineGroups e clique no botão Experimentar.
  • Forneça o nome da pasta de trabalho do Excel em relação ao campo de nome (que é Sparkline.xlsx no nosso caso).
  • Insira o nome da planilha que contém o grupo Sparkline no campo sheetName (Sheet1 no nosso caso).
  • Clique no botão Execute. Os detalhes são buscados e exibidos na seção responses.

URL da solicitação

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

A resposta exibirá todos os detalhes relacionados à cor, predefinição, estilo, tipo, LowPointColor, MarkersColor, etc. Dê uma olhada nas imagens a seguir que mostram uma prévia de uma planilha do Excel contendo grupos de sparkline, bem como informações renderizadas em resposta.

Prévia das propriedades do Sparkline

Fig 1:- Visualização das propriedades associadas ao grupo Sparkline.

Intervalo de dados para grupo sparkline vertical

Fig 2:- Visualização do intervalo de dados para o grupo sparkline vertical.

Intervalo de dados do sparkline horizontal

Fig 3:- Visualização do intervalo de dados para o grupo Sparkline horizontal.

Tipo de grupo Sparkline

Fig 4:- Prévia do tipo de grupo sparkline.

Adicionar descrição do grupo Sparkline

O Aspose.Cells Cloud também fornece os recursos para adicionar a descrição do grupo Sparkline na planilha do Excel. O PostWorksheetSparklineGroup requer os parâmetros name, sheetName, sparklineGroupIndex, sparklineGroup para cumprir esse requisito.

Atualizar descrição do grupo Sparkline no Excel

Para atualizar um sparkline no Excel, tente usar a API PutWorksheetSparklineGroup. A API requer os seguintes parâmetros para atender ao requisito

  • nome :- Nome da pasta de trabalho armazenada no armazenamento em nuvem
  • sheetName :- Planilha onde você precisa adicionar o sparkline
  • tipo :- Tipo Sparkline (Linha, Coluna, Ganho/Perda)
  • dataRange :- O intervalo de dados que precisamos usar como fonte para o sparkline
  • isVertical :- O sparkline é vertical ou não
  • locationRange :- O local onde precisamos desenhar o sparkline

Comando 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>"

No cenário acima, o tipo de sparkline é especificado como Column (atualizado de Line para Column), dataRange é especificado como B3:F9, isVertical é especificado como False e locationRange é especificado como G3:G9.

URL da solicitação

https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups?type=Column&dataRange=B3%3AF9&isVertical=false&locationRange=G3%3AG9
Prévia da atualização do tipo Sparkline

Fig 5:- Prévia do tipo sparkline atualizada.

Etapas para excluir a descrição do grupo Sparkline

O Aspose.Cells Cloud também fornece um mecanismo rápido para excluir sparklines existentes no Excel. Para remover todos os grupos de sparklines, tente usar a API DeleteWorksheetSparklineGroups. Enquanto isso, se precisarmos remover o grupo de sparklines com base em uma ID de índice específica, precisamos usar DeleteWorksheetSparklineGroup.

comando 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 da solicitação

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

Após a execução bem-sucedida, o código de resposta 200 é exibido no corpo da resposta. A imagem a seguir mostra o grupo sparkline vertical removido da planilha do Excel. Enquanto o outro grupo sparkline horizontal permanece na planilha porque apenas o grupo de índice 1 é removido.

Grupo de sparkline vertical removido

Fig 6:- Visualização do grupo Sparkline vertical após a exclusão.

O artigo explicou as etapas para obter, criar, atualizar e excluir sparklines no Excel usando a API REST. Você também pode considerar a leitura de um blog relacionado a Manipulate Charts Pivot Tables and Sparklines using Cloud API. Caso tenha alguma dúvida relacionada, sinta-se à vontade para entrar em contato via Free support forum.

O código fonte da API também pode ser encontrado no Repositório de código gratuito do GitHub.

Artigos relacionados

Recomendamos fortemente que você visite os seguintes links para saber mais sobre: