@salesforce/plugin-data 4.0.40 → 4.0.41

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.
Files changed (3) hide show
  1. package/README.md +24 -24
  2. package/oclif.manifest.json +374 -374
  3. package/package.json +5 -5
package/README.md CHANGED
@@ -144,7 +144,7 @@ EXAMPLES
144
144
  $ sf data bulk results --job-id 7507i000fake341G --target-org my-scratch
145
145
  ```
146
146
 
147
- _See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/bulk/results.ts)_
147
+ _See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/bulk/results.ts)_
148
148
 
149
149
  ## `sf data create file`
150
150
 
@@ -193,7 +193,7 @@ EXAMPLES
193
193
  $ sf data create file --file path/to/astro.png --parent-id a03fakeLoJWPIA3
194
194
  ```
195
195
 
196
- _See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/create/file.ts)_
196
+ _See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/create/file.ts)_
197
197
 
198
198
  ## `sf data create record`
199
199
 
@@ -249,7 +249,7 @@ EXAMPLES
249
249
  TracedEntityId=01p17000000R6bLAAS"
250
250
  ```
251
251
 
252
- _See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/create/record.ts)_
252
+ _See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/create/record.ts)_
253
253
 
254
254
  ## `sf data delete bulk`
255
255
 
@@ -309,7 +309,7 @@ FLAG DESCRIPTIONS
309
309
  and can be enabled only by a system administrator.
310
310
  ```
311
311
 
312
- _See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/delete/bulk.ts)_
312
+ _See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/delete/bulk.ts)_
313
313
 
314
314
  ## `sf data delete record`
315
315
 
@@ -370,7 +370,7 @@ EXAMPLES
370
370
  $ sf data delete record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
371
371
  ```
372
372
 
373
- _See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/delete/record.ts)_
373
+ _See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/delete/record.ts)_
374
374
 
375
375
  ## `sf data delete resume`
376
376
 
@@ -409,7 +409,7 @@ EXAMPLES
409
409
  $ sf data delete resume --use-most-recent --target-org my-scratch
410
410
  ```
411
411
 
412
- _See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/delete/resume.ts)_
412
+ _See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/delete/resume.ts)_
413
413
 
414
414
  ## `sf data export bulk`
415
415
 
@@ -483,7 +483,7 @@ EXAMPLES
483
483
  --result-format json --async
484
484
  ```
485
485
 
486
- _See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/export/bulk.ts)_
486
+ _See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/export/bulk.ts)_
487
487
 
488
488
  ## `sf data export resume`
489
489
 
@@ -519,7 +519,7 @@ EXAMPLES
519
519
  $ sf data export resume --use-most-recent --target-org my-scratch
520
520
  ```
521
521
 
522
- _See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/export/resume.ts)_
522
+ _See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/export/resume.ts)_
523
523
 
524
524
  ## `sf data export tree`
525
525
 
@@ -579,7 +579,7 @@ EXAMPLES
579
579
  my-scratch
580
580
  ```
581
581
 
582
- _See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/export/tree.ts)_
582
+ _See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/export/tree.ts)_
583
583
 
584
584
  ## `sf data get record`
585
585
 
@@ -643,7 +643,7 @@ EXAMPLES
643
643
  $ sf data get record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
644
644
  ```
645
645
 
646
- _See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/get/record.ts)_
646
+ _See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/get/record.ts)_
647
647
 
648
648
  ## `sf data import bulk`
649
649
 
@@ -701,7 +701,7 @@ EXAMPLES
701
701
  $ sf data import bulk --file accounts.csv --sobject Account --async
702
702
  ```
703
703
 
704
- _See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/import/bulk.ts)_
704
+ _See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/import/bulk.ts)_
705
705
 
706
706
  ## `sf data import resume`
707
707
 
@@ -737,7 +737,7 @@ EXAMPLES
737
737
  $ sf data import resume --use-most-recent --target-org my-scratch
738
738
  ```
739
739
 
740
- _See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/import/resume.ts)_
740
+ _See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/import/resume.ts)_
741
741
 
742
742
  ## `sf data import tree`
743
743
 
@@ -801,7 +801,7 @@ FLAG DESCRIPTIONS
801
801
  - files(array) - Files: An array of files paths to load
802
802
  ```
803
803
 
804
- _See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/import/tree.ts)_
804
+ _See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/import/tree.ts)_
805
805
 
806
806
  ## `sf data query`
807
807
 
@@ -854,7 +854,7 @@ EXAMPLES
854
854
  $ sf data query --query "SELECT Name FROM ApexTrigger" --use-tooling-api
855
855
  ```
856
856
 
857
- _See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/query.ts)_
857
+ _See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/query.ts)_
858
858
 
859
859
  ## `sf data resume`
860
860
 
@@ -891,7 +891,7 @@ EXAMPLES
891
891
  $ sf data resume --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA
892
892
  ```
893
893
 
894
- _See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/resume.ts)_
894
+ _See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/resume.ts)_
895
895
 
896
896
  ## `sf data search`
897
897
 
@@ -941,7 +941,7 @@ EXAMPLES
941
941
  $ sf data search --file query.txt --target-org my-scratch --result-format csv
942
942
  ```
943
943
 
944
- _See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/search.ts)_
944
+ _See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/search.ts)_
945
945
 
946
946
  ## `sf data update bulk`
947
947
 
@@ -1002,7 +1002,7 @@ EXAMPLES
1002
1002
  $ sf data update bulk --file accounts.csv --sobject Account --async
1003
1003
  ```
1004
1004
 
1005
- _See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/update/bulk.ts)_
1005
+ _See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/update/bulk.ts)_
1006
1006
 
1007
1007
  ## `sf data update record`
1008
1008
 
@@ -1064,7 +1064,7 @@ EXAMPLES
1064
1064
  "ExpirationDate=2017-12-01T00:58:04.000+0000"
1065
1065
  ```
1066
1066
 
1067
- _See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/update/record.ts)_
1067
+ _See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/update/record.ts)_
1068
1068
 
1069
1069
  ## `sf data update resume`
1070
1070
 
@@ -1100,7 +1100,7 @@ EXAMPLES
1100
1100
  $ sf data update resume --use-most-recent --target-org my-scratch
1101
1101
  ```
1102
1102
 
1103
- _See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/update/resume.ts)_
1103
+ _See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/update/resume.ts)_
1104
1104
 
1105
1105
  ## `sf data upsert bulk`
1106
1106
 
@@ -1157,7 +1157,7 @@ EXAMPLES
1157
1157
  my-scratch
1158
1158
  ```
1159
1159
 
