Pivot Tables

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

object (PivotGroup)

Cada agrupamento de linhas na tabela dinâmica.

object (PivotGroup)

Cada agrupamento de colunas na tabela dinâmica.

map (key: integer, value: object ( PivotFilterCriteria))

Um mapeamento opcional de filtros por deslocamento da coluna de origem.

Os filtros são aplicados antes da agregação de dados na tabela dinâmica. A chave do mapa é o deslocamento da coluna do intervalo de origem que você quer filtrar, e o valor são os critérios dessa coluna.

Por exemplo, se a fonte era C10:E15, uma chave de 0 terão o filtro por coluna C, enquanto a chave 1 é para a coluna D.

O uso desse campo foi descontinuado em favor de filterSpecs.

object (PivotFilterSpec)

Os filtros aplicados às colunas de origem antes de agregar os dados à tabela dinâmica.

Ambos criteria e filterSpecs são preenchidos nas respostas. Se ambos os campos forem especificados em uma solicitação de atualização, esse campo terá precedência.

object (PivotValue)

Uma lista de valores a serem incluídos na tabela dinâmica.

enum (PivotValueLayout)

Define se os valores devem ser listados horizontalmente (como colunas) ou verticalmente (como linhas).

object (DataExecutionStatus)

Apenas saída. O status de execução dos dados das tabelas dinâmicas da fonte de dados.

object (GridRange)

O intervalo de leitura de dados da tabela dinâmica.

string

O ID da fonte de dados da qual a tabela dinâmica está lendo os dados.

boolean

Verdadeiro se a tabela dinâmica precisar incluir os totais desse agrupamento.

object (PivotGroupValueMetadata)

Metadados sobre os valores no agrupamento.

enum (SortOrder)

A ordem em que os valores desse grupo precisam ser classificados.

object (PivotGroupSortValueBucket)

O bucket do grupo dinâmico oposto para classificar. Se não for especificado, a classificação será alfabética pelos valores desse grupo.

boolean

Verdadeiro se os títulos deste grupo dinâmico precisarem ser repetidos. Isso é válido apenas para agrupamentos de linhas e é ignorado pelas colunas.

Por padrão, minimizamos a repetição de títulos ao não mostrar cabeçalhos de níveis superiores onde são iguais. Por exemplo, embora a terceira linha abaixo corresponda a "Q1 Mar", "Q1" não é mostrada porque é redundante com as linhas anteriores. A definição de repeatHeadings como "true" faria com que "Q1" fosse repetido para "Fev" e "Mar".

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+

string

Os rótulos a serem usados para os grupos de linha/coluna que podem ser personalizados. Por exemplo, na tabela dinâmica a seguir, o rótulo da linha é Region (que pode ser renomeada como State) e o rótulo da coluna é Product (que pode ser renomeada Item). As tabelas dinâmicas criadas antes de dezembro de 2017 não têm rótulos de cabeçalho. Se você quiser adicionar rótulos de cabeçalho a uma tabela dinâmica existente, exclua a tabela dinâmica existente e crie uma nova tabela dinâmica com os mesmos parâmetros.

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+

object (PivotGroupRule)

A regra de grupo a ser aplicada a esse grupo de linhas/colunas.

object (PivotGroupLimit)

O limite de contagem em linhas ou colunas que serão aplicadas a este grupo dinâmico.

integer

O deslocamento da coluna do intervalo de origem em que esse agrupamento se baseia.

Por exemplo, se a origem for C10:E15, um sourceColumnOffset de 0 significa que esse grupo se refere à coluna C, enquanto o deslocamento 1 se refere à coluna D.

object (DataSourceColumnReference)

A referência à coluna da fonte de dados na qual esse agrupamento se baseia.

object (ExtendedValue)

O valor calculado ao qual os metadados correspondem. (Observe que formulaValue não é válido, porque os valores serão calculados.)

boolean

Verdadeiro se os dados correspondentes ao valor estiverem recolhidos.

integer

O deslocamento na PivotTable.values lista pelos quais os valores nesse agrupamento devem ser classificados.

object (ExtendedValue)

Determina o bucket a partir do qual os valores são escolhidos para classificação.

Por exemplo, em uma tabela dinâmica com um grupo de linhas e dois grupos de colunas, o grupo de linhas pode listar até dois valores. O primeiro valor corresponde a um valor no primeiro grupo de colunas, e o segundo valor corresponde a um valor no segundo grupo de colunas. Se nenhum valor for listado, isso indicará que a linha precisa ser classificada de acordo com o "Total geral" nos grupos de colunas. Se um único valor for listado, isso corresponderia ao uso do atributo "Total" do bucket.

