Stapelverarbeitung von Excel-Dateien

Diese REST-API ermöglicht die Stapelverarbeitung (Batch-Konvertierung) kompatibler Dateien.

REST API

POST http://api.aspose.cloud/v3.0/cells/batch/convert

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

Anforderungsparameter

Parametername	Typ	Ort	Beschreibung
batchConvertRequest	Objekt	body	Anforderungstext mit Konvertierungseinstellungen.

Eigenschaften von BatchConvertRequest

Name	Typ	Beschreibung	Hinweise
SourceFolder	Zeichenkette	Pfad zum Ordner, der die Quell-Excel-Dateien enthält.	[optional]
MatchCondition	MatchConditionRequest	Bedingungen zur Auswahl von Dateien für die Konvertierung.	[optional]
Format	Zeichenkette	Zielformat für die Konvertierung (z. B. `pdf`, `csv`).	[optional]
OutFolder	Zeichenkette	Zielordner, in dem die konvertierten Dateien gespeichert werden.	[optional]
SaveOptions	SaveOptions	Zusätzliche Optionen zur Steuerung des Dateispeichervorgangs.	[optional]

Eigenschaften von MatchConditionRequest

Name	Typ	Beschreibung	Hinweise
RegexPattern	Zeichenkette	Regulärer Ausdruck zur Filterung von Dateinamen.	[optional]
FullMatchConditions	Zeichenketten-Array	Liste exakter Dateinamenbedingungen für die Übereinstimmung.	[optional]

Anforderungstext-Parameter

Parametername	Typ	Beschreibung
data	Datei	Binärinhalt der zu erstellenden Arbeitsmappe.

Antwort

{
    "Name": "ResponseFile",
    "DataType": {
        "Identifier": "File",
        "Reference": "Stream",
        "Name": "file"
    }
}

HTTP-Statuscodes

Code	Bedeutung	Wann wird dieser zurückgegeben?
200 OK	Arbeitsmappe erfolgreich erstellt	Normaler Ablauf
201 Created	Arbeitsmappe erstellt (Alternative Antwort)	Wenn die API einen „Created“-Status zurückgibt
400 Bad Request	Ungültige Parameter	Client-seitiger Fehler
401 Unauthorized	Fehlendes oder ungültiges Token	Authentifizierungsfehler
409 Conflict	Datei existiert bereits und `isWriteOver=false`	Konflikt mit vorhandener Datei

Verwendung der PostBatchConvert API mit SDKs

PostBatchConvert API-Spezifikation

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.

Sie können das cURL-Befehlszeilentool nutzen, um Aspose.Cells-Webdienste problemlos aufzurufen. Das folgende Beispiel zeigt, wie Aufrufe an die Cloud-API mit cURL durchgeführt werden.

Anforderung

curl -v "http://api.aspose.cloud/v3.0/cells/batch/convert" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-D "{\"SourceFolder\":\"CellsTests\",\"OutFolder\":\"Output\",\"MatchCondition\":{\"RegexPattern\":\"(^Book)(.+)(xlsx$)\"},\"Format\":\"pdf\",\"SaveOptions\":{\"SaveFormat\":\"pdf\",\"CalculateFormula\":true,\"EnableHTTPCompression\":true,\"OnePagePerSheet\":true,\"CreateDirectory\":false,\"Compliance\":\"None\"}}"

Antwort

{
  "Code": 200,
  "Status": "OK"
}

Verwendung der Aspose.Cells Cloud SDKs

Die Verwendung eines SDKs ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Low-Level-Details und ermöglicht es Ihnen, sich auf Ihre Projektaufgaben zu konzentrieren. Weitere Informationen finden Sie im GitHub-Repository, das eine vollständige Liste der Aspose.Cells Cloud SDKs enthält.

Die folgenden Codebeispiele zeigen, wie Aufrufe an Aspose.Cells-Webdienste mithilfe verschiedener SDKs durchgeführt werden: