Você está aqui:
Sintaxe de filtro e seleção para painéis integrados
Para especificar filtros ou seleções de painel que exigem strings de JSON, use o atributo Filtrar do componente Painel do CRM Analytics do LWC ou o atributo Filtrar do componente do painel do CRM Analytics integrado do componente do Aura.
Sintaxe do filtro
Use esta sintaxe para filtrar com base em dimensões. Veja abaixo exemplos da sintaxe de valores de medidas e datas para filtros e seleções.
{"datasets" : {
"dataset1": [
{
"fields": ["field1"],
"filter": {
"operator": "in",
"values": ["$value1", "$value2"]
}
}
]
}
}Neste exemplo, o painel filtra o nome da conta na página do registro e exibe apenas os dados relacionados a esse nome de conta.
{"datasets": {
"account":[
{
"fields":["Name"],
"filter": {
"operator": "matches",
"values":["$Name"]
}
}
]
}
}Sintaxe da seleção
Com a opção de seleção, o painel é exibido com todos os seus dados e os valores de dimensão especificados são destacados. A opção de seleção pode ser usada sozinha ou com a opção de filtro. A seleção toma somente valores de dimensão. Para poder usar esta opção, é necessário que o painel inclua uma consulta (etapa) do ID especificado que agrupe pelo nome de grupo especificado. Se uma seleção especificar um valor que não existe ou se a consulta em si não for usada (por exemplo, não estiver anexada a nenhum widget), a entrada de seleção será ignorada e o painel aparecerá sem nenhuma seleção aplicada.
Este exemplo aplica o nome da conta como uma seleção. Com a opção de seleção, o painel exibe todos os seus dados e os valores especificados aparecem destacados ou selecionados no painel.
{"steps" : {
"Account_Step":
{
"metadata": {"groups": ["Name"]},
"values": ["$Name"]
}
}
}Outros exemplos de sintaxe de filtro e seleção
Use esta sintaxe para filtrar ou selecionar com valores de medição.
{
...
"values": [[value1]]
...
}Use esta sintaxe para filtrar ou selecionar com valores do intervalo de datas relativo.
{
...
"values": [["year", 0], ["year", 2]]
...
}Use esta sintaxe para filtrar ou selecionar com valores do intervalo de data relativo aberto.
{
...
"values": [null, ["year", 2]]
...
}Use esta sintaxe para filtrar ou selecionar com intervalo de datas absoluto. Use os horários de época para esse intervalo.
{
...
"values": [[1581033600000, 1585353600000]]
...
}Tabelas de referência de sintaxe
Use estas tabelas para entender a notação da sintaxe de filtros e seleção.
| Notação | Descrição | Notas |
|---|---|---|
datasets
|
Conjuntos de dados do CRM Analytics. Os conjuntos de dados têm fields e um filter, descritos na tabela de Notação de conjuntos de dados. |
Onde encontrar: No Analytics Studio, selecione Editar no conjunto de dados. O Nome do sistema está no painel esquerdo da página de edição para o conjunto de dados. Se sua organização tiver namespaces, inclua o prefixo de namespace e dois sublinhados antes do nome do sistema de conjunto de dados. |
steps
|
Os nomes da etapa a serem mencionados para a seleção. As etapas têm metadata e values, descritas na tabela Notação de etapas. |
Onde encontrar: No Analytics Studio, selecione Editar no painel. Selecione o widget ao qual aplicar a seleção. O nome da etapa é o valor de ID na guia Consulta. |
| Notação de conjuntos de dados | Descrição | Notas |
|---|---|---|
fields
|
Uma lista de dimensões ou medidas no conjunto de dados do CRM Analytics. | Onde encontrar: Clique no ícone Explorar para abrir o widget. Depois, selecione Exibir SAQL no menu de Opções. Para encontrar nomes de dimensões, procure por instruções "agrupar por". Para encontrar nomes de medidas, procure por instruções com funções como "sum" ou "stddev". |
| filtro | O filtro a aplicar aos dados do painel. Os filtros têm operators e values, descritos na tabela de Notação de filtro. |
O filtro toma valores de dimensão ou medição, descritos na próxima tabela. |
| Notação de filtro | Descrição | Notas |
|---|---|---|
operator
|
O operador de filtro. | Operadores compatíveis para dimensões: in, not in, matches Operadores compatíveis para medidas: |
| valores | Os valores a serem usados para o filtro. É possível especificar esses valores estatisticamente ou inseri-los de modo dinâmico usando o contexto da página com o prefixo $, como $<FieldName>. |
Onde encontrar: Em Configuração, encontre o objeto que deseja e selecione Campos. Use o Nome do campo, também conhecido como nome de API. Para campos personalizados, use o nome com "__c" no final. |
| Notação de etapas | Descrição | Notas |
|---|---|---|
metadata
|
Os metadados da etapa. |
Os |
values
|
A lista de valores de etapa a serem usados para a seleção. É possível especificar esses valores da etapa estatisticamente ou inseri-los de modo dinâmico usando o contexto da página com o prefixo |
Onde encontrar: Em Configuração, encontre o objeto que deseja e selecione Campos. Use o Nome do campo, também conhecido como nome de API. Para campos personalizados, use o nome com "__c" no final. |
{ "datasetSystemName1": {"field1": ["$value1"]}, "datasetSystemName2": {"field1": ["$value1", "$value2"],"field2": ["$value3"]} } Por exemplo:
{"opportunity": {"AccountId': ["$Id"]}}Impedir que os usuários exponham mais dados bloqueando ou ocultando filtros. Com a opção Bloqueado, o menu Filtros aparece no cabeçalho de painel integrado, mas os usuários não podem modificar nem excluir os filtros. Com a opção Oculto, o menu Filtros não aparece no cabeçalho do painel integrado.
Opções bloqueadas e ocultas podem ser usadas apenas para filtros, não para seleções. Adicione as opções no JSON do filtro com um valor booleano. Por exemplo, “locked”:false,”hidden”:true
Ao configurar filtros bloqueados ou ocultos para painéis integrados, lembre-se destes aspectos.
- Filtros bloqueados e ocultos são aplicados no painel. Se um filtro tornar um campo visível, os usuários verão o campo mesmo quando você tem acesso restrito a filtros com uma destas opções.
- Opções bloqueadas e ocultas não são aplicadas automaticamente em painéis vinculados ou explorações do lens. As opções são aplicadas apenas no painel no qual foram especificadas.
- Opções bloqueadas e ocultas são aplicadas a um painel quando integradas ou abertas no CRM Analytics Studio ou guia do Analytics.
- Quando filtros bloqueados ou ocultos são aplicados ao painel, o menu Minhas visualizações não fica visível aos usuários.

