Loading
CRM Analytics
Strukturerat filter i sfdcDigest-transformation

Du är här:

  1. Salesforce-hjälp
  2. Dokument
  3. CRM Analytics

Strukturerat filter i sfdcDigest-transformation

Du definierar ett strukturerat filter med JSON-syntax.

Ett strukturerat filter använder följande JSON-syntax för varje filtervillkor.

{ 
"field": "<field name>", 
"operator": "<operator>", 
"value": "<value>"|"["<value 1>", "<value 2>"]", 
"isQuoted": true|false}

Värdet kan vara ett nummer, datum, en sträng, lista över strängar eller ett datumformat. CRM Analytics citerar automatiskt strängar om du inte ställer in isQuoted till sant, vilket indikerar att strängen redan är citerad.

Du kan använda en av följande operatörer i ett filtervillkor.

Operator Kommentar
=

Filtervillkor är sant om värdet i fältet är lika med det specificerade värdet. Strängjämförelser som använder operatören Lika med är inte skiftlägeskänsliga.

Exempel:

"filterConditions": [
   {
   "field": "OwnerId",
   "operator": "=",
   "value": "0056A0000020jzDQAQ" 
   }
]
!=

Filtervillkor är sant om värdet i fältet inte är lika med det specificerade värdet.

Exempel (med omvända snedstreck (\) som läcktecken för att undanta dubbla citattecken i ett strängvärde): 

"filterConditions": [
   {
   "field": "Nickname__c",
   "operator": "!=",
   "value": "\"Sammy\"" 
   }
]
>

Filtervillkor är sant om värdet i fältet är större än det specificerade värdet.

Exempel: 

"filterConditions": [
   {
   "field": "Amount",
   "operator": ">",
   "value": "100000"
   }
]
<

Filtervillkor är sant om värdet i fältet är mindre än det specificerade värdet.

Exempel (med ett datumformat): 

"filterConditions": [
   {
   "field": "CloseDate",
   "operator": "<",
   "value": "THIS_MONTH",
   "isQuoted": false 
   }
]
>=

Filtervillkor är sant om värdet i fältet är större än eller lika med det specificerade värdet.

Exempel: 

"filterConditions": [
   {
   "field": "Amount",
   "operator": ">=",
   "value": "100000"
   }
]
<=

Filtervillkor är sant om värdet i fältet är mindre än eller lika med det specificerade värdet.

Exempel (med en SOQL-funktion): 

"filterConditions": [
   {
   "field": "CALENDAR_YEAR (CreatedDate)",
   "operator": "<=",
   "value": "2015",
   "isQuoted": true
   }
]
LIKE

Filtervillkor är sant om värdet i fältet matchar det specificerade värdet. Operatören LIKE liknar operatören LIKE operator i SQL; den tillhandahåller en mekanism för att matcha partiella textsträngar och stöder jokertecken.

  • Jokertecknen % och _ stöds för LIKE operatören.
  • Jokertecknet % står för noll eller flera tecken.
  • Jokertecknet _ står för exakt 1 tecken.
  • Operatören LIKE stöds endast för strängfält.
  • Operatören LIKE utför en matchning som inte är skiftlägeskänslig.
  • Operatören LIKE stöder läcktecken för att undanta specialtecknen % eller _. Använd ett omvänt snedstreck (\) som läcktecken för att undanta specialtecken.

Exempel:

"filterConditions": [
   {
   "field": "FirstName",
   "operator": "LIKE",
   "value": "Chris%" 
   }
 ]
IN

Filtervillkor är sant om värdet i fältet stämmer överens med något av värdena i den specificerade listan. Du kan specificera en citerad eller icke-citerad lista över värden. Om listan citeras, sätt isQuoted till sant.

Exempel: 

"filterConditions": [
   {
   "field": "StageName",
   "operator": "IN",
   "value": ["Closed Won", "Closed Lost"] 
   }
]
NOT IN

Filtervillkor är sant om värdet i fältet inte stämmer överens med något av värdena i den specificerade listan.

Exempel: 

"filterConditions": [
   {
   "field": "BillingState",
   "operator": "NOT IN",
   "value": ["California", "New York"] 
   }
]
INCLUDES

Endast för kombinationsrutor eller kombinationsrutor med flerval. Filtervillkor är sant om värdet i kombinationsrutan matchar det specificerade värdet.

Exempel: 

"filterConditions": [
   {
   "field": "BillingState",
   "operator": "INCLUDES",
   "value": ["California"] 
   }
]
EXCLUDES

Endast för kombinationsrutor eller kombinationsrutor med flerval. Filtervillkor är sant om värdet i kombinationsrutan utesluter det specificerade värdet.

Exempel: 

"filterConditions": [
   {
   "field": "BillingState",
   "operator": "EXCLUDES",
   "value": ["California", "New York"] 
   }
]

Vi tar några exempel på strukturerade filter.

Exempel
Exempel Här är ett exempel med ett grundläggande strukturerat filter. För att utföra pipelineanalys på säljprojekt i räkenskapskvartal 2 av räkenskapsår 2015 skapar du denna definitionsfil för dataflöde för att skapa den relevanta datauppsättningen.
{
   "Extract_Filtered_Opportunities": {        
      "action": "sfdcDigest",        
      "parameters": {            
         "object": "Opportunity",
         "fields": [                
            { "name": "Id" },                
            { "name": "Name" }, 
            { "name": "AccountId" },               
            { "name": "Amount" },                
            { "name": "StageName" },                
            { "name": "CloseDate" },                
            { "name": "OwnerId" },
            { "name": "FiscalYear" },
            { "name": "FiscalQuarter" },
            { "name": "SystemModstamp" }            
         ],
         "filterConditions": [
               {
                  "field": "FiscalYear",
                  "operator": "=",
                  "value": "2015"
               },
               {
                  "field": "FiscalQuarter",
                  "operator": "=",
                  "value": "2"
               }
         ]
      }    
   },    
   "Register_Opportunities_Dataset": {        
      "action": "sfdcRegister",        
      "parameters": {            
         "alias": "Opportunities_2015Q2",            
         "name": "Opportunities_2015Q2",            
         "source": "Extract_Filtered_Opportunities"        
      }
   } 
}
Anteckning
Anteckning Om du inte anger en logisk operator för flera filtervillkor – vilket är fallet i detta exempel – tillämparCRM Analytics AND mellan villkoren.
Exempel
Exempel Vi tar ett exempel på ett strukturerat filter med en logisk operatör. För att hjälpa till att prognosticera förväntad avkastning skapar du detta dataflöde för att visa alla säljprojekt som antingen har avslutats eller har 90% sannolikhet att avslutas.
{
   "Extract_Opportunities": {        
      "action": "sfdcDigest",        
      "parameters": {            
         "object": "Opportunity",
         "fields": [                
            { "name": "Id" },                
            { "name": "Name" }, 
            { "name": "AccountId" },               
            { "name": "Amount" },                
            { "name": "StageName" },                
            { "name": "CloseDate" },                
            { "name": "OwnerId" },
            { "name": "Probability" },
            { "name": "FiscalYear" },
            { "name": "FiscalQuarter" }          
         ],
         "filterConditions": [
            {
               "operator": "OR",
               "conditions": [
                  {
                     "field": "StageName",
                     "operator": "=",
                     "value": "Closed Won"
                  },
                  {
                     "field": "Probability",
                     "operator": ">=",
                     "value": "90"
                  }
               ]
            }
         ]
      }    
   },    
   "Register_Opportunities_Dataset": {        
      "action": "sfdcRegister",        
      "parameters": {            
         "alias": "OpportunitiesExpectedToWin",            
         "name": "OpportunitiesExpectedToWin",            
         "source": "Extract_Opportunities"        
      }
   } 
}
Exempel
Exempel Till sist tar vi ett exempel på ett strukturerat filter med en kapslad logisk operatör. Du skapar detta dataflöde för att visa alla säljprojekt som är avslutade i nuvarande räkenskapskvartal och som ägs av någon av dina två direkta rapporter.
{
    "Extract_Opportunities": {
        "action": "sfdcDigest",
        "parameters": {
            "object": "Opportunity",
            "fields": [
                { "name": "Id" },
                { "name": "Name" },
                { "name": "AccountId" },
                { "name": "Amount" },
                { "name": "StageName" },
                { "name": "CloseDate" },
                { "name": "OwnerId" },
                { "name": "FiscalYear" },
                { "name": "FiscalQuarter" }
            ],
            "filterConditions": [
                {
                    "operator": "AND",
                    "conditions": [
                        {
                            "field": "CloseDate",
                            "operator": "=",
                            "value": "THIS_FISCAL_QUARTER",
                            "isQuoted": false
                        },
                        {
                            "operator": "OR",
                            "conditions": [
                                {
                                    "field": "OwnerId",
                                    "operator": "=",
                                    "value": "0056A0000020jzDQAQ"
                                },
                                {
                                    "field": "OwnerId",
                                    "operator": "=",
                                    "value": "0056A0000020jzGQAQ"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    },
    "Register_Opportunities_Dataset": {
        "action": "sfdcRegister",
        "parameters": {
            "alias": "DirectReport_Opportunities",
            "name": "DirectReport_Opportunities",
            "source": "Extract_Opportunities"
        }
    }
}
 
Laddar
Salesforce Help | Article