
A marca d’água é um aspecto crucial do gerenciamento de documentos, especialmente quando se trata de informações sensíveis ou confidenciais. Adicionar marcas d’água a arquivos Excel(XLS,XLSX) pode ajudar a proteger o conteúdo e identificar o status do documento. Nesta postagem do blog, exploraremos como adicionar uma marca d’água a um arquivo Excel usando a API REST de marca d’água do Excel e seu Java SDK. Este guia cobrirá os seguintes pontos ao longo do artigo e não se esqueça de ler uma seção bônus no final desta postagem do blog.
- [Configurando o ambiente][8]
- [Inicializar cliente API][9]
- [Carregar o arquivo Excel][10]
- [Criar marca d’água no arquivo Excel usando Java][11]
- [Baixar arquivo de saída][12]
Configurando o Ambiente
Pré-requisitos:
Antes de nos aprofundarmos na implementação, certifique-se de ter os seguintes pré-requisitos em vigor:
- Kit de desenvolvimento Java (JDK) instalado.
- Conta GroupDocs para obter credenciais de API.
- Conhecimento básico de APIs REST e programação Java.
Obtenção de credenciais de API:
Para começar, inscreva-se em uma conta na nuvem GroupDocs e crie um aplicativo. O [painel][7] fornecerá as credenciais necessárias (App SID e App Key) para autenticar suas solicitações.
Adicionando o GroupDocs.Watermark Cloud SDK para Java:
Para incorporar o SDK em seu projeto Java, você pode [baixar][5] o arquivo JAR da API ou instalá-lo usando Maven adicionando o seguinte repositório e dependência ao arquivo pom.xml do seu projeto:
Repositório Maven:
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
Dependência do Maven:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-watermark-cloud</artifactId>
<version>23.3</version>
<scope>compile</scope>
</dependency>
Inicie a inicialização do cliente API
Para configurar o cliente API, adquira seu ID do cliente e Segredo do cliente no [painel][7]. A seguir, insira o código fornecido conforme mostrado no exemplo abaixo:
String clientId = "APP_SID"; | |
String clientSecret = "APP_KEY"; | |
String myStorage = ""; | |
Configuration configuration = new Configuration(clientId, clientSecret); |
Carregando o documento Excel
Antes de adicionar uma marca d’água a um arquivo Excel, você precisa carregar o arquivo Excel específico ao qual planeja aplicar a marca d’água. Você pode conseguir isso utilizando qualquer um dos seguintes métodos para carregar o arquivo para armazenamento em nuvem:
- Carregue todos os arquivos um por um usando Upload File API do navegador.
- Usando o [painel][7].
- Faça upload programaticamente usando o exemplo de código abaixo:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
// api initialization FileApi apiInstance = new FileApi(clientId, clientSecret); // input file File fileStream = new File("C:\\Files\\sample.xlsx"); // create file upload request UploadFileRequest request = new UploadFileRequest("sample.xlsx", fileStream, myStorage); // upload file FilesUploadResult response = apiInstance.uploadFile(request);
Conseqüentemente, os arquivos enviados estarão acessíveis na [seção de arquivos][5] do seu painel na nuvem.
Adicionar marca d’água no arquivo Excel usando Java
Aqui estão as etapas e o código de exemplo que mostram como adicionar uma marca d’água a um arquivo Excel em Java usando a API REST de marca d’água do Excel.
- Inicialmente, obtenha AppKey e AppSID no GroupDocs Dashboard.
- Em seguida, configure usando AppKey e AppSID.
- Em seguida, defina as opções de marca d’água e informações do arquivo.
- Em seguida, defina os detalhes da marca d’água do texto (texto, fonte, tamanho).
- Em seguida, crie uma lista de detalhes.
- Em seguida, crie uma solicitação de adição usando WatermarkApi.
- Por fim, execute a solicitação usando a instância WatermarkApi.
O exemplo de código a seguir mostra como inserir uma marca d’água em um arquivo Excel em Java usando a API REST de marca d’água do Excel.
String MyAppKey = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
String MyAppSid = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
Configuration configuration = new Configuration(MyAppSid, MyAppKey); | |
WatermarkApi apiInstance = new WatermarkApi(configuration); | |
WatermarkOptions options = new WatermarkOptions(); | |
FileInfo fileInfo = new FileInfo(); | |
fileInfo.setFilePath("documents/sample.xlsx"); | |
options.setFileInfo(fileInfo); | |
WatermarkDetails watermarkDetails = new WatermarkDetails(); | |
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions(); | |
textWatermarkOptions.setText("Hello World!"); | |
textWatermarkOptions.setFontFamilyName("Arial"); | |
textWatermarkOptions.setFontSize(12d); | |
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions); | |
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>(); | |
watermarkDetailsList.add(watermarkDetails); | |
options.setWatermarkDetails(watermarkDetailsList); | |
AddRequest request = new AddRequest(options); | |
WatermarkResult response = apiInstance.add(request); |
Você verá a saída na seguinte captura de tela:

