Spezifische Dokumenteigenschaft abrufen
Diese REST API liest eine Dokumenteigenschaft anhand ihres Namens.
REST API
GET https://api.aspose.cloud/v3.0/cells/{name}/documentproperties/{propertyName}
Anforderungsparameter
| Parametername | Typ | Speicherort | Beschreibung |
|---|---|---|---|
| name | string | path | Der Name der Excel-Datei. |
| propertyName | string | path | Der Name der abzurufenden Dokumenteigenschaft. |
| folder | string | query | Der Ordner, der die Datei enthält (optional). |
| storageName | string | query | Der Speichername (optional). |
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht Ihnen REST-Interaktionen direkt aus einem Webbrowser.
Sie können das cURL-Befehlszeilentool verwenden, um problemlos auf die Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie mithilfe von cURL Aufrufe an die Cloud-API durchgeführt werden.
Antwortdetails
Das von der API zurückgegebene JSON-Objekt enthält die folgenden Felder:
| Feld | Typ | Beschreibung |
|---|---|---|
| DocumentProperty.Name | string | Der Name der Eigenschaft (z. B. Author). |
| DocumentProperty.Value | string | Der Wert der Eigenschaft. Kann leer sein, wenn nicht gesetzt. |
| DocumentProperty.BuiltIn | boolean | Gibt an, ob es sich um eine integrierte Excel-Eigenschaft handelt. |
| DocumentProperty.link.Href | string | Relative URL zur Ressource der Eigenschaft. |
| DocumentProperty.link.Rel | string | Beziehungstyp, gewöhnlich self. |
| DocumentProperty.link.Title | string | Menschlich lesbare Überschrift (kann null sein). |
| DocumentProperty.link.Type | string | MIME-Typ der verknüpften Ressource (kann null sein). |
| Code | integer | Von dem Dienst zurückgegebener HTTP-Statuscode. |
| Status | string | Textuelle Beschreibung des Status (z. B. OK). |
Fehlerantworten
| HTTP-Status | Code | Beschreibung |
|---|---|---|
| 400 | InvalidParameter |
Mindestens ein Anforderungsparameter ist ungültig. |
| 401 | AuthenticationFailed |
Fehlender oder ungültiger JWT-Token. |
| 404 | PropertyNotFound |
Die angegebene Dokumenteigenschaft existiert nicht. |
| 500 | InternalError |
Auf dem Server ist ein unerwarteter Fehler aufgetreten. |
Ein typischer Fehlerkörper sieht wie folgt aus:
{
"Code": 404,
"Status": "Property not found"
}
Cloud SDK-Familie
Die Verwendung eines SDKs ist die beste Möglichkeit, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Low-Level-Details, sodass Sie sich auf die Aufgaben Ihres Projekts konzentrieren können. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.
Die folgenden Codebeispiele zeigen, wie Aufrufe an die Aspose.Cells-Webdienste mithilfe verschiedener SDKs durchgeführt werden:
Terminologie
| Begriff | Definition |
|---|---|
| Dokumenteigenschaft | Ein Metadatenelement, das mit einer Excel-Arbeitsmappe verknüpft ist (z. B. Autor, Titel, Erstelldatum). |
| Metadaten | Allgemeiner Begriff für Daten, die andere Daten beschreiben; hier bezieht es sich auf Dokumenteigenschaften. |
| Benutzerdefinierte Eigenschaft | Eine benutzerdefinierte Eigenschaft, die nicht im integrierten Satz enthalten ist. |
Häufig gestellte Fragen (FAQ)
Q: Wie kann ich die Autor-Eigenschaft einer Excel-Datei abrufen, die in Aspose Cloud gespeichert ist?
A: Senden Sie eine GET-Anforderung an https://api.aspose.cloud/v3.0/cells/{fileName}/documentproperties/author mit einem gültigen Bearer-Token. Die JSON-Antwort enthält DocumentProperty.Name = "Author" sowie dessen Value.
Q: Welcher Fehler wird zurückgegeben, wenn die angeforderte Eigenschaft nicht existiert?
A: Die API gibt HTTP 404 zurück, wobei der JSON-Körper Code: 404 und Status: "Property not found" enthält.
Q: Muss ich storageName angeben, wenn sich die Datei im Standardspeicher befindet?
A: Nein. Der Abfrageparameter storageName ist optional; lassen Sie ihn weg, um den für Ihr Konto konfigurierten Standardspeicher zu verwenden.