1160
- _See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/upsert/bulk.ts)_
1160
+ _See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/upsert/bulk.ts)_
1161
1161
 
1162
1162
  ## `sf data upsert resume`
1163
1163
 
@@ -1196,7 +1196,7 @@ EXAMPLES
1196
1196
  $ sf data upsert resume --use-most-recent --target-org my-scratch
1197
1197
  ```
1198
1198
 
1199
- _See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/upsert/resume.ts)_
1199
+ _See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/data/upsert/resume.ts)_
1200
1200
 
1201
1201
  ## `sf force data bulk delete`
1202
1202
 
@@ -1243,7 +1243,7 @@ EXAMPLES
1243
1243
  $ sf force data bulk delete --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch
1244
1244
  ```
1245
1245
 
1246
- _See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/force/data/bulk/delete.ts)_
1246
+ _See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/force/data/bulk/delete.ts)_
1247
1247
 
1248
1248
  ## `sf force data bulk status`
1249
1249
 
@@ -1280,7 +1280,7 @@ EXAMPLES
1280
1280
  $ sf force data bulk status --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --target-org my-scratch
1281
1281
  ```
1282
1282
 
1283
- _See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/force/data/bulk/status.ts)_
1283
+ _See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/force/data/bulk/status.ts)_
1284
1284
 
1285
1285
  ## `sf force data bulk upsert`
1286
1286
 
@@ -1338,6 +1338,6 @@ EXAMPLES
1338
1338
  --target-org my-scratch
1339
1339
  ```
1340
1340
 
1341
- _See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/force/data/bulk/upsert.ts)_
1341
+ _See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.41/src/commands/force/data/bulk/upsert.ts)_
1342
1342
 
1343
1343
  <!-- commandsstop -->
@@ -401,83 +401,6 @@
401
401
  "search:data"
402
402
  ]
403
403
  },
404
- "data:bulk:results": {
405
- "aliases": [],
406
- "args": {},
407
- "description": "Use this command to get the complete results after running one of the CLI commands that uses Bulk API 2.0 to ingest (import, update, upsert, or delete) large datasets to your org, such as \"data import bulk\". The previously-run bulk command must have completed; if it's still processing, run the corresponding resume command first, such as \"data import resume.\" Make note of the job ID of the previous bulk command because you use it to run this command. \n\nYou can also use this command to get results from running a bulk ingest job with a different tool, such as Data Loader, as long as you have the job ID. For information on Data Loader, see https://developer.salesforce.com/docs/atlas.en-us.dataLoader.meta/dataLoader/data_loader_intro.htm. \n\nThis command first displays the status of the previous bulk job, the operation that was executed in the org (such as insert or hard delete), and the updated Salesforce object. The command then displays how many records were processed in total, and how many were successful or failed. Finally, the output displays the names of the generated CSV-formatted files that contain the specific results for each ingested record. Depending on the success or failure of the bulk command, the results files can include the IDs of inserted records or the specific errors. When possible, if the ingest job failed or was aborted, you also get a CSV file with the unprocessed results.",
408
- "examples": [
409
- "Get results from a bulk ingest job; use the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --job-id 7507i000fake341G --target-org my-scratch"
410
- ],
411
- "flags": {
412
- "json": {
413
- "description": "Format output as json.",
414
- "helpGroup": "GLOBAL",
415
- "name": "json",
416
- "allowNo": false,
417
- "type": "boolean"
418
- },
419
- "flags-dir": {
420
- "helpGroup": "GLOBAL",
421
- "name": "flags-dir",
422
- "summary": "Import flag values from a directory.",
423
- "hasDynamicHelp": false,
424
- "multiple": false,
425
- "type": "option"
426
- },
427
- "job-id": {
428
- "char": "i",
429
- "name": "job-id",
430
- "required": true,
431
- "summary": "Job ID of the bulk job.",
432
- "hasDynamicHelp": false,
433
- "multiple": false,
434
- "type": "option"
435
- },
436
- "target-org": {
437
- "char": "o",
438
- "name": "target-org",
439
- "noCacheDefault": true,
440
- "required": true,
441
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
442
- "hasDynamicHelp": true,
443
- "multiple": false,
444
- "type": "option"
445
- },
446
- "api-version": {
447
- "description": "Override the api version used for api requests made by this command",
448
- "name": "api-version",
449
- "hasDynamicHelp": false,
450
- "multiple": false,
451
- "type": "option"
452
- }
453
- },
454
- "hasDynamicHelp": true,
455
- "hiddenAliases": [],
456
- "id": "data:bulk:results",
457
- "pluginAlias": "@salesforce/plugin-data",
458
- "pluginName": "@salesforce/plugin-data",
459
- "pluginType": "core",
460
- "strict": true,
461
- "summary": "Get the results of a bulk ingest job that you previously ran.",
462
- "enableJsonFlag": true,
463
- "isESM": true,
464
- "relativePath": [
465
- "lib",
466
- "commands",
467
- "data",
468
- "bulk",
469
- "results.js"
470
- ],
471
- "aliasPermutations": [],
472
- "permutations": [
473
- "data:bulk:results",
474
- "bulk:data:results",
475
- "bulk:results:data",
476
- "data:results:bulk",
477
- "results:data:bulk",
478
- "results:bulk:data"
479
- ]
480
- },
481
404
  "data:create:file": {
482
405
  "aliases": [],
483
406
  "args": {},
@@ -1179,6 +1102,83 @@
1179
1102
  "resume:delete:data"
1180
1103
  ]
1181
1104
  },
