Hämta en specifik dokumentegenskap

Denna REST API läser en dokumentegenskap med namn.

REST API

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

Parametrar för begäran

ParameterNamn	Typ	Plats	Beskrivning
name	string	path	Namnet på Excel-filen.
propertyName	string	path	Namnet på den dokumentegenskap som ska hämtas.
folder	string	query	Mappen som innehåller filen (valfritt).
storageName	string	query	Lagringsnamnet (valfritt).

OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.

Du kan använda cURL kommandoradsverktyget för enkelt att komma åt Aspose.Cells webbtjänster. Följande exempel visar hur man gör anrop till molntjänsten med cURL.

Begäran

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/documentproperties/author" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Svar

{
  "DocumentProperty": {
    "Name": "Author",
    "Value": "",
    "BuiltIn": "True",
    "link": {
      "Href": "/test.xlsx/documentproperties/Author",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Detaljer för svar

JSON-objektet som returneras av API:et innehåller följande fält:

Fält	Typ	Beskrivning
DocumentProperty.Name	string	Namnet på egenskapen (t.ex. `Author`).
DocumentProperty.Value	string	Värdet för egenskapen. Kan vara tomt om inte angivet.
DocumentProperty.BuiltIn	boolean	Anger om egenskapen är en inbyggd Excel-egenskap.
DocumentProperty.link.Href	string	Relativ URL till egenskapsresursen.
DocumentProperty.link.Rel	string	Relations typ, vanligtvis `self`.
DocumentProperty.link.Title	string	Mänsklig läsbar titel (kan vara `null`).
DocumentProperty.link.Type	string	MIME-typ för den länkade resursen (kan vara `null`).
Code	integer	HTTP-statuskod som returnerats av tjänsten.
Status	string	Textuell beskrivning av statusen (t.ex. `OK`).

Felaktiga svar

HTTP-status	Kod	Beskrivning
400	`InvalidParameter`	En eller flera begäransparametrar är ogiltiga.
401	`AuthenticationFailed`	Saknas eller ogiltigt JWT-token.
404	`PropertyNotFound`	Den angivna dokumentegenskapen finns inte.
500	`InternalError`	Ett oväntat fel uppstod på servern.

Ett typiskt felmeddelande ser ut så här:

{
  "Code": 404,
  "Status": "Property not found"
}

Molnsdk-familj

Att använda en sdk är det bästa sättet att påskynda utvecklingen. En sdk hanterar detaljer på låg nivå så att du kan fokusera på dina projektuppgifter. Kontrollera GitHub-lagringsplatsen för en komplett lista över Aspose.Cells Cloud SDK:n.

Följande kodexempel visar hur man gör anrop till Aspose.Cells webbtjänster med olika SDK:n:

Terminologi

Term	Definition
Document Property	En bit metadata kopplad till en Excel-arbetsbok (t.ex. författare, titel, skapat).
Metadata	Generellt uttryck för data som beskriver annan data; i detta sammanhang avses dokumentegenskaper.
Custom Property	En användardefinierad egenskap som inte ingår i den inbyggda uppsättningen.

Vanliga frågor

Fråga: Hur kan jag hämta författaregenskapen för en Excel-fil som lagras i Aspose Cloud?
Svar: Skicka en GET-begäran till https://api.aspose.cloud/v3.0/cells/{fileName}/documentproperties/author med ett giltigt Bearer-token. SVaret JSON innehåller DocumentProperty.Name = "Author" och dess Value.

Fråga: Vilket fel returneras om den begärda egenskapen inte finns?
Svar: API:et returnerar HTTP 404 med ett JSON-svar innehållande Code: 404 och Status: "Property not found".

Fråga: Måste jag ange storageName när filen finns i standardlagringen?
Svar: Nej. Parametern storageName är valfri; utelämna den för att använda standardlagringen som konfigurerats för ditt konto.

Hämta metadata från Excel-filer