object (ManualRule)

Um ManualRule:

object (HistogramRule)

Um HistogramRule.

object (DateTimeRule)

Um DateTimeRule.

object (ManualRuleGroup)

A lista de nomes de grupos e os itens correspondentes dos dados de origem que são mapeados para cada nome de grupo.

object (ExtendedValue)

O nome do grupo, que precisa ser uma string. Cada grupo em um determinado ManualRule precisa ter um nome exclusivo.

object (ExtendedValue)

Os itens nos dados de origem que precisam ser colocados neste grupo. Cada item pode ser uma string, um número ou um booleano. Os itens podem aparecer em no máximo um grupo de determinado ManualRule: Os itens que não aparecem em nenhum grupo aparecerão por conta própria.

number

o tamanho dos buckets criados; Precisa ser positivo.

number

O valor mínimo em que os itens são colocados em buckets de tamanho constante. Os valores abaixo do início são agrupados em um único bucket. Este campo é opcional.

number

O valor máximo em que os itens são colocados em buckets de tamanho constante. Os valores acima do final são agrupados em um único bucket. Este campo é opcional.

enum (DateTimeRuleType)

O tipo de agrupamento de data e hora a ser aplicado.

integer

O limite de contagem.

integer

A ordem em que o limite do grupo é aplicado à tabela dinâmica.

Os limites do grupo de pivots são aplicados do número de ordem mais baixo para o mais alto. Números de ordem são normalizados para números inteiros consecutivos a partir de 0.

Na solicitação de gravação, para personalizar totalmente os pedidos aplicados, todos os limites do grupo dinâmico devem ter esse campo definido com um número exclusivo. Caso contrário, a ordem é determinada pelo índice na lista PivotTable.rows e depois na lista PivotTable.columns.

string

Valores que devem ser incluídos. Os valores não listados aqui são excluídos.

object (BooleanCondition)

Uma condição que precisa ser verdadeira para que os valores sejam mostrados. O visibleValues não substitui esse comportamento. Mesmo que um valor seja listado, ele ainda fica oculto se não atender à condição.

Os valores de condição que se referem a intervalos na notação A1 são avaliados em relação à planilha da tabela dinâmica. As referências são tratadas de forma absoluta e, portanto, não são preenchidas na tabela dinâmica. Por exemplo, um valor de condição de =A1 na "Tabela dinâmica 1" é tratado como 'Pivot Table 1'!$A$1.

Os dados de origem da tabela dinâmica podem ser referenciados pelo nome do cabeçalho da coluna. Por exemplo, se os dados de origem tiverem colunas chamadas "Receita" e "Custo" e uma condição for aplicada à coluna "Receita" com o tipo NUMBER_GREATER e o valor =Cost, apenas as colunas em que "Receita" > "Custo" serão incluídas.

boolean

Indica se os valores ficam visíveis por padrão. Se for verdadeiro, o visibleValues será ignorado, e todos os valores que atenderem condition (se especificado) serão mostrados. Se for falso, os valores que estiverem em visibleValues e atenderem a condition serão mostrados.

object (PivotFilterCriteria)

Os critérios da coluna.

integer

O deslocamento de coluna baseado em zero do intervalo de origem.

object (DataSourceColumnReference)

A referência à coluna da fonte de dados.

enum (PivotValueSummarizeFunction)

Uma função para resumir o valor. Se formula estiver definido, os únicos valores aceitos serão SUM e CUSTOM. Se sourceColumnOffset estiver definido, CUSTOM não tem suporte.

string

Um nome a ser usado para o valor.

enum (PivotValueCalculatedDisplayType)

Se especificado, indica que os valores de pivot precisam ser mostrados como o resultado de um cálculo com outro valor de pivot. Por exemplo, se computeDisplayType for especificado como PERCENT_OF_GRAND_TOTAL, todos os valores dinâmicos serão exibidos como a porcentagem do total geral. No editor do Planilhas, isso é chamado de "Mostrar como" na seção de valor de uma tabela dinâmica.

integer

O deslocamento da coluna do intervalo de origem que esse valor lê.

Por exemplo, se a origem for C10:E15, um sourceColumnOffset de 0 significa que esse valor se refere à coluna C, enquanto o deslocamento 1 se refere à coluna D.

string

Uma fórmula personalizada para calcular o valor. A fórmula precisa começar com um caractere =.

object (DataSourceColumnReference)

A referência à coluna da fonte de dados usada para a leitura desse valor.