1105
+ "data:bulk:results": {
1106
+ "aliases": [],
1107
+ "args": {},
1108
+ "description": "Use this command to get the complete results after running one of the CLI commands that uses Bulk API 2.0 to ingest (import, update, upsert, or delete) large datasets to your org, such as \"data import bulk\". The previously-run bulk command must have completed; if it's still processing, run the corresponding resume command first, such as \"data import resume.\" Make note of the job ID of the previous bulk command because you use it to run this command. \n\nYou can also use this command to get results from running a bulk ingest job with a different tool, such as Data Loader, as long as you have the job ID. For information on Data Loader, see https://developer.salesforce.com/docs/atlas.en-us.dataLoader.meta/dataLoader/data_loader_intro.htm. \n\nThis command first displays the status of the previous bulk job, the operation that was executed in the org (such as insert or hard delete), and the updated Salesforce object. The command then displays how many records were processed in total, and how many were successful or failed. Finally, the output displays the names of the generated CSV-formatted files that contain the specific results for each ingested record. Depending on the success or failure of the bulk command, the results files can include the IDs of inserted records or the specific errors. When possible, if the ingest job failed or was aborted, you also get a CSV file with the unprocessed results.",
1109
+ "examples": [
1110
+ "Get results from a bulk ingest job; use the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --job-id 7507i000fake341G --target-org my-scratch"
1111
+ ],
1112
+ "flags": {
1113
+ "json": {
1114
+ "description": "Format output as json.",
1115
+ "helpGroup": "GLOBAL",
1116
+ "name": "json",
1117
+ "allowNo": false,
1118
+ "type": "boolean"
1119
+ },
1120
+ "flags-dir": {
1121
+ "helpGroup": "GLOBAL",
1122
+ "name": "flags-dir",
1123
+ "summary": "Import flag values from a directory.",
1124
+ "hasDynamicHelp": false,
1125
+ "multiple": false,
1126
+ "type": "option"
1127
+ },
1128
+ "job-id": {
1129
+ "char": "i",
1130
+ "name": "job-id",
1131
+ "required": true,
1132
+ "summary": "Job ID of the bulk job.",
1133
+ "hasDynamicHelp": false,
1134
+ "multiple": false,
1135
+ "type": "option"
1136
+ },
1137
+ "target-org": {
1138
+ "char": "o",
1139
+ "name": "target-org",
1140
+ "noCacheDefault": true,
1141
+ "required": true,
1142
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1143
+ "hasDynamicHelp": true,
1144
+ "multiple": false,
1145
+ "type": "option"
1146
+ },
1147
+ "api-version": {
1148
+ "description": "Override the api version used for api requests made by this command",
1149
+ "name": "api-version",
1150
+ "hasDynamicHelp": false,
1151
+ "multiple": false,
1152
+ "type": "option"
1153
+ }
1154
+ },
1155
+ "hasDynamicHelp": true,
1156
+ "hiddenAliases": [],
1157
+ "id": "data:bulk:results",
1158
+ "pluginAlias": "@salesforce/plugin-data",
1159
+ "pluginName": "@salesforce/plugin-data",
1160
+ "pluginType": "core",
1161
+ "strict": true,
1162
+ "summary": "Get the results of a bulk ingest job that you previously ran.",
1163
+ "enableJsonFlag": true,
1164
+ "isESM": true,
1165
+ "relativePath": [
1166
+ "lib",
1167
+ "commands",
1168
+ "data",
1169
+ "bulk",
1170
+ "results.js"
1171
+ ],
1172
+ "aliasPermutations": [],
1173
+ "permutations": [
1174
+ "data:bulk:results",
1175
+ "bulk:data:results",
1176
+ "bulk:results:data",
1177
+ "data:results:bulk",
1178
+ "results:data:bulk",
1179
+ "results:bulk:data"
1180
+ ]
1181
+ },
1182
1182
  "data:export:bulk": {
1183
1183
  "aliases": [],
1184
1184
  "args": {},
@@ -2504,13 +2504,13 @@
2504
2504
  "resume:update:data"
2505
2505
  ]
2506
2506
  },