Baixe o arquivo Excel resultante
O código fornecido na etapa anterior salva o arquivo resultante na nuvem. Para baixá-lo, você pode usar o seguinte trecho de código.
// api initialization | |
FileApi apiInstance = new FileApi(clientId, clientSecret); | |
// create download file request | |
DownloadFileRequest request = new DownloadFileRequest("watermark/sample_excel/sample.xlsx", "", null); | |
File response = apiInstance.downloadFile(request); |
Conclusão
Concluindo, empregar a API REST GroupDocs.Watermark Cloud e o Java SDK para adicionar marcas d’água a arquivos Excel apresenta uma abordagem robusta para reforçar a segurança e a marca dos documentos. Siga as ações descritas neste guia para integrar perfeitamente a marca d’água ao seu fluxo de trabalho de gerenciamento de documentos e proteger seus arquivos Excel com facilidade. Recomendamos que você visite a [documentação][14] e experimente diversas configurações para criar marcas d’água em suas imagens ou documentos que atendam perfeitamente às suas necessidades de marca.
Além disso, você encontrará uma seção [Referência de API][15] que permite visualização direta e interação com nossas APIs diretamente de seu navegador. O código-fonte abrangente do Java SDK pode ser acessado abertamente no [Github][16].
No final, nossos esforços continuam girando em torno da criação de novos conteúdos de blog que se concentram em vários formatos de arquivo e sua interpretação usando a API REST. Fique conectado para as atualizações mais recentes. Desejo a você sucesso e realização em sua jornada de codificação!
Aplicativo Excel Watermarker online gratuito
Para obter um método alternativo para adicionar marcas d’água a arquivos do Excel, explore o [aplicativo online de marca d’água do Excel][13]. Esta ferramenta para adicionar marcas d’água ao Excel foi criada usando a biblioteca de marcas d’água Java mencionada anteriormente.
Faça uma pergunta
Caso você tenha alguma dúvida ou dúvida sobre o Excel Watermarker, não hesite em entrar em contato conosco através do nosso [fórum][17].
Veja também
Aqui estão alguns artigos relacionados que podem ser úteis:
- [Adicionar marca d’água a documentos do Word usando API REST em C#][21]
- [Adicionar marca d’água às imagens usando Java][22]
- [Encontrar e substituir marca d’água usando API REST][23]
https://dashboard.groupdocs.cloud/files [6]: https://www.nuget.org/packages/GroupDocs.watermark-Cloud/ [7]: https://dashboard.groupdocs.cloud/ [8]: #setup [9]: #initialize-API-Client [10]: #upload-file [11]: #generate-watermark [12]: #download-xlsx-file [13]: https://products.groupdocs.app/watermark/xlsx [14]: https://docs.groupdocs.cloud/watermark/ [15]: https://apireference.groupdocs.cloud/watermark/ [16]: https://github.com/groupdocs-watermark-cloud/groupdocs-watermark-cloud-dotnet [17]: https://forum.groupdocs.cloud/c/watermark/29 [18]: https://products.groupdocs.cloud/watermark/net/ [19]: #faq [20]: # [21]: https://blog.groupdocs.cloud/pt/watermark/add-watermark-to-word-documents-using-rest-api-in-csharp/ [22]: https://blog.groupdocs.cloud/pt/watermark/add-watermark-to-images-using-java/ [23]: https://blog.groupdocs.cloud/pt/watermark/find-and-replace-watermark-using-rest-api/