Lavorare con i filtri pivot – Documentazione di Aspose.Cells Cloud

Questa API REST aggiunge un filtro pivot alla tabella pivot presente all’indice specificato.

Prerequisiti
Prima di chiamare questo endpoint è necessario:

Generare un token di accesso OAuth/JWT valido e includeerlo nell’intestazione Authorization.
Assicurarsi che il foglio di calcolo di destinazione sia archiviato in una cartella cloud a cui si ha accesso (specificare folder e opzionalmente storageName).
Utilizzare la versione 3.0 o successiva dell’API REST di Aspose.Cells Cloud.

API PutWorksheetPivotTableFilter

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}/PivotFilters

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 Excel.
sheetName	string	path	Foglio di calcolo contenente la tabella pivot.
pivotTableIndex	integer	path	Indice in base zero della tabella pivot alla quale applicare il filtro.
filter	object	body	Oggetto JSON che definisce le impostazioni del filtro. Vedere la tabella schema del filtro riportata di seguito.
needReCalculate	boolean	query	Se impostato su true, forza il foglio di calcolo a ricalcolarsi dopo l’aggiunta del filtro. Default: false.
folder	string	query	Cartella nell’archivio cloud in cui si trova il file.
storageName	string	query	Nome dell’archivio cloud.

Schema del filtro

Proprietà	Tipo	Descrizione
AutoFilter	object	Impostazioni per un filtro automatico; può essere omesso se non utilizzato.
EvaluationOrder	integer	Ordine in cui viene valutato il filtro.
FieldIndex	integer	Indice in base zero del campo a cui si applica il filtro.
FilterType	string	Tipo di filtro (ad es. `Value`, `Count`, `Label`).
MeasureFldIndex	integer	Indice del campo misura, se applicabile.
MemberPropertyFieldIndex	integer	Indice del campo proprietà membro, se applicabile.
Name	string	Nome facoltativo del filtro.
Value1	string	Primo valore utilizzato dal filtro (ad es. limite inferiore per un intervallo).
Value2	string	Secondo valore utilizzato dal filtro (ad es. limite superiore per un intervallo).
CustomFilters	array	Raccolta di oggetti filtro personalizzato (ciascuno con `FilterOperatorType`, `Value1`, `Value2`).
DynamicFilter	object	Impostazioni per un filtro dinamico (ad es. Top10, Bottom10).
IconFilter	object	Impostazioni per un filtro basato su icone.
Top10Filter	object	Impostazioni per un filtro Top10/Bottom10.
ColorFilter	object	Impostazioni per un filtro basato sul colore.
Visibledropdown	boolean	Indica se il menu a discesa del filtro è visibile.

Nota: Tutti i parametri elencati sopra sono obbligatori, a meno che non siano esplicitamente contrassegnati come facoltativi nella documentazione dell’API.

Codici di risposta

Codice	Significato
200	Filtro aggiunto correttamente.
400	Richiesta non valida – parametri non validi.
401	Non autorizzato – token mancante o non valido.
404	Non trovato – foglio di calcolo o tabella pivot mancante.
500	Errore interno del server.

Best practice

Mantenere gli oggetti filtro il più piccoli possibile; definizioni di filtri grandi possono aumentare la latenza della richiesta.
Le chiamate sono idempotenti: aggiungere lo stesso filtro due volte non crea duplicati.
Rispettare il limite di frequenza dell’API: 100 richieste al minuto per account.

Note aggiuntive:

La dimensione massima di una definizione di filtro è di 1 MB; payload più grandi verranno rifiutati con un errore 400.
Quando si utilizza needReCalculate=true, il ricalcolo può aumentare il tempo di risposta per fogli di calcolo di grandi dimensioni.

Puoi esplorare l’intera definizione OpenAPI qui:
Specifica OpenAPI

Esempio di richiesta cURL

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/pivottables/0/PivotFilters?needReCalculate=true" \
  -X PUT \
  -d '{
        "AutoFilter": {
          "link": { "Href": "https://example.com", "Rel": "self", "Title": "AutoFilter Link", "Type": "application/json" },
          "FilterColumns": [
            {
              "FieldIndex": 0,
              "FilterType": "Value",
              "MultipleFilters": {
                "MatchBlank": true,
                "MultipleFilterList": [ { "Value": "example" } ]
              },
              "ColorFilter": {
                "FilterByFillColor": "FF0000",
                "Pattern": "Solid",
                "Color": {
                  "Color": { "A": 255, "R": 255, "G": 0, "B": 0 },
                  "ColorIndex": 3,
                  "IsShapeColor": false,
                  "ThemeColor": { "ColorType": "Accent1", "Tint": 0 },
                  "Type": "Rgb"
                },
                "ForegroundColorColor": null,
                "BackgroundColor": null
              },
              "CustomFilters": [ { "FilterOperatorType": "Equals", "Value1": "Example" } ],
              "DynamicFilter": { "DynamicFilterType": "Top10" },
              "IconFilter": { "IconId": 1, "IconSetType": "3Arrows" },
              "Top10Filter": { "Criteria": "Top", "IsPercent": true, "IsTop": true, "Items": 10 },
              "Visibledropdown": "true"
            }
          ],
          "Range": "A1:D100",
          "Sorter": {
            "CaseSensitive": false,
            "HasHeaders": true,
            "KeyList": [ { "Key": 0, "SortOrder": "Ascending", "CustomList": null } ],
            "SortLeftToRight": false
          }
        },
        "EvaluationOrder": 0,
        "FieldIndex": 0,
        "FilterType": "Value",
        "MeasureFldIndex": 0,
        "MemberPropertyFieldIndex": 0,
        "Name": "MyFilter",
        "Value1": "10",
        "Value2": "20"
      }' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

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

Famiglia di SDK per il cloud

Utilizzare un SDK è il modo più rapido per sviluppare con Aspose.Cells Cloud. Gli SDK gestiscono i dettagli di basso livello, consentendoti di concentrarti sulla logica di business. 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.

using System;
using System.Threading.Tasks;
using Aspose.Cells.Cloud.Sdk.Api;
using Aspose.Cells.Cloud.Sdk.Model;

public class PivotFilterExample
{
    public static async Task AddPivotFilterAsync()
    {
        // Inizializza il client API (sostituisci con le tue credenziali)
        var config = new Configuration
        {
            ClientId = "YOUR_CLIENT_ID",
            ClientSecret = "YOUR_CLIENT_SECRET"
        };
        var apiInstance = new CellsApi(config);

        // Costruisci l'oggetto filtro
        var filter = new PivotFilter
        {
            AutoFilter = null,
            EvaluationOrder = 0,
            FieldIndex = 1,
            FilterType = "Count"
        };

        // Prepara la richiesta
        var request = new PutWorksheetPivotTableFilterRequest(
            name: "Book1.xlsx",
            sheetName: "PivotSheet",
            pivotTableIndex: 0,
            filter: filter,
            needReCalculate: true,
            folder: "Temp",
            storageName: null);

        // Esegui la richiesta
        var response = await apiInstance.PutWorksheetPivotTableFilterAsync(request);
        Console.WriteLine($"Stato: {response.Status}");
    }
}

Per ulteriori operazioni relative alle tabelle pivot, consulta la documentazione relativa ai filtri Aggiungi, Elimina e Pulisci.

Eliminare una tabella pivot in un foglio Excel