2507
- "data:upsert:bulk": {
2507
+ "force:data:bulk:delete": {
2508
2508
  "aliases": [],
2509
2509
  "args": {},
2510
- "description": "An upsert refers to inserting a record into a Salesforce object if the record doesn't already exist, or updating it if it does exist.\n\nWhen you execute this command, it starts a job, displays the ID, and then immediately returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with the \"<%= config.bin %> data upsert resume\" command.\n\nSee \"Prepare CSV Files\" in the Bulk API Developer Guide for details on formatting your CSV file. (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_csv.htm)",
2510
+ "description": "The CSV file must have only one column (\"Id\") and then the list of record IDs you want to delete, one ID per line.\n\nWhen you execute this command, it starts a job and one or more batches, displays their IDs, and then immediately returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with the \"<%= config.bin %> force data bulk status\" command. A single job can contain many batches, depending on the length of the CSV file.",
2511
2511
  "examples": [
2512
- "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> <%= command.id %> --sobject Contact --file files/contacts.csv --external-id Id",
2513
- "Bulk upsert records to a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5 --target-org my-scratch"
2512
+ "Bulk delete Account records from your default org using the list of IDs in the \"files/delete.csv\" file:\n<%= config.bin %> <%= command.id %> --sobject Account --file files/delete.csv",
2513
+ "Bulk delete records from a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch"
2514
2514
  ],
2515
2515
  "flags": {
2516
2516
  "json": {
@@ -2572,7 +2572,7 @@
2572
2572
  "deprecateAliases": true,
2573
2573
  "name": "file",
2574
2574
  "required": true,
2575
- "summary": "CSV file that contains the IDs of the records to update or delete.",
2575
+ "summary": "CSV file that contains the IDs of the records to delete.",
2576
2576
  "hasDynamicHelp": false,
2577
2577
  "multiple": false,
2578
2578
  "type": "option"
@@ -2585,121 +2585,84 @@
2585
2585
  "deprecateAliases": true,
2586
2586
  "name": "sobject",
2587
2587
  "required": true,
2588
- "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
2588
+ "summary": "API name of the Salesforce object, either standard or custom, that you want to delete records from.",
2589
2589
  "hasDynamicHelp": false,
2590
2590
  "multiple": false,
2591
2591
  "type": "option"
2592
2592
  },
2593
2593
  "wait": {
2594
2594
  "char": "w",
2595
- "exclusive": [
2596
- "async"
2597
- ],
2598
2595
  "name": "wait",
2599
2596
  "summary": "Number of minutes to wait for the command to complete before displaying the results.",
2600
2597
  "default": "0 minutes",
2601
2598
  "hasDynamicHelp": true,
2602
2599
  "multiple": false,
2603
2600
  "type": "option"
2604
- },
2605
- "async": {
2606
- "char": "a",
2607
- "deprecated": true,
2608
- "exclusive": [
2609
- "wait"
2610
- ],
2611
- "name": "async",
2612
- "summary": "Run the command asynchronously.",
2613
- "allowNo": false,
2614
- "type": "boolean"
2615
- },
2616
- "line-ending": {
2617
- "dependsOn": [
2618
- "file"
2619
- ],
2620
- "name": "line-ending",
2621
- "summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
2622
- "hasDynamicHelp": false,
2623
- "multiple": false,
2624
- "options": [
2625
- "CRLF",
2626
- "LF"
2627
- ],
2628
- "type": "option"
2629
- },
2630
- "column-delimiter": {
2631
- "name": "column-delimiter",
2632
- "summary": "Column delimiter used in the CSV file.",
2633
- "hasDynamicHelp": false,
2634
- "multiple": false,
2635
- "options": [
2636
- "BACKQUOTE",
2637
- "CARET",
2638
- "COMMA",
2639
- "PIPE",
2640
- "SEMICOLON",
2641
- "TAB"
2642
- ],
2643
- "type": "option"
2644
- },
2645
- "external-id": {
2646
- "aliases": [
2647
- "externalid"
2648
- ],
2649
- "char": "i",
2650
- "deprecateAliases": true,
2651
- "name": "external-id",
2652
- "required": true,
2653
- "summary": "Name of the external ID field, or the Id field.",
2654
- "hasDynamicHelp": false,
2655
- "multiple": false,
2656
- "type": "option"
2657
2601
  }
2658
2602
  },
2659
2603
  "hasDynamicHelp": true,
2660
2604
  "hiddenAliases": [],
2661
- "id": "data:upsert:bulk",
2605
+ "id": "force:data:bulk:delete",
2662
2606
  "pluginAlias": "@salesforce/plugin-data",
2663
2607
  "pluginName": "@salesforce/plugin-data",
2664
2608
  "pluginType": "core",
2665
2609
  "strict": true,
2666
- "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.",
2610
+ "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 1.0.",
2667
2611
  "enableJsonFlag": true,
2668
2612
  "isESM": true,
2669
2613
  "relativePath": [
2670
2614
  "lib",
2671
2615
  "commands",
2616
+ "force",
2672
2617
  "data",
2673
- "upsert",
2674
- "bulk.js"
2618
+ "bulk",
2619
+ "delete.js"
2675
2620
  ],
2676
2621
  "aliasPermutations": [],
2677
2622
  "permutations": [
2678
- "data:upsert:bulk",
2679
- "upsert:data:bulk",
2680
- "upsert:bulk:data",
2681
- "data:bulk:upsert",
2682
- "bulk:data:upsert",
2683
- "bulk:upsert:data"
2684
- ]
2685
- },
2686
- "data:upsert:resume": {
2687
- "aliases": [],
2688
- "args": {},
2689
- "description": "The command uses the job ID returned from the \"<%= config.bin %> data upsert bulk\" command or the most recently-run bulk upsert job.",
2690
- "examples": [
2691
- "Resume a bulk upsert job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
2692
- "Resume the most recently run bulk upsert job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
2693
- ],
2694
- "flags": {
2695
- "json": {
2696
- "description": "Format output as json.",
2697
- "helpGroup": "GLOBAL",
2698
- "name": "json",
2699
- "allowNo": false,
2700
- "type": "boolean"
2701
- },
2702
- "flags-dir": {
2623
+ "force:data:bulk:delete",
2624
+ "data:force:bulk:delete",
2625
+ "data:bulk:force:delete",
2626
+ "data:bulk:delete:force",
2627
+ "force:bulk:data:delete",
2628
+ "bulk:force:data:delete",
2629
+ "bulk:data:force:delete",
2630
+ "bulk:data:delete:force",
2631
+ "force:bulk:delete:data",
2632
+ "bulk:force:delete:data",
2633
+ "bulk:delete:force:data",
2634
+ "bulk:delete:data:force",
2635
+ "force:data:delete:bulk",
2636
+ "data:force:delete:bulk",
2637
+ "data:delete:force:bulk",
2638
+ "data:delete:bulk:force",
2639
+ "force:delete:data:bulk",
2640
+ "delete:force:data:bulk",
2641
+ "delete:data:force:bulk",
2642
+ "delete:data:bulk:force",
2643
+ "force:delete:bulk:data",
2644
+ "delete:force:bulk:data",
2645
+ "delete:bulk:force:data",
2646
+ "delete:bulk:data:force"
2647
+ ]
2648
+ },
2649
+ "force:data:bulk:status": {
2650
+ "aliases": [],
2651
+ "args": {},
2652
+ "description": "Run this command using the job ID or batch ID returned from the \"<%= config.bin %> force data bulk delete\" or \"<%= config.bin %> force data bulk upsert\" commands.",
2653
+ "examples": [
2654
+ "View the status of a bulk load job in your default org:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
2655
+ "View the status of a bulk load job and a specific batches in an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --target-org my-scratch"
2656
+ ],
2657
+ "flags": {
2658
+ "json": {
2659
+ "description": "Format output as json.",
2660
+ "helpGroup": "GLOBAL",
2661
+ "name": "json",
2662
+ "allowNo": false,
2663
+ "type": "boolean"
2664
+ },
2665
+ "flags-dir": {
2703
2666
  "helpGroup": "GLOBAL",
2704
2667
  "name": "flags-dir",
2705
2668
  "summary": "Import flag values from a directory.",
@@ -2716,41 +2679,17 @@
2716
2679
  "deprecateAliases": true,
2717
2680
  "name": "target-org",
2718
2681
  "noCacheDefault": true,
2719
- "summary": "Username or alias of the target org. Not required if the \"target-org\" configuration variable is already set.",
2682
+ "required": true,
2683
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2720
2684
  "hasDynamicHelp": true,
2721
2685
  "multiple": false,
2722
2686
  "type": "option"
2723
2687
  },
2724
- "job-id": {
2688
+ "api-version": {
2725
2689
  "aliases": [
2726
- "jobid"
2690
+ "apiversion"
2727
2691
  ],
2728
- "char": "i",
2729
2692
  "deprecateAliases": true,
2730
- "name": "job-id",
2731
- "summary": "ID of the job you want to resume.",
2732
- "hasDynamicHelp": false,
2733
- "multiple": false,
2734
- "type": "option"
2735
- },
2736
- "use-most-recent": {
2737
- "exclusive": [
2738
- "job-id"
2739
- ],
2740
- "name": "use-most-recent",
2741
- "summary": "Use the ID of the most recently-run bulk job.",
2742
- "allowNo": false,
2743
- "type": "boolean"
2744
- },
2745
- "wait": {
2746
- "name": "wait",
2747
- "summary": "Number of minutes to wait for the command to complete before displaying the results.",
2748
- "default": "5 minutes",
2749
- "hasDynamicHelp": true,
2750
- "multiple": false,
2751
- "type": "option"
2752
- },
2753
- "api-version": {
2754
2693
  "description": "Override the api version used for api requests made by this command",
2755
2694
  "name": "api-version",
2756
2695
  "hasDynamicHelp": false,
@@ -2766,42 +2705,86 @@
2766
2705
  "hasDynamicHelp": false,
2767
2706
  "multiple": false,
2768
2707
  "type": "option"
2708
+ },
2709
+ "batch-id": {
2710
+ "aliases": [
2711
+ "batchid"
2712
+ ],
2713
+ "char": "b",
2714
+ "deprecateAliases": true,
2715
+ "name": "batch-id",
2716
+ "summary": "ID of the batch whose status you want to view; you must also specify the job ID.",
2717
+ "hasDynamicHelp": false,
2718
+ "multiple": false,
2719
+ "type": "option"
2720
+ },
2721
+ "job-id": {
2722
+ "aliases": [
2723
+ "jobid"
2724
+ ],
2725
+ "char": "i",
2726
+ "deprecateAliases": true,
2727
+ "name": "job-id",
2728
+ "required": true,
2729
+ "summary": "ID of the job whose status you want to view.",
2730
+ "hasDynamicHelp": false,
2731
+ "multiple": false,
2732
+ "type": "option"
2769
2733
  }
2770
2734
  },
2771
2735
  "hasDynamicHelp": true,
2772
2736
  "hiddenAliases": [],
2773
- "id": "data:upsert:resume",
2737
+ "id": "force:data:bulk:status",
2774
2738
  "pluginAlias": "@salesforce/plugin-data",
2775
2739
  "pluginName": "@salesforce/plugin-data",
2776
2740
  "pluginType": "core",
2777
2741
  "strict": true,
2778
- "summary": "Resume a bulk upsert job that you previously started. Uses Bulk API 2.0.",
2742
+ "summary": "View the status of a bulk data load job or batch. Uses Bulk API 1.0.",
2779
2743
  "enableJsonFlag": true,
2780
2744
  "isESM": true,
2781
2745
  "relativePath": [
2782
2746
  "lib",
2783
2747
  "commands",
2748
+ "force",
2784
2749
  "data",
2785
- "upsert",
2786
- "resume.js"
2750
+ "bulk",
2751
+ "status.js"
2787
2752
  ],
2788
2753
  "aliasPermutations": [],
2789
2754
  "permutations": [
2790
- "data:upsert:resume",
2791
- "upsert:data:resume",
2792
- "upsert:resume:data",
2793
- "data:resume:upsert",
2794
- "resume:data:upsert",
2795
- "resume:upsert:data"
2755
+ "force:data:bulk:status",
2756
+ "data:force:bulk:status",
2757
+ "data:bulk:force:status",
2758
+ "data:bulk:status:force",
2759
+ "force:bulk:data:status",
2760
+ "bulk:force:data:status",
2761
+ "bulk:data:force:status",
2762
+ "bulk:data:status:force",
2763
+ "force:bulk:status:data",
2764
+ "bulk:force:status:data",
2765
+ "bulk:status:force:data",
2766
+ "bulk:status:data:force",
2767
+ "force:data:status:bulk",
2768
+ "data:force:status:bulk",
2769
+ "data:status:force:bulk",
2770
+ "data:status:bulk:force",
2771
+ "force:status:data:bulk",
2772
+ "status:force:data:bulk",
2773
+ "status:data:force:bulk",
2774
+ "status:data:bulk:force",
2775
+ "force:status:bulk:data",
2776
+ "status:force:bulk:data",
2777
+ "status:bulk:force:data",
2778
+ "status:bulk:data:force"
2796
2779
  ]
2797
2780
  },
2798
- "force:data:bulk:delete": {
2781
+ "force:data:bulk:upsert": {
2799
2782
  "aliases": [],
2800
2783
  "args": {},
2801
- "description": "The CSV file must have only one column (\"Id\") and then the list of record IDs you want to delete, one ID per line.\n\nWhen you execute this command, it starts a job and one or more batches, displays their IDs, and then immediately returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with the \"<%= config.bin %> force data bulk status\" command. A single job can contain many batches, depending on the length of the CSV file.",
2784
+ "description": "An upsert refers to inserting a record into a Salesforce object if the record doesn't already exist, or updating it if it does exist.\n\nWhen you execute this command, it starts a job and one or more batches, displays their IDs, and then immediately returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with the \"<%= config.bin %> force data bulk status\" command. A single job can contain many batches, depending on the length of the CSV file.\n\nSee \"Prepare CSV Files\" in the Bulk API Developer Guide for details on formatting your CSV file. (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_csv_preparing.htm)\n\nBy default, the job runs the batches in parallel, which we recommend. You can run jobs serially by specifying the --serial flag. But don't process data in serial mode unless you know this would otherwise result in lock timeouts and you can't reorganize your batches to avoid the locks.",
2802
2785
  "examples": [
2803
- "Bulk delete Account records from your default org using the list of IDs in the \"files/delete.csv\" file:\n<%= config.bin %> <%= command.id %> --sobject Account --file files/delete.csv",
2804
- "Bulk delete records from a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch"
2786
+ "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> --sobject Contact --file files/contacts.csv --external-id Id",
2787
+ "Bulk upsert records to a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5 --target-org my-scratch"
2805
2788
  ],
2806
2789
  "flags": {
2807
2790
  "json": {
@@ -2855,6 +2838,19 @@
2855
2838
  "multiple": false,
2856
2839
  "type": "option"
2857
2840
  },
2841
+ "external-id": {
2842
+ "aliases": [
2843
+ "externalid"
2844
+ ],
2845
+ "char": "i",
2846
+ "deprecateAliases": true,
2847
+ "name": "external-id",
2848
+ "required": true,
2849
+ "summary": "Name of the external ID field, or the Id field.",
2850
+ "hasDynamicHelp": false,
2851
+ "multiple": false,
2852
+ "type": "option"
2853
+ },
2858
2854
  "file": {
2859
2855
  "aliases": [
2860
2856
  "csvfile"
@@ -2863,7 +2859,7 @@
2863
2859
  "deprecateAliases": true,
2864
2860
  "name": "file",
2865
2861
  "required": true,
2866
- "summary": "CSV file that contains the IDs of the records to delete.",
2862
+ "summary": "CSV file that contains the records to upsert.",
2867
2863
  "hasDynamicHelp": false,
2868
2864
  "multiple": false,
2869
2865
  "type": "option"
@@ -2876,7 +2872,7 @@
2876
2872
  "deprecateAliases": true,
2877
2873
  "name": "sobject",
2878
2874
  "required": true,
2879
- "summary": "API name of the Salesforce object, either standard or custom, that you want to delete records from.",
2875
+ "summary": "API name of the Salesforce object, either standard or custom, that you want to upsert records to.",
2880
2876
  "hasDynamicHelp": false,
2881
2877
  "multiple": false,
2882
2878
  "type": "option"
@@ -2889,16 +2885,23 @@
2889
2885
  "hasDynamicHelp": true,
2890
2886
  "multiple": false,
2891
2887
  "type": "option"
2888
+ },
2889
+ "serial": {
2890
+ "char": "r",
2891
+ "name": "serial",
2892
+ "summary": "Run batches in serial mode.",
2893
+ "allowNo": false,
2894
+ "type": "boolean"
2892
2895
  }
2893
2896
  },
2894
2897
  "hasDynamicHelp": true,
2895
2898
  "hiddenAliases": [],
2896
- "id": "force:data:bulk:delete",
2899
+ "id": "force:data:bulk:upsert",
2897
2900
  "pluginAlias": "@salesforce/plugin-data",
2898
2901
  "pluginName": "@salesforce/plugin-data",
2899
2902
  "pluginType": "core",
2900
2903
  "strict": true,
2901
- "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 1.0.",
2904
+ "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 1.0.",
2902
2905
  "enableJsonFlag": true,
2903
2906
  "isESM": true,
2904
2907
  "relativePath": [
@@ -2907,43 +2910,43 @@
2907
2910
  "force",
2908
2911
  "data",
2909
2912
  "bulk",
2910
- "delete.js"
2913
+ "upsert.js"
2911
2914
  ],
2912
2915
  "aliasPermutations": [],
2913
2916
  "permutations": [
2914
- "force:data:bulk:delete",
2915
- "data:force:bulk:delete",
2916
- "data:bulk:force:delete",
2917
- "data:bulk:delete:force",
2918
- "force:bulk:data:delete",
2919
- "bulk:force:data:delete",
2920
- "bulk:data:force:delete",
2921
- "bulk:data:delete:force",
2922
- "force:bulk:delete:data",
2923
- "bulk:force:delete:data",
2924
- "bulk:delete:force:data",
2925
- "bulk:delete:data:force",
2926
- "force:data:delete:bulk",
2927
- "data:force:delete:bulk",
2928
- "data:delete:force:bulk",
2929
- "data:delete:bulk:force",
2930
- "force:delete:data:bulk",
2931
- "delete:force:data:bulk",
2932
- "delete:data:force:bulk",
2933
- "delete:data:bulk:force",
2934
- "force:delete:bulk:data",
2935
- "delete:force:bulk:data",
2936
- "delete:bulk:force:data",
2937
- "delete:bulk:data:force"
2917
+ "force:data:bulk:upsert",
2918
+ "data:force:bulk:upsert",
2919
+ "data:bulk:force:upsert",
2920
+ "data:bulk:upsert:force",
2921
+ "force:bulk:data:upsert",
2922
+ "bulk:force:data:upsert",
2923
+ "bulk:data:force:upsert",
2924
+ "bulk:data:upsert:force",
2925
+ "force:bulk:upsert:data",
2926
+ "bulk:force:upsert:data",
2927
+ "bulk:upsert:force:data",
2928
+ "bulk:upsert:data:force",
2929
+ "force:data:upsert:bulk",
2930
+ "data:force:upsert:bulk",
2931
+ "data:upsert:force:bulk",
2932
+ "data:upsert:bulk:force",
2933
+ "force:upsert:data:bulk",
2934
+ "upsert:force:data:bulk",
2935
+ "upsert:data:force:bulk",
2936
+ "upsert:data:bulk:force",
2937
+ "force:upsert:bulk:data",
2938
+ "upsert:force:bulk:data",
2939
+ "upsert:bulk:force:data",
2940
+ "upsert:bulk:data:force"
2938
2941
  ]
2939
2942
  },
2940
- "force:data:bulk:status": {
2943
+ "data:upsert:bulk": {
2941
2944
  "aliases": [],
2942
2945
  "args": {},
2943
- "description": "Run this command using the job ID or batch ID returned from the \"<%= config.bin %> force data bulk delete\" or \"<%= config.bin %> force data bulk upsert\" commands.",
2946
+ "description": "An upsert refers to inserting a record into a Salesforce object if the record doesn't already exist, or updating it if it does exist.\n\nWhen you execute this command, it starts a job, displays the ID, and then immediately returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with the \"<%= config.bin %> data upsert resume\" command.\n\nSee \"Prepare CSV Files\" in the Bulk API Developer Guide for details on formatting your CSV file. (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_csv.htm)",
2944
2947
  "examples": [
2945
- "View the status of a bulk load job in your default org:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
2946
- "View the status of a bulk load job and a specific batches in an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --target-org my-scratch"
2948
+ "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> <%= command.id %> --sobject Contact --file files/contacts.csv --external-id Id",
2949
+ "Bulk upsert records to a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5 --target-org my-scratch"
2947
2950
  ],
2948
2951
  "flags": {
2949
2952
  "json": {
@@ -2997,27 +3000,93 @@
2997
3000
  "multiple": false,
2998
3001
  "type": "option"
2999
3002
  },
3000
- "batch-id": {
3003
+ "file": {
3001
3004
  "aliases": [
3002
- "batchid"
3005
+ "csvfile"
3003
3006
  ],
3004
- "char": "b",
3007
+ "char": "f",
3005
3008
  "deprecateAliases": true,
3006
- "name": "batch-id",
3007
- "summary": "ID of the batch whose status you want to view; you must also specify the job ID.",
3009
+ "name": "file",
3010
+ "required": true,
3011
+ "summary": "CSV file that contains the IDs of the records to update or delete.",
3008
3012
  "hasDynamicHelp": false,
3009
3013
  "multiple": false,
3010
3014
  "type": "option"
3011
3015
  },
3012
- "job-id": {
3016
+ "sobject": {
3013
3017
  "aliases": [
3014
- "jobid"
3018
+ "sobjecttype"
3019
+ ],
3020
+ "char": "s",
3021
+ "deprecateAliases": true,
3022
+ "name": "sobject",
3023
+ "required": true,
3024
+ "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
3025
+ "hasDynamicHelp": false,
3026
+ "multiple": false,
3027
+ "type": "option"
3028
+ },
3029
+ "wait": {
3030
+ "char": "w",
3031
+ "exclusive": [
3032
+ "async"
3033
+ ],
3034
+ "name": "wait",
3035
+ "summary": "Number of minutes to wait for the command to complete before displaying the results.",
3036
+ "default": "0 minutes",
3037
+ "hasDynamicHelp": true,
3038
+ "multiple": false,
3039
+ "type": "option"
3040
+ },
3041
+ "async": {
3042
+ "char": "a",
3043
+ "deprecated": true,
3044
+ "exclusive": [
3045
+ "wait"
3046
+ ],
3047
+ "name": "async",
3048
+ "summary": "Run the command asynchronously.",
3049
+ "allowNo": false,
3050
+ "type": "boolean"
3051
+ },
3052
+ "line-ending": {
3053
+ "dependsOn": [
3054
+ "file"
3055
+ ],
3056
+ "name": "line-ending",
3057
+ "summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
3058
+ "hasDynamicHelp": false,
3059
+ "multiple": false,
3060
+ "options": [
3061
+ "CRLF",
3062
+ "LF"
3063
+ ],
3064
+ "type": "option"
3065
+ },
3066
+ "column-delimiter": {
3067
+ "name": "column-delimiter",
3068
+ "summary": "Column delimiter used in the CSV file.",
3069
+ "hasDynamicHelp": false,
3070
+ "multiple": false,
3071
+ "options": [
3072
+ "BACKQUOTE",
3073
+ "CARET",
3074
+ "COMMA",
3075
+ "PIPE",
3076
+ "SEMICOLON",
3077
+ "TAB"
3078
+ ],
3079
+ "type": "option"
3080
+ },
3081
+ "external-id": {
3082
+ "aliases": [
3083
+ "externalid"
3015
3084
  ],
3016
3085
  "char": "i",
3017
3086
  "deprecateAliases": true,
3018
- "name": "job-id",
3087
+ "name": "external-id",
3019
3088
  "required": true,
3020
- "summary": "ID of the job whose status you want to view.",
3089
+ "summary": "Name of the external ID field, or the Id field.",
3021
3090
  "hasDynamicHelp": false,
3022
3091
  "multiple": false,
3023
3092
  "type": "option"
@@ -3025,57 +3094,38 @@
3025
3094
  },
3026
3095
  "hasDynamicHelp": true,
3027
3096
  "hiddenAliases": [],
3028
- "id": "force:data:bulk:status",
3097
+ "id": "data:upsert:bulk",
3029
3098
  "pluginAlias": "@salesforce/plugin-data",
3030
3099
  "pluginName": "@salesforce/plugin-data",
3031
3100
  "pluginType": "core",
3032
3101
  "strict": true,
3033
- "summary": "View the status of a bulk data load job or batch. Uses Bulk API 1.0.",
3102
+ "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.",
3034
3103
  "enableJsonFlag": true,
3035
3104
  "isESM": true,
3036
3105
  "relativePath": [
3037
3106
  "lib",
3038
3107
  "commands",
3039
- "force",
3040
3108
  "data",
3041
- "bulk",
3042
- "status.js"
3109
+ "upsert",
3110
+ "bulk.js"
3043
3111
  ],
3044
3112
  "aliasPermutations": [],
3045
3113
  "permutations": [
3046
- "force:data:bulk:status",
3047
- "data:force:bulk:status",
3048
- "data:bulk:force:status",
3049
- "data:bulk:status:force",
3050
- "force:bulk:data:status",
3051
- "bulk:force:data:status",
3052
- "bulk:data:force:status",
3053
- "bulk:data:status:force",
3054
- "force:bulk:status:data",
3055
- "bulk:force:status:data",
3056
- "bulk:status:force:data",
3057
- "bulk:status:data:force",
3058
- "force:data:status:bulk",
3059
- "data:force:status:bulk",
3060
- "data:status:force:bulk",
3061
- "data:status:bulk:force",
3062
- "force:status:data:bulk",
3063
- "status:force:data:bulk",
3064
- "status:data:force:bulk",
3065
- "status:data:bulk:force",
3066
- "force:status:bulk:data",
3067
- "status:force:bulk:data",
3068
- "status:bulk:force:data",
3069
- "status:bulk:data:force"
3114
+ "data:upsert:bulk",
3115
+ "upsert:data:bulk",
3116
+ "upsert:bulk:data",
3117
+ "data:bulk:upsert",
3118
+ "bulk:data:upsert",
3119
+ "bulk:upsert:data"
3070
3120
  ]
3071
3121
  },
3072
- "force:data:bulk:upsert": {
3122
+ "data:upsert:resume": {
3073
3123
  "aliases": [],
3074
3124
  "args": {},
3075
- "description": "An upsert refers to inserting a record into a Salesforce object if the record doesn't already exist, or updating it if it does exist.\n\nWhen you execute this command, it starts a job and one or more batches, displays their IDs, and then immediately returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with the \"<%= config.bin %> force data bulk status\" command. A single job can contain many batches, depending on the length of the CSV file.\n\nSee \"Prepare CSV Files\" in the Bulk API Developer Guide for details on formatting your CSV file. (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_csv_preparing.htm)\n\nBy default, the job runs the batches in parallel, which we recommend. You can run jobs serially by specifying the --serial flag. But don't process data in serial mode unless you know this would otherwise result in lock timeouts and you can't reorganize your batches to avoid the locks.",
3125
+ "description": "The command uses the job ID returned from the \"<%= config.bin %> data upsert bulk\" command or the most recently-run bulk upsert job.",
3076
3126
  "examples": [
3077
- "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> --sobject Contact --file files/contacts.csv --external-id Id",
3078
- "Bulk upsert records to a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5 --target-org my-scratch"
3127
+ "Resume a bulk upsert job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
3128
+ "Resume the most recently run bulk upsert job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
3079
3129
  ],
3080
3130
  "flags": {
3081
3131
  "json": {
@@ -3102,135 +3152,85 @@
3102
3152
  "deprecateAliases": true,
3103
3153
  "name": "target-org",
3104
3154
  "noCacheDefault": true,
3105
- "required": true,
3106
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3155
+ "summary": "Username or alias of the target org. Not required if the \"target-org\" configuration variable is already set.",
3107
3156
  "hasDynamicHelp": true,
3108
3157
  "multiple": false,
3109
3158
  "type": "option"
3110
3159
  },
3111
- "api-version": {
3112
- "aliases": [
3113
- "apiversion"
3114
- ],
3115
- "deprecateAliases": true,
3116
- "description": "Override the api version used for api requests made by this command",
3117
- "name": "api-version",
3118
- "hasDynamicHelp": false,
3119
- "multiple": false,
3120
- "type": "option"
3121
- },
3122
- "loglevel": {
3123
- "deprecated": {
3124
- "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
3125
- },
3126
- "hidden": true,
3127
- "name": "loglevel",
3128
- "hasDynamicHelp": false,
3129
- "multiple": false,
3130
- "type": "option"
3131
- },
3132
- "external-id": {
3160
+ "job-id": {
3133
3161
  "aliases": [
3134
- "externalid"
3162
+ "jobid"
3135
3163
  ],
3136
3164
  "char": "i",
3137
3165
  "deprecateAliases": true,
3138
- "name": "external-id",
3139
- "required": true,
3140
- "summary": "Name of the external ID field, or the Id field.",
3166
+ "name": "job-id",
3167
+ "summary": "ID of the job you want to resume.",
3141
3168
  "hasDynamicHelp": false,
3142
3169
  "multiple": false,
3143
3170
  "type": "option"
3144
3171
  },
3145
- "file": {
3146
- "aliases": [
3147
- "csvfile"
3172
+ "use-most-recent": {
3173
+ "exclusive": [
3174
+ "job-id"
3148
3175
  ],
3149
- "char": "f",
3150
- "deprecateAliases": true,
3151
- "name": "file",
3152
- "required": true,
3153
- "summary": "CSV file that contains the records to upsert.",
3154
- "hasDynamicHelp": false,
3176
+ "name": "use-most-recent",
3177
+ "summary": "Use the ID of the most recently-run bulk job.",
3178
+ "allowNo": false,
3179
+ "type": "boolean"
3180
+ },
3181
+ "wait": {
3182
+ "name": "wait",
3183
+ "summary": "Number of minutes to wait for the command to complete before displaying the results.",
3184
+ "default": "5 minutes",
3185
+ "hasDynamicHelp": true,
3155
3186
  "multiple": false,
3156
3187
  "type": "option"
3157
3188
  },
3158
- "sobject": {
3159
- "aliases": [
3160
- "sobjecttype"
3161
- ],
3162
- "char": "s",
3163
- "deprecateAliases": true,
3164
- "name": "sobject",
3165
- "required": true,
3166
- "summary": "API name of the Salesforce object, either standard or custom, that you want to upsert records to.",
3189
+ "api-version": {
3190
+ "description": "Override the api version used for api requests made by this command",
3191
+ "name": "api-version",
3167
3192
  "hasDynamicHelp": false,
3168
3193
  "multiple": false,
3169
3194
  "type": "option"
3170
3195
  },
3171
- "wait": {
3172
- "char": "w",
3173
- "name": "wait",
3174
- "summary": "Number of minutes to wait for the command to complete before displaying the results.",
3175
- "default": "0 minutes",
3176
- "hasDynamicHelp": true,
3196
+ "loglevel": {
3197
+ "deprecated": {
3198
+ "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
3199
+ },
3200
+ "hidden": true,
3201
+ "name": "loglevel",
3202
+ "hasDynamicHelp": false,
3177
3203
  "multiple": false,
3178
3204
  "type": "option"
3179
- },
3180
- "serial": {
3181
- "char": "r",
3182
- "name": "serial",
3183
- "summary": "Run batches in serial mode.",
3184
- "allowNo": false,
3185
- "type": "boolean"
3186
3205
  }
3187
3206
  },
3188
3207
  "hasDynamicHelp": true,
3189
3208
  "hiddenAliases": [],
3190
- "id": "force:data:bulk:upsert",
3209
+ "id": "data:upsert:resume",
3191
3210
  "pluginAlias": "@salesforce/plugin-data",
3192
3211
  "pluginName": "@salesforce/plugin-data",
3193
3212
  "pluginType": "core",
3194
3213
  "strict": true,
3195
- "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 1.0.",
3214
+ "summary": "Resume a bulk upsert job that you previously started. Uses Bulk API 2.0.",
3196
3215
  "enableJsonFlag": true,
3197
3216
  "isESM": true,
3198
3217
  "relativePath": [
3199
3218
  "lib",
3200
3219
  "commands",
3201
- "force",
3202
3220
  "data",
3203
- "bulk",
3204
- "upsert.js"
3221
+ "upsert",
3222
+ "resume.js"
3205
3223
  ],
3206
3224
  "aliasPermutations": [],
3207
3225
  "permutations": [
3208
- "force:data:bulk:upsert",
3209
- "data:force:bulk:upsert",
3210
- "data:bulk:force:upsert",
3211
- "data:bulk:upsert:force",
3212
- "force:bulk:data:upsert",
3213
- "bulk:force:data:upsert",
3214
- "bulk:data:force:upsert",
3215
- "bulk:data:upsert:force",
3216
- "force:bulk:upsert:data",
3217
- "bulk:force:upsert:data",
3218
- "bulk:upsert:force:data",
3219
- "bulk:upsert:data:force",
3220
- "force:data:upsert:bulk",
3221
- "data:force:upsert:bulk",
3222
- "data:upsert:force:bulk",
3223
- "data:upsert:bulk:force",
3224
- "force:upsert:data:bulk",
3225
- "upsert:force:data:bulk",
3226
- "upsert:data:force:bulk",
3227
- "upsert:data:bulk:force",
3228
- "force:upsert:bulk:data",
3229
- "upsert:force:bulk:data",
3230
- "upsert:bulk:force:data",
3231
- "upsert:bulk:data:force"
3226
+ "data:upsert:resume",
3227
+ "upsert:data:resume",
3228
+ "upsert:resume:data",
3229
+ "data:resume:upsert",
3230
+ "resume:data:upsert",
3231
+ "resume:upsert:data"
3232
3232
  ]
3233
3233
  }
3234
3234
  },
3235
- "version": "4.0.40"
3235
+ "version": "4.0.41"
3236
3236
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/plugin-data",
3
- "version": "4.0.40",
3
+ "version": "4.0.41",
4
4
  "description": "Plugin for salesforce data commands",
5
5
  "author": "Salesforce",
6
6
  "homepage": "https://github.com/salesforcecli/plugin-data",
@@ -124,7 +124,7 @@
124
124
  "@oclif/multi-stage-output": "^0.8.15",
125
125
  "@salesforce/core": "^8.12.0",
126
126
  "@salesforce/kit": "^3.2.2",
127
- "@salesforce/sf-plugins-core": "^12.2.2",
127
+ "@salesforce/sf-plugins-core": "^12.2.3",
128
128
  "@salesforce/ts-types": "^2.0.11",
129
129
  "ansis": "^3.16.0",
130
130
  "change-case": "^5.4.4",
@@ -141,7 +141,7 @@
141
141
  "@salesforce/dev-scripts": "^11.0.2",
142
142
  "@salesforce/plugin-command-reference": "^3.1.54",
143
143
  "@salesforce/types": "^1.3.0",
144
- "eslint-plugin-sf-plugin": "^1.20.24",
144
+ "eslint-plugin-sf-plugin": "^1.20.26",
145
145
  "oclif": "^4.18.1",
146
146
  "ts-node": "^10.9.2",
147
147
  "typescript": "^5.8.3"
@@ -267,7 +267,7 @@
267
267
  "exports": "./lib/index.js",
268
268
  "type": "module",
269
269
  "sfdx": {
270
- "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.40.crt",
271
- "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.40.sig"
270
+ "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.41.crt",
271
+ "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.41.sig"
272
272
  }
273
273
  }