ampscript-data 3.7.0 → 4.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -0
- package/package.json +2 -2
- package/src/constants.js +63 -0
- package/src/derived.js +100 -0
- package/src/functions/content.js +1039 -0
- package/src/functions/data-extension.js +1118 -0
- package/src/functions/date-time.js +416 -0
- package/src/functions/einstein-email-recs.js +32 -0
- package/src/functions/encryption-encoding.js +550 -0
- package/src/functions/http.js +342 -0
- package/src/functions/index.js +203 -0
- package/src/functions/marketing-cloud-api.js +378 -0
- package/src/functions/math.js +167 -0
- package/src/functions/microsoft-dynamics.js +400 -0
- package/src/functions/mobileconnect.js +339 -0
- package/src/functions/sales-service-cloud.js +230 -0
- package/src/functions/social.js +151 -0
- package/src/functions/string.js +432 -0
- package/src/functions/utility.js +1120 -0
- package/src/globals.js +9 -0
- package/src/index.js +41 -7235
- package/src/keywords.js +121 -0
- package/src/operators.js +66 -0
- package/src/personalization.js +254 -0
|
@@ -0,0 +1,400 @@
|
|
|
1
|
+
// AUTO-SPLIT from the original single-file src/index.js. Data moved verbatim.
|
|
2
|
+
// AMPscript FUNCTIONS — category: Microsoft Dynamics CRM (9 entries).
|
|
3
|
+
|
|
4
|
+
import { INF } from '../constants.js';
|
|
5
|
+
|
|
6
|
+
export const MICROSOFT_DYNAMICS_FUNCTIONS = [
|
|
7
|
+
{
|
|
8
|
+
name: 'AddMscrmListMember',
|
|
9
|
+
supportedInCloudPage: false,
|
|
10
|
+
supportedInEmail: false,
|
|
11
|
+
mcnSince: null,
|
|
12
|
+
handlebarsEquivalent: null,
|
|
13
|
+
mcnNotes: null,
|
|
14
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-mscrm/mc-ampscript-reference-microsoft-dynamics-crm-add-list-member.html',
|
|
15
|
+
guideUrl: 'https://ampscript.guide/addmscrmlistmember/',
|
|
16
|
+
minArgs: 2,
|
|
17
|
+
maxArgs: 2,
|
|
18
|
+
category: 'Microsoft Dynamics CRM',
|
|
19
|
+
description: 'Appends a member to a Dynamics CRM list.',
|
|
20
|
+
params: [
|
|
21
|
+
{
|
|
22
|
+
name: 'recordGuid',
|
|
23
|
+
description: 'The GUID of the record that you want to add to the marketing list',
|
|
24
|
+
type: 'string',
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
name: 'listGuid',
|
|
28
|
+
description: 'The GUID of the marketing list that you want to add the record to',
|
|
29
|
+
type: 'string',
|
|
30
|
+
},
|
|
31
|
+
],
|
|
32
|
+
returnType: 'void',
|
|
33
|
+
returnDescription: 'No value is returned.',
|
|
34
|
+
syntax: 'AddMscrmListMember(recordGuid, listGuid)',
|
|
35
|
+
example:
|
|
36
|
+
'%%[\n' +
|
|
37
|
+
'var @member = "43b4a7c9-7360-4753-955f-738bd89934b5"\n' +
|
|
38
|
+
'var @list = "fdc5dfe4-e5e1-48af-87a1-4ac10433e895"\n' +
|
|
39
|
+
'AddMscrmListMember(@member, @list)\n' +
|
|
40
|
+
']%%',
|
|
41
|
+
isConfirmed: true,
|
|
42
|
+
nonFunctionalAtRuntime: true,
|
|
43
|
+
deprecated: true,
|
|
44
|
+
deprecatedReason:
|
|
45
|
+
'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
name: 'CreateMSCRMRecord',
|
|
49
|
+
supportedInCloudPage: false,
|
|
50
|
+
supportedInEmail: false,
|
|
51
|
+
mcnSince: null,
|
|
52
|
+
handlebarsEquivalent: null,
|
|
53
|
+
mcnNotes: null,
|
|
54
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-mscrm/mc-ampscript-reference-microsoft-dynamics-crm-create-record.html',
|
|
55
|
+
guideUrl: 'https://ampscript.guide/createmscrmrecord/',
|
|
56
|
+
minArgs: 4,
|
|
57
|
+
maxArgs: INF,
|
|
58
|
+
category: 'Microsoft Dynamics CRM',
|
|
59
|
+
description: 'Creates a new record in Microsoft Dynamics CRM.',
|
|
60
|
+
params: [
|
|
61
|
+
{
|
|
62
|
+
name: 'entityName',
|
|
63
|
+
description: 'The name of the Microsoft Dynamics CRM entity',
|
|
64
|
+
type: 'string',
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
name: 'numFields',
|
|
68
|
+
description: 'The number of name and value pairs of fields to create',
|
|
69
|
+
type: 'number',
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
name: 'attributeName1',
|
|
73
|
+
description: 'The name of the first attribute to populate in the record',
|
|
74
|
+
type: 'string',
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
name: 'attributeValue1',
|
|
78
|
+
description: 'The value of the first attribute to populate in the record',
|
|
79
|
+
},
|
|
80
|
+
{
|
|
81
|
+
name: 'attributeNameN',
|
|
82
|
+
mcnSince: null,
|
|
83
|
+
mcnNotes: null,
|
|
84
|
+
description: 'Additional attribute name',
|
|
85
|
+
type: 'string',
|
|
86
|
+
optional: true,
|
|
87
|
+
},
|
|
88
|
+
{ name: 'attributeValueN', description: 'Additional attribute value', optional: true },
|
|
89
|
+
],
|
|
90
|
+
returnType: 'string',
|
|
91
|
+
returnDescription: 'The GUID of the newly created Microsoft Dynamics CRM record.',
|
|
92
|
+
repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1, countParam: 'numFields' }],
|
|
93
|
+
syntax: 'CreateMSCRMRecord(entityName, numFields, attributeName1, attributeValue1[, attributeNameN, attributeValueN, ...])',
|
|
94
|
+
example: "%%=CreateMSCRMRecord('contact', 1, 'lastname', 'Smith')=%%",
|
|
95
|
+
isConfirmed: true,
|
|
96
|
+
nonFunctionalAtRuntime: true,
|
|
97
|
+
deprecated: true,
|
|
98
|
+
deprecatedReason:
|
|
99
|
+
'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
name: 'DescribeMSCRMEntities',
|
|
103
|
+
supportedInCloudPage: false,
|
|
104
|
+
supportedInEmail: false,
|
|
105
|
+
mcnSince: null,
|
|
106
|
+
handlebarsEquivalent: null,
|
|
107
|
+
mcnNotes: null,
|
|
108
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-mscrm/mc-ampscript-reference-microsoft-dynamics-crm-describe-entities.html',
|
|
109
|
+
guideUrl: 'https://ampscript.guide/describemscrmentities/',
|
|
110
|
+
minArgs: 0,
|
|
111
|
+
maxArgs: 0,
|
|
112
|
+
category: 'Microsoft Dynamics CRM',
|
|
113
|
+
description: 'Returns a rowset describing all available Dynamics CRM entity types.',
|
|
114
|
+
params: [],
|
|
115
|
+
returnType: 'rowset',
|
|
116
|
+
returnDescription: 'A rowset describing the available Microsoft Dynamics CRM entities.',
|
|
117
|
+
syntax: 'DescribeMSCRMEntities()',
|
|
118
|
+
example: '%%[ SET @entities = DescribeMSCRMEntities() ]%%',
|
|
119
|
+
isConfirmed: true,
|
|
120
|
+
nonFunctionalAtRuntime: true,
|
|
121
|
+
deprecated: true,
|
|
122
|
+
deprecatedReason:
|
|
123
|
+
'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
|
|
124
|
+
},
|
|
125
|
+
{
|
|
126
|
+
name: 'DescribeMSCRMEntityAttributes',
|
|
127
|
+
supportedInCloudPage: false,
|
|
128
|
+
supportedInEmail: false,
|
|
129
|
+
mcnSince: null,
|
|
130
|
+
handlebarsEquivalent: null,
|
|
131
|
+
mcnNotes: null,
|
|
132
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-mscrm/mc-ampscript-reference-microsoft-dynamics-crm-describe-entity-attributes.html',
|
|
133
|
+
guideUrl: 'https://ampscript.guide/describemscrmentityattributes/',
|
|
134
|
+
minArgs: 1,
|
|
135
|
+
maxArgs: 1,
|
|
136
|
+
category: 'Microsoft Dynamics CRM',
|
|
137
|
+
description: 'Returns a rowset of attributes for the specified CRM entity type.',
|
|
138
|
+
params: [{ name: 'entityType', description: 'CRM entity type name', type: 'string' }],
|
|
139
|
+
returnType: 'rowset',
|
|
140
|
+
returnDescription: 'A rowset describing the attributes of the requested CRM entity.',
|
|
141
|
+
syntax: 'DescribeMSCRMEntityAttributes(entityType)',
|
|
142
|
+
example: "%%[ SET @attrs = DescribeMSCRMEntityAttributes('contact') ]%%",
|
|
143
|
+
isConfirmed: true,
|
|
144
|
+
nonFunctionalAtRuntime: true,
|
|
145
|
+
deprecated: true,
|
|
146
|
+
deprecatedReason:
|
|
147
|
+
'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
|
|
148
|
+
},
|
|
149
|
+
{
|
|
150
|
+
name: 'RetrieveMSCRMRecords',
|
|
151
|
+
supportedInCloudPage: false,
|
|
152
|
+
supportedInEmail: false,
|
|
153
|
+
mcnSince: null,
|
|
154
|
+
handlebarsEquivalent: null,
|
|
155
|
+
mcnNotes: null,
|
|
156
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-mscrm/mc-ampscript-reference-microsoft-dynamics-crm-retrieve-records.html',
|
|
157
|
+
guideUrl: 'https://ampscript.guide/retrievemscrmrecords/',
|
|
158
|
+
minArgs: 5,
|
|
159
|
+
maxArgs: 5,
|
|
160
|
+
category: 'Microsoft Dynamics CRM',
|
|
161
|
+
description: 'Retrieves records from Dynamics CRM using a simple filter.',
|
|
162
|
+
params: [
|
|
163
|
+
{
|
|
164
|
+
name: 'entityName',
|
|
165
|
+
description:
|
|
166
|
+
'The name of the Microsoft Dynamics CRM entity to retrieve records from',
|
|
167
|
+
type: 'string',
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
name: 'fieldsToRetrieve',
|
|
171
|
+
mcnSince: null,
|
|
172
|
+
mcnNotes: null,
|
|
173
|
+
description: 'A comma-separated list of fields to retrieve',
|
|
174
|
+
type: 'string',
|
|
175
|
+
},
|
|
176
|
+
{
|
|
177
|
+
name: 'queryFieldName',
|
|
178
|
+
description: 'The name of the field to filter on',
|
|
179
|
+
type: 'string',
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
name: 'queryFieldOperator',
|
|
183
|
+
description: 'The operator to use for the filter',
|
|
184
|
+
type: 'string',
|
|
185
|
+
},
|
|
186
|
+
{ name: 'queryFieldValue', description: 'The value to filter on' },
|
|
187
|
+
],
|
|
188
|
+
returnType: 'rowset',
|
|
189
|
+
returnDescription: 'A rowset of matching Microsoft Dynamics CRM records.',
|
|
190
|
+
syntax: 'RetrieveMSCRMRecords(entityName, fieldsToRetrieve, queryFieldName, queryFieldOperator, queryFieldValue)',
|
|
191
|
+
example:
|
|
192
|
+
"%%[ SET @rows = RetrieveMSCRMRecords('contact', 'fullname,emailaddress1', 'lastname', 'eq', 'Smith') ]%%",
|
|
193
|
+
isConfirmed: true,
|
|
194
|
+
nonFunctionalAtRuntime: true,
|
|
195
|
+
deprecated: true,
|
|
196
|
+
deprecatedReason:
|
|
197
|
+
'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
|
|
198
|
+
},
|
|
199
|
+
{
|
|
200
|
+
name: 'RetrieveMSCRMRecordsFetchXML',
|
|
201
|
+
supportedInCloudPage: false,
|
|
202
|
+
supportedInEmail: false,
|
|
203
|
+
mcnSince: null,
|
|
204
|
+
handlebarsEquivalent: null,
|
|
205
|
+
mcnNotes: null,
|
|
206
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-mscrm/mc-ampscript-reference-microsoft-dynamics-crm-retrieve-records-fetch-xml.html',
|
|
207
|
+
guideUrl: 'https://ampscript.guide/retrievemscrmrecordsfetchxml/',
|
|
208
|
+
minArgs: 1,
|
|
209
|
+
maxArgs: 1,
|
|
210
|
+
category: 'Microsoft Dynamics CRM',
|
|
211
|
+
description: 'Retrieves records from Dynamics CRM using a FetchXML query.',
|
|
212
|
+
params: [{ name: 'fetchXml', description: 'FetchXML query string', type: 'string' }],
|
|
213
|
+
returnType: 'rowset',
|
|
214
|
+
returnDescription: 'A rowset of CRM records matching the FetchXML query.',
|
|
215
|
+
syntax: 'RetrieveMSCRMRecordsFetchXML(fetchXml)',
|
|
216
|
+
example: '%%[ SET @rows = RetrieveMSCRMRecordsFetchXML(@fetchXml) ]%%',
|
|
217
|
+
isConfirmed: true,
|
|
218
|
+
nonFunctionalAtRuntime: true,
|
|
219
|
+
deprecated: true,
|
|
220
|
+
deprecatedReason:
|
|
221
|
+
'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
|
|
222
|
+
},
|
|
223
|
+
{
|
|
224
|
+
name: 'SetStateMscrmRecord',
|
|
225
|
+
supportedInCloudPage: false,
|
|
226
|
+
supportedInEmail: false,
|
|
227
|
+
mcnSince: null,
|
|
228
|
+
handlebarsEquivalent: null,
|
|
229
|
+
mcnNotes: null,
|
|
230
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-mscrm/mc-ampscript-reference-microsoft-dynamics-crm-set-state-record.html',
|
|
231
|
+
guideUrl: 'https://ampscript.guide/setstatemscrmrecord/',
|
|
232
|
+
minArgs: 4,
|
|
233
|
+
maxArgs: 4,
|
|
234
|
+
category: 'Microsoft Dynamics CRM',
|
|
235
|
+
description: 'Sets the state and status of a Dynamics CRM record.',
|
|
236
|
+
params: [
|
|
237
|
+
{
|
|
238
|
+
name: 'recordGuid',
|
|
239
|
+
description: 'The GUID of the record to set the state and status of',
|
|
240
|
+
type: 'string',
|
|
241
|
+
},
|
|
242
|
+
{
|
|
243
|
+
name: 'entityName',
|
|
244
|
+
description: 'The name of the Microsoft Dynamics CRM entity',
|
|
245
|
+
type: 'string',
|
|
246
|
+
},
|
|
247
|
+
{
|
|
248
|
+
name: 'stateToSet',
|
|
249
|
+
description: 'The state to set for the record.',
|
|
250
|
+
type: 'string',
|
|
251
|
+
enum: ['active', 'inactive'],
|
|
252
|
+
},
|
|
253
|
+
{
|
|
254
|
+
name: 'statusToSet',
|
|
255
|
+
description: 'The status to set for the record.',
|
|
256
|
+
type: 'number',
|
|
257
|
+
enum: [0, 1, -1],
|
|
258
|
+
},
|
|
259
|
+
],
|
|
260
|
+
returnType: 'void',
|
|
261
|
+
returnDescription: 'No value is returned; the record state and status are updated.',
|
|
262
|
+
syntax: 'SetStateMscrmRecord(recordGuid, entityName, stateToSet, statusToSet)',
|
|
263
|
+
example: "SetStateMscrmRecord(@guid, 'contact', 'active', 1)",
|
|
264
|
+
isConfirmed: true,
|
|
265
|
+
nonFunctionalAtRuntime: true,
|
|
266
|
+
deprecated: true,
|
|
267
|
+
deprecatedReason:
|
|
268
|
+
'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
|
|
269
|
+
},
|
|
270
|
+
{
|
|
271
|
+
name: 'UpdateMSCRMRecords',
|
|
272
|
+
supportedInCloudPage: false,
|
|
273
|
+
supportedInEmail: false,
|
|
274
|
+
mcnSince: null,
|
|
275
|
+
handlebarsEquivalent: null,
|
|
276
|
+
mcnNotes: null,
|
|
277
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-mscrm/mc-ampscript-reference-microsoft-dynamics-crm-update-records.html',
|
|
278
|
+
guideUrl: 'https://ampscript.guide/updatemscrmrecords/',
|
|
279
|
+
minArgs: 4,
|
|
280
|
+
maxArgs: INF,
|
|
281
|
+
category: 'Microsoft Dynamics CRM',
|
|
282
|
+
description:
|
|
283
|
+
'Updates one or more records in a Microsoft Dynamics CRM entity, and returns the number of successfully updated records.',
|
|
284
|
+
params: [
|
|
285
|
+
{
|
|
286
|
+
name: 'entityName',
|
|
287
|
+
description:
|
|
288
|
+
'The name of the Microsoft Dynamics CRM entity that contains the records to update',
|
|
289
|
+
type: 'string',
|
|
290
|
+
},
|
|
291
|
+
{
|
|
292
|
+
name: 'guidsToUpdate',
|
|
293
|
+
description: 'A comma-separated list of GUIDs to update',
|
|
294
|
+
type: 'string',
|
|
295
|
+
},
|
|
296
|
+
{
|
|
297
|
+
name: 'attributeName1',
|
|
298
|
+
description: 'The name of the attribute to update on the target records',
|
|
299
|
+
type: 'string',
|
|
300
|
+
},
|
|
301
|
+
{
|
|
302
|
+
name: 'attributeValue1',
|
|
303
|
+
description: 'The attribute value to update on the target records',
|
|
304
|
+
},
|
|
305
|
+
{
|
|
306
|
+
name: 'attributeNameN',
|
|
307
|
+
mcnSince: null,
|
|
308
|
+
mcnNotes: null,
|
|
309
|
+
description: 'Additional attribute name',
|
|
310
|
+
type: 'string',
|
|
311
|
+
optional: true,
|
|
312
|
+
},
|
|
313
|
+
{ name: 'attributeValueN', description: 'Additional attribute value', optional: true },
|
|
314
|
+
],
|
|
315
|
+
returnType: 'number',
|
|
316
|
+
returnDescription: 'The number of Microsoft Dynamics CRM records updated.',
|
|
317
|
+
repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1 }],
|
|
318
|
+
syntax: 'UpdateMSCRMRecords(entityName, guidsToUpdate, attributeName1, attributeValue1[, attributeNameN, attributeValueN, ...])',
|
|
319
|
+
example: "%%=UpdateMSCRMRecords('contact', @guids, 'lastname', 'Smith')=%%",
|
|
320
|
+
isConfirmed: true,
|
|
321
|
+
nonFunctionalAtRuntime: true,
|
|
322
|
+
deprecated: true,
|
|
323
|
+
deprecatedReason:
|
|
324
|
+
'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
|
|
325
|
+
},
|
|
326
|
+
{
|
|
327
|
+
name: 'UpsertMSCRMRecord',
|
|
328
|
+
supportedInCloudPage: false,
|
|
329
|
+
supportedInEmail: false,
|
|
330
|
+
mcnSince: null,
|
|
331
|
+
handlebarsEquivalent: null,
|
|
332
|
+
mcnNotes: null,
|
|
333
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-mscrm/mc-ampscript-reference-microsoft-dynamics-crm-upsert-record.html',
|
|
334
|
+
guideUrl: 'https://ampscript.guide/upsertmscrmrecord/',
|
|
335
|
+
minArgs: 9,
|
|
336
|
+
maxArgs: 9,
|
|
337
|
+
category: 'Microsoft Dynamics CRM',
|
|
338
|
+
description:
|
|
339
|
+
'Upserts a Microsoft Dynamics CRM record. Updates the matched record or creates one if no match is found. Returns the GUID of the record.',
|
|
340
|
+
params: [
|
|
341
|
+
{
|
|
342
|
+
name: 'entityName',
|
|
343
|
+
description: 'The name of the Microsoft Dynamics CRM entity to upsert',
|
|
344
|
+
type: 'string',
|
|
345
|
+
},
|
|
346
|
+
{
|
|
347
|
+
name: 'sortField',
|
|
348
|
+
mcnSince: null,
|
|
349
|
+
mcnNotes: null,
|
|
350
|
+
description: 'The field to sort the retrieve results on',
|
|
351
|
+
type: 'string',
|
|
352
|
+
},
|
|
353
|
+
{
|
|
354
|
+
name: 'sortType',
|
|
355
|
+
description: 'The order to sort retrieve results. Accepted values: ASC or DESC',
|
|
356
|
+
type: 'string',
|
|
357
|
+
},
|
|
358
|
+
{
|
|
359
|
+
name: 'numPairsForRetrieve',
|
|
360
|
+
description: 'The number of name-value pairs used to retrieve results',
|
|
361
|
+
type: 'number',
|
|
362
|
+
},
|
|
363
|
+
{
|
|
364
|
+
name: 'filterAttributeName',
|
|
365
|
+
description: 'The name of the attribute to filter the target entity by',
|
|
366
|
+
type: 'string',
|
|
367
|
+
},
|
|
368
|
+
{
|
|
369
|
+
name: 'filterAttributeValue',
|
|
370
|
+
description: 'The value of the attribute to filter the target entity by',
|
|
371
|
+
type: 'string',
|
|
372
|
+
},
|
|
373
|
+
{
|
|
374
|
+
name: 'numPairsForUpdate',
|
|
375
|
+
description: 'The number of name-value pairs used to update records',
|
|
376
|
+
type: 'number',
|
|
377
|
+
},
|
|
378
|
+
{
|
|
379
|
+
name: 'updateAttributeName',
|
|
380
|
+
description: 'The name of the attribute to update in the target entity',
|
|
381
|
+
type: 'string',
|
|
382
|
+
},
|
|
383
|
+
{
|
|
384
|
+
name: 'updateAttributeValue',
|
|
385
|
+
description: 'The value of the attribute to update in the target entity',
|
|
386
|
+
type: 'string',
|
|
387
|
+
},
|
|
388
|
+
],
|
|
389
|
+
returnType: 'string',
|
|
390
|
+
returnDescription: 'The GUID of the created or updated Microsoft Dynamics CRM record.',
|
|
391
|
+
syntax: 'UpsertMSCRMRecord(entityName, sortField, sortType, numPairsForRetrieve, filterAttributeName, filterAttributeValue, numPairsForUpdate, updateAttributeName, updateAttributeValue)',
|
|
392
|
+
example:
|
|
393
|
+
"%%=UpsertMSCRMRecord('contact', 'createdon', 'DESC', 1, 'emailaddress1', @email, 1, 'lastname', 'Smith')=%%",
|
|
394
|
+
isConfirmed: true,
|
|
395
|
+
nonFunctionalAtRuntime: true,
|
|
396
|
+
deprecated: true,
|
|
397
|
+
deprecatedReason:
|
|
398
|
+
'The Marketing Cloud Connector for Microsoft Dynamics CRM was retired (online integration in December 2020, on-premises in October 2021), so the Dynamics CRM AMPscript functions no longer have a live integration to call and are non-functional. No replacement AMPscript function exists; integrate Dynamics data through the SFTP import/export or a custom API instead.',
|
|
399
|
+
},
|
|
400
|
+
];
|