Documentation –

Developer-Guide: Ottenere elementi di testo da un workbook Excel

Mon, 01 Jan 0001 00:00:00 +0000

API REST

Questa API REST legge gli elementi di testo di un workbook in un file Excel.

GET https://api.aspose.cloud/v3.0/cells/{name}/textItems

Sicurezza e autenticazione

Le API Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Il nome del file del workbook.
folder	string	query	Il percorso della cartella nello storage dove risiede il workbook.
storageName	string	query	Il nome del servizio di storage.

Risposta

{
  "Status":"OK",
  "Code":200,
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto nel server.

Come utilizzare l’API GetWorkbookTextItems con gli SDK

Specifica dell’API GetWorkbookTextItems

La specifica OpenAPI definisce un’interfaccia di programmazione accessibile pubblicamente e consente di effettuare interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare una chiamata all’API Cloud con cURL.

Richiesta

curl -X GET "https://api.aspose.cloud/v3.0/cells/test.xlsx/textItems" -H "accept: application/json"

Risposta

{
  "Status": "string",
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

Codici di risposta HTTP tipici:

Codice	Descrizione
200	Richiesta riuscita; gli elementi di testo vengono restituiti.
401	Non autorizzato – token mancante o non valido.
403	Vietato – permessi insufficienti.
404	Non trovato – workbook o risorsa non trovato.
500	Errore interno del server – errore imprevisto.

Utilizzare gli SDK di Aspose.Cells Cloud

Questo esempio utilizza la versione dell’API v3.0; fare riferimento al changelog per le versioni più recenti. Utilizzare un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli a basso livello e ti consente di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK:

Developer-Guide: Ottenere elementi di testo da un foglio di lavoro Excel

Mon, 01 Jan 0001 00:00:00 +0000

API REST

Questa API REST legge gli elementi di testo di un foglio di lavoro in un file Excel.

https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{worksheet}/textItems

Sicurezza e autenticazione

Le API REST di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Obbligatorio	Descrizione
name	string	path	Sì	Nome del file del workbook.
sheetName	string	path	Sì	Nome del foglio di lavoro.
folder	string	query	No	Percorso della cartella contenente il workbook.
storageName	string	query	No	Nome dello storage Aspose Cloud.

Risposta

{
  "Status":"OK",
  "Code":200,
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto sul server.

Come utilizzare l’API GetWorksheetTextItems con gli SDK

Specifica dell’API GetWorksheetTextItems

La Specifica OpenAPI{:target="_blank" rel=“noopener noreferrer”} definisce un’interfaccia di programmazione accessibile pubblicamente e consente di effettuare interazioni REST direttamente da un browser web.

È possibile utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API cloud con cURL.

Richiesta

curl -X GET "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/sheet1/textItems" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <access_token>"

Risposta

{
  "Status": "string",
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

Utilizzo degli SDK di Aspose.Cells Cloud

Gli SDK semplificano l’integrazione gestendo i dettagli a basso livello e consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub{:target="_blank" rel=“noopener noreferrer”} per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK:

Developer-Guide: Cercare testo in un workbook Excel

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST consente di cercare testo in un workbook Excel.

API REST

POST https://api.aspose.cloud/v3.0/cells/{name}/findText

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del workbook Excel.
text	string	query	Stringa di testo da cercare.
folder	string	query	Cartella contenente il workbook (opzionale).
storageName	string	query	Nome dello storage in cui si trova il workbook (opzionale).

Risposta

{
  "Status":"OK",
  "Code":200,
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto sul server.

Come utilizzare l’API PostWorkbooksTextSearch con gli SDK

Specifica dell’API PostWorkbooksTextSearch

La Specifiche OpenAPI definiscono un’interfaccia di programmazione pubblicamente accessibile e consentono di eseguire interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come richiamare l’API con cURL.

Richiesta

curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/findText?text=a" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <your_access_token>"

Risposta

{
  "Status": "string",
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK rappresenta il modo più rapido per sviluppare. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sul tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come richiamare i servizi web di Aspose.Cells utilizzando vari SDK:

Developer-Guide: Trova testo in un foglio di lavoro Excel

Mon, 01 Jan 0001 00:00:00 +0000

Questa REST API consente di cercare testo in un foglio di lavoro Excel.

REST API

POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/findText

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del documento.
sheetName	string	path	Nome del foglio di lavoro.
text	string	query	Testo da cercare.
folder	string	query	Cartella del documento.
storageName	string	query	Nome dello storage.

Risposta

{
  "Status":"OK",
  "Code":200,
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida (Bad Request)	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato (Unauthorized)	Token JWT non valido o mancante.
413	Payload troppo grande (Payload Too Large)	Il file caricato supera il limite di dimensione.
500	Errore interno del server (Internal Server Error)	Errore imprevisto nel server.

Come utilizzare l’API PostWorksheetTextSearch con gli SDK

Specifica dell’API PostWorksheetTextSearch

La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come chiamare l’API Cloud con cURL.

Richiesta

curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/findText?text=a" -H "accept: application/json"

Risposta

{
  "Status": "string",
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

Utilizzare gli SDK di Aspose.Cells Cloud

Utilizzare un SDK rappresenta il modo più rapido per sviluppare. Un SDK astrae i dettagli di basso livello, permettendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web Aspose.Cells mediante vari SDK:

Developer-Guide: Cercare testo nei file Excel – Aspose.Cells Cloud API

Mon, 01 Jan 0001 00:00:00 +0000

Cercare testo nei file Excel – Aspose.Cells Cloud API

Panoramica

Aspose.Cells Cloud fornisce un endpoint POST che consente di cercare una stringa di testo all’interno di cartelle di lavoro Excel (XLS, XLSX, XLSM, XLSB) e di file di fogli di calcolo OpenDocument (ODS). L’API restituisce ogni cella contenente il testo richiesto, insieme a un collegamento al foglio di calcolo in cui è stata trovata la corrispondenza.

Casi d’uso

Convalidare che un valore specifico esista in un report prima di procedere con ulteriori elaborazioni.

Creare uno strumento rapido di “trova e sostituisci” che elenchi innanzitutto tutte le occorrenze.

Generare un indice di termini chiave in un batch di fogli di calcolo.

Prerequisiti

Requisito	Dettagli
Autenticazione	Token JWT ottenuto tramite il flusso OAuth di Aspose Cloud. Il token deve includere l’ambito Cells.
Formati supportati	XLS, XLSX, XLSM, XLSB, ODS
Dimensione massima del file	150 MB (compressi). File più grandi generano l’errore 413 Payload Too Large.
Intestazioni obbligatorie	`Authorization: Bearer <jwt-token>` `Accept: application/json`
Autorizzazioni	Il token deve avere il permesso di lettura sull’archivio di destinazione (se si utilizza un archivio remoto); non è richiesto quando il file viene caricato come `multipart/form-data`.

Suggerimento: Utilizza l’endpoint /connect/token per generare un token JWT. Consulta la Guida all’autenticazione per maggiori dettagli.

Endpoint

Elemento	Valore
Metodo HTTP	`POST`
URL	`https://api.aspose.cloud/v3.0/cells/search`
Scopo	Cerca il testo specificato all’interno di una cartella di lavoro Excel caricata.
Sicurezza	Token JWT (Bearer) – consulta i Prerequisiti sopra.

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione basata su token JWT.

Parametri della richiesta

Nome	Tipo	Posizione	Obbligatorio	Descrizione
`file`	file	`formData` (multipart)	Sì	Il file del foglio di calcolo da caricare.
`text`	string	Query string	Sì	La stringa di testo da cercare.
`password`	string	Query string	No	Password per aprire una cartella di lavoro protetta, se richiesta.
`sheetname`	string	Query string	No	Nome del foglio di calcolo da limitare alla ricerca. Se omesso, vengono cercati tutti i fogli.
`checkExcelRestriction`	boolean	Query string	No (default: `true`)	Quando impostato su `true`, l’API convalida le restrizioni specifiche di Excel (ad esempio, celle di sola lettura) prima di effettuare la ricerca.

Esempio di richiesta (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/search?text=Invoice&sheetname=Sheet1" \
  -X POST \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt-token>" \
  -F "file=@InvoiceReport.xlsx"

Sostituisci <jwt-token> con un token valido e regola i parametri della query in base alle tue esigenze.

Risposta in caso di successo

HTTP 200 – Ricerca riuscita; la risposta contiene gli elementi di testo trovati.

{
  "Status": "OK",
  "Code": 200,
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "Text": "Invoice #12345",
        "link": {
          "Href": "InvoiceReport.xlsx/worksheets/Sheet1",
          "Rel": "parent",
          "Title": "Sheet1",
          "Type": "string"
        }
      },
      {
        "Text": "Invoice #12346",
        "link": {
          "Href": "InvoiceReport.xlsx/worksheets/Sheet1",
          "Rel": "parent",
          "Title": "Sheet1",
          "Type": "string"
        }
      }
    ]
  }
}

Campi della risposta

Campo	Tipo	Descrizione
`Status`	string	Stato complessivo della richiesta (`OK` in caso di successo).
`Code`	integer	Codice di stato HTTP (200).
`TextItems.link`	object	Link ipermedia al collection resource.
`TextItems.TextItemList`	array	Elenco delle corrispondenze. Ogni elemento contiene:
`Text`	string	Valore della cella che ha trovato corrispondenza con il testo cercato.
`link`	object	Link ipermedia al foglio di calcolo in cui è stata trovata la corrispondenza (`Href` punta a `Workbook/worksheets/SheetName`).

Risposte di errore

Codice HTTP	Significato	Causa tipica	Corpo dell’esempio
400	Richiesta non valida	Parametri obbligatori mancanti, tipo di file non supportato o valori di query non validi.	`{ "Status":"Error","Code":400,"Message":"Il parametro di query 'text' è obbligatorio." }`
401	Non autorizzato	Token JWT mancante o non valido.	`{ "Status":"Error","Code":401,"Message":"Token di accesso non valido o scaduto." }`
413	Payload troppo grande	Il file caricato supera il limite di 150 MB.	`{ "Status":"Error","Code":413,"Message":"La dimensione del file supera il limite consentito." }`
500	Errore interno del server	Problema imprevisto lato server.	`{ "Status":"Error","Code":500,"Message":"Si è verificato un errore imprevisto." }`

Esempi di SDK

Di seguito sono riportati frammenti di codice minimi per l’operazione PostSearch utilizzando gli SDK ufficiali di Aspose.Cells Cloud. Sostituisci YOUR_JWT_TOKEN e il percorso del file con i tuoi valori.

C# (.NET)

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        var config = new Configuration
        {
            AccessToken = "YOUR_JWT_TOKEN",
            BaseUrl = "https://api.aspose.cloud"
        };
        var cellsApi = new CellsApi(config);

        using var stream = File.OpenRead("InvoiceReport.xlsx");
        var result = cellsApi.PostSearch(
            file: stream,
            text: "Invoice",
            sheetname: "Sheet1",
            password: null,
            checkExcelRestriction: true
        );

        foreach (var item in result.TextItems.TextItemList)
        {
            Console.WriteLine($"{item.Text}  ->  {item.Link.Href}");
        }
    }
}

Java

import com.aspose.cells.cloud.sdk.api.CellsApi;
import com.aspose.cells.cloud.sdk.model.*;
import java.io.File;

public class PostSearchDemo {
    public static void main(String[] args) throws Exception {
        CellsApi api = new CellsApi("YOUR_JWT_TOKEN");
        File file = new File("InvoiceReport.xlsx");

        TextItemsResponse response = api.postSearch(
                file,
                "Invoice",
                null,          // password
                "Sheet1",      // sheetname
                true           // checkExcelRestriction
        );

        response.getTextItems().getTextItemList()
                .forEach(item -> System.out.println(item.getText() + " -> " + item.getLink().getHref()));
    }
}

Python

import asposecellscloudsdk
from asposecellscloudsdk import CellsApi, ApiException, Configuration
from asposecellscloudsdk.models import TextItemsResponse
import pathlib

config = Configuration()
config.access_token = "YOUR_JWT_TOKEN"
config.host = "https://api.aspose.cloud"

api_instance = CellsApi(configuration=config)

file_path = pathlib.Path("InvoiceReport.xlsx")
with open(file_path, "rb") as f:
    result: TextItemsResponse = api_instance.post_search(
        file=f,
        text="Invoice",
        password=None,
        sheetname="Sheet1",
        check_excel_restriction=True
    )

for item in result.text_items.text_item_list:
    print(f"{item.text} -> {item.link.href}")

Node.js (TypeScript)

import { CellsApi, Configuration } from "@asposecells-cloud/sdk";

const config = new Configuration({
    accessToken: "YOUR_JWT_TOKEN",
    basePath: "https://api.aspose.cloud"
});

const api = new CellsApi(config);

api.postSearch({
    file: fs.createReadStream("InvoiceReport.xlsx"),
    text: "Invoice",
    sheetname: "Sheet1",
    checkExcelRestriction: true
}).then(response => {
    response.textItems?.textItemList?.forEach(item => {
        console.log(`${item.text} -> ${item.link?.href}`);
    });
}).catch(err => console.error(err));

(Gli SDK per PHP, Ruby, Go e Perl sono disponibili nel repository GitHub di Aspose.Cells Cloud.)

Note aggiuntive

checkExcelRestriction ha come valore predefinito true. Impostalo su false solo se sei certo che la cartella di lavoro non contenga celle protette che potrebbero interferire con la ricerca.
L’API restituisce link ipermedia (Href) che possono essere utilizzati con altri endpoint di Aspose.Cells Cloud (ad esempio, per scaricare il foglio di calcolo o recuperare la formattazione delle celle).
Quando si cercano in cartelle di lavoro di grandi dimensioni, considera di ridurre l’ambiente di ricerca mediante il parametro sheetname per migliorare i tempi di risposta.

Link correlati

Guida all’autenticazione – https://docs.aspose.cloud/total/getting-started/rest-api-overview/authenticating-api-requests/
Specifiche OpenAPI per PostSearch – https://apireference.aspose.cloud/cells/#/LightCells/PostSearch
SDK di Aspose.Cells Cloud – https://github.com/aspose-cells-cloud
Limiti e quote – https://docs.aspose.cloud/total/getting-started/limits/

Developer-Guide: Sostituisci testo in un foglio di calcolo Excel

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST sostituisce il testo in un foglio di calcolo Excel.

API REST

POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/replaceText

Sicurezza e autenticazione

Le API REST di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file del foglio di calcolo.
sheetName	string	path	Nome del foglio di calcolo in cui avviene la sostituzione.
oldValue	string	query	Testo che deve essere sostituito.
newValue	string	query	Testo che sostituirà il valore precedente.
folder	string	query	Percorso della cartella contenente il foglio di calcolo.
storageName	string	query	Nome del servizio di archiviazione in cui risiede il foglio di calcolo.

Risposta

{
    "Status":"OK",
    "Code":200,
      "Workbook": {
    "FileName": "test.xlsx",
    "Links": [
      {
        "Href": "/test.xlsx",
        "Rel": "self",
        "Title": null,
        "Type": null
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come CSV",
        "Type": "text/csv"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come HTML",
        "Type": "text/html"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come ODS",
        "Type": "application/vnd.oasis.opendocument.spreadsheet"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come PDF",
        "Type": "application/pdf"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come formato di testo delimitato da tabulazioni",
        "Type": "text/plain"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come TIFF",
        "Type": "image/tiff"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come Microsoft Excel 2003",
        "Type": "application/vnd.ms-excel"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come Microsoft Excel 2007",
        "Type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come XPS",
        "Type": "application/vnd.ms-xpsdocument"
      }
    ],
    "Worksheets": {
      "link": {
        "Href": "/worksheets",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "DefaultStyle": {
      "link": {
        "Href": "/defaultstyle",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "DocumentProperties": {
      "link": {
        "Href": "/documentproperties",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "Names": {
      "link": {
        "Href": "/names",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "Settings": {
      "link": {
        "Href": "/settings",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "IsWriteProtected": "False",
    "IsProtected": "False",
    "IsEncryption": "false",
    "Password": null
  }
}

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (es. tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto nel server.

Come usare l’API PostReplace con gli SDK

Specifica dell’API PostReplace

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.

È possibile utilizzare lo strumento a riga di comando cURL per richiamare facilmente i servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare una richiesta con cURL.

Richiesta

curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/replaceText?oldValue=a&newValue=a12" -H "accept: application/json"

Risposta

{
  "Matches": 26,
  "Workbook": {
    "link": {
      "Href": "/test.xlsx",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK è il modo più rapido per integrare questa funzionalità. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulla logica di business. Consulta la repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK:

Developer-Guide: Sostituisci testo in un foglio di lavoro Excel – API Aspose.Cells Cloud

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST sostituisce il testo in un foglio di lavoro Excel utilizzando l'API di sostituzione testo di Aspose.Cells.

Sicurezza e autenticazione

Le API Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

API REST

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/replaceText

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file cartella di lavoro Excel.
sheetName	string	path	Nome del foglio di lavoro.
oldValue	string	query	Testo da sostituire.
newValue	string	query	Testo di sostituzione.
folder	string	query	Cartella contenente il file.
storageName	string	query	Nome del servizio di archiviazione.

Risposta

{
    "Status":"OK",
    "Code":200,
      "Workbook": {
    "FileName": "test.xlsx",
    "Links": [
      {
        "Href": "/test.xlsx",
        "Rel": "self",
        "Title": null,
        "Type": null
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come CSV",
        "Type": "text/csv"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come HTML",
        "Type": "text/html"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come ODS",
        "Type": "application/vnd.oasis.opendocument.spreadsheet"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come PDF",
        "Type": "application/pdf"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come formato testo delimitato da tabulazioni",
        "Type": "text/plain"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come TIFF",
        "Type": "image/tiff"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come Microsoft Excel 2003",
        "Type": "application/vnd.ms-excel"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come Microsoft Excel 2007",
        "Type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "Scarica come XPS",
        "Type": "application/vnd.ms-xpsdocument"
      }
    ],
    "Worksheets": {
      "link": {
        "Href": "/worksheets",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "DefaultStyle": {
      "link": {
        "Href": "/defaultstyle",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "DocumentProperties": {
      "link": {
        "Href": "/documentproperties",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "Names": {
      "link": {
        "Href": "/names",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "Settings": {
      "link": {
        "Href": "/settings",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "IsWriteProtected": "False",
    "IsProtected": "False",
    "IsEncryption": "false",
    "Password": null
  }
}

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (es. tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	File caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto del server.

Come utilizzare l’API PostWorksheetTextReplace con gli SDK

Specifica dell’API PostWorksheetTextReplace

La specificazione OpenAPI definisce questa interfaccia accessibile pubblicamente.

Puoi utilizzare lo strumento a riga di comando cURL per chiamare il servizio:

Richiesta

curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/replaceText?oldValue=b&newValue=b11" \
     -H "accept: application/json" \
     -H "Authorization: Bearer {access_token}"

Risposta

{
  "Matches": 0,
  "Worksheet": {
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK rappresenta il modo più efficace per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK:

Developer-Guide: Sostituisci il testo nei file Excel

Mon, 01 Jan 0001 00:00:00 +0000

API REST

Questa API REST sostituisce i dati nei file Excel.

POST https://api.aspose.cloud/v3.0/cells/replace

Sicurezza e autenticazione

Le API REST di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
file	file	formData (multipart)	File Excel da elaborare.
text	string	query	Stringa di testo da sostituire.
newtext	string	query	Testo di sostituzione.
password	string	query	Password per un workbook protetto (opzionale).
sheetname	string	query	Nome del foglio di calcolo da interessare (opzionale).

Risposta

{
  "Status":"OK",
  "Code":200,
  "Files": [
    {
      "Filename" : "[nome file1]",
      "Filesize" : [dimensione file],
      "FileContent" : "[Base64String]"
    },
    {
      "Filename" : "[nome file2]",
      "Filesize" : [dimensione file],
      "FileContent" : "[Base64String]"
    },
    {
      "Filename" : "[nome file3]",
      "Filesize" : [dimensione file],
      "FileContent" : "[Base64String]"
    }
  ]
}

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto del server.

Come utilizzare l’API PostReplace con gli SDK

Specifica dell’API PostReplace

La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e permettono di effettuare interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API Cloud con cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/replace?text=1&newtext=aspose.cells.cloud" \
-X POST \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-F 'xxxxx1=@xxxx1.xlsx' \
-F 'xxxxx2=@xxxx2.xlsx'

Risposta

{
  "Files": [
    {
      "Filename": "xxxx1",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "xxxx2",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Famiglia di SDK per il Cloud

L’utilizzo di un SDK rappresenta il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli a basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK: