Ottenere una Proprietà Specifica del Documento
Questa REST API legge una proprietà del documento per nome.
API REST
GET https://api.aspose.cloud/v3.0/cells/{name}/documentproperties/{propertyName}
Parametri della Richiesta
| Nome Parametro | Tipo | Posizione | Descrizione |
|---|---|---|---|
| name | string | path | Il nome del file Excel. |
| propertyName | string | path | Il nome della proprietà del documento da recuperare. |
| folder | string | query | La cartella contenente il file (opzionale). |
| storageName | string | query | Il nome dello storage (opzionale). |
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 effettuare chiamate all’API Cloud con cURL.
Dettagli della Risposta
L’oggetto JSON restituito dall’API contiene i seguenti campi:
| Campo | Tipo | Descrizione |
|---|---|---|
| DocumentProperty.Name | string | Il nome della proprietà (ad esempio, Author). |
| DocumentProperty.Value | string | Il valore della proprietà. Può essere vuoto se non impostato. |
| DocumentProperty.BuiltIn | boolean | Indica se la proprietà è una proprietà integrata di Excel. |
| DocumentProperty.link.Href | string | URL relativo alla risorsa della proprietà. |
| DocumentProperty.link.Rel | string | Tipo di relazione, di solito self. |
| DocumentProperty.link.Title | string | Titolo leggibile (può essere null). |
| DocumentProperty.link.Type | string | Tipo MIME della risorsa collegata (può essere null). |
| Code | integer | Codice di stato HTTP restituito dal servizio. |
| Status | string | Descrizione testuale dello stato (ad esempio, OK). |
Risposte di Errore
| Stato HTTP | Codice | Descrizione |
|---|---|---|
| 400 | InvalidParameter |
Uno o più parametri della richiesta non sono validi. |
| 401 | AuthenticationFailed |
Token JWT mancante o non valido. |
| 404 | PropertyNotFound |
La proprietà del documento specificata non esiste. |
| 500 | InternalError |
Si è verificato un errore imprevisto sul server. |
Un corpo di errore tipico ha il seguente aspetto:
{
"Code": 404,
"Status": "Property not found"
}
Famiglia di SDK Cloud
L’utilizzo di un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce 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 effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK:
Terminologia
| Termine | Definizione |
|---|---|
| Proprietà Documento | Un pezzo di metadata associato a un file Excel (ad esempio, Autore, Titolo, Creato). |
| Metadata | Termine generico per dati che descrivono altri dati; in questo contesto si riferisce alle proprietà del documento. |
| Proprietà Personalizzata | Una proprietà definita dall’utente non inclusa nell’insieme integrato. |
Domande Frequenti
Domanda: Come posso recuperare la proprietà Autore di un file Excel archiviato in Aspose Cloud?
Risposta: Invia una richiesta GET a https://api.aspose.cloud/v3.0/cells/{fileName}/documentproperties/author con un token Bearer valido. La risposta JSON include DocumentProperty.Name = "Author" e il relativo Value.
Domanda: Quale errore viene restituito se la proprietà richiesta non esiste?
Risposta: L’API restituisce HTTP 404 con un corpo JSON contenente Code: 404 e Status: "Property not found".
Domanda: Devo specificare storageName quando il file si trova nello storage predefinito?
Risposta: No. Il parametro di query storageName è opzionale; omettilo per utilizzare lo storage predefinito configurato per il tuo account.