You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -69,6 +70,58 @@ Field name|Mandatory|Description|
69
70
- click on ``Save`` button for saving your credentials
70
71
71
72
## Triggers
73
+
74
+
### Get Updated Objects Polling
75
+
### Config Fields
76
+
***Object Type** Dropdown: Indicates Object Type to be fetched
77
+
***Include linked objects** Multiselect dropdown: list with all the related child and parent objects of the selected object type. List entries are given as `Object Name/Reference To (Relationship Name)`. Select one or more related objects, which will be join queried and included in the response from your Salesforce Organization. Please see the **Limitations** section below for use case advisories.
78
+
***Emit behavior** Dropdown: Indicates emit objects individually or emit by page
79
+
***Start Time** - TextField (string, optional): Indicates the beginning time to start retrieving events from in ISO 8601 Date time utc format - YYYY-MM-DDThh:mm:ssZ
80
+
***End Time** - TextField (string, optional, defaults to never): If provided, don’t fetch records modified after this time in ISO 8601 Date time utc format - YYYY-MM-DDThh:mm:ssZ
81
+
***Size of Polling Page** - TextField (optional, positive integer, max 10000, defaults to 10000): Indicates the size of pages to be fetched
82
+
***Process Single Page Per Execution** - Checkbox: Indicates that if the number of changed records exceeds the maximum number of results in a page, instead of fetching the next page immediately, wait until the next flow start to fetch the next page
83
+
84
+
#### Output Metadata
85
+
- For `Fetch page`: An object with key ***results*** that has an array as its value
86
+
- For `Emit Individually`: Each object fill the entire message
87
+
88
+
### Limitations
89
+
* If records reach `Size of Polling Page` flow will find largest update date and use it as `Start Time` for next iterations, results with this date will be excluded from that iteration and include in the next one.
90
+
* If all records from one iteration will have same 'LastModifiedDate' they will be proceed, but all objects in the next iteration will start from date strictly greater than this, to avoid this use bigger `Size of Polling Page`
91
+
* Highly not recommended use very small (less than 5) `Size of Polling Page` (look at previous point)
92
+
* When a binary field (primitive type `base64`, e.g. Documents, Attachments, etc) is selected on **Include linked objects**, an error will be thrown: `MALFORMED_QUERY: Binary fields cannot be selected in join queries. Instead of querying objects with binary fields as linked objects (such as children Attachments), try querying them directly.` There is also a limit to the number of linked objects that you can query at once - beyond two or three, depending on the number of fields in the linked objects, Salesforce could potentially return a Status Code 431 or 414 error, meaning the query is too long. Finally, due to a bug with multiselect dropdowns, it is recommended to deselect all of the elements in this field before you change your selection in the *Object* dropdown list.
93
+
94
+
### Query Trigger
95
+
Continuously runs the same SOQL Query and emits results according to ``Output method`` configuration field.
96
+
Use the Salesforce Object Query Language (SOQL) to search your organization’s Salesforce data for specific information.
97
+
SOQL is similar to the SELECT statement in the widely used Structured Query Language (SQL) but is designed specifically for Salesforce data.
98
+
This trigger allows you to interact with your data using SOQL.
99
+
100
+
#### List of Expected Config fields
101
+
102
+
***SOQL Query** - Input field for your SOQL Query
103
+
***Output method** - dropdown list with options: `Emit all` - all found records will be emitted in one array `records`, and `Emit individually` - each found object will be emitted individual. Optional field, defaults to: `Emit individually`.
104
+
105
+
### Subscribe to platform events (REALTIME FLOWS ONLY)
106
+
This trigger will subscribe for any platform Event using Salesforce streaming API.
107
+
108
+
#### Input field description
109
+
***Event object name** - Input field where you should select the type of platform event which you want to subscribe E.g. `My platform event`
110
+
111
+
#### How to create new custom Platform event Entity:
112
+
`Setup --> Integrations --> Platform Events --> New Platform Event`
113
+
114
+
115
+
You can find more detail information in the [Platform Events Intro Documentation](https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_events_intro.htm).
116
+
117
+
#### Limitations:
118
+
At the moment this trigger can be used only for **"Realtime"** flows.
119
+
120
+
### Deprecated triggers
121
+
122
+
<details>
123
+
<summary>Get New and Updated Objects Polling</summary>
124
+
72
125
### Get New and Updated Objects Polling
73
126
Polls existing and updated objects. You can select any custom or built-in object for your Salesforce instance.
74
127
@@ -83,6 +136,7 @@ Polls existing and updated objects. You can select any custom or built-in object
83
136
***Include linked objects** - Multiselect dropdown list with all the related child and parent objects of the selected object type. List entries are given as `Object Name/Reference To (Relationship Name)`. Select one or more related objects, which will be join queried and included in the response from your Salesforce Organization. Please see the **Limitations** section below for use case advisories.
84
137
***Output method** - dropdown list with options: `Emit all` - all found records will be emitted in one array `records`, and `Emit individually` - each found object will be emitted individual. Optional field, defaults to: `Emit individually`.
85
138
***Max Fetch Count** - limit for a number of messages that can be fetched. 1,000 is the default value when the variable is not set.
139
+
86
140
For example, you have 234 “Contact” objects, 213 of them were changed from 2019-01-01.
87
141
You want to select all “Contacts” that were changed from 2019-01-01, set the page size to 100 and process single page per execution.
88
142
For you purpose you need to specify following fields:
@@ -99,31 +153,7 @@ If you select `no` in **Process single page per execution**, all 213 contacts wi
99
153
#### Limitations
100
154
When a binary field (primitive type `base64`, e.g. Documents, Attachments, etc) is selected on **Include linked objects**, an error will be thrown: 'MALFORMED_QUERY: Binary fields cannot be selected in join queries. Instead of querying objects with binary fields as linked objects (such as children Attachments), try querying them directly.' There is also a limit to the number of linked objects that you can query at once - beyond two or three, depending on the number of fields in the linked objects, Salesforce could potentially return a Status Code 431 or 414 error, meaning the query is too long. Finally, due to a bug with multiselect dropdowns, it is recommended to deselect all of the elements in this field before you change your selection in the *Object* dropdown list.
101
155
102
-
### Query Trigger
103
-
Continuously runs the same SOQL Query and emits results according to ``Output method`` configuration field.
104
-
Use the Salesforce Object Query Language (SOQL) to search your organization’s Salesforce data for specific information.
105
-
SOQL is similar to the SELECT statement in the widely used Structured Query Language (SQL) but is designed specifically for Salesforce data.
106
-
This trigger allows you to interact with your data using SOQL.
107
-
108
-
#### List of Expected Config fields
109
-
110
-
***SOQL Query** - Input field for your SOQL Query
111
-
***Output method** - dropdown list with options: `Emit all` - all found records will be emitted in one array `records`, and `Emit individually` - each found object will be emitted individual. Optional field, defaults to: `Emit individually`.
112
-
113
-
### Subscribe to platform events (REALTIME FLOWS ONLY)
114
-
This trigger will subscribe for any platform Event using Salesforce streaming API.
115
-
116
-
#### Input field description
117
-
***Event object name** - Input field where you should select the type of platform event which you want to subscribe E.g. `My platform event`
118
-
119
-
#### How to create new custom Platform event Entity:
120
-
`Setup --> Integrations --> Platform Events --> New Platform Event`
121
-
122
-
123
-
You can find more detail information in the [Platform Events Intro Documentation](https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_events_intro.htm).
124
-
125
-
#### Limitations:
126
-
At the moment this trigger can be used only for **"Realtime"** flows.
156
+
</details>
127
157
128
158
## Actions
129
159
### Bulk Create/Update/Delete/Upsert
@@ -277,6 +307,9 @@ This parameters can be changed by setting environment variables:
277
307
***HASH_LIMIT_TIME** - Hash expiration time in milis
278
308
***HASH_LIMIT_ELEMENTS** - Hash size number limit
279
309
310
+
#### Known limitations
311
+
If `Output method` set to `Emit page` maximum "Page number" must be less or equal to "Page size"/2000
312
+
280
313
### Query Action
281
314
Executing a SOQL Query that may return many objects.
282
315
Use the Salesforce Object Query Language (SOQL) to search your organization’s Salesforce data for specific information.
"description": "Linked objects that you can query at once - beyond two or three, depending on the number of fields in the linked objects."
61
+
},
62
+
"model": "linkedObjectTypes"
63
+
},
64
+
"emitBehavior": {
65
+
"viewClass": "SelectView",
66
+
"order": 12,
67
+
"required": false,
68
+
"label": "Emit Behavior",
69
+
"prompt": "Select an output method. Defaults to: Emit individually",
70
+
"model": {
71
+
"emitIndividually": "Emit individually",
72
+
"fetchPage": "Emit page"
73
+
}
74
+
},
75
+
"startTime": {
76
+
"viewClass": "TextFieldView",
77
+
"label": "Start Time",
78
+
"order": 10,
79
+
"required": false,
80
+
"placeholder": "1970-01-01T00:00:00.000Z",
81
+
"note": "Indicates the beginning time to start polling from, default 1970-01-01T00:00:00.000Z"
82
+
},
83
+
"endTime": {
84
+
"viewClass": "TextFieldView",
85
+
"label": "End Time",
86
+
"order": 8,
87
+
"required": false,
88
+
"placeholder": "3000-01-01T00:00:00.000Z",
89
+
"note": "If provided, do not fetch records modified after this time (defaults to execution time)"
90
+
},
91
+
"pageSize": {
92
+
"required": false,
93
+
"viewClass": "TextFieldView",
94
+
"order": 7,
95
+
"label": "Size of Polling Page",
96
+
"placeholder": "10000",
97
+
"note": "Number of records to be fetched (defaults to 10000). Positive integer only, max 10000 objects"
98
+
},
99
+
"singlePagePerInterval": {
100
+
"viewClass": "CheckBoxView",
101
+
"order": 4,
102
+
"label": "Process Single Page Per Execution",
103
+
"note": "Indicates that if the number of changed records exceeds the maximum number of results in a page, instead of fetching the next page immediately, wait until the next flow start to fetch the next page."
104
+
}
105
+
},
106
+
"dynamicMetadata": true
107
+
},
35
108
"entry": {
36
109
"title": "Get New and Updated Objects Polling",
37
110
"main": "./lib/entry.js",
111
+
"deprecated": true,
38
112
"order": 99,
39
113
"help": {
40
114
"description": "Will poll for existing and updated objects where you can select any custom or build-in object for your Salesforce instance",
0 commit comments