Leia, adicione e edite comentários encadeados no Excel usando Python

MS Excel é uma ferramenta poderosa e fácil de usar, sempre considerada a melhor escolha para análise de dados. No Excel, podemos alcançar novos patamares de colaboração usando comentários encadeados. Neste artigo, aprenderemos como ler, adicionar, editar e excluir comentários encadeados programaticamente no Excel usando Python.

Este artigo cobre os seguintes tópicos:

API Python para processar comentários encadeados no Excel

Aspose.Cells é uma biblioteca amplamente utilizada que permite manipular arquivos do Microsoft Excel em diversas linguagens de programação, incluindo Python, com APIs. Usaremos Aspose.Cells for Python via .NET para adicionar, ler, editar ou excluir comentários encadeados em planilhas do Excel. Ele permite que os desenvolvedores gerem, transformem ou modifiquem os formatos de arquivo suportados pelo Excel em seus aplicativos Python.

pip install aspose-cells-python

Adicione comentários encadeados no Excel usando Python

Podemos adicionar facilmente um comentário encadeado a uma planilha do Excel seguindo as etapas abaixo:

  1. Crie uma instância da classe Workbook.
  2. Adicione um autor à coleção threadedcommentauthors usando o método add(name, userid, providerid).
  3. Obtenha o objeto de classe ThreadedCommentAuthor para o autor recém-criado por seu índice.
  4. Adicione o comentário encadeado usando o método addthreadedcomment(). Ele usa o nome da célula, o texto do comentário e o objeto ThreadedCommentAuthor como argumentos.
  5. Salve o arquivo Excel usando o método Workbook.save(string).

O exemplo de código a seguir mostra como adicionar um comentário encadeado a uma planilha do Excel usando Python.

# Este exemplo de código demonstra como adicionar comentários encadeados em uma planilha do Excel
# Crie uma instância da classe Workbook
workbook = Workbook();

# Adicionar um autor
authorIndex = workbook.worksheets.threaded_comment_authors.add("Aspose Test", "", "");
author = workbook.worksheets.threaded_comment_authors[authorIndex];

# Adicionar comentário encadeado
workbook.worksheets[0].comments.add_threaded_comment("A1", "Test Threaded Comment", author);

# Salve o arquivo de saída
workbook.save("D:\\Files\\AddThreadedComments_out.xlsx");

Leia comentários encadeados para a célula específica em Python

Podemos ler comentários encadeados para a célula especificada em uma planilha do Excel seguindo as etapas abaixo:

  1. Carregue um arquivo Excel existente usando a classe Workbook.
  2. Acesse a planilha pelo seu índice.
  3. Obtenha comentários encadeados para uma célula específica usando o método getthreadedcomments(). Leva o nome da célula como argumento.
  4. Percorra todos os comentários encadeados e leia os detalhes.

O exemplo de código a seguir mostra como ler comentários encadeados para a coluna especificada em uma planilha do Excel usando Python.

# Este exemplo de código demonstra como ler comentários encadeados para uma célula especificada em uma planilha do Excel
# Carregar um arquivo Excel existente
workbook = Workbook("D:\\Files\\AddThreadedComments_out.xlsx")

# Acesse a primeira planilha
worksheet = workbook.worksheets[0];

# Obtenha comentários encadeados para uma célula específica
threadedComments = worksheet.comments.get_threaded_comments("A1");

# Leia os comentários encadeados
for comment in threadedComments:
    print("Author Name: " + comment.author.name)
    print("Threaded comment Notes:" + comment.notes)

Author Name: Aspose Test
Threaded comment Notes:Test Threaded Comment

Leia todos os comentários encadeados do Excel em Python

Da mesma forma, podemos ler todos os comentários encadeados disponíveis em uma planilha do Excel seguindo as etapas abaixo:

  1. Carregue um arquivo Excel existente usando a classe Workbook.
  2. Percorra todos os comentários e leia os comentários encadeados para cada comentário.

O exemplo de código a seguir mostra como ler todos os comentários encadeados de uma planilha do Excel usando Python.

# Este exemplo de código demonstra como ler todos os comentários encadeados de uma planilha do Excel
# Carregar um arquivo Excel existente
workbook = Workbook("D:\\Files\\MultipleThreadedComments_out.xlsx")

# Acesse a primeira planilha
worksheet = workbook.worksheets[0];

# Receba todos os comentários
comments = worksheet.comments

# Leia todos os comentários encadeados
for comment in comments:
    # Processar comentários encadeados
   for threadedComment in comment.threaded_comments:
        print("Author Name: " + threadedComment.author.name)
        print("Threaded comment author User Id: " + threadedComment.author.user_id)
        print("Threaded comment author ProviderId:" + threadedComment.author.provider_id)
        print("Threaded comment Notes:" + threadedComment.notes)

Edite comentários encadeados no Excel usando Python

Siga as etapas abaixo para atualizar qualquer um dos comentários encadeados em uma planilha do Excel:

  1. Carregue um arquivo Excel existente usando a classe Workbook.
  2. Acesse a planilha pelo seu índice.
  3. Obtenha comentários encadeados para uma célula específica usando o método getthreadedcomments(). Leva o nome da célula como argumento.
  4. Atualize a propriedade de notas do comentário.
  5. Salve o arquivo Excel usando o método Workbook.save(string).

O exemplo de código a seguir mostra como editar comentários encadeados em uma planilha do Excel usando Python.

# Este exemplo de código demonstra como editar comentários encadeados em uma planilha do Excel
# Carregar um arquivo Excel existente
workbook = Workbook("D:\\Files\\AddThreadedComments_out.xlsx")

# Acesse a primeira planilha
worksheet = workbook.worksheets[0];

# Obtenha comentários encadeados para uma célula específica
threadedComments = worksheet.comments.get_threaded_comments("A1");
comment = threadedComments[0]

# Atualizar a nota de comentário
comment.notes = "Updated Comment";

# Salve o arquivo de saída
workbook.save("D:\\Files\\EditThreadedComments.xlsx");

Exclua comentários encadeados no Excel usando Python

Também podemos excluir os comentários encadeados de uma célula específica em uma planilha do Excel seguindo as etapas abaixo:

  1. Carregue um arquivo Excel existente usando a classe Workbook.
  2. Acesse a planilha pelo seu índice.
  3. Remova um comentário da coleção de comentários usando o método removeat(). Leva o nome da célula como argumento.
  4. Salve o arquivo Excel usando o método save(string).

O exemplo de código a seguir mostra como excluir comentários encadeados em uma planilha do Excel usando Python.

# Este exemplo de código demonstra como excluir comentários encadeados em uma planilha do Excel
# Carregar um arquivo Excel existente
workbook = Workbook("D:\\Files\\AddThreadedComments_out.xlsx")

# Receba todos os comentários
comments = workbook.worksheets[0].comments

# Remover comentários
comments.remove_at("A1")
    
# Salve o arquivo de saída
workbook.save("D:\\Files\\DeleteThreadedComments.xlsx");

Obtenha uma licença gratuita

Você pode usar Aspose.Cells for Python sem limitações de avaliação usando uma licença temporária.

Comentários encadeados no Excel – Recursos de aprendizagem

Além de trabalhar com comentários encadeados em planilhas do Excel, aprenda mais sobre como criar, manipular e converter arquivos do Excel e explore vários outros recursos da biblioteca usando os recursos abaixo:

Conclusão

Neste artigo, aprendemos como ler, adicionar, editar e excluir comentários encadeados de planilhas do Excel usando Python. Ao aproveitar o Aspose.Cell para Python, você pode manipular facilmente planilhas do Excel em seus aplicativos Python. Em caso de qualquer ambigüidade, entre em contato conosco em nosso fórum de suporte gratuito.

Veja também