ampscript-data 3.3.0 → 3.5.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/package.json +1 -1
- package/src/index.js +473 -85
package/src/index.js
CHANGED
|
@@ -150,6 +150,11 @@ export const FUNCTIONS = [
|
|
|
150
150
|
'var @list = "fdc5dfe4-e5e1-48af-87a1-4ac10433e895"\n' +
|
|
151
151
|
'AddMscrmListMember(@member, @list)\n' +
|
|
152
152
|
']%%',
|
|
153
|
+
isConfirmed: true,
|
|
154
|
+
nonFunctionalAtRuntime: true,
|
|
155
|
+
deprecated: true,
|
|
156
|
+
deprecatedReason:
|
|
157
|
+
'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.',
|
|
153
158
|
},
|
|
154
159
|
{
|
|
155
160
|
name: 'AddObjectArrayItem',
|
|
@@ -158,6 +163,7 @@ export const FUNCTIONS = [
|
|
|
158
163
|
mcnNotes: null,
|
|
159
164
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-add-object-array.html',
|
|
160
165
|
guideUrl: 'https://ampscript.guide/addobjectarrayitem/',
|
|
166
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/addobjectarrayitem/',
|
|
161
167
|
minArgs: 3,
|
|
162
168
|
maxArgs: 3,
|
|
163
169
|
category: 'Marketing Cloud API',
|
|
@@ -172,6 +178,7 @@ export const FUNCTIONS = [
|
|
|
172
178
|
'No value is returned; the item is appended to the named array property.',
|
|
173
179
|
syntax: 'AddObjectArrayItem(apiObject, arrayProperty, itemToAdd)',
|
|
174
180
|
example: "AddObjectArrayItem(@apiObject, 'Recipients', @recipient)",
|
|
181
|
+
isConfirmed: true,
|
|
175
182
|
},
|
|
176
183
|
{
|
|
177
184
|
name: 'AttachFile',
|
|
@@ -245,6 +252,11 @@ export const FUNCTIONS = [
|
|
|
245
252
|
returnDescription: 'No value is returned; the file is attached to the outgoing email.',
|
|
246
253
|
syntax: 'AttachFile(fileLocationType, fileLocation, attachmentFileName, viewOnWeb, viewOnWebUrl, viewOnWebFileName, viewOnWebDuration, contentDispositionAttachment)',
|
|
247
254
|
example: "%%=AttachFile('http', 'https://example.com/catalog.pdf', 'Catalog.pdf')=%%",
|
|
255
|
+
isConfirmed: false,
|
|
256
|
+
verificationBlocked: true,
|
|
257
|
+
verificationBlockedReason: 'no-working-invocation',
|
|
258
|
+
officialDocsNote:
|
|
259
|
+
'AttachFile targets the outgoing email at send time; it has no working invocation on a CloudPage. Every reached call — contentbuilder key, http URL, and the two-argument minimum form — aborted the page with HTTP 422 and no partial output, on the child QA BU (MID 518005426) and again on the parent BU (MID 7281698). The abort only happens when the call is actually reached: gating it behind an unmatched query-string branch leaves the page at HTTP 200, so the failure is a runtime abort of the reached call rather than a compile-time rejection. The official reference additionally documents that the capability must be provisioned per account, which cannot be observed from a full-access probe.',
|
|
248
260
|
},
|
|
249
261
|
{
|
|
250
262
|
name: 'AttributeValue',
|
|
@@ -420,11 +432,12 @@ export const FUNCTIONS = [
|
|
|
420
432
|
mcnNotes: null,
|
|
421
433
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-barcode-url.html',
|
|
422
434
|
guideUrl: 'https://ampscript.guide/barcodeurl/',
|
|
423
|
-
|
|
435
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/barcodeurl/',
|
|
436
|
+
minArgs: 4,
|
|
424
437
|
maxArgs: 9,
|
|
425
438
|
category: 'Content',
|
|
426
439
|
description:
|
|
427
|
-
'Generates a URL
|
|
440
|
+
'Generates a URL that renders a barcode image from the given value, symbology, width, and height, plus optional formatting. An empty value aborts the page instead of returning an empty result.',
|
|
428
441
|
params: [
|
|
429
442
|
{
|
|
430
443
|
name: 'valueToConvert',
|
|
@@ -496,7 +509,9 @@ export const FUNCTIONS = [
|
|
|
496
509
|
returnType: 'string',
|
|
497
510
|
returnDescription: 'A URL that renders the requested barcode image.',
|
|
498
511
|
syntax: 'BarcodeURL(valueToConvert, barcodeType, width, height, checksumValue, showText, altText, rotation, transparentBG)',
|
|
499
|
-
example: "%%=BarcodeURL('
|
|
512
|
+
example: "<img src=\"%%=BarcodeURL('12345678901', 'code128auto', 150, 50)=%%\">",
|
|
513
|
+
isConfirmed: true,
|
|
514
|
+
differsFromOfficialDocs: false,
|
|
500
515
|
},
|
|
501
516
|
{
|
|
502
517
|
name: 'Base64Decode',
|
|
@@ -586,10 +601,14 @@ export const FUNCTIONS = [
|
|
|
586
601
|
mcnNotes: null,
|
|
587
602
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-begin-impression-region.html',
|
|
588
603
|
guideUrl: 'https://ampscript.guide/beginimpressionregion/',
|
|
604
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/beginimpressionregion/',
|
|
589
605
|
minArgs: 1,
|
|
590
606
|
maxArgs: 1,
|
|
607
|
+
isConfirmed: true,
|
|
608
|
+
differsFromOfficialDocs: false,
|
|
591
609
|
category: 'Content',
|
|
592
|
-
description:
|
|
610
|
+
description:
|
|
611
|
+
'Marks the start of an impression tracking region. The region name must be a literal — a variable argument aborts the page.',
|
|
593
612
|
params: [{ name: 'regionName', description: 'Impression region name', type: 'string' }],
|
|
594
613
|
returnType: 'void',
|
|
595
614
|
returnDescription: 'No value is returned; it marks the start of an impression region.',
|
|
@@ -603,11 +622,12 @@ export const FUNCTIONS = [
|
|
|
603
622
|
mcnNotes: null,
|
|
604
623
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-build-option-list.html',
|
|
605
624
|
guideUrl: 'https://ampscript.guide/buildoptionlist/',
|
|
625
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/buildoptionlist/',
|
|
606
626
|
minArgs: 3,
|
|
607
627
|
maxArgs: INF,
|
|
608
628
|
category: 'Content',
|
|
609
629
|
description:
|
|
610
|
-
'Builds HTML <option> elements from
|
|
630
|
+
'Builds HTML <option> elements from supplied value/text pairs for use in a <select> dropdown, marking the pair whose value matches the default selection as selected.',
|
|
611
631
|
params: [
|
|
612
632
|
{
|
|
613
633
|
name: 'defaultSelection',
|
|
@@ -652,6 +672,8 @@ export const FUNCTIONS = [
|
|
|
652
672
|
']%%\n' +
|
|
653
673
|
'<p>Choose an option:</p>\n' +
|
|
654
674
|
'<select name="choice">\n%%=v(@OptionList)=%%\n</select>',
|
|
675
|
+
isConfirmed: true,
|
|
676
|
+
differsFromOfficialDocs: false,
|
|
655
677
|
},
|
|
656
678
|
{
|
|
657
679
|
name: 'BuildRowsetFromJSON',
|
|
@@ -813,6 +835,7 @@ export const FUNCTIONS = [
|
|
|
813
835
|
mcnNotes: null,
|
|
814
836
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-claim-row.html',
|
|
815
837
|
guideUrl: 'https://ampscript.guide/claimrow/',
|
|
838
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/claimrow/',
|
|
816
839
|
minArgs: 4,
|
|
817
840
|
maxArgs: INF,
|
|
818
841
|
category: 'Data Extension',
|
|
@@ -869,6 +892,10 @@ export const FUNCTIONS = [
|
|
|
869
892
|
repeat: [{ startIndex: 4, groupSize: 2, minGroups: 0 }],
|
|
870
893
|
syntax: 'ClaimRow(dataExt, claimColumn, claimantColumn, claimantValue[, additionalColumnNameN, additionalColumnValueN, ...])',
|
|
871
894
|
example: "%%[ SET @row = ClaimRow('Coupons', 'Claimed', 'SubKey', _subscriberkey) ]%%",
|
|
895
|
+
isConfirmed: true,
|
|
896
|
+
differsFromOfficialDocs: true,
|
|
897
|
+
officialDocsNote:
|
|
898
|
+
'Runtime-proven on a Marketing Cloud Engagement CloudPage (child BU MID 518005426) against a data extension built to the documented claimable schema (Text primary key, Text claimant column, required non-nullable Boolean claim column defaulting to False, nullable Date column). Each call passing a NEW claimant value claims the next unclaimed row and advances: four distinct claimants received C1, C2, C3, C4 in order, each row flipping to claimed with its claimant recorded and ClaimedDate auto-populated. Re-calling with a claimant value that already holds a row returns that same row rather than advancing (per-subscriber idempotency). The official reference states that ClaimRow returns an exception when no unclaimed rows remain; at runtime it instead returned an empty row that does not abort the page (Empty() on it is true), so a caller must guard with Empty() rather than expecting a raised error. Each claim was driven by a separate HTTP request carrying the claimant value as a RequestParameter — the prior single-render probe that reused one claimant value never advanced because of the idempotency rule, not a provisioning gap.',
|
|
872
899
|
},
|
|
873
900
|
{
|
|
874
901
|
name: 'ClaimRowValue',
|
|
@@ -877,6 +904,7 @@ export const FUNCTIONS = [
|
|
|
877
904
|
mcnNotes: null,
|
|
878
905
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-claim-row-value.html',
|
|
879
906
|
guideUrl: 'https://ampscript.guide/claimrowvalue/',
|
|
907
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/claimrowvalue/',
|
|
880
908
|
minArgs: 3,
|
|
881
909
|
maxArgs: INF,
|
|
882
910
|
category: 'Data Extension',
|
|
@@ -931,6 +959,8 @@ export const FUNCTIONS = [
|
|
|
931
959
|
repeat: [{ startIndex: 4, groupSize: 2, minGroups: 0 }],
|
|
932
960
|
syntax: 'ClaimRowValue(dataExt, returnValueColumn, claimColumn[, valueIfClaimed, claimantColumnN, claimantValueN, ...])',
|
|
933
961
|
example: "%%=ClaimRowValue('Coupons', 'Code', 'Claimed', '', 'SubKey', _subscriberkey)=%%",
|
|
962
|
+
isConfirmed: true,
|
|
963
|
+
differsFromOfficialDocs: false,
|
|
934
964
|
},
|
|
935
965
|
{
|
|
936
966
|
name: 'CloudPagesURL',
|
|
@@ -1028,6 +1058,7 @@ export const FUNCTIONS = [
|
|
|
1028
1058
|
mcnNotes: null,
|
|
1029
1059
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-area.html',
|
|
1030
1060
|
guideUrl: 'https://ampscript.guide/contentarea/',
|
|
1061
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentarea/',
|
|
1031
1062
|
minArgs: 1,
|
|
1032
1063
|
maxArgs: 5,
|
|
1033
1064
|
category: 'Content',
|
|
@@ -1062,7 +1093,8 @@ export const FUNCTIONS = [
|
|
|
1062
1093
|
name: 'errorMessage',
|
|
1063
1094
|
mcnSince: null,
|
|
1064
1095
|
mcnNotes: null,
|
|
1065
|
-
description:
|
|
1096
|
+
description:
|
|
1097
|
+
'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
|
|
1066
1098
|
type: 'string',
|
|
1067
1099
|
optional: true,
|
|
1068
1100
|
},
|
|
@@ -1080,6 +1112,8 @@ export const FUNCTIONS = [
|
|
|
1080
1112
|
returnDescription: 'The rendered HTML of the referenced content area.',
|
|
1081
1113
|
syntax: 'ContentArea(contentAreaId[, impressionRegionName, errorOnMissingContentArea, errorMessage, statusCode])',
|
|
1082
1114
|
example: '%%=ContentArea(12345)=%%',
|
|
1115
|
+
isConfirmed: true,
|
|
1116
|
+
differsFromOfficialDocs: false,
|
|
1083
1117
|
deprecated: true,
|
|
1084
1118
|
deprecatedReplacement: 'ContentBlockByID',
|
|
1085
1119
|
deprecatedReason:
|
|
@@ -1092,6 +1126,7 @@ export const FUNCTIONS = [
|
|
|
1092
1126
|
mcnNotes: null,
|
|
1093
1127
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-area-by-name.html',
|
|
1094
1128
|
guideUrl: 'https://ampscript.guide/contentareabyname/',
|
|
1129
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentareabyname/',
|
|
1095
1130
|
minArgs: 1,
|
|
1096
1131
|
maxArgs: 5,
|
|
1097
1132
|
category: 'Content',
|
|
@@ -1124,7 +1159,8 @@ export const FUNCTIONS = [
|
|
|
1124
1159
|
name: 'errorMessage',
|
|
1125
1160
|
mcnSince: null,
|
|
1126
1161
|
mcnNotes: null,
|
|
1127
|
-
description:
|
|
1162
|
+
description:
|
|
1163
|
+
'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
|
|
1128
1164
|
type: 'string',
|
|
1129
1165
|
optional: true,
|
|
1130
1166
|
},
|
|
@@ -1142,6 +1178,8 @@ export const FUNCTIONS = [
|
|
|
1142
1178
|
returnDescription: 'The rendered HTML of the named content area.',
|
|
1143
1179
|
syntax: 'ContentAreaByName(contentAreaName[, impressionRegionName, errorOnMissingContentArea, errorMessage, statusCode])',
|
|
1144
1180
|
example: String.raw`%%=ContentAreaByName('My Folder\My Content')=%%`,
|
|
1181
|
+
isConfirmed: true,
|
|
1182
|
+
differsFromOfficialDocs: false,
|
|
1145
1183
|
deprecated: true,
|
|
1146
1184
|
deprecatedReplacement: 'ContentBlockByName',
|
|
1147
1185
|
deprecatedReason:
|
|
@@ -1154,6 +1192,7 @@ export const FUNCTIONS = [
|
|
|
1154
1192
|
mcnNotes: null,
|
|
1155
1193
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-block-by-id.html',
|
|
1156
1194
|
guideUrl: 'https://ampscript.guide/contentblockbyid/',
|
|
1195
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentblockbyid/',
|
|
1157
1196
|
minArgs: 1,
|
|
1158
1197
|
maxArgs: 5,
|
|
1159
1198
|
category: 'Content',
|
|
@@ -1187,7 +1226,8 @@ export const FUNCTIONS = [
|
|
|
1187
1226
|
name: 'errorMessage',
|
|
1188
1227
|
mcnSince: null,
|
|
1189
1228
|
mcnNotes: null,
|
|
1190
|
-
description:
|
|
1229
|
+
description:
|
|
1230
|
+
'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
|
|
1191
1231
|
type: 'string',
|
|
1192
1232
|
optional: true,
|
|
1193
1233
|
},
|
|
@@ -1205,6 +1245,8 @@ export const FUNCTIONS = [
|
|
|
1205
1245
|
returnDescription: 'The rendered HTML of the content block identified by ID.',
|
|
1206
1246
|
syntax: 'ContentBlockByID(contentBlockId[, impressionRegionName, errorOnMissingContentBlock, errorMessage, statusCode])',
|
|
1207
1247
|
example: '%%=ContentBlockByID(12345)=%%',
|
|
1248
|
+
isConfirmed: true,
|
|
1249
|
+
differsFromOfficialDocs: false,
|
|
1208
1250
|
},
|
|
1209
1251
|
{
|
|
1210
1252
|
name: 'ContentBlockByKey',
|
|
@@ -1214,6 +1256,7 @@ export const FUNCTIONS = [
|
|
|
1214
1256
|
mcnNotes: null,
|
|
1215
1257
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-block-by-key.html',
|
|
1216
1258
|
guideUrl: 'https://ampscript.guide/contentblockbykey/',
|
|
1259
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentblockbykey/',
|
|
1217
1260
|
minArgs: 1,
|
|
1218
1261
|
maxArgs: 5,
|
|
1219
1262
|
category: 'Content',
|
|
@@ -1247,7 +1290,8 @@ export const FUNCTIONS = [
|
|
|
1247
1290
|
name: 'errorMessage',
|
|
1248
1291
|
mcnSince: null,
|
|
1249
1292
|
mcnNotes: null,
|
|
1250
|
-
description:
|
|
1293
|
+
description:
|
|
1294
|
+
'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
|
|
1251
1295
|
type: 'string',
|
|
1252
1296
|
optional: true,
|
|
1253
1297
|
},
|
|
@@ -1265,6 +1309,8 @@ export const FUNCTIONS = [
|
|
|
1265
1309
|
returnDescription: 'The rendered HTML of the content block identified by customer key.',
|
|
1266
1310
|
syntax: 'ContentBlockByKey(contentBlockKey[, impressionRegionName, errorOnMissingContentBlock, errorMessage, statusCode])',
|
|
1267
1311
|
example: "%%=ContentBlockByKey('welcome-header')=%%",
|
|
1312
|
+
isConfirmed: true,
|
|
1313
|
+
differsFromOfficialDocs: false,
|
|
1268
1314
|
},
|
|
1269
1315
|
{
|
|
1270
1316
|
name: 'ContentBlockByName',
|
|
@@ -1273,6 +1319,7 @@ export const FUNCTIONS = [
|
|
|
1273
1319
|
mcnNotes: null,
|
|
1274
1320
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-block-by-name.html',
|
|
1275
1321
|
guideUrl: 'https://ampscript.guide/contentblockbyname/',
|
|
1322
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentblockbyname/',
|
|
1276
1323
|
minArgs: 1,
|
|
1277
1324
|
maxArgs: 5,
|
|
1278
1325
|
category: 'Content',
|
|
@@ -1307,7 +1354,8 @@ export const FUNCTIONS = [
|
|
|
1307
1354
|
name: 'errorMessage',
|
|
1308
1355
|
mcnSince: null,
|
|
1309
1356
|
mcnNotes: null,
|
|
1310
|
-
description:
|
|
1357
|
+
description:
|
|
1358
|
+
'Default content to return if an error occurs. This value is emitted literally - any AMPscript it contains is not evaluated.',
|
|
1311
1359
|
type: 'string',
|
|
1312
1360
|
optional: true,
|
|
1313
1361
|
},
|
|
@@ -1325,6 +1373,8 @@ export const FUNCTIONS = [
|
|
|
1325
1373
|
returnDescription: 'The rendered HTML of the content block identified by name or path.',
|
|
1326
1374
|
syntax: 'ContentBlockByName(contentBlockName[, impressionRegionName, errorOnMissingContentBlock, errorMessage, statusCode])',
|
|
1327
1375
|
example: String.raw`%%=ContentBlockByName('My Folder\Welcome Header')=%%`,
|
|
1376
|
+
isConfirmed: true,
|
|
1377
|
+
differsFromOfficialDocs: false,
|
|
1328
1378
|
},
|
|
1329
1379
|
{
|
|
1330
1380
|
name: 'ContentImageByID',
|
|
@@ -1333,10 +1383,12 @@ export const FUNCTIONS = [
|
|
|
1333
1383
|
mcnNotes: null,
|
|
1334
1384
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-image-by-id.html',
|
|
1335
1385
|
guideUrl: 'https://ampscript.guide/contentimagebyid/',
|
|
1336
|
-
|
|
1386
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentimagebyid/',
|
|
1387
|
+
minArgs: 1,
|
|
1337
1388
|
maxArgs: 2,
|
|
1338
1389
|
category: 'Content',
|
|
1339
|
-
description:
|
|
1390
|
+
description:
|
|
1391
|
+
'Returns an HTML img tag for a Content Builder image asset by its numeric ID. A missing image with no fallback aborts the page.',
|
|
1340
1392
|
params: [
|
|
1341
1393
|
{
|
|
1342
1394
|
name: 'id',
|
|
@@ -1350,12 +1402,16 @@ export const FUNCTIONS = [
|
|
|
1350
1402
|
description:
|
|
1351
1403
|
"The ID of a fallback image in Content Builder. The function uses this image if it can't find the image that you specified in the first parameter",
|
|
1352
1404
|
type: 'number|string',
|
|
1405
|
+
optional: true,
|
|
1353
1406
|
},
|
|
1354
1407
|
],
|
|
1355
1408
|
returnType: 'string',
|
|
1356
|
-
returnDescription:
|
|
1357
|
-
|
|
1358
|
-
|
|
1409
|
+
returnDescription:
|
|
1410
|
+
'An HTML img tag for the referenced image, with title, alt, border and thid attributes.',
|
|
1411
|
+
syntax: 'ContentImageByID(id[, defaultImageExternalId])',
|
|
1412
|
+
example: '%%=ContentImageByID(12345)=%%',
|
|
1413
|
+
isConfirmed: true,
|
|
1414
|
+
differsFromOfficialDocs: false,
|
|
1359
1415
|
},
|
|
1360
1416
|
{
|
|
1361
1417
|
name: 'ContentImageByKey',
|
|
@@ -1364,10 +1420,12 @@ export const FUNCTIONS = [
|
|
|
1364
1420
|
mcnNotes: null,
|
|
1365
1421
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-image-by-key.html',
|
|
1366
1422
|
guideUrl: 'https://ampscript.guide/contentimagebykey/',
|
|
1367
|
-
|
|
1423
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/contentimagebykey/',
|
|
1424
|
+
minArgs: 1,
|
|
1368
1425
|
maxArgs: 2,
|
|
1369
1426
|
category: 'Content',
|
|
1370
|
-
description:
|
|
1427
|
+
description:
|
|
1428
|
+
'Returns an HTML img tag for a Content Builder image asset by its customer key. A missing image with no fallback aborts the page.',
|
|
1371
1429
|
params: [
|
|
1372
1430
|
{
|
|
1373
1431
|
name: 'imageExternalKey',
|
|
@@ -1380,12 +1438,16 @@ export const FUNCTIONS = [
|
|
|
1380
1438
|
mcnNotes: null,
|
|
1381
1439
|
description: 'External key of the fallback image asset',
|
|
1382
1440
|
type: 'string',
|
|
1441
|
+
optional: true,
|
|
1383
1442
|
},
|
|
1384
1443
|
],
|
|
1385
1444
|
returnType: 'string',
|
|
1386
|
-
returnDescription:
|
|
1387
|
-
|
|
1388
|
-
|
|
1445
|
+
returnDescription:
|
|
1446
|
+
'An HTML img tag for the referenced image, with title, alt, border and thid attributes.',
|
|
1447
|
+
syntax: 'ContentImageByKey(imageExternalKey[, defaultImageExternalKey])',
|
|
1448
|
+
example: "%%=ContentImageByKey('hero-image')=%%",
|
|
1449
|
+
isConfirmed: true,
|
|
1450
|
+
differsFromOfficialDocs: false,
|
|
1389
1451
|
},
|
|
1390
1452
|
{
|
|
1391
1453
|
name: 'CreateMSCRMRecord',
|
|
@@ -1433,6 +1495,11 @@ export const FUNCTIONS = [
|
|
|
1433
1495
|
repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1, countParam: 'numFields' }],
|
|
1434
1496
|
syntax: 'CreateMSCRMRecord(entityName, numFields, attributeName1, attributeValue1[, attributeNameN, attributeValueN, ...])',
|
|
1435
1497
|
example: "%%=CreateMSCRMRecord('contact', 1, 'lastname', 'Smith')=%%",
|
|
1498
|
+
isConfirmed: true,
|
|
1499
|
+
nonFunctionalAtRuntime: true,
|
|
1500
|
+
deprecated: true,
|
|
1501
|
+
deprecatedReason:
|
|
1502
|
+
'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.',
|
|
1436
1503
|
},
|
|
1437
1504
|
{
|
|
1438
1505
|
name: 'CreateObject',
|
|
@@ -1441,6 +1508,7 @@ export const FUNCTIONS = [
|
|
|
1441
1508
|
mcnNotes: null,
|
|
1442
1509
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-create-object.html',
|
|
1443
1510
|
guideUrl: 'https://ampscript.guide/createobject/',
|
|
1511
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/createobject/',
|
|
1444
1512
|
minArgs: 1,
|
|
1445
1513
|
maxArgs: 1,
|
|
1446
1514
|
category: 'Marketing Cloud API',
|
|
@@ -1453,6 +1521,7 @@ export const FUNCTIONS = [
|
|
|
1453
1521
|
returnDescription: 'A new API object instance for use with the Invoke* functions.',
|
|
1454
1522
|
syntax: 'CreateObject(objectName)',
|
|
1455
1523
|
example: "%%=CreateObject('DataExtensionObject')=%%",
|
|
1524
|
+
isConfirmed: true,
|
|
1456
1525
|
},
|
|
1457
1526
|
{
|
|
1458
1527
|
name: 'CreateSalesforceObject',
|
|
@@ -1461,10 +1530,16 @@ export const FUNCTIONS = [
|
|
|
1461
1530
|
mcnNotes: null,
|
|
1462
1531
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-create-object.html',
|
|
1463
1532
|
guideUrl: 'https://ampscript.guide/createsalesforceobject/',
|
|
1533
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/createsalesforceobject/',
|
|
1464
1534
|
minArgs: 4,
|
|
1465
1535
|
maxArgs: INF,
|
|
1466
1536
|
category: 'Sales and Service Cloud',
|
|
1467
|
-
description:
|
|
1537
|
+
description:
|
|
1538
|
+
'Creates a new record in a connected Salesforce Sales or Service Cloud object via Marketing Cloud Connect and returns the 18-character ID of the created record. Requires an active Marketing Cloud Connect integration; the field names must be valid API names on the target object, and a fault (unknown object or field) aborts the whole page rather than returning an error value.',
|
|
1539
|
+
isConfirmed: true,
|
|
1540
|
+
differsFromOfficialDocs: false,
|
|
1541
|
+
officialDocsNote:
|
|
1542
|
+
'The success path was runtime-proven on cred/DEV (MID 510007949), which has an active Marketing Cloud Connect integration to a real Salesforce org. Creating a benign Task with a single opaque field returned a real 18-character Salesforce ID (an 00T-prefixed Task ID), confirming the documented return shape. The fault path was also proven: an unknown object name and an unknown field name on a real object each aborted the CloudPage with HTTP 422 — the SOAP fault from the connected org propagates as an uncatchable page abort (AMPscript has no try/catch), exactly like RetrieveSalesforceObjects against an unknown object — so there is no testable error value, the function either returns an ID or aborts. AMPscript has no delete function for Salesforce objects, so the created Task remains as benign residue in the org. Catalog signature, returnType and repeat group all match the official reference and ampscript.guide, so differsFromOfficialDocs stays false.',
|
|
1468
1543
|
params: [
|
|
1469
1544
|
{
|
|
1470
1545
|
name: 'objectName',
|
|
@@ -1494,7 +1569,7 @@ export const FUNCTIONS = [
|
|
|
1494
1569
|
{ name: 'fieldValueN', description: 'Additional field value', optional: true },
|
|
1495
1570
|
],
|
|
1496
1571
|
returnType: 'string',
|
|
1497
|
-
returnDescription: 'The ID of the newly created Salesforce object record.',
|
|
1572
|
+
returnDescription: 'The 18-character ID of the newly created Salesforce object record.',
|
|
1498
1573
|
repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1, countParam: 'numFields' }],
|
|
1499
1574
|
syntax: 'CreateSalesforceObject(objectName, numFields, fieldName1, fieldValue1[, fieldNameN, fieldValueN, ...])',
|
|
1500
1575
|
example: "%%=CreateSalesforceObject('Contact', 1, 'LastName', 'Smith')=%%",
|
|
@@ -1509,17 +1584,41 @@ export const FUNCTIONS = [
|
|
|
1509
1584
|
minArgs: 4,
|
|
1510
1585
|
maxArgs: 4,
|
|
1511
1586
|
category: 'MobileConnect',
|
|
1512
|
-
description:
|
|
1587
|
+
description:
|
|
1588
|
+
'Initiates an SMS conversation with a contact from within a MobileConnect message. Returns true when a conversation is created inside a MobileConnect message context, and false in any other context (for example a CloudPage or email). The success path cannot be exercised outside a live MobileConnect send.',
|
|
1589
|
+
isConfirmed: false,
|
|
1590
|
+
verificationBlocked: true,
|
|
1591
|
+
verificationBlockedReason: 'no-working-invocation',
|
|
1592
|
+
differsFromOfficialDocs: true,
|
|
1593
|
+
officialDocsNote:
|
|
1594
|
+
"Runtime-observed on cred/DEV (MID 510007949), the only BU available for this batch (no parent-BU escalation). Unlike Msg()/Noun()/Verb(), this is an ordinary function call, so it compiles and runs on a CloudPage: called there with a real short code, the authorized destination number and app 'MOBILECONNECT', it returned the literal boolean false (Empty() false) and the page rendered fully with no exception — no SMS was sent. Passing an invalid app value also returned false, so the CloudPage context masks any app-validation error. This confirms the ampscript.guide claim that the function returns false outside a MobileConnect message context; the official Salesforce reference omits this and describes only the in-context behaviour (true on success, exception on failure). The success path (true, real conversation creation) requires a live MobileConnect message context that does not exist on a CloudPage and cannot be captured on this tenant, so the function is recorded blocked for the success path while the CloudPage false-return is proven. The catalogued signature was also corrected here: the four parameters are originationNumber, destinationNumber, nextKeyword and app, and the return is a boolean, not void.",
|
|
1513
1595
|
params: [
|
|
1514
|
-
{
|
|
1515
|
-
|
|
1516
|
-
|
|
1517
|
-
|
|
1596
|
+
{
|
|
1597
|
+
name: 'originationNumber',
|
|
1598
|
+
description: 'The MobileConnect short code or long code used to send',
|
|
1599
|
+
type: 'string',
|
|
1600
|
+
},
|
|
1601
|
+
{
|
|
1602
|
+
name: 'destinationNumber',
|
|
1603
|
+
description: "The contact's phone number, including country code",
|
|
1604
|
+
type: 'string',
|
|
1605
|
+
},
|
|
1606
|
+
{
|
|
1607
|
+
name: 'nextKeyword',
|
|
1608
|
+
description: 'The keyword to set as the next conversation keyword',
|
|
1609
|
+
type: 'string',
|
|
1610
|
+
},
|
|
1611
|
+
{
|
|
1612
|
+
name: 'app',
|
|
1613
|
+
description: "The application for the conversation; must be 'MOBILECONNECT'",
|
|
1614
|
+
type: 'string',
|
|
1615
|
+
},
|
|
1518
1616
|
],
|
|
1519
|
-
returnType: '
|
|
1520
|
-
returnDescription:
|
|
1521
|
-
|
|
1522
|
-
|
|
1617
|
+
returnType: 'boolean',
|
|
1618
|
+
returnDescription:
|
|
1619
|
+
'true when a conversation is created inside a MobileConnect message context; false in any other context (proven on a CloudPage). Fails with an exception in-context if unsuccessful.',
|
|
1620
|
+
syntax: 'CreateSmsConversation(originationNumber, destinationNumber, nextKeyword, app)',
|
|
1621
|
+
example: '%%=CreateSmsConversation("12345", MOBILE_NUMBER, "KEYWORD", "MOBILECONNECT")=%%',
|
|
1523
1622
|
},
|
|
1524
1623
|
{
|
|
1525
1624
|
name: 'DataExtensionRowCount',
|
|
@@ -1528,6 +1627,9 @@ export const FUNCTIONS = [
|
|
|
1528
1627
|
mcnNotes: null,
|
|
1529
1628
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-de-row-count.html',
|
|
1530
1629
|
guideUrl: 'https://ampscript.guide/dataextensionrowcount/',
|
|
1630
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/dataextensionrowcount/',
|
|
1631
|
+
isConfirmed: true,
|
|
1632
|
+
differsFromOfficialDocs: false,
|
|
1531
1633
|
minArgs: 1,
|
|
1532
1634
|
maxArgs: 1,
|
|
1533
1635
|
category: 'Data Extension',
|
|
@@ -1791,6 +1893,9 @@ export const FUNCTIONS = [
|
|
|
1791
1893
|
mcnNotes: null,
|
|
1792
1894
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-delete-data.html',
|
|
1793
1895
|
guideUrl: 'https://ampscript.guide/deletedata/',
|
|
1896
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/deletedata/',
|
|
1897
|
+
isConfirmed: true,
|
|
1898
|
+
differsFromOfficialDocs: false,
|
|
1794
1899
|
minArgs: 3,
|
|
1795
1900
|
maxArgs: INF,
|
|
1796
1901
|
category: 'Data Extension',
|
|
@@ -1835,6 +1940,9 @@ export const FUNCTIONS = [
|
|
|
1835
1940
|
mcnNotes: null,
|
|
1836
1941
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-delete-de.html',
|
|
1837
1942
|
guideUrl: 'https://ampscript.guide/deletede/',
|
|
1943
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/deletede/',
|
|
1944
|
+
isConfirmed: true,
|
|
1945
|
+
differsFromOfficialDocs: false,
|
|
1838
1946
|
minArgs: 3,
|
|
1839
1947
|
maxArgs: INF,
|
|
1840
1948
|
category: 'Data Extension',
|
|
@@ -1887,6 +1995,11 @@ export const FUNCTIONS = [
|
|
|
1887
1995
|
returnDescription: 'A rowset describing the available Microsoft Dynamics CRM entities.',
|
|
1888
1996
|
syntax: 'DescribeMSCRMEntities()',
|
|
1889
1997
|
example: '%%[ SET @entities = DescribeMSCRMEntities() ]%%',
|
|
1998
|
+
isConfirmed: true,
|
|
1999
|
+
nonFunctionalAtRuntime: true,
|
|
2000
|
+
deprecated: true,
|
|
2001
|
+
deprecatedReason:
|
|
2002
|
+
'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.',
|
|
1890
2003
|
},
|
|
1891
2004
|
{
|
|
1892
2005
|
name: 'DescribeMSCRMEntityAttributes',
|
|
@@ -1904,6 +2017,11 @@ export const FUNCTIONS = [
|
|
|
1904
2017
|
returnDescription: 'A rowset describing the attributes of the requested CRM entity.',
|
|
1905
2018
|
syntax: 'DescribeMSCRMEntityAttributes(entityType)',
|
|
1906
2019
|
example: "%%[ SET @attrs = DescribeMSCRMEntityAttributes('contact') ]%%",
|
|
2020
|
+
isConfirmed: true,
|
|
2021
|
+
nonFunctionalAtRuntime: true,
|
|
2022
|
+
deprecated: true,
|
|
2023
|
+
deprecatedReason:
|
|
2024
|
+
'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.',
|
|
1907
2025
|
},
|
|
1908
2026
|
{
|
|
1909
2027
|
name: 'Divide',
|
|
@@ -2053,8 +2171,11 @@ export const FUNCTIONS = [
|
|
|
2053
2171
|
mcnNotes: null,
|
|
2054
2172
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-end-impression-region.html',
|
|
2055
2173
|
guideUrl: 'https://ampscript.guide/endimpressionregion/',
|
|
2174
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/endimpressionregion/',
|
|
2056
2175
|
minArgs: 0,
|
|
2057
2176
|
maxArgs: 1,
|
|
2177
|
+
isConfirmed: true,
|
|
2178
|
+
differsFromOfficialDocs: false,
|
|
2058
2179
|
category: 'Content',
|
|
2059
2180
|
description: 'Marks the end of an impression tracking region.',
|
|
2060
2181
|
params: [
|
|
@@ -2062,8 +2183,9 @@ export const FUNCTIONS = [
|
|
|
2062
2183
|
name: 'endAllRegions',
|
|
2063
2184
|
mcnSince: null,
|
|
2064
2185
|
mcnNotes: null,
|
|
2065
|
-
description:
|
|
2066
|
-
|
|
2186
|
+
description:
|
|
2187
|
+
'Whether to end all open impression regions. A truthy value ends every open region; the default ends only the most recent one.',
|
|
2188
|
+
type: 'string|boolean|number',
|
|
2067
2189
|
optional: true,
|
|
2068
2190
|
},
|
|
2069
2191
|
],
|
|
@@ -2082,15 +2204,31 @@ export const FUNCTIONS = [
|
|
|
2082
2204
|
minArgs: 2,
|
|
2083
2205
|
maxArgs: 2,
|
|
2084
2206
|
category: 'MobileConnect',
|
|
2085
|
-
description:
|
|
2207
|
+
description:
|
|
2208
|
+
'Ends an active SMS conversation with a contact from within a MobileConnect message. Returns true when the conversation is ended inside a MobileConnect message context, and false in any other context (for example a CloudPage or email). The success path cannot be exercised outside a live MobileConnect send.',
|
|
2209
|
+
isConfirmed: false,
|
|
2210
|
+
verificationBlocked: true,
|
|
2211
|
+
verificationBlockedReason: 'no-working-invocation',
|
|
2212
|
+
differsFromOfficialDocs: true,
|
|
2213
|
+
officialDocsNote:
|
|
2214
|
+
'Runtime-observed on cred/DEV (MID 510007949), the only BU available (no parent-BU escalation). This is an ordinary function call, so it compiles and runs on a CloudPage: called there with a real short code and the authorized destination number, it returned the literal boolean false (Empty() false) and the page rendered fully with no exception — no SMS was sent and no conversation state changed. This confirms the ampscript.guide claim that the function returns false outside a MobileConnect message context; the official Salesforce reference omits this and describes only the in-context behaviour (true on success, exception on failure). The success path (true, real conversation end) requires a live MobileConnect message context that cannot be captured on this tenant, so the function is recorded blocked for the success path while the CloudPage false-return is proven. The catalogued signature was corrected here: the two parameters are originationNumber and destinationNumber, and the return is a boolean, not void.',
|
|
2086
2215
|
params: [
|
|
2087
|
-
{
|
|
2088
|
-
|
|
2216
|
+
{
|
|
2217
|
+
name: 'originationNumber',
|
|
2218
|
+
description: 'The MobileConnect short code or long code used to send',
|
|
2219
|
+
type: 'string',
|
|
2220
|
+
},
|
|
2221
|
+
{
|
|
2222
|
+
name: 'destinationNumber',
|
|
2223
|
+
description: "The contact's phone number, including country code",
|
|
2224
|
+
type: 'string',
|
|
2225
|
+
},
|
|
2089
2226
|
],
|
|
2090
|
-
returnType: '
|
|
2091
|
-
returnDescription:
|
|
2092
|
-
|
|
2093
|
-
|
|
2227
|
+
returnType: 'boolean',
|
|
2228
|
+
returnDescription:
|
|
2229
|
+
'true when the conversation is ended inside a MobileConnect message context; false in any other context (proven on a CloudPage). Fails with an exception in-context if unsuccessful.',
|
|
2230
|
+
syntax: 'EndSmsConversation(originationNumber, destinationNumber)',
|
|
2231
|
+
example: '%%=EndSmsConversation("12345", MOBILE_NUMBER)=%%',
|
|
2094
2232
|
},
|
|
2095
2233
|
{
|
|
2096
2234
|
name: 'ExecuteFilter',
|
|
@@ -2099,6 +2237,9 @@ export const FUNCTIONS = [
|
|
|
2099
2237
|
mcnNotes: null,
|
|
2100
2238
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-execute-filter.html',
|
|
2101
2239
|
guideUrl: 'https://ampscript.guide/executefilter/',
|
|
2240
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/executefilter/',
|
|
2241
|
+
isConfirmed: true,
|
|
2242
|
+
differsFromOfficialDocs: false,
|
|
2102
2243
|
minArgs: 1,
|
|
2103
2244
|
maxArgs: 1,
|
|
2104
2245
|
category: 'Data Extension',
|
|
@@ -2123,6 +2264,9 @@ export const FUNCTIONS = [
|
|
|
2123
2264
|
mcnNotes: null,
|
|
2124
2265
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-execute-filter-ordered-rows.html',
|
|
2125
2266
|
guideUrl: 'https://ampscript.guide/executefilterorderedrows/',
|
|
2267
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/executefilterorderedrows/',
|
|
2268
|
+
isConfirmed: true,
|
|
2269
|
+
differsFromOfficialDocs: false,
|
|
2126
2270
|
minArgs: 3,
|
|
2127
2271
|
maxArgs: 3,
|
|
2128
2272
|
category: 'Data Extension',
|
|
@@ -2161,10 +2305,14 @@ export const FUNCTIONS = [
|
|
|
2161
2305
|
mcnNotes: null,
|
|
2162
2306
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-field.html',
|
|
2163
2307
|
guideUrl: 'https://ampscript.guide/field/',
|
|
2308
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/field/',
|
|
2309
|
+
isConfirmed: true,
|
|
2310
|
+
differsFromOfficialDocs: false,
|
|
2164
2311
|
minArgs: 2,
|
|
2165
2312
|
maxArgs: 3,
|
|
2166
2313
|
category: 'Data Extension',
|
|
2167
|
-
description:
|
|
2314
|
+
description:
|
|
2315
|
+
'Retrieves the value of a named field from a rowset row. The two-argument form aborts the page when the column is absent; pass the optional third argument as 0 (or false) to get an empty string for a possibly-missing column instead.',
|
|
2168
2316
|
params: [
|
|
2169
2317
|
{ name: 'row', description: 'Row object from a rowset', type: 'row' },
|
|
2170
2318
|
{ name: 'fieldName', description: 'Column name to retrieve', type: 'string' },
|
|
@@ -2459,9 +2607,8 @@ export const FUNCTIONS = [
|
|
|
2459
2607
|
],
|
|
2460
2608
|
returnType: 'string',
|
|
2461
2609
|
returnDescription: 'A signed JSON Web Token string created with the named key.',
|
|
2462
|
-
isConfirmed:
|
|
2463
|
-
|
|
2464
|
-
verificationBlockedReason: 'no-test-data',
|
|
2610
|
+
isConfirmed: true,
|
|
2611
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/getjwtbykeyname/',
|
|
2465
2612
|
syntax: 'GetJWTByKeyName(keyName, algorithm, jsonPayload)',
|
|
2466
2613
|
example: "%%=GetJWTByKeyName('MyKeyName', 'HS256', @payload)=%%",
|
|
2467
2614
|
},
|
|
@@ -2487,6 +2634,10 @@ export const FUNCTIONS = [
|
|
|
2487
2634
|
returnDescription: 'The content of the requested Portfolio item.',
|
|
2488
2635
|
syntax: 'GetPortfolioItem(itemExternalKey)',
|
|
2489
2636
|
example: "%%=GetPortfolioItem('my-portfolio-key')=%%",
|
|
2637
|
+
isConfirmed: true,
|
|
2638
|
+
nonFunctionalAtRuntime: true,
|
|
2639
|
+
officialDocsNote:
|
|
2640
|
+
'Classic Portfolio is retired on this tenant, so no Portfolio item exists to retrieve. A reached call with an external key that does not resolve aborted the page with HTTP 422 and no partial output, on both the child QA BU (MID 518005426) and the parent BU (MID 7281698); the same call gated behind an unmatched query-string branch left the page at HTTP 200, confirming a runtime abort of the reached call. No valid key could be sourced because Portfolio asset creation and applications were retired, so the documented success path could not be exercised here.',
|
|
2490
2641
|
},
|
|
2491
2642
|
{
|
|
2492
2643
|
name: 'GetPublishedSocialContent',
|
|
@@ -2506,6 +2657,10 @@ export const FUNCTIONS = [
|
|
|
2506
2657
|
returnDescription: 'The published social content for the supplied identifier.',
|
|
2507
2658
|
syntax: 'GetPublishedSocialContent(socialContentId)',
|
|
2508
2659
|
example: "%%=GetPublishedSocialContent('socialContentId')=%%",
|
|
2660
|
+
isConfirmed: true,
|
|
2661
|
+
nonFunctionalAtRuntime: true,
|
|
2662
|
+
officialDocsNote:
|
|
2663
|
+
'The community guide flags this as usable only inside Microsites and Landing Pages and only for content regions built in Classic Content, which is retired on this tenant. A reached call aborted the page with HTTP 422 and no partial output for both a string region name and a numeric region id, on the child QA BU (MID 518005426) and again on the parent BU (MID 7281698). The same call gated behind an unmatched query-string branch left the page at HTTP 200, confirming a runtime abort of the reached call rather than a compile-time failure. No Classic Content region exists here to source a resolvable identifier, so the documented success path could not be exercised.',
|
|
2509
2664
|
},
|
|
2510
2665
|
{
|
|
2511
2666
|
name: 'GetSendTime',
|
|
@@ -2549,16 +2704,18 @@ export const FUNCTIONS = [
|
|
|
2549
2704
|
mcnNotes: null,
|
|
2550
2705
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-social/mc-ampscript-reference-social-get-social-publish-url.html',
|
|
2551
2706
|
guideUrl: 'https://ampscript.guide/getsocialpublishurl/',
|
|
2707
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/getsocialpublishurl/',
|
|
2552
2708
|
minArgs: 2,
|
|
2553
2709
|
maxArgs: INF,
|
|
2554
2710
|
category: 'Social',
|
|
2711
|
+
isConfirmed: true,
|
|
2555
2712
|
description:
|
|
2556
2713
|
'Returns HTML for sharing a content region on a supported social network via Social Forward. Optionally accepts repeating key/value parameter pairs.',
|
|
2557
2714
|
params: [
|
|
2558
2715
|
{
|
|
2559
2716
|
name: 'socialNetworkCode',
|
|
2560
2717
|
description: 'The number code of the social network to share to',
|
|
2561
|
-
type: 'number',
|
|
2718
|
+
type: 'string|number',
|
|
2562
2719
|
},
|
|
2563
2720
|
{
|
|
2564
2721
|
name: 'contentRegion',
|
|
@@ -2603,9 +2760,12 @@ export const FUNCTIONS = [
|
|
|
2603
2760
|
mcnNotes: null,
|
|
2604
2761
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-social/mc-ampscript-reference-social-get-social-publish-url-by-name.html',
|
|
2605
2762
|
guideUrl: 'https://ampscript.guide/getsocialpublishurlbyname/',
|
|
2763
|
+
sfmcGuideUrl:
|
|
2764
|
+
'https://sfmc.guide/engagement/ampscript/functions/getsocialpublishurlbyname/',
|
|
2606
2765
|
minArgs: 3,
|
|
2607
2766
|
maxArgs: INF,
|
|
2608
2767
|
category: 'Social',
|
|
2768
|
+
isConfirmed: true,
|
|
2609
2769
|
description:
|
|
2610
2770
|
'Returns HTML for sharing a content region on a supported social network (identified by name) via Social Forward. Optionally accepts repeating key/value parameter pairs.',
|
|
2611
2771
|
params: [
|
|
@@ -2678,8 +2838,10 @@ export const FUNCTIONS = [
|
|
|
2678
2838
|
mcnSince: null,
|
|
2679
2839
|
handlebarsEquivalent: null,
|
|
2680
2840
|
mcnNotes: null,
|
|
2841
|
+
isConfirmed: true,
|
|
2681
2842
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-get.html',
|
|
2682
2843
|
guideUrl: 'https://ampscript.guide/httpget/',
|
|
2844
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httpget/',
|
|
2683
2845
|
minArgs: 1,
|
|
2684
2846
|
maxArgs: 4,
|
|
2685
2847
|
category: 'HTTP',
|
|
@@ -2699,25 +2861,27 @@ export const FUNCTIONS = [
|
|
|
2699
2861
|
optional: true,
|
|
2700
2862
|
},
|
|
2701
2863
|
{
|
|
2702
|
-
name: '
|
|
2864
|
+
name: 'emptyContentHandling',
|
|
2703
2865
|
mcnSince: null,
|
|
2704
2866
|
mcnNotes: null,
|
|
2705
|
-
description:
|
|
2706
|
-
|
|
2867
|
+
description:
|
|
2868
|
+
'How empty content is handled: 0 allows empty content, 1 returns an error, 2 skips the subscriber in a send',
|
|
2869
|
+
type: 'number',
|
|
2707
2870
|
optional: true,
|
|
2708
2871
|
},
|
|
2709
2872
|
{
|
|
2710
|
-
name: '
|
|
2873
|
+
name: 'status',
|
|
2711
2874
|
mcnSince: null,
|
|
2712
2875
|
mcnNotes: null,
|
|
2713
|
-
description:
|
|
2714
|
-
|
|
2876
|
+
description:
|
|
2877
|
+
'Output variable that receives the function status: 0 success, -1 not found, -2 HTTP request error, -3 empty content',
|
|
2878
|
+
type: 'number',
|
|
2715
2879
|
optional: true,
|
|
2716
2880
|
},
|
|
2717
2881
|
],
|
|
2718
2882
|
returnType: 'string',
|
|
2719
2883
|
returnDescription: 'The body of the HTTP response as a string.',
|
|
2720
|
-
syntax: 'HTTPGet(httpGetUrl[, continueOnError,
|
|
2884
|
+
syntax: 'HTTPGet(httpGetUrl[, continueOnError, emptyContentHandling, status])',
|
|
2721
2885
|
example: "%%=HTTPGet('https://example.com/api')=%%",
|
|
2722
2886
|
},
|
|
2723
2887
|
{
|
|
@@ -2727,11 +2891,16 @@ export const FUNCTIONS = [
|
|
|
2727
2891
|
mcnNotes: null,
|
|
2728
2892
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-post.html',
|
|
2729
2893
|
guideUrl: 'https://ampscript.guide/httppost/',
|
|
2894
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httppost/',
|
|
2730
2895
|
minArgs: 3,
|
|
2731
2896
|
maxArgs: INF,
|
|
2732
2897
|
category: 'HTTP',
|
|
2898
|
+
isConfirmed: true,
|
|
2899
|
+
differsFromOfficialDocs: true,
|
|
2900
|
+
officialDocsNote:
|
|
2901
|
+
'The official reference labels the fourth argument as an output parameter holding the "status" of the request, but on a live Engagement CloudPage (child MID 518005426) that variable receives the response BODY, not the status. The HTTP status code is the function return value. A non-2xx response (proven with a 404) and an empty URL both abort the whole page rather than returning the status, so a failing status can never be read from the return value.',
|
|
2733
2902
|
description:
|
|
2734
|
-
'Performs an HTTP POST request. The response body is
|
|
2903
|
+
'Performs an HTTP POST request and returns the HTTP status code. The response body is written to the optional output variable.',
|
|
2735
2904
|
params: [
|
|
2736
2905
|
{
|
|
2737
2906
|
name: 'urlEndpoint',
|
|
@@ -2752,7 +2921,7 @@ export const FUNCTIONS = [
|
|
|
2752
2921
|
name: 'response',
|
|
2753
2922
|
mcnSince: null,
|
|
2754
2923
|
mcnNotes: null,
|
|
2755
|
-
description: 'Output variable that
|
|
2924
|
+
description: 'Output variable that receives the response body',
|
|
2756
2925
|
type: 'string',
|
|
2757
2926
|
optional: true,
|
|
2758
2927
|
},
|
|
@@ -2795,11 +2964,16 @@ export const FUNCTIONS = [
|
|
|
2795
2964
|
mcnNotes: null,
|
|
2796
2965
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-post2.html',
|
|
2797
2966
|
guideUrl: 'https://ampscript.guide/httppost2/',
|
|
2967
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httppost2/',
|
|
2798
2968
|
minArgs: 3,
|
|
2799
2969
|
maxArgs: INF,
|
|
2800
2970
|
category: 'HTTP',
|
|
2971
|
+
isConfirmed: true,
|
|
2972
|
+
differsFromOfficialDocs: true,
|
|
2973
|
+
officialDocsNote:
|
|
2974
|
+
'The official reference labels the fifth argument (response) as storing the "status" of the request, but on a live Engagement CloudPage (child MID 518005426) it receives the response BODY and the sixth argument (responseRowSet) receives the response HEADERS as a rowset (11 header rows observed). The HTTP status code is the function return value. The boolean exceptionOnError flag is accepted at position four.',
|
|
2801
2975
|
description:
|
|
2802
|
-
'Performs an HTTP POST
|
|
2976
|
+
'Performs an HTTP POST and returns the HTTP status code. The response body and the response headers (as a rowset) are written to optional output variables.',
|
|
2803
2977
|
params: [
|
|
2804
2978
|
{ name: 'url', description: 'Request URL', type: 'string' },
|
|
2805
2979
|
{ name: 'contentType', description: 'Content-Type header', type: 'string' },
|
|
@@ -2864,11 +3038,16 @@ export const FUNCTIONS = [
|
|
|
2864
3038
|
mcnNotes: null,
|
|
2865
3039
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-post-with-retry.html',
|
|
2866
3040
|
guideUrl: 'https://ampscript.guide/httppostwithretry/',
|
|
3041
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httppostwithretry/',
|
|
2867
3042
|
minArgs: 3,
|
|
2868
3043
|
maxArgs: INF,
|
|
2869
3044
|
category: 'HTTP',
|
|
3045
|
+
isConfirmed: true,
|
|
3046
|
+
differsFromOfficialDocs: true,
|
|
3047
|
+
officialDocsNote:
|
|
3048
|
+
'The official reference labels the responseStatus argument as storing the "status" of the request, but on a live Engagement CloudPage (child MID 518005426) it receives the response BODY and responseContentRowset receives the response HEADERS as a rowset (11 header rows observed). The HTTP status code is the function return value. The numRetries, reschedule and returnExceptionOnError arguments are all accepted at runtime; retry-on-failure is documented but was not forced here because a transient failure could not be induced safely against the echo endpoint.',
|
|
2870
3049
|
description:
|
|
2871
|
-
'Posts content to the specified URL with automatic retry logic on failure. Similar to HTTPPost2 but adds configurable retries and rescheduling.',
|
|
3050
|
+
'Posts content to the specified URL with automatic retry logic on failure, and returns the HTTP status code. Similar to HTTPPost2 but adds configurable retries and rescheduling; the response body and headers (as a rowset) are written to optional output variables.',
|
|
2872
3051
|
params: [
|
|
2873
3052
|
{ name: 'urlEndpoint', description: 'The URL to send the content to', type: 'string' },
|
|
2874
3053
|
{
|
|
@@ -2905,7 +3084,7 @@ export const FUNCTIONS = [
|
|
|
2905
3084
|
},
|
|
2906
3085
|
{
|
|
2907
3086
|
name: 'responseStatus',
|
|
2908
|
-
description: 'An AMPscript variable that
|
|
3087
|
+
description: 'An AMPscript variable that receives the response body',
|
|
2909
3088
|
type: 'string',
|
|
2910
3089
|
optional: true,
|
|
2911
3090
|
},
|
|
@@ -2951,8 +3130,13 @@ export const FUNCTIONS = [
|
|
|
2951
3130
|
mcnSince: null,
|
|
2952
3131
|
handlebarsEquivalent: null,
|
|
2953
3132
|
mcnNotes: null,
|
|
3133
|
+
isConfirmed: true,
|
|
3134
|
+
differsFromOfficialDocs: true,
|
|
3135
|
+
officialDocsNote:
|
|
3136
|
+
'Runtime-verified on a live Marketing Cloud Engagement CloudPage (child BU MID 518005426). The official reference states this function can only retrieve the standard HTTP headers listed in RFC 7231, but at runtime it also returns the value of a non-standard custom request header: a request sent with an X-Amp-Probe header returned that exact value, so the RFC 7231 restriction is not enforced when reading headers. A header that is absent from the request (for example Referer when none was sent) returns the empty string, matching the documented note.',
|
|
2954
3137
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-http/mc-ampscript-reference-http-request-header.html',
|
|
2955
3138
|
guideUrl: 'https://ampscript.guide/httprequestheader/',
|
|
3139
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/httprequestheader/',
|
|
2956
3140
|
minArgs: 1,
|
|
2957
3141
|
maxArgs: 1,
|
|
2958
3142
|
category: 'HTTP',
|
|
@@ -3042,6 +3226,13 @@ export const FUNCTIONS = [
|
|
|
3042
3226
|
returnDescription: 'An HTML img tag for the referenced image.',
|
|
3043
3227
|
syntax: 'Image(imageExternalKey[, defaultImageExternalKey])',
|
|
3044
3228
|
example: "%%=Image('CorpLogo', 'DefaultImage')=%%",
|
|
3229
|
+
isConfirmed: true,
|
|
3230
|
+
nonFunctionalAtRuntime: true,
|
|
3231
|
+
deprecated: true,
|
|
3232
|
+
deprecatedReason:
|
|
3233
|
+
'The classic Portfolio / Classic Content area this function reads from was retired in April 2023, so no image assets exist for it to reference on any current tenant, and every invocation aborts the page at runtime. Use ContentImageByKey or ContentImageByID against Content Builder image assets instead.',
|
|
3234
|
+
officialDocsNote:
|
|
3235
|
+
'No working invocation was found on either the child QA BU (MID 518005426) or the parent BU (MID 7281698). Image resolves images from the legacy Portfolio, whose creation and applications have been retired; no Portfolio assets exist on either BU to reference. Every attempt aborted the CloudPage with HTTP 422 and no output: a literal URL, a Content Builder asset external key, and a plausible Portfolio-style key were all tried on the child BU, and a Portfolio-style key on the parent BU. Use ContentImageByKey or ContentImageByID against Content Builder image assets instead.',
|
|
3045
3236
|
},
|
|
3046
3237
|
{
|
|
3047
3238
|
name: 'IndexOf',
|
|
@@ -3085,6 +3276,9 @@ export const FUNCTIONS = [
|
|
|
3085
3276
|
mcnNotes: null,
|
|
3086
3277
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-insert-data.html',
|
|
3087
3278
|
guideUrl: 'https://ampscript.guide/insertdata/',
|
|
3279
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/insertdata/',
|
|
3280
|
+
isConfirmed: true,
|
|
3281
|
+
differsFromOfficialDocs: false,
|
|
3088
3282
|
minArgs: 3,
|
|
3089
3283
|
maxArgs: INF,
|
|
3090
3284
|
category: 'Data Extension',
|
|
@@ -3127,6 +3321,9 @@ export const FUNCTIONS = [
|
|
|
3127
3321
|
mcnNotes: null,
|
|
3128
3322
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-insert-de.html',
|
|
3129
3323
|
guideUrl: 'https://ampscript.guide/insertde/',
|
|
3324
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/insertde/',
|
|
3325
|
+
isConfirmed: true,
|
|
3326
|
+
differsFromOfficialDocs: false,
|
|
3130
3327
|
minArgs: 3,
|
|
3131
3328
|
maxArgs: INF,
|
|
3132
3329
|
category: 'Data Extension',
|
|
@@ -3170,6 +3367,7 @@ export const FUNCTIONS = [
|
|
|
3170
3367
|
mcnNotes: null,
|
|
3171
3368
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-create.html',
|
|
3172
3369
|
guideUrl: 'https://ampscript.guide/invokecreate/',
|
|
3370
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokecreate/',
|
|
3173
3371
|
minArgs: 3,
|
|
3174
3372
|
maxArgs: 4,
|
|
3175
3373
|
category: 'Marketing Cloud API',
|
|
@@ -3200,9 +3398,12 @@ export const FUNCTIONS = [
|
|
|
3200
3398
|
},
|
|
3201
3399
|
],
|
|
3202
3400
|
returnType: 'string',
|
|
3203
|
-
returnDescription:
|
|
3401
|
+
returnDescription:
|
|
3402
|
+
"The SOAP OverallStatus as a string — 'OK' on success, 'Error' on failure. The human-readable message goes to the statusMessage out-variable and the numeric error code to errorCode.",
|
|
3403
|
+
returnEnum: ['OK', 'Error'],
|
|
3204
3404
|
syntax: 'InvokeCreate(apiObject, @statusMessage, @errorCode[, createOptionsObject])',
|
|
3205
3405
|
example: '%%=InvokeCreate(@apiObject, @statusMessage, @errorCode)=%%',
|
|
3406
|
+
isConfirmed: true,
|
|
3206
3407
|
},
|
|
3207
3408
|
{
|
|
3208
3409
|
name: 'InvokeDelete',
|
|
@@ -3211,6 +3412,7 @@ export const FUNCTIONS = [
|
|
|
3211
3412
|
mcnNotes: null,
|
|
3212
3413
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-delete.html',
|
|
3213
3414
|
guideUrl: 'https://ampscript.guide/invokedelete/',
|
|
3415
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokedelete/',
|
|
3214
3416
|
minArgs: 3,
|
|
3215
3417
|
maxArgs: 4,
|
|
3216
3418
|
category: 'Marketing Cloud API',
|
|
@@ -3241,9 +3443,12 @@ export const FUNCTIONS = [
|
|
|
3241
3443
|
},
|
|
3242
3444
|
],
|
|
3243
3445
|
returnType: 'string',
|
|
3244
|
-
returnDescription:
|
|
3446
|
+
returnDescription:
|
|
3447
|
+
"The SOAP OverallStatus as a string — 'OK' on success, 'Error' on failure. The human-readable message goes to the statusMessage out-variable and the numeric error code to errorCode.",
|
|
3448
|
+
returnEnum: ['OK', 'Error'],
|
|
3245
3449
|
syntax: 'InvokeDelete(apiObject, @statusMessage, @errorCode[, deleteOptionsObject])',
|
|
3246
3450
|
example: '%%=InvokeDelete(@apiObject, @statusMessage, @errorCode)=%%',
|
|
3451
|
+
isConfirmed: true,
|
|
3247
3452
|
},
|
|
3248
3453
|
{
|
|
3249
3454
|
name: 'InvokeExecute',
|
|
@@ -3252,6 +3457,7 @@ export const FUNCTIONS = [
|
|
|
3252
3457
|
mcnNotes: null,
|
|
3253
3458
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-execute.html',
|
|
3254
3459
|
guideUrl: 'https://ampscript.guide/invokeexecute/',
|
|
3460
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokeexecute/',
|
|
3255
3461
|
minArgs: 1,
|
|
3256
3462
|
maxArgs: 3,
|
|
3257
3463
|
category: 'Marketing Cloud API',
|
|
@@ -3276,9 +3482,10 @@ export const FUNCTIONS = [
|
|
|
3276
3482
|
],
|
|
3277
3483
|
returnType: 'rowset',
|
|
3278
3484
|
returnDescription:
|
|
3279
|
-
'A rowset containing the API
|
|
3485
|
+
'A rowset containing the API Results. Use Row() and Field() to read each result — StatusCode, StatusMessage and ErrorCode. The optional @statusMessage out-variable receives the OverallStatus string and @requestId receives the RequestID GUID.',
|
|
3280
3486
|
syntax: 'InvokeExecute(apiObject[, @statusMessage, @requestId])',
|
|
3281
3487
|
example: '%%[ SET @rows = InvokeExecute(@apiObject, @statusMessage, @requestId) ]%%',
|
|
3488
|
+
isConfirmed: true,
|
|
3282
3489
|
},
|
|
3283
3490
|
{
|
|
3284
3491
|
name: 'InvokePerform',
|
|
@@ -3287,6 +3494,7 @@ export const FUNCTIONS = [
|
|
|
3287
3494
|
mcnNotes: null,
|
|
3288
3495
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-perform.html',
|
|
3289
3496
|
guideUrl: 'https://ampscript.guide/invokeperform/',
|
|
3497
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokeperform/',
|
|
3290
3498
|
minArgs: 2,
|
|
3291
3499
|
maxArgs: 3,
|
|
3292
3500
|
category: 'Marketing Cloud API',
|
|
@@ -3308,9 +3516,12 @@ export const FUNCTIONS = [
|
|
|
3308
3516
|
},
|
|
3309
3517
|
],
|
|
3310
3518
|
returnType: 'string',
|
|
3311
|
-
returnDescription:
|
|
3519
|
+
returnDescription:
|
|
3520
|
+
"The SOAP OverallStatus as a string — 'OK' on success, 'Error' on failure. The human-readable message goes to the optional @statusMessage out-variable.",
|
|
3521
|
+
returnEnum: ['OK', 'Error'],
|
|
3312
3522
|
syntax: 'InvokePerform(apiObject, actionToPerform[, @statusMessage])',
|
|
3313
3523
|
example: "%%=InvokePerform(@apiObject, 'Start', @statusMessage)=%%",
|
|
3524
|
+
isConfirmed: true,
|
|
3314
3525
|
},
|
|
3315
3526
|
{
|
|
3316
3527
|
name: 'InvokeRetrieve',
|
|
@@ -3319,6 +3530,7 @@ export const FUNCTIONS = [
|
|
|
3319
3530
|
mcnNotes: null,
|
|
3320
3531
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-retrieve.html',
|
|
3321
3532
|
guideUrl: 'https://ampscript.guide/invokeretrieve/',
|
|
3533
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokeretrieve/',
|
|
3322
3534
|
minArgs: 1,
|
|
3323
3535
|
maxArgs: 3,
|
|
3324
3536
|
category: 'Marketing Cloud API',
|
|
@@ -3350,6 +3562,7 @@ export const FUNCTIONS = [
|
|
|
3350
3562
|
returnDescription: 'A rowset containing the retrieved API records.',
|
|
3351
3563
|
syntax: 'InvokeRetrieve(apiObject[, @statusMessage, @requestId])',
|
|
3352
3564
|
example: '%%[ SET @rows = InvokeRetrieve(@apiObject, @statusMessage, @requestId) ]%%',
|
|
3565
|
+
isConfirmed: true,
|
|
3353
3566
|
},
|
|
3354
3567
|
{
|
|
3355
3568
|
name: 'InvokeUpdate',
|
|
@@ -3358,6 +3571,7 @@ export const FUNCTIONS = [
|
|
|
3358
3571
|
mcnNotes: null,
|
|
3359
3572
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-invoke-update.html',
|
|
3360
3573
|
guideUrl: 'https://ampscript.guide/invokeupdate/',
|
|
3574
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/invokeupdate/',
|
|
3361
3575
|
minArgs: 1,
|
|
3362
3576
|
maxArgs: 4,
|
|
3363
3577
|
category: 'Marketing Cloud API',
|
|
@@ -3390,9 +3604,12 @@ export const FUNCTIONS = [
|
|
|
3390
3604
|
},
|
|
3391
3605
|
],
|
|
3392
3606
|
returnType: 'string',
|
|
3393
|
-
returnDescription:
|
|
3607
|
+
returnDescription:
|
|
3608
|
+
"The SOAP OverallStatus as a string — 'OK' on success, 'Error' on failure. The human-readable message goes to the statusMessage out-variable and the numeric error code to errorCode.",
|
|
3609
|
+
returnEnum: ['OK', 'Error'],
|
|
3394
3610
|
syntax: 'InvokeUpdate(apiObject[, @statusMessage, @errorCode, updateOptions])',
|
|
3395
3611
|
example: '%%=InvokeUpdate(@apiObject, @statusMessage, @errorCode)=%%',
|
|
3612
|
+
isConfirmed: true,
|
|
3396
3613
|
},
|
|
3397
3614
|
{
|
|
3398
3615
|
name: 'IsCHTMLBrowser',
|
|
@@ -3588,6 +3805,13 @@ export const FUNCTIONS = [
|
|
|
3588
3805
|
maxArgs: 2,
|
|
3589
3806
|
category: 'Content',
|
|
3590
3807
|
description: 'Generates a URL to a microsite page that serves live, dynamic content.',
|
|
3808
|
+
isConfirmed: true,
|
|
3809
|
+
nonFunctionalAtRuntime: true,
|
|
3810
|
+
deprecated: true,
|
|
3811
|
+
deprecatedReason:
|
|
3812
|
+
'Live Offers (Live Content) was removed from Marketing Cloud in 2019 and the Classic Microsites this URL points at were retired in June 2022, so there is no provisionable modern equivalent and every invocation aborts the page at runtime.',
|
|
3813
|
+
officialDocsNote:
|
|
3814
|
+
"Attempted on both the child QA BU (MID 518005426) and the parent BU (MID 7281698). Every invocation shape aborted the CloudPage with HTTP 200 lost to a 422 page abort: the documented-valid LiveContentMicrositeURL('coupon','MyCoupon'), an unknown content type, and an empty external key all failed identically. The function resolves a Live Offers (Live Content) coupon by external key, and no such Live Content asset is provisioned on either BU, so no working invocation could be produced. Left blocked pending a tenant with a real Live Offers coupon.",
|
|
3591
3815
|
params: [
|
|
3592
3816
|
{
|
|
3593
3817
|
name: 'contentType',
|
|
@@ -3644,6 +3868,9 @@ export const FUNCTIONS = [
|
|
|
3644
3868
|
mcnNotes: null,
|
|
3645
3869
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-long-sfid.html',
|
|
3646
3870
|
guideUrl: 'https://ampscript.guide/longsfid/',
|
|
3871
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/longsfid/',
|
|
3872
|
+
isConfirmed: true,
|
|
3873
|
+
differsFromOfficialDocs: false,
|
|
3647
3874
|
minArgs: 1,
|
|
3648
3875
|
maxArgs: 1,
|
|
3649
3876
|
category: 'Sales and Service Cloud',
|
|
@@ -3664,11 +3891,14 @@ export const FUNCTIONS = [
|
|
|
3664
3891
|
'In MCN, search arguments must be provided in column/value pairs - an odd count causes an error. All filter keys must fully specify the composite primary key.',
|
|
3665
3892
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup.html',
|
|
3666
3893
|
guideUrl: 'https://ampscript.guide/lookup/',
|
|
3894
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookup/',
|
|
3895
|
+
isConfirmed: true,
|
|
3896
|
+
differsFromOfficialDocs: false,
|
|
3667
3897
|
minArgs: 4,
|
|
3668
3898
|
maxArgs: INF,
|
|
3669
3899
|
category: 'Data Extension',
|
|
3670
3900
|
description:
|
|
3671
|
-
'Returns a single field value from the first matching row in a data extension.',
|
|
3901
|
+
'Returns a single field value from the first matching row in a data extension. A no-match returns an empty string.',
|
|
3672
3902
|
params: [
|
|
3673
3903
|
{
|
|
3674
3904
|
name: 'dataObject',
|
|
@@ -3711,6 +3941,9 @@ export const FUNCTIONS = [
|
|
|
3711
3941
|
mcnNotes: null,
|
|
3712
3942
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup-ordered-rows.html',
|
|
3713
3943
|
guideUrl: 'https://ampscript.guide/lookuporderedrows/',
|
|
3944
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookuporderedrows/',
|
|
3945
|
+
isConfirmed: true,
|
|
3946
|
+
differsFromOfficialDocs: false,
|
|
3714
3947
|
minArgs: 5,
|
|
3715
3948
|
maxArgs: INF,
|
|
3716
3949
|
category: 'Data Extension',
|
|
@@ -3766,6 +3999,9 @@ export const FUNCTIONS = [
|
|
|
3766
3999
|
mcnNotes: null,
|
|
3767
4000
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup-ordered-rows-cs.html',
|
|
3768
4001
|
guideUrl: 'https://ampscript.guide/lookuporderedrowscs/',
|
|
4002
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookuporderedrowscs/',
|
|
4003
|
+
isConfirmed: true,
|
|
4004
|
+
differsFromOfficialDocs: false,
|
|
3769
4005
|
minArgs: 5,
|
|
3770
4006
|
maxArgs: INF,
|
|
3771
4007
|
category: 'Data Extension',
|
|
@@ -3820,6 +4056,9 @@ export const FUNCTIONS = [
|
|
|
3820
4056
|
mcnNotes: null,
|
|
3821
4057
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup-rows.html',
|
|
3822
4058
|
guideUrl: 'https://ampscript.guide/lookuprows/',
|
|
4059
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookuprows/',
|
|
4060
|
+
isConfirmed: true,
|
|
4061
|
+
differsFromOfficialDocs: false,
|
|
3823
4062
|
minArgs: 3,
|
|
3824
4063
|
maxArgs: INF,
|
|
3825
4064
|
category: 'Data Extension',
|
|
@@ -3860,6 +4099,9 @@ export const FUNCTIONS = [
|
|
|
3860
4099
|
mcnNotes: null,
|
|
3861
4100
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-lookup-rows-cs.html',
|
|
3862
4101
|
guideUrl: 'https://ampscript.guide/lookuprowscs/',
|
|
4102
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/lookuprowscs/',
|
|
4103
|
+
isConfirmed: true,
|
|
4104
|
+
differsFromOfficialDocs: false,
|
|
3863
4105
|
minArgs: 3,
|
|
3864
4106
|
maxArgs: INF,
|
|
3865
4107
|
category: 'Data Extension',
|
|
@@ -3970,6 +4212,11 @@ export const FUNCTIONS = [
|
|
|
3970
4212
|
category: 'MobileConnect',
|
|
3971
4213
|
description:
|
|
3972
4214
|
'Returns the URL of MMS content from an inbound mobile-originated (MO) message. Only usable in MobileConnect.',
|
|
4215
|
+
isConfirmed: false,
|
|
4216
|
+
verificationBlocked: true,
|
|
4217
|
+
verificationBlockedReason: 'no-working-invocation',
|
|
4218
|
+
officialDocsNote:
|
|
4219
|
+
'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation is configured on this tenant). Including an MMS_Content_URL(0) call in the injected content block aborted the whole page at compile time (HTTP 422) even when the call sat inside a non-matching IF branch, while an otherwise identical page with the call removed rendered HTTP 200. This matches the official reference, which states the function is usable only in MobileConnect and not in landing pages or other content types; there is no mobile-originated message context on a CloudPage to exercise it against.',
|
|
3973
4220
|
params: [
|
|
3974
4221
|
{
|
|
3975
4222
|
name: 'position',
|
|
@@ -4070,6 +4317,11 @@ export const FUNCTIONS = [
|
|
|
4070
4317
|
category: 'MobileConnect',
|
|
4071
4318
|
description:
|
|
4072
4319
|
'Returns the content of an inbound mobile-originated (MO) message. Only usable in MobileConnect. The only accepted argument value is 0.',
|
|
4320
|
+
isConfirmed: false,
|
|
4321
|
+
verificationBlocked: true,
|
|
4322
|
+
verificationBlockedReason: 'no-working-invocation',
|
|
4323
|
+
officialDocsNote:
|
|
4324
|
+
'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation is configured on this tenant). A page containing a Msg(0) call aborted at compile time (HTTP 422) even when the call sat inside a non-matching IF branch, whereas the same page with no Msg construct rendered HTTP 200 — so the abort happens at parse time, before any runtime gate. This matches the official reference, which states the function is usable only in MobileConnect and not in landing pages or other content types; a CloudPage supplies no mobile-originated message to read.',
|
|
4073
4325
|
params: [
|
|
4074
4326
|
{
|
|
4075
4327
|
name: 'index',
|
|
@@ -4118,6 +4370,11 @@ export const FUNCTIONS = [
|
|
|
4118
4370
|
category: 'MobileConnect',
|
|
4119
4371
|
description:
|
|
4120
4372
|
'Returns a single word that follows the keyword in an inbound mobile-originated (MO) message, by position. Only usable in MobileConnect, chained off Msg(0).',
|
|
4373
|
+
isConfirmed: false,
|
|
4374
|
+
verificationBlocked: true,
|
|
4375
|
+
verificationBlockedReason: 'no-working-invocation',
|
|
4376
|
+
officialDocsNote:
|
|
4377
|
+
'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation on this tenant). Noun is chained off Msg(0), and any page containing a Msg(0) construct aborts at compile time (HTTP 422) on a CloudPage while an otherwise identical page without it renders HTTP 200. This matches the official reference, which restricts the function to MobileConnect and forbids landing pages / other content types; a CloudPage supplies no mobile-originated message to parse.',
|
|
4121
4378
|
params: [
|
|
4122
4379
|
{
|
|
4123
4380
|
name: 'position',
|
|
@@ -4143,6 +4400,11 @@ export const FUNCTIONS = [
|
|
|
4143
4400
|
category: 'MobileConnect',
|
|
4144
4401
|
description:
|
|
4145
4402
|
'Returns all message content that follows the keyword in an inbound mobile-originated (MO) message. Only usable in MobileConnect, chained off Msg(0). Takes no arguments.',
|
|
4403
|
+
isConfirmed: false,
|
|
4404
|
+
verificationBlocked: true,
|
|
4405
|
+
verificationBlockedReason: 'no-working-invocation',
|
|
4406
|
+
officialDocsNote:
|
|
4407
|
+
'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation on this tenant). Nouns is chained off Msg(0), and any page containing a Msg(0) construct aborts at compile time (HTTP 422) on a CloudPage while an otherwise identical page without it renders HTTP 200. This matches the official reference, which restricts the function to MobileConnect and forbids landing pages / other content types; a CloudPage supplies no mobile-originated message to parse.',
|
|
4146
4408
|
params: [],
|
|
4147
4409
|
returnType: 'string',
|
|
4148
4410
|
returnDescription: 'All content that follows the keyword in the inbound message.',
|
|
@@ -4397,6 +4659,11 @@ export const FUNCTIONS = [
|
|
|
4397
4659
|
returnDescription: 'An HTML string of star images representing the rating.',
|
|
4398
4660
|
syntax: 'RatingStars(rating, maxRating, imageUrl)',
|
|
4399
4661
|
example: "%%=RatingStars(4, 5, 'https://example.com/star.png')=%%",
|
|
4662
|
+
isConfirmed: false,
|
|
4663
|
+
verificationBlocked: true,
|
|
4664
|
+
verificationBlockedReason: 'no-test-data',
|
|
4665
|
+
officialDocsNote:
|
|
4666
|
+
'No working CloudPage invocation was found. Any valid-arity call aborts the whole page with HTTP 422 at compile time, even when placed inside an unreached IF gate, so it cannot be probed behind a query-string switch. Two signature shapes were each deployed as the whole page: the catalog form RatingStars(4, 5, "https://example.com/star.png") and the ampscript.guide form RatingStars(5, "yellow", 25). Both returned HTTP 422 on the child BU (MID 518005426) and again on the parent BU (MID 7281698). The surrounding harness structure (RequestParameter gating, IF/ELSE/ENDIF) returned HTTP 200 once the RatingStars call was removed, confirming the abort is caused by the function itself, not the harness. RatingStars is an Einstein Email Recommendations helper that appears to resolve only inside the recommendations rendering context, which a bare CloudPage does not supply.',
|
|
4400
4667
|
},
|
|
4401
4668
|
{
|
|
4402
4669
|
name: 'Redirect',
|
|
@@ -4632,6 +4899,11 @@ export const FUNCTIONS = [
|
|
|
4632
4899
|
syntax: 'RetrieveMSCRMRecords(entityName, fieldsToRetrieve, queryFieldName, queryFieldOperator, queryFieldValue)',
|
|
4633
4900
|
example:
|
|
4634
4901
|
"%%[ SET @rows = RetrieveMSCRMRecords('contact', 'fullname,emailaddress1', 'lastname', 'eq', 'Smith') ]%%",
|
|
4902
|
+
isConfirmed: true,
|
|
4903
|
+
nonFunctionalAtRuntime: true,
|
|
4904
|
+
deprecated: true,
|
|
4905
|
+
deprecatedReason:
|
|
4906
|
+
'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.',
|
|
4635
4907
|
},
|
|
4636
4908
|
{
|
|
4637
4909
|
name: 'RetrieveMSCRMRecordsFetchXML',
|
|
@@ -4649,6 +4921,11 @@ export const FUNCTIONS = [
|
|
|
4649
4921
|
returnDescription: 'A rowset of CRM records matching the FetchXML query.',
|
|
4650
4922
|
syntax: 'RetrieveMSCRMRecordsFetchXML(fetchXml)',
|
|
4651
4923
|
example: '%%[ SET @rows = RetrieveMSCRMRecordsFetchXML(@fetchXml) ]%%',
|
|
4924
|
+
isConfirmed: true,
|
|
4925
|
+
nonFunctionalAtRuntime: true,
|
|
4926
|
+
deprecated: true,
|
|
4927
|
+
deprecatedReason:
|
|
4928
|
+
'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.',
|
|
4652
4929
|
},
|
|
4653
4930
|
{
|
|
4654
4931
|
name: 'RetrieveSalesforceJobSources',
|
|
@@ -4657,13 +4934,25 @@ export const FUNCTIONS = [
|
|
|
4657
4934
|
mcnNotes: null,
|
|
4658
4935
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-retrieve-job-sources.html',
|
|
4659
4936
|
guideUrl: 'https://ampscript.guide/retrievesalesforcejobsources/',
|
|
4937
|
+
sfmcGuideUrl:
|
|
4938
|
+
'https://sfmc.guide/engagement/ampscript/functions/retrievesalesforcejobsources/',
|
|
4939
|
+
isConfirmed: true,
|
|
4940
|
+
differsFromOfficialDocs: false,
|
|
4660
4941
|
minArgs: 1,
|
|
4661
4942
|
maxArgs: 1,
|
|
4662
4943
|
category: 'Sales and Service Cloud',
|
|
4663
|
-
description:
|
|
4664
|
-
|
|
4944
|
+
description:
|
|
4945
|
+
'Retrieves the source records (SourceID, SourceType, IsInclusionSource) that made up the audience of a Salesforce-triggered send, matched by its numeric job ID, and returns them as a rowset. Requires an active Marketing Cloud Connect integration. A job ID with no matching sources returns an empty rowset rather than an error; the function reports nothing about the job status.',
|
|
4946
|
+
params: [
|
|
4947
|
+
{
|
|
4948
|
+
name: 'jobId',
|
|
4949
|
+
description: 'The numeric job ID of the Salesforce send',
|
|
4950
|
+
type: 'number',
|
|
4951
|
+
},
|
|
4952
|
+
],
|
|
4665
4953
|
returnType: 'rowset',
|
|
4666
|
-
returnDescription:
|
|
4954
|
+
returnDescription:
|
|
4955
|
+
'A rowset of the send sources (SourceID, SourceType, IsInclusionSource); an empty rowset when the job ID has no matching sources.',
|
|
4667
4956
|
syntax: 'RetrieveSalesforceJobSources(jobId)',
|
|
4668
4957
|
example: '%%[ SET @rows = RetrieveSalesforceJobSources(@jobId) ]%%',
|
|
4669
4958
|
},
|
|
@@ -4675,10 +4964,15 @@ export const FUNCTIONS = [
|
|
|
4675
4964
|
mcnNotes: null,
|
|
4676
4965
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-retrieve-objects.html',
|
|
4677
4966
|
guideUrl: 'https://ampscript.guide/retrievesalesforceobjects/',
|
|
4967
|
+
sfmcGuideUrl:
|
|
4968
|
+
'https://sfmc.guide/engagement/ampscript/functions/retrievesalesforceobjects/',
|
|
4969
|
+
isConfirmed: true,
|
|
4970
|
+
differsFromOfficialDocs: false,
|
|
4678
4971
|
minArgs: 5,
|
|
4679
4972
|
maxArgs: INF,
|
|
4680
4973
|
category: 'Sales and Service Cloud',
|
|
4681
|
-
description:
|
|
4974
|
+
description:
|
|
4975
|
+
'Retrieves records from a connected Salesforce Sales or Service Cloud object via Marketing Cloud Connect and returns them as a rowset. Requires an active Marketing Cloud Connect integration; a call against an unknown object name aborts the page.',
|
|
4682
4976
|
params: [
|
|
4683
4977
|
{
|
|
4684
4978
|
name: 'objectName',
|
|
@@ -4736,10 +5030,14 @@ export const FUNCTIONS = [
|
|
|
4736
5030
|
mcnNotes: null,
|
|
4737
5031
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-row.html',
|
|
4738
5032
|
guideUrl: 'https://ampscript.guide/row/',
|
|
5033
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/row/',
|
|
5034
|
+
isConfirmed: true,
|
|
5035
|
+
differsFromOfficialDocs: false,
|
|
4739
5036
|
minArgs: 2,
|
|
4740
5037
|
maxArgs: 2,
|
|
4741
5038
|
category: 'Data Extension',
|
|
4742
|
-
description:
|
|
5039
|
+
description:
|
|
5040
|
+
'Returns a specific row from a rowset by its 1-based index. Index 0 (or any out-of-range index) aborts the page rather than returning an empty row.',
|
|
4743
5041
|
params: [
|
|
4744
5042
|
{ name: 'rowset', description: 'Rowset to access', type: 'rowset' },
|
|
4745
5043
|
{ name: 'rowIndex', description: '1-based row index', type: 'number' },
|
|
@@ -4757,6 +5055,9 @@ export const FUNCTIONS = [
|
|
|
4757
5055
|
mcnNotes: null,
|
|
4758
5056
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-row-count.html',
|
|
4759
5057
|
guideUrl: 'https://ampscript.guide/rowcount/',
|
|
5058
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/rowcount/',
|
|
5059
|
+
isConfirmed: true,
|
|
5060
|
+
differsFromOfficialDocs: false,
|
|
4760
5061
|
minArgs: 1,
|
|
4761
5062
|
maxArgs: 1,
|
|
4762
5063
|
category: 'Data Extension',
|
|
@@ -4774,6 +5075,7 @@ export const FUNCTIONS = [
|
|
|
4774
5075
|
mcnNotes: null,
|
|
4775
5076
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-api/mc-ampscript-reference-api-set-object-property.html',
|
|
4776
5077
|
guideUrl: 'https://ampscript.guide/setobjectproperty/',
|
|
5078
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/setobjectproperty/',
|
|
4777
5079
|
minArgs: 3,
|
|
4778
5080
|
maxArgs: 3,
|
|
4779
5081
|
category: 'Marketing Cloud API',
|
|
@@ -4795,26 +5097,48 @@ export const FUNCTIONS = [
|
|
|
4795
5097
|
returnDescription: 'No value is returned; the named property is set on the object.',
|
|
4796
5098
|
syntax: 'SetObjectProperty(apiObject, propertyName, propertyValue)',
|
|
4797
5099
|
example: "SetObjectProperty(@apiObject, 'LastName', 'Smith')",
|
|
5100
|
+
isConfirmed: true,
|
|
4798
5101
|
},
|
|
4799
5102
|
{
|
|
4800
5103
|
name: 'SetSmsConversationNextKeyword',
|
|
4801
5104
|
mcnSince: null,
|
|
4802
5105
|
handlebarsEquivalent: null,
|
|
4803
5106
|
mcnNotes: null,
|
|
5107
|
+
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-sms/mc-ampscript-reference-sms-set-sms-conversation-next-keyword.html',
|
|
4804
5108
|
guideUrl: 'https://ampscript.guide/setsmsconversationnextkeyword/',
|
|
4805
5109
|
minArgs: 3,
|
|
4806
5110
|
maxArgs: 3,
|
|
4807
5111
|
category: 'MobileConnect',
|
|
4808
|
-
description:
|
|
5112
|
+
description:
|
|
5113
|
+
'Sets the keyword for the next path of an existing SMS conversation, applied when the contact next replies. Does not create a new conversation. Returns true when set inside a MobileConnect message context, and false in any other context (for example a CloudPage or email). The success path cannot be exercised outside a live MobileConnect send.',
|
|
5114
|
+
isConfirmed: false,
|
|
5115
|
+
verificationBlocked: true,
|
|
5116
|
+
verificationBlockedReason: 'no-working-invocation',
|
|
5117
|
+
differsFromOfficialDocs: true,
|
|
5118
|
+
officialDocsNote:
|
|
5119
|
+
'Runtime-observed on cred/DEV (MID 510007949), the only BU available (no parent-BU escalation). This is an ordinary function call, so it compiles and runs on a CloudPage: called there with a real short code, the authorized destination number and a keyword, it returned the literal boolean false (Empty() false) and the page rendered fully with no exception — no SMS was sent and no conversation state changed. This confirms the ampscript.guide claim that the function returns false outside a MobileConnect message context; the official Salesforce reference omits this and describes only the in-context behaviour. The success path (true, keyword actually set) requires a live MobileConnect message context that cannot be captured on this tenant, so the function is recorded blocked for the success path while the CloudPage false-return is proven. The catalogued signature was corrected here: the three parameters are originationNumber, destinationNumber and keyword, and the return is a boolean, not void. A docUrl to the official reference was also added.',
|
|
4809
5120
|
params: [
|
|
4810
|
-
{
|
|
4811
|
-
|
|
4812
|
-
|
|
5121
|
+
{
|
|
5122
|
+
name: 'originationNumber',
|
|
5123
|
+
description: 'The MobileConnect short code or long code used to send',
|
|
5124
|
+
type: 'string',
|
|
5125
|
+
},
|
|
5126
|
+
{
|
|
5127
|
+
name: 'destinationNumber',
|
|
5128
|
+
description: "The contact's phone number, including country code",
|
|
5129
|
+
type: 'string',
|
|
5130
|
+
},
|
|
5131
|
+
{
|
|
5132
|
+
name: 'keyword',
|
|
5133
|
+
description: 'The string to set as the next conversation keyword',
|
|
5134
|
+
type: 'string',
|
|
5135
|
+
},
|
|
4813
5136
|
],
|
|
4814
|
-
returnType: '
|
|
4815
|
-
returnDescription:
|
|
4816
|
-
|
|
4817
|
-
|
|
5137
|
+
returnType: 'boolean',
|
|
5138
|
+
returnDescription:
|
|
5139
|
+
'true when the next keyword is set inside a MobileConnect message context; false in any other context (proven on a CloudPage). Fails with an exception in-context if unsuccessful.',
|
|
5140
|
+
syntax: 'SetSmsConversationNextKeyword(originationNumber, destinationNumber, keyword)',
|
|
5141
|
+
example: '%%=SetSmsConversationNextKeyword("12345", MOBILE_NUMBER, "EXAMPLE")=%%',
|
|
4818
5142
|
},
|
|
4819
5143
|
{
|
|
4820
5144
|
name: 'SetStateMscrmRecord',
|
|
@@ -4855,6 +5179,11 @@ export const FUNCTIONS = [
|
|
|
4855
5179
|
returnDescription: 'No value is returned; the record state and status are updated.',
|
|
4856
5180
|
syntax: 'SetStateMscrmRecord(recordGuid, entityName, stateToSet, statusToSet)',
|
|
4857
5181
|
example: "SetStateMscrmRecord(@guid, 'contact', 'active', 1)",
|
|
5182
|
+
isConfirmed: true,
|
|
5183
|
+
nonFunctionalAtRuntime: true,
|
|
5184
|
+
deprecated: true,
|
|
5185
|
+
deprecatedReason:
|
|
5186
|
+
'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.',
|
|
4858
5187
|
},
|
|
4859
5188
|
{
|
|
4860
5189
|
name: 'SHA1',
|
|
@@ -5141,10 +5470,12 @@ export const FUNCTIONS = [
|
|
|
5141
5470
|
mcnNotes: null,
|
|
5142
5471
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-transform-xml.html',
|
|
5143
5472
|
guideUrl: 'https://ampscript.guide/transformxml/',
|
|
5473
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/transformxml/',
|
|
5144
5474
|
minArgs: 2,
|
|
5145
5475
|
maxArgs: 2,
|
|
5146
5476
|
category: 'Content',
|
|
5147
5477
|
description: 'Transforms an XML document using an XSLT stylesheet.',
|
|
5478
|
+
isConfirmed: true,
|
|
5148
5479
|
params: [
|
|
5149
5480
|
{ name: 'xmlDocument', description: 'XML document string', type: 'string' },
|
|
5150
5481
|
{ name: 'xslDocument', description: 'XSLT stylesheet string', type: 'string' },
|
|
@@ -5161,11 +5492,14 @@ export const FUNCTIONS = [
|
|
|
5161
5492
|
mcnNotes: null,
|
|
5162
5493
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-treat-as-content.html',
|
|
5163
5494
|
guideUrl: 'https://ampscript.guide/treatascontent/',
|
|
5495
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/treatascontent/',
|
|
5164
5496
|
minArgs: 1,
|
|
5165
5497
|
maxArgs: 1,
|
|
5498
|
+
isConfirmed: true,
|
|
5499
|
+
differsFromOfficialDocs: false,
|
|
5166
5500
|
category: 'Content',
|
|
5167
5501
|
description:
|
|
5168
|
-
'Evaluates a string as AMPscript content, rendering any embedded AMPscript expressions.',
|
|
5502
|
+
'Evaluates a string as AMPscript content, rendering any embedded AMPscript expressions, and returns the rendered string. Plain text and the empty string pass through unchanged.',
|
|
5169
5503
|
params: [
|
|
5170
5504
|
{
|
|
5171
5505
|
name: 'stringToReturn',
|
|
@@ -5187,11 +5521,14 @@ export const FUNCTIONS = [
|
|
|
5187
5521
|
mcnNotes: null,
|
|
5188
5522
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-content/mc-ampscript-reference-content-treat-as-content-area.html',
|
|
5189
5523
|
guideUrl: 'https://ampscript.guide/treatascontentarea/',
|
|
5524
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/treatascontentarea/',
|
|
5190
5525
|
minArgs: 2,
|
|
5191
5526
|
maxArgs: 3,
|
|
5527
|
+
isConfirmed: true,
|
|
5528
|
+
differsFromOfficialDocs: false,
|
|
5192
5529
|
category: 'Content',
|
|
5193
5530
|
description:
|
|
5194
|
-
'
|
|
5531
|
+
'Stores a content string under a key for the duration of a send and renders it, evaluating any embedded AMPscript. An optional third argument names an impression region.',
|
|
5195
5532
|
params: [
|
|
5196
5533
|
{ name: 'contentKey', description: 'Content area key identifier', type: 'string' },
|
|
5197
5534
|
{ name: 'contentValue', description: 'HTML/AMPscript content', type: 'string' },
|
|
@@ -5240,6 +5577,9 @@ export const FUNCTIONS = [
|
|
|
5240
5577
|
mcnNotes: null,
|
|
5241
5578
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-update-data.html',
|
|
5242
5579
|
guideUrl: 'https://ampscript.guide/updatedata/',
|
|
5580
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/updatedata/',
|
|
5581
|
+
isConfirmed: true,
|
|
5582
|
+
differsFromOfficialDocs: false,
|
|
5243
5583
|
minArgs: 6,
|
|
5244
5584
|
maxArgs: INF,
|
|
5245
5585
|
category: 'Data Extension',
|
|
@@ -5305,6 +5645,9 @@ export const FUNCTIONS = [
|
|
|
5305
5645
|
mcnNotes: null,
|
|
5306
5646
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-update-de.html',
|
|
5307
5647
|
guideUrl: 'https://ampscript.guide/updatede/',
|
|
5648
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/updatede/',
|
|
5649
|
+
isConfirmed: true,
|
|
5650
|
+
differsFromOfficialDocs: false,
|
|
5308
5651
|
minArgs: 6,
|
|
5309
5652
|
maxArgs: INF,
|
|
5310
5653
|
category: 'Data Extension',
|
|
@@ -5411,6 +5754,11 @@ export const FUNCTIONS = [
|
|
|
5411
5754
|
repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1 }],
|
|
5412
5755
|
syntax: 'UpdateMSCRMRecords(entityName, guidsToUpdate, attributeName1, attributeValue1[, attributeNameN, attributeValueN, ...])',
|
|
5413
5756
|
example: "%%=UpdateMSCRMRecords('contact', @guids, 'lastname', 'Smith')=%%",
|
|
5757
|
+
isConfirmed: true,
|
|
5758
|
+
nonFunctionalAtRuntime: true,
|
|
5759
|
+
deprecated: true,
|
|
5760
|
+
deprecatedReason:
|
|
5761
|
+
'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.',
|
|
5414
5762
|
},
|
|
5415
5763
|
{
|
|
5416
5764
|
name: 'UpdateSingleSalesforceObject',
|
|
@@ -5419,11 +5767,17 @@ export const FUNCTIONS = [
|
|
|
5419
5767
|
mcnNotes: null,
|
|
5420
5768
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-salesforce/mc-ampscript-reference-salesforce-update-single-object.html',
|
|
5421
5769
|
guideUrl: 'https://ampscript.guide/updatesinglesalesforceobject/',
|
|
5770
|
+
sfmcGuideUrl:
|
|
5771
|
+
'https://sfmc.guide/engagement/ampscript/functions/updatesinglesalesforceobject/',
|
|
5422
5772
|
minArgs: 4,
|
|
5423
5773
|
maxArgs: INF,
|
|
5424
5774
|
category: 'Sales and Service Cloud',
|
|
5425
5775
|
description:
|
|
5426
|
-
'Updates a single record in a connected Salesforce
|
|
5776
|
+
'Updates a single record in a connected Salesforce Sales or Service Cloud object via Marketing Cloud Connect. Accepts one or more field name and value pairs. Returns 1 on success; per the official reference it returns 0 on failure, but on a CloudPage a failed update (unknown object, malformed or non-existent record ID) instead surfaces the SOAP fault as an uncatchable page abort rather than returning 0.',
|
|
5777
|
+
isConfirmed: true,
|
|
5778
|
+
differsFromOfficialDocs: false,
|
|
5779
|
+
officialDocsNote:
|
|
5780
|
+
'The success token 1 was runtime-proven on cred/DEV (MID 510007949), which has an active Marketing Cloud Connect integration to a real Salesforce org: updating one field of a record created moments earlier in the same run (a benign Task) returned the literal 1 with the page rendering fully. The failure token 0 is NOT observable in CloudPage GET context: every safe induced failure (unknown object, a malformed ID, and a well-formed but non-existent Lead ID at both 15 and 18 characters, on a real field) aborted the whole page with HTTP 422 — the SOAP fault propagates as an uncatchable page abort (identical to CreateSalesforceObject and RetrieveSalesforceObjects against a bad target), so the documented 0 return never materialises to be read. returnEnum is therefore left unset: only 1 is provable here, and asserting a [0,1] enum would ship the unproven 0 token. returnType stays number and the 0/1 semantics are retained in the description as a documented fact attributed to the official reference. The 0-on-CloudPage-abort behaviour is a context observation, not a contradiction of the send/preview-context 0/1 contract, so differsFromOfficialDocs stays false.',
|
|
5427
5781
|
params: [
|
|
5428
5782
|
{
|
|
5429
5783
|
name: 'objectName',
|
|
@@ -5446,8 +5800,8 @@ export const FUNCTIONS = [
|
|
|
5446
5800
|
{ name: 'fieldValueN', description: 'Additional field value', optional: true },
|
|
5447
5801
|
],
|
|
5448
5802
|
returnType: 'number',
|
|
5449
|
-
returnDescription:
|
|
5450
|
-
|
|
5803
|
+
returnDescription:
|
|
5804
|
+
'1 when the record was updated successfully (runtime-proven). Per the official reference a failed update returns 0, but on a CloudPage a failure aborts the page (HTTP 422) instead of returning 0, so the 0 token is not observable in that context.',
|
|
5451
5805
|
repeat: [{ startIndex: 2, groupSize: 2, minGroups: 1 }],
|
|
5452
5806
|
syntax: 'UpdateSingleSalesforceObject(objectName, idToUpdate, fieldName1, fieldValue1[, fieldNameN, fieldValueN, ...])',
|
|
5453
5807
|
example: "%%=UpdateSingleSalesforceObject('Contact', @recordId, 'LastName', 'Smith')=%%",
|
|
@@ -5487,11 +5841,16 @@ export const FUNCTIONS = [
|
|
|
5487
5841
|
mcnNotes: null,
|
|
5488
5842
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-contacts/mc-ampscript-reference-contacts-upsert-contact.html',
|
|
5489
5843
|
guideUrl: 'https://ampscript.guide/upsertcontact/',
|
|
5844
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/upsertcontact/',
|
|
5490
5845
|
minArgs: 5,
|
|
5491
5846
|
maxArgs: INF,
|
|
5492
5847
|
category: 'MobileConnect',
|
|
5493
5848
|
description:
|
|
5494
|
-
|
|
5849
|
+
"Upserts attributes onto a mobile contact matched by phone number. If the contact exists it is updated; otherwise a new contact is created. Returns a status code: 0 when the upsert succeeds and 1 when an error occurs. The only supported channel is 'mobile' and the only supported match attribute is 'phone'. An unknown attribute name returns the error status without writing anything.",
|
|
5850
|
+
isConfirmed: true,
|
|
5851
|
+
differsFromOfficialDocs: false,
|
|
5852
|
+
officialDocsNote:
|
|
5853
|
+
'Both return tokens were runtime-proven on cred/DEV (MID 510007949). The success status 0 was proven by creating a brand-new mobile contact keyed on an opaque, unreachable phone number in a reserved test range with a documented system attribute (_ZipCode); calling the same key a second time with a different value updated that contact and again returned 0, so both the create and update branches of the upsert return 0. The error status 1 was proven three independent ways (unsupported channel, unsupported match attribute, non-numeric phone) and again by passing an attribute name that is not a defined MobileConnect attribute — each returned 1 with the page rendering fully and no write performed. The return is a status code (0 success / 1 error), not a count of records. The phone-number argument accepts both an integer literal and a numeric string (both returned 0 for a successful create). runtime matches the official reference, so differsFromOfficialDocs stays false.',
|
|
5495
5854
|
params: [
|
|
5496
5855
|
{
|
|
5497
5856
|
name: 'channel',
|
|
@@ -5507,7 +5866,7 @@ export const FUNCTIONS = [
|
|
|
5507
5866
|
{
|
|
5508
5867
|
name: 'phoneNumber',
|
|
5509
5868
|
description: 'The phone number of the contact, including the country code',
|
|
5510
|
-
type: 'number',
|
|
5869
|
+
type: 'string|number',
|
|
5511
5870
|
},
|
|
5512
5871
|
{
|
|
5513
5872
|
name: 'keyToUpsert1',
|
|
@@ -5530,10 +5889,12 @@ export const FUNCTIONS = [
|
|
|
5530
5889
|
{ name: 'valueToUpsertN', description: 'Additional attribute value', optional: true },
|
|
5531
5890
|
],
|
|
5532
5891
|
returnType: 'number',
|
|
5533
|
-
|
|
5892
|
+
returnEnum: [0, 1],
|
|
5893
|
+
returnDescription:
|
|
5894
|
+
'A status code: 0 when the upsert succeeds (both creating a new contact and updating an existing one), 1 when an error occurs. Both tokens were proven at runtime.',
|
|
5534
5895
|
repeat: [{ startIndex: 3, groupSize: 2, minGroups: 1 }],
|
|
5535
5896
|
syntax: 'UpsertContact(channel, attribute, phoneNumber, keyToUpsert1, valueToUpsert1[, keyToUpsertN, valueToUpsertN, ...])',
|
|
5536
|
-
example: "%%=UpsertContact('
|
|
5897
|
+
example: "%%=UpsertContact('mobile', 'phone', 14255550142, '_ZipCode', '98026')=%%",
|
|
5537
5898
|
},
|
|
5538
5899
|
{
|
|
5539
5900
|
name: 'UpsertData',
|
|
@@ -5542,6 +5903,9 @@ export const FUNCTIONS = [
|
|
|
5542
5903
|
mcnNotes: null,
|
|
5543
5904
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-upsert-data.html',
|
|
5544
5905
|
guideUrl: 'https://ampscript.guide/upsertdata/',
|
|
5906
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/upsertdata/',
|
|
5907
|
+
isConfirmed: true,
|
|
5908
|
+
differsFromOfficialDocs: false,
|
|
5545
5909
|
minArgs: 6,
|
|
5546
5910
|
maxArgs: INF,
|
|
5547
5911
|
category: 'Data Extension',
|
|
@@ -5617,6 +5981,9 @@ export const FUNCTIONS = [
|
|
|
5617
5981
|
mcnNotes: null,
|
|
5618
5982
|
docUrl: 'https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-data-extension/mc-ampscript-reference-data-extension-upsert-de.html',
|
|
5619
5983
|
guideUrl: 'https://ampscript.guide/upsertde/',
|
|
5984
|
+
sfmcGuideUrl: 'https://sfmc.guide/engagement/ampscript/functions/upsertde/',
|
|
5985
|
+
isConfirmed: true,
|
|
5986
|
+
differsFromOfficialDocs: false,
|
|
5620
5987
|
minArgs: 6,
|
|
5621
5988
|
maxArgs: INF,
|
|
5622
5989
|
category: 'Data Extension',
|
|
@@ -5751,6 +6118,11 @@ export const FUNCTIONS = [
|
|
|
5751
6118
|
syntax: 'UpsertMSCRMRecord(entityName, sortField, sortType, numPairsForRetrieve, filterAttributeName, filterAttributeValue, numPairsForUpdate, updateAttributeName, updateAttributeValue)',
|
|
5752
6119
|
example:
|
|
5753
6120
|
"%%=UpsertMSCRMRecord('contact', 'createdon', 'DESC', 1, 'emailaddress1', @email, 1, 'lastname', 'Smith')=%%",
|
|
6121
|
+
isConfirmed: true,
|
|
6122
|
+
nonFunctionalAtRuntime: true,
|
|
6123
|
+
deprecated: true,
|
|
6124
|
+
deprecatedReason:
|
|
6125
|
+
'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.',
|
|
5754
6126
|
},
|
|
5755
6127
|
{
|
|
5756
6128
|
name: 'URLEncode',
|
|
@@ -5808,6 +6180,11 @@ export const FUNCTIONS = [
|
|
|
5808
6180
|
category: 'MobileConnect',
|
|
5809
6181
|
description:
|
|
5810
6182
|
'Returns the keyword (verb) from an inbound mobile-originated (MO) message. Only usable in MobileConnect, chained off Msg(0). Takes no arguments.',
|
|
6183
|
+
isConfirmed: false,
|
|
6184
|
+
verificationBlocked: true,
|
|
6185
|
+
verificationBlockedReason: 'no-working-invocation',
|
|
6186
|
+
officialDocsNote:
|
|
6187
|
+
'Could not runtime-verify on the only available context (a CloudPage GET on cred/DEV, MID 510007949; no parent-BU escalation on this tenant). Verb is chained off Msg(0), and any page containing a Msg(0) construct aborts at compile time (HTTP 422) on a CloudPage while an otherwise identical page without it renders HTTP 200. This matches the official reference, which restricts the function to MobileConnect and forbids landing pages / other content types; a CloudPage supplies no mobile-originated message to parse.',
|
|
5811
6188
|
params: [],
|
|
5812
6189
|
returnType: 'string',
|
|
5813
6190
|
returnDescription: 'The keyword (first word) of the inbound mobile-originated message.',
|
|
@@ -6031,6 +6408,17 @@ export const deprecatedFunctionLookup = new Map(
|
|
|
6031
6408
|
FUNCTIONS.filter((f) => f.deprecated).map((f) => [f.name.toLowerCase(), f]),
|
|
6032
6409
|
);
|
|
6033
6410
|
|
|
6411
|
+
/**
|
|
6412
|
+
* Case-insensitive lookup of functions that resolve at runtime but have no known
|
|
6413
|
+
* working invocation (`nonFunctionalAtRuntime`): lowercase name -> function entry.
|
|
6414
|
+
* Every reached call aborts the page (e.g. a retired Classic feature), so callers
|
|
6415
|
+
* can flag the call site. Kept separate from deprecation because these functions
|
|
6416
|
+
* were never formally deprecated by Salesforce.
|
|
6417
|
+
*/
|
|
6418
|
+
export const nonFunctionalFunctionLookup = new Map(
|
|
6419
|
+
FUNCTIONS.filter((f) => f.nonFunctionalAtRuntime).map((f) => [f.name.toLowerCase(), f]),
|
|
6420
|
+
);
|
|
6421
|
+
|
|
6034
6422
|
// ── Keywords ─────────────────────────────────────────────────────────────────
|
|
6035
6423
|
|
|
6036
6424
|
/**
|