@salesforce/plugin-data 3.5.12 → 3.5.13

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 +17 -17
  2. package/oclif.manifest.json +300 -300
  3. package/package.json +4 -4
package/README.md CHANGED
@@ -141,7 +141,7 @@ EXAMPLES
141
141
  $ sf data create file --file path/to/astro.png --parent-id a03fakeLoJWPIA3
142
142
  ```
143
143
 
144
- _See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/create/file.ts)_
144
+ _See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/create/file.ts)_
145
145
 
146
146
  ## `sf data create record`
147
147
 
@@ -197,7 +197,7 @@ EXAMPLES
197
197
  TracedEntityId=01p17000000R6bLAAS"
198
198
  ```
199
199
 
200
- _See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/create/record.ts)_
200
+ _See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/create/record.ts)_
201
201
 
202
202
  ## `sf data delete bulk`
203
203
 
@@ -255,7 +255,7 @@ FLAG DESCRIPTIONS
255
255
  and can be enabled only by a system administrator.
256
256
  ```
257
257
 
258
- _See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/delete/bulk.ts)_
258
+ _See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/delete/bulk.ts)_
259
259
 
260
260
  ## `sf data delete record`
261
261
 
@@ -316,7 +316,7 @@ EXAMPLES
316
316
  $ sf data delete record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
317
317
  ```
318
318
 
319
- _See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/delete/record.ts)_
319
+ _See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/delete/record.ts)_
320
320
 
321
321
  ## `sf data delete resume`
322
322
 
@@ -355,7 +355,7 @@ EXAMPLES
355
355
  $ sf data delete resume --use-most-recent --target-org my-scratch
356
356
  ```
357
357
 
358
- _See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/delete/resume.ts)_
358
+ _See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/delete/resume.ts)_
359
359
 
360
360
  ## `sf data export tree`
361
361
 
@@ -416,7 +416,7 @@ EXAMPLES
416
416
  my-scratch
417
417
  ```
418
418
 
419
- _See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/export/tree.ts)_
419
+ _See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/export/tree.ts)_
420
420
 
421
421
  ## `sf data get record`
422
422
 
@@ -480,7 +480,7 @@ EXAMPLES
480
480
  $ sf data get record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
481
481
  ```
482
482
 
483
- _See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/get/record.ts)_
483
+ _See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/get/record.ts)_
484
484
 
485
485
  ## `sf data import tree`
486
486
 
@@ -545,7 +545,7 @@ FLAG DESCRIPTIONS
545
545
  - files(array) - Files: An array of files paths to load
546
546
  ```
547
547
 
548
- _See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/import/tree.ts)_
548
+ _See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/import/tree.ts)_
549
549
 
550
550
  ## `sf data query`
551
551
 
@@ -609,7 +609,7 @@ EXAMPLES
609
609
  $ sf data query --query "SELECT Id FROM Contact" --bulk --wait 0
610
610
  ```
611
611
 
612
- _See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/query.ts)_
612
+ _See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/query.ts)_
613
613
 
614
614
  ## `sf data query resume`
615
615
 
@@ -647,7 +647,7 @@ EXAMPLES
647
647
  $ sf data query resume --bulk-query-id 7500x000005BdFzXXX
648
648
  ```
649
649
 
650
- _See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/query/resume.ts)_
650
+ _See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/query/resume.ts)_
651
651
 
652
652
  ## `sf data resume`
653
653
 
@@ -684,7 +684,7 @@ EXAMPLES
684
684
  $ sf data resume --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA
685
685
  ```
686
686
 
687
- _See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/resume.ts)_
687
+ _See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/resume.ts)_
688
688
 
689
689
  ## `sf data update record`
690
690
 
@@ -746,7 +746,7 @@ EXAMPLES
746
746
  "ExpirationDate=2017-12-01T00:58:04.000+0000"
747
747
  ```
748
748
 
749
- _See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/update/record.ts)_
749
+ _See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/update/record.ts)_
750
750
 
751
751
  ## `sf data upsert bulk`
752
752
 
@@ -799,7 +799,7 @@ EXAMPLES
799
799
  my-scratch
800
800
  ```
801
801
 
802
- _See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/upsert/bulk.ts)_
802
+ _See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/upsert/bulk.ts)_
803
803
 
804
804
  ## `sf data upsert resume`
805
805
 
@@ -838,7 +838,7 @@ EXAMPLES
838
838
  $ sf data upsert resume --use-most-recent --target-org my-scratch
839
839
  ```
840
840
 
841
- _See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/data/upsert/resume.ts)_
841
+ _See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/data/upsert/resume.ts)_
842
842
 
843
843
  ## `sf force data bulk delete`
844
844
 
@@ -885,7 +885,7 @@ EXAMPLES
885
885
  $ sf force data bulk delete --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch
886
886
  ```
887
887
 
888
- _See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/force/data/bulk/delete.ts)_
888
+ _See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/force/data/bulk/delete.ts)_
889
889
 
890
890
  ## `sf force data bulk status`
891
891
 
@@ -922,7 +922,7 @@ EXAMPLES
922
922
  $ sf force data bulk status --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --target-org my-scratch
923
923
  ```
924
924
 
925
- _See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/force/data/bulk/status.ts)_
925
+ _See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/force/data/bulk/status.ts)_
926
926
 
927
927
  ## `sf force data bulk upsert`
928
928
 
@@ -980,6 +980,6 @@ EXAMPLES
980
980
  --target-org my-scratch
981
981
  ```
982
982
 
983
- _See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.12/src/commands/force/data/bulk/upsert.ts)_
983
+ _See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.5.13/src/commands/force/data/bulk/upsert.ts)_
984
984
 
985
985
  <!-- commandsstop -->
@@ -326,14 +326,13 @@
326
326
  "resume:data"
327
327
  ]
328
328
  },
329
- "data:create:file": {
329
+ "data:delete:bulk": {
330
330
  "aliases": [],
331
331
  "args": {},
332
- "description": "This command always creates a new file in the org; you can't update an existing file. After a successful upload, the command displays the ID of the new ContentDocument record which represents the uploaded file.\n\nBy default, the uploaded file isn't attached to a record; in the Salesforce UI the file shows up in the Files tab. You can optionally attach the file to an existing record, such as an account, as long as you know its record ID.\n\nYou can also give the file a new name after it's been uploaded; by default its name in the org is the same as the local file name.",
332
+ "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, 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 ID to check the status of the job with the \"<%= config.bin %> data delete resume\" command.",
333
333
  "examples": [
334
- "Upload the local file \"resources/astro.png\" to your default org:\n<%= config.bin %> <%= command.id %> --file resources/astro.png",
335
- "Give the file a different filename after it's uploaded to the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --file resources/astro.png --title AstroOnABoat.png --target-org my-scratch",
336
- "Attach the file to a record in the org:\n<%= config.bin %> <%= command.id %> --file path/to/astro.png --parent-id a03fakeLoJWPIA3"
334
+ "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",
335
+ "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"
337
336
  ],
338
337
  "flags": {
339
338
  "json": {
@@ -352,7 +351,12 @@
352
351
  "type": "option"
353
352
  },
354
353
  "target-org": {
354
+ "aliases": [
355
+ "targetusername",
356
+ "u"
357
+ ],
355
358
  "char": "o",
359
+ "deprecateAliases": true,
356
360
  "name": "target-org",
357
361
  "noCacheDefault": true,
358
362
  "required": true,
@@ -362,77 +366,127 @@
362
366
  "type": "option"
363
367
  },
364
368
  "api-version": {
369
+ "aliases": [
370
+ "apiversion"
371
+ ],
372
+ "deprecateAliases": true,
365
373
  "description": "Override the api version used for api requests made by this command",
366
374
  "name": "api-version",
367
375
  "hasDynamicHelp": false,
368
376
  "multiple": false,
369
377
  "type": "option"
370
378
  },
371
- "title": {
372
- "char": "t",
373
- "name": "title",
374
- "required": false,
375
- "summary": "New title given to the file (ContentDocument) after it's uploaded.",
379
+ "loglevel": {
380
+ "deprecated": {
381
+ "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."
382
+ },
383
+ "hidden": true,
384
+ "name": "loglevel",
376
385
  "hasDynamicHelp": false,
377
386
  "multiple": false,
378
387
  "type": "option"
379
388
  },
380
389
  "file": {
390
+ "aliases": [
391
+ "csvfile"
392
+ ],
381
393
  "char": "f",
394
+ "deprecateAliases": true,
382
395
  "name": "file",
383
396
  "required": true,
384
- "summary": "Path of file to upload.",
397
+ "summary": "CSV file that contains the IDs of the records to update or delete.",
385
398
  "hasDynamicHelp": false,
386
399
  "multiple": false,
387
400
  "type": "option"
388
401
  },
389
- "parent-id": {
390
- "char": "i",
391
- "name": "parent-id",
392
- "summary": "ID of the record to attach the file to.",
402
+ "sobject": {
403
+ "aliases": [
404
+ "sobjecttype"
405
+ ],
406
+ "char": "s",
407
+ "deprecateAliases": true,
408
+ "name": "sobject",
409
+ "required": true,
410
+ "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
393
411
  "hasDynamicHelp": false,
394
412
  "multiple": false,
395
413
  "type": "option"
414
+ },
415
+ "wait": {
416
+ "char": "w",
417
+ "exclusive": [
418
+ "async"
419
+ ],
420
+ "name": "wait",
421
+ "summary": "Number of minutes to wait for the command to complete before displaying the results.",
422
+ "default": "0 minutes",
423
+ "hasDynamicHelp": true,
424
+ "multiple": false,
425
+ "type": "option"
426
+ },
427
+ "async": {
428
+ "char": "a",
429
+ "exclusive": [
430
+ "wait"
431
+ ],
432
+ "name": "async",
433
+ "summary": "Run the command asynchronously.",
434
+ "allowNo": false,
435
+ "type": "boolean"
436
+ },
437
+ "verbose": {
438
+ "name": "verbose",
439
+ "summary": "Print verbose output of failed records if result is available.",
440
+ "allowNo": false,
441
+ "type": "boolean"
442
+ },
443
+ "hard-delete": {
444
+ "description": "You must have the \"Bulk API Hard Delete\" system permission to use this flag. The permission is disabled by default and can be enabled only by a system administrator.",
445
+ "name": "hard-delete",
446
+ "summary": "Mark the records as immediately eligible for deletion by your org. If you don't specify this flag, the deleted records go into the Recycle Bin.",
447
+ "allowNo": false,
448
+ "type": "boolean"
396
449
  }
397
450
  },
398
451
  "hasDynamicHelp": true,
399
452
  "hiddenAliases": [],
400
- "id": "data:create:file",
453
+ "id": "data:delete:bulk",
401
454
  "pluginAlias": "@salesforce/plugin-data",
402
455
  "pluginName": "@salesforce/plugin-data",
403
456
  "pluginType": "core",
404
457
  "strict": true,
405
- "summary": "Upload a local file to an org.",
458
+ "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 2.0.",
406
459
  "enableJsonFlag": true,
407
460
  "isESM": true,
408
461
  "relativePath": [
409
462
  "lib",
410
463
  "commands",
411
464
  "data",
412
- "create",
413
- "file.js"
465
+ "delete",
466
+ "bulk.js"
414
467
  ],
415
468
  "aliasPermutations": [],
416
469
  "permutations": [
417
- "data:create:file",
418
- "create:data:file",
419
- "create:file:data",
420
- "data:file:create",
421
- "file:data:create",
422
- "file:create:data"
470
+ "data:delete:bulk",
471
+ "delete:data:bulk",
472
+ "delete:bulk:data",
473
+ "data:bulk:delete",
474
+ "bulk:data:delete",
475
+ "bulk:delete:data"
423
476
  ]
424
477
  },
425
- "data:create:record": {
478
+ "data:delete:record": {
426
479
  "aliases": [
427
- "force:data:record:create"
480
+ "force:data:record:delete"
428
481
  ],
429
482
  "args": {},
430
483
  "deprecateAliases": true,
431
- "description": "You must specify a value for all required fields of the object.\n\nWhen specifying fields, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command inserts a record into Salesforce objects by default. Use the --use-tooling-api flag to insert into a Tooling API object.",
484
+ "description": "Specify the record you want to delete with either its ID or with a list of field-value pairs that identify the record. If your list of fields identifies more than one record, the delete fails; the error displays how many records were found.\n\nWhen specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command deletes a record from Salesforce objects by default. Use the --use-tooling-api flag to delete from a Tooling API object.",
432
485
  "examples": [
433
- "Insert a record into the Account object of your default org; only the required Name field has a value:\n<%= config.bin %> <%= command.id %> --sobject Account --values \"Name=Acme\"",
434
- "Insert an Account record with values for two fields, one value contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --values \"Name='Universal Containers' Website=www.example.com\" --target-org my-scratch",
435
- "Insert a record into the Tooling API object TraceFlag:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --values \"DebugLevelId=7dl170000008U36AAE StartDate=2022-12-15T00:26:04.000+0000 ExpirationDate=2022-12-15T00:56:04.000+0000 LogType=CLASS_TRACING TracedEntityId=01p17000000R6bLAAS\""
486
+ "Delete a record from Account with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 00180XX",
487
+ "Delete a record from Account whose name equals \"Acme\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name=Acme\"",
488
+ "Delete a record from Account identified with two field values, one that contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Universal Containers' Phone='(123) 456-7890'\" --target-org myscratch",
489
+ "Delete a record from the Tooling API object TraceFlag with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --record-id 7tf8c"
436
490
  ],
437
491
  "flags": {
438
492
  "json": {
@@ -494,16 +548,27 @@
494
548
  "deprecateAliases": true,
495
549
  "name": "sobject",
496
550
  "required": true,
497
- "summary": "API name of the Salesforce or Tooling API object that you're inserting a record into.",
551
+ "summary": "API name of the Salesforce or Tooling API object that you're deleting a record from.",
498
552
  "hasDynamicHelp": false,
499
553
  "multiple": false,
500
554
  "type": "option"
501
555
  },
502
- "values": {
503
- "char": "v",
504
- "name": "values",
505
- "required": true,
506
- "summary": "Values for the flags in the form <fieldName>=<value>, separate multiple pairs with spaces.",
556
+ "record-id": {
557
+ "aliases": [
558
+ "sobjectid"
559
+ ],
560
+ "char": "i",
561
+ "deprecateAliases": true,
562
+ "name": "record-id",
563
+ "summary": "ID of the record you’re deleting.",
564
+ "hasDynamicHelp": false,
565
+ "multiple": false,
566
+ "type": "option"
567
+ },
568
+ "where": {
569
+ "char": "w",
570
+ "name": "where",
571
+ "summary": "List of <fieldName>=<value> pairs that identify the record you want to delete.",
507
572
  "hasDynamicHelp": false,
508
573
  "multiple": false,
509
574
  "type": "option"
@@ -515,7 +580,7 @@
515
580
  "char": "t",
516
581
  "deprecateAliases": true,
517
582
  "name": "use-tooling-api",
518
- "summary": "Use Tooling API so you can insert a record in a Tooling API object.",
583
+ "summary": "Use Tooling API so you can delete a record from a Tooling API object.",
519
584
  "allowNo": false,
520
585
  "type": "boolean"
521
586
  },
@@ -533,63 +598,64 @@
533
598
  },
534
599
  "hasDynamicHelp": true,
535
600
  "hiddenAliases": [],
536
- "id": "data:create:record",
601
+ "id": "data:delete:record",
537
602
  "pluginAlias": "@salesforce/plugin-data",
538
603
  "pluginName": "@salesforce/plugin-data",
539
604
  "pluginType": "core",
540
605
  "strict": true,
541
- "summary": "Create and insert a record into a Salesforce or Tooling API object.",
606
+ "summary": "Deletes a single record from a Salesforce or Tooling API object.",
542
607
  "enableJsonFlag": true,
543
608
  "isESM": true,
544
609
  "relativePath": [
545
610
  "lib",
546
611
  "commands",
547
612
  "data",
548
- "create",
613
+ "delete",
549
614
  "record.js"
550
615
  ],
551
616
  "aliasPermutations": [
552
- "force:data:record:create",
553
- "data:force:record:create",
554
- "data:record:force:create",
555
- "data:record:create:force",
556
- "force:record:data:create",
557
- "record:force:data:create",
558
- "record:data:force:create",
559
- "record:data:create:force",
560
- "force:record:create:data",
561
- "record:force:create:data",
562
- "record:create:force:data",
563
- "record:create:data:force",
564
- "force:data:create:record",
565
- "data:force:create:record",
566
- "data:create:force:record",
567
- "data:create:record:force",
568
- "force:create:data:record",
569
- "create:force:data:record",
570
- "create:data:force:record",
571
- "create:data:record:force",
572
- "force:create:record:data",
573
- "create:force:record:data",
574
- "create:record:force:data",
575
- "create:record:data:force"
617
+ "force:data:record:delete",
618
+ "data:force:record:delete",
619
+ "data:record:force:delete",
620
+ "data:record:delete:force",
621
+ "force:record:data:delete",
622
+ "record:force:data:delete",
623
+ "record:data:force:delete",
624
+ "record:data:delete:force",
625
+ "force:record:delete:data",
626
+ "record:force:delete:data",
627
+ "record:delete:force:data",
628
+ "record:delete:data:force",
629
+ "force:data:delete:record",
630
+ "data:force:delete:record",
631
+ "data:delete:force:record",
632
+ "data:delete:record:force",
633
+ "force:delete:data:record",
634
+ "delete:force:data:record",
635
+ "delete:data:force:record",
636
+ "delete:data:record:force",
637
+ "force:delete:record:data",
638
+ "delete:force:record:data",
639
+ "delete:record:force:data",
640
+ "delete:record:data:force"
576
641
  ],
577
642
  "permutations": [
578
- "data:create:record",
579
- "create:data:record",
580
- "create:record:data",
581
- "data:record:create",
582
- "record:data:create",
583
- "record:create:data"
643
+ "data:delete:record",
644
+ "delete:data:record",
645
+ "delete:record:data",
646
+ "data:record:delete",
647
+ "record:data:delete",
648
+ "record:delete:data"
584
649
  ]
585
650
  },
586
- "data:delete:bulk": {
651
+ "data:delete:resume": {
587
652
  "aliases": [],
588
653
  "args": {},
589
- "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, 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 ID to check the status of the job with the \"<%= config.bin %> data delete resume\" command.",
654
+ "deprecateAliases": true,
655
+ "description": "The command uses the job ID returned by the \"<%= config.bin %> data delete bulk\" command or the most recently-run bulk delete job.",
590
656
  "examples": [
591
- "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",
592
- "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"
657
+ "Resume a bulk delete job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
658
+ "Resume the most recently run bulk delete job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
593
659
  ],
594
660
  "flags": {
595
661
  "json": {
@@ -616,17 +682,41 @@
616
682
  "deprecateAliases": true,
617
683
  "name": "target-org",
618
684
  "noCacheDefault": true,
619
- "required": true,
620
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
685
+ "summary": "Username or alias of the target org. Not required if the \"target-org\" configuration variable is already set.",
621
686
  "hasDynamicHelp": true,
622
687
  "multiple": false,
623
688
  "type": "option"
624
689
  },
625
- "api-version": {
690
+ "job-id": {
626
691
  "aliases": [
627
- "apiversion"
692
+ "jobid"
628
693
  ],
694
+ "char": "i",
629
695
  "deprecateAliases": true,
696
+ "name": "job-id",
697
+ "summary": "ID of the job you want to resume.",
698
+ "hasDynamicHelp": false,
699
+ "multiple": false,
700
+ "type": "option"
701
+ },
702
+ "use-most-recent": {
703
+ "exclusive": [
704
+ "job-id"
705
+ ],
706
+ "name": "use-most-recent",
707
+ "summary": "Use the ID of the most recently-run bulk job.",
708
+ "allowNo": false,
709
+ "type": "boolean"
710
+ },
711
+ "wait": {
712
+ "name": "wait",
713
+ "summary": "Number of minutes to wait for the command to complete before displaying the results.",
714
+ "default": "0 minutes",
715
+ "hasDynamicHelp": true,
716
+ "multiple": false,
717
+ "type": "option"
718
+ },
719
+ "api-version": {
630
720
  "description": "Override the api version used for api requests made by this command",
631
721
  "name": "api-version",
632
722
  "hasDynamicHelp": false,
@@ -642,77 +732,16 @@
642
732
  "hasDynamicHelp": false,
643
733
  "multiple": false,
644
734
  "type": "option"
645
- },
646
- "file": {
647
- "aliases": [
648
- "csvfile"
649
- ],
650
- "char": "f",
651
- "deprecateAliases": true,
652
- "name": "file",
653
- "required": true,
654
- "summary": "CSV file that contains the IDs of the records to update or delete.",
655
- "hasDynamicHelp": false,
656
- "multiple": false,
657
- "type": "option"
658
- },
659
- "sobject": {
660
- "aliases": [
661
- "sobjecttype"
662
- ],
663
- "char": "s",
664
- "deprecateAliases": true,
665
- "name": "sobject",
666
- "required": true,
667
- "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
668
- "hasDynamicHelp": false,
669
- "multiple": false,
670
- "type": "option"
671
- },
672
- "wait": {
673
- "char": "w",
674
- "exclusive": [
675
- "async"
676
- ],
677
- "name": "wait",
678
- "summary": "Number of minutes to wait for the command to complete before displaying the results.",
679
- "default": "0 minutes",
680
- "hasDynamicHelp": true,
681
- "multiple": false,
682
- "type": "option"
683
- },
684
- "async": {
685
- "char": "a",
686
- "exclusive": [
687
- "wait"
688
- ],
689
- "name": "async",
690
- "summary": "Run the command asynchronously.",
691
- "allowNo": false,
692
- "type": "boolean"
693
- },
694
- "verbose": {
695
- "name": "verbose",
696
- "summary": "Print verbose output of failed records if result is available.",
697
- "allowNo": false,
698
- "type": "boolean"
699
- },
700
- "hard-delete": {
701
- "description": "You must have the \"Bulk API Hard Delete\" system permission to use this flag. The permission is disabled by default and can be enabled only by a system administrator.",
702
- "name": "hard-delete",
703
- "summary": "Mark the records as immediately eligible for deletion by your org. If you don't specify this flag, the deleted records go into the Recycle Bin.",
704
- "allowNo": false,
705
- "type": "boolean"
706
735
  }
707
736
  },
708
737
  "hasDynamicHelp": true,
709
738
  "hiddenAliases": [],
710
- "id": "data:delete:bulk",
739
+ "id": "data:delete:resume",
711
740
  "pluginAlias": "@salesforce/plugin-data",
712
741
  "pluginName": "@salesforce/plugin-data",
713
742
  "pluginType": "core",
714
743
  "strict": true,
715
- "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 2.0.",
744
+ "summary": "Resume a bulk delete job that you previously started. Uses Bulk API 2.0.",
716
745
  "enableJsonFlag": true,
717
746
  "isESM": true,
718
747
  "relativePath": [
@@ -720,30 +749,26 @@
720
749
  "commands",
721
750
  "data",
722
751
  "delete",
723
- "bulk.js"
752
+ "resume.js"
724
753
  ],
725
754
  "aliasPermutations": [],
726
755
  "permutations": [
727
- "data:delete:bulk",
728
- "delete:data:bulk",
729
- "delete:bulk:data",
730
- "data:bulk:delete",
731
- "bulk:data:delete",
732
- "bulk:delete:data"
756
+ "data:delete:resume",
757
+ "delete:data:resume",
758
+ "delete:resume:data",
759
+ "data:resume:delete",
760
+ "resume:data:delete",
761
+ "resume:delete:data"
733
762
  ]
734
763
  },
735
- "data:delete:record": {
736
- "aliases": [
737
- "force:data:record:delete"
738
- ],
764
+ "data:create:file": {
765
+ "aliases": [],
739
766
  "args": {},
740
- "deprecateAliases": true,
741
- "description": "Specify the record you want to delete with either its ID or with a list of field-value pairs that identify the record. If your list of fields identifies more than one record, the delete fails; the error displays how many records were found.\n\nWhen specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command deletes a record from Salesforce objects by default. Use the --use-tooling-api flag to delete from a Tooling API object.",
767
+ "description": "This command always creates a new file in the org; you can't update an existing file. After a successful upload, the command displays the ID of the new ContentDocument record which represents the uploaded file.\n\nBy default, the uploaded file isn't attached to a record; in the Salesforce UI the file shows up in the Files tab. You can optionally attach the file to an existing record, such as an account, as long as you know its record ID.\n\nYou can also give the file a new name after it's been uploaded; by default its name in the org is the same as the local file name.",
742
768
  "examples": [
743
- "Delete a record from Account with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 00180XX",
744
- "Delete a record from Account whose name equals \"Acme\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name=Acme\"",
745
- "Delete a record from Account identified with two field values, one that contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Universal Containers' Phone='(123) 456-7890'\" --target-org myscratch",
746
- "Delete a record from the Tooling API object TraceFlag with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --record-id 7tf8c"
769
+ "Upload the local file \"resources/astro.png\" to your default org:\n<%= config.bin %> <%= command.id %> --file resources/astro.png",
770
+ "Give the file a different filename after it's uploaded to the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --file resources/astro.png --title AstroOnABoat.png --target-org my-scratch",
771
+ "Attach the file to a record in the org:\n<%= config.bin %> <%= command.id %> --file path/to/astro.png --parent-id a03fakeLoJWPIA3"
747
772
  ],
748
773
  "flags": {
749
774
  "json": {
@@ -762,12 +787,7 @@
762
787
  "type": "option"
763
788
  },
764
789
  "target-org": {
765
- "aliases": [
766
- "targetusername",
767
- "u"
768
- ],
769
790
  "char": "o",
770
- "deprecateAliases": true,
771
791
  "name": "target-org",
772
792
  "noCacheDefault": true,
773
793
  "required": true,
@@ -777,142 +797,77 @@
777
797
  "type": "option"
778
798
  },
779
799
  "api-version": {
780
- "aliases": [
781
- "apiversion"
782
- ],
783
- "deprecateAliases": true,
784
800
  "description": "Override the api version used for api requests made by this command",
785
801
  "name": "api-version",
786
802
  "hasDynamicHelp": false,
787
803
  "multiple": false,
788
804
  "type": "option"
789
805
  },
790
- "loglevel": {
791
- "deprecated": {
792
- "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."
793
- },
794
- "hidden": true,
795
- "name": "loglevel",
806
+ "title": {
807
+ "char": "t",
808
+ "name": "title",
809
+ "required": false,
810
+ "summary": "New title given to the file (ContentDocument) after it's uploaded.",
796
811
  "hasDynamicHelp": false,
797
812
  "multiple": false,
798
813
  "type": "option"
799
814
  },
800
- "sobject": {
801
- "aliases": [
802
- "sobjecttype"
803
- ],
804
- "char": "s",
805
- "deprecateAliases": true,
806
- "name": "sobject",
815
+ "file": {
816
+ "char": "f",
817
+ "name": "file",
807
818
  "required": true,
808
- "summary": "API name of the Salesforce or Tooling API object that you're deleting a record from.",
819
+ "summary": "Path of file to upload.",
809
820
  "hasDynamicHelp": false,
810
821
  "multiple": false,
811
822
  "type": "option"
812
823
  },
813
- "record-id": {
814
- "aliases": [
815
- "sobjectid"
816
- ],
824
+ "parent-id": {
817
825
  "char": "i",
818
- "deprecateAliases": true,
819
- "name": "record-id",
820
- "summary": "ID of the record you’re deleting.",
821
- "hasDynamicHelp": false,
822
- "multiple": false,
823
- "type": "option"
824
- },
825
- "where": {
826
- "char": "w",
827
- "name": "where",
828
- "summary": "List of <fieldName>=<value> pairs that identify the record you want to delete.",
826
+ "name": "parent-id",
827
+ "summary": "ID of the record to attach the file to.",
829
828
  "hasDynamicHelp": false,
830
829
  "multiple": false,
831
830
  "type": "option"
832
- },
833
- "use-tooling-api": {
834
- "aliases": [
835
- "usetoolingapi"
836
- ],
837
- "char": "t",
838
- "deprecateAliases": true,
839
- "name": "use-tooling-api",
840
- "summary": "Use Tooling API so you can delete a record from a Tooling API object.",
841
- "allowNo": false,
842
- "type": "boolean"
843
- },
844
- "perflog": {
845
- "deprecated": {
846
- "version": "57"
847
- },
848
- "description": "Gets data on API performance metrics from the server. The data is stored in $HOME/.sfdx/apiPerformanceLog.json.",
849
- "hidden": true,
850
- "name": "perflog",
851
- "summary": "Get API performance data.",
852
- "allowNo": false,
853
- "type": "boolean"
854
831
  }
855
832
  },
856
833
  "hasDynamicHelp": true,
857
834
  "hiddenAliases": [],
858
- "id": "data:delete:record",
835
+ "id": "data:create:file",
859
836
  "pluginAlias": "@salesforce/plugin-data",
860
837
  "pluginName": "@salesforce/plugin-data",
861
838
  "pluginType": "core",
862
839
  "strict": true,
863
- "summary": "Deletes a single record from a Salesforce or Tooling API object.",
840
+ "summary": "Upload a local file to an org.",
864
841
  "enableJsonFlag": true,
865
842
  "isESM": true,
866
843
  "relativePath": [
867
844
  "lib",
868
845
  "commands",
869
846
  "data",
870
- "delete",
871
- "record.js"
872
- ],
873
- "aliasPermutations": [
874
- "force:data:record:delete",
875
- "data:force:record:delete",
876
- "data:record:force:delete",
877
- "data:record:delete:force",
878
- "force:record:data:delete",
879
- "record:force:data:delete",
880
- "record:data:force:delete",
881
- "record:data:delete:force",
882
- "force:record:delete:data",
883
- "record:force:delete:data",
884
- "record:delete:force:data",
885
- "record:delete:data:force",
886
- "force:data:delete:record",
887
- "data:force:delete:record",
888
- "data:delete:force:record",
889
- "data:delete:record:force",
890
- "force:delete:data:record",
891
- "delete:force:data:record",
892
- "delete:data:force:record",
893
- "delete:data:record:force",
894
- "force:delete:record:data",
895
- "delete:force:record:data",
896
- "delete:record:force:data",
897
- "delete:record:data:force"
847
+ "create",
848
+ "file.js"
898
849
  ],
850
+ "aliasPermutations": [],
899
851
  "permutations": [
900
- "data:delete:record",
901
- "delete:data:record",
902
- "delete:record:data",
903
- "data:record:delete",
904
- "record:data:delete",
905
- "record:delete:data"
852
+ "data:create:file",
853
+ "create:data:file",
854
+ "create:file:data",
855
+ "data:file:create",
856
+ "file:data:create",
857
+ "file:create:data"
906
858
  ]
907
859
  },
908
- "data:delete:resume": {
909
- "aliases": [],
860
+ "data:create:record": {
861
+ "aliases": [
862
+ "force:data:record:create"
863
+ ],
910
864
  "args": {},
911
865
  "deprecateAliases": true,
912
- "description": "The command uses the job ID returned by the \"<%= config.bin %> data delete bulk\" command or the most recently-run bulk delete job.",
866
+ "description": "You must specify a value for all required fields of the object.\n\nWhen specifying fields, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command inserts a record into Salesforce objects by default. Use the --use-tooling-api flag to insert into a Tooling API object.",
913
867
  "examples": [
914
- "Resume a bulk delete job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
915
- "Resume the most recently run bulk delete job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
868
+ "Insert a record into the Account object of your default org; only the required Name field has a value:\n<%= config.bin %> <%= command.id %> --sobject Account --values \"Name=Acme\"",
869
+ "Insert an Account record with values for two fields, one value contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --values \"Name='Universal Containers' Website=www.example.com\" --target-org my-scratch",
870
+ "Insert a record into the Tooling API object TraceFlag:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --values \"DebugLevelId=7dl170000008U36AAE StartDate=2022-12-15T00:26:04.000+0000 ExpirationDate=2022-12-15T00:56:04.000+0000 LogType=CLASS_TRACING TracedEntityId=01p17000000R6bLAAS\""
916
871
  ],
917
872
  "flags": {
918
873
  "json": {
@@ -939,41 +894,17 @@
939
894
  "deprecateAliases": true,
940
895
  "name": "target-org",
941
896
  "noCacheDefault": true,
942
- "summary": "Username or alias of the target org. Not required if the \"target-org\" configuration variable is already set.",
897
+ "required": true,
898
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
943
899
  "hasDynamicHelp": true,
944
900
  "multiple": false,
945
901
  "type": "option"
946
902
  },
947
- "job-id": {
903
+ "api-version": {
948
904
  "aliases": [
949
- "jobid"
905
+ "apiversion"
950
906
  ],
951
- "char": "i",
952
907
  "deprecateAliases": true,
953
- "name": "job-id",
954
- "summary": "ID of the job you want to resume.",
955
- "hasDynamicHelp": false,
956
- "multiple": false,
957
- "type": "option"
958
- },
959
- "use-most-recent": {
960
- "exclusive": [
961
- "job-id"
962
- ],
963
- "name": "use-most-recent",
964
- "summary": "Use the ID of the most recently-run bulk job.",
965
- "allowNo": false,
966
- "type": "boolean"
967
- },
968
- "wait": {
969
- "name": "wait",
970
- "summary": "Number of minutes to wait for the command to complete before displaying the results.",
971
- "default": "0 minutes",
972
- "hasDynamicHelp": true,
973
- "multiple": false,
974
- "type": "option"
975
- },
976
- "api-version": {
977
908
  "description": "Override the api version used for api requests made by this command",
978
909
  "name": "api-version",
979
910
  "hasDynamicHelp": false,
@@ -989,33 +920,102 @@
989
920
  "hasDynamicHelp": false,
990
921
  "multiple": false,
991
922
  "type": "option"
923
+ },
924
+ "sobject": {
925
+ "aliases": [
926
+ "sobjecttype"
927
+ ],
928
+ "char": "s",
929
+ "deprecateAliases": true,
930
+ "name": "sobject",
931
+ "required": true,
932
+ "summary": "API name of the Salesforce or Tooling API object that you're inserting a record into.",
933
+ "hasDynamicHelp": false,
934
+ "multiple": false,
935
+ "type": "option"
936
+ },
937
+ "values": {
938
+ "char": "v",
939
+ "name": "values",
940
+ "required": true,
941
+ "summary": "Values for the flags in the form <fieldName>=<value>, separate multiple pairs with spaces.",
942
+ "hasDynamicHelp": false,
943
+ "multiple": false,
944
+ "type": "option"
945
+ },
946
+ "use-tooling-api": {
947
+ "aliases": [
948
+ "usetoolingapi"
949
+ ],
950
+ "char": "t",
951
+ "deprecateAliases": true,
952
+ "name": "use-tooling-api",
953
+ "summary": "Use Tooling API so you can insert a record in a Tooling API object.",
954
+ "allowNo": false,
955
+ "type": "boolean"
956
+ },
957
+ "perflog": {
958
+ "deprecated": {
959
+ "version": "57"
960
+ },
961
+ "description": "Gets data on API performance metrics from the server. The data is stored in $HOME/.sfdx/apiPerformanceLog.json.",
962
+ "hidden": true,
963
+ "name": "perflog",
964
+ "summary": "Get API performance data.",
965
+ "allowNo": false,
966
+ "type": "boolean"
992
967
  }
993
968
  },
994
969
  "hasDynamicHelp": true,
995
970
  "hiddenAliases": [],
996
- "id": "data:delete:resume",
971
+ "id": "data:create:record",
997
972
  "pluginAlias": "@salesforce/plugin-data",
998
973
  "pluginName": "@salesforce/plugin-data",
999
974
  "pluginType": "core",
1000
975
  "strict": true,
1001
- "summary": "Resume a bulk delete job that you previously started. Uses Bulk API 2.0.",
976
+ "summary": "Create and insert a record into a Salesforce or Tooling API object.",
1002
977
  "enableJsonFlag": true,
1003
978
  "isESM": true,
1004
979
  "relativePath": [
1005
980
  "lib",
1006
981
  "commands",
1007
982
  "data",
1008
- "delete",
1009
- "resume.js"
983
+ "create",
984
+ "record.js"
985
+ ],
986
+ "aliasPermutations": [
987
+ "force:data:record:create",
988
+ "data:force:record:create",
989
+ "data:record:force:create",
990
+ "data:record:create:force",
991
+ "force:record:data:create",
992
+ "record:force:data:create",
993
+ "record:data:force:create",
994
+ "record:data:create:force",
995
+ "force:record:create:data",
996
+ "record:force:create:data",
997
+ "record:create:force:data",
998
+ "record:create:data:force",
999
+ "force:data:create:record",
1000
+ "data:force:create:record",
1001
+ "data:create:force:record",
1002
+ "data:create:record:force",
1003
+ "force:create:data:record",
1004
+ "create:force:data:record",
1005
+ "create:data:force:record",
1006
+ "create:data:record:force",
1007
+ "force:create:record:data",
1008
+ "create:force:record:data",
1009
+ "create:record:force:data",
1010
+ "create:record:data:force"
1010
1011
  ],
1011
- "aliasPermutations": [],
1012
1012
  "permutations": [
1013
- "data:delete:resume",
1014
- "delete:data:resume",
1015
- "delete:resume:data",
1016
- "data:resume:delete",
1017
- "resume:data:delete",
1018
- "resume:delete:data"
1013
+ "data:create:record",
1014
+ "create:data:record",
1015
+ "create:record:data",
1016
+ "data:record:create",
1017
+ "record:data:create",
1018
+ "record:create:data"
1019
1019
  ]
1020
1020
  },
1021
1021
  "data:export:tree": {
@@ -2979,5 +2979,5 @@
2979
2979
  ]
2980
2980
  }
2981
2981
  },
2982
- "version": "3.5.12"
2982
+ "version": "3.5.13"
2983
2983
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/plugin-data",
3
- "version": "3.5.12",
3
+ "version": "3.5.13",
4
4
  "description": "Plugin for salesforce data commands",
5
5
  "author": "Salesforce",
6
6
  "homepage": "https://github.com/salesforcecli/plugin-data",
@@ -107,7 +107,7 @@
107
107
  "version": "oclif readme"
108
108
  },
109
109
  "dependencies": {
110
- "@jsforce/jsforce-node": "^3.3.2",
110
+ "@jsforce/jsforce-node": "^3.3.3",
111
111
  "@salesforce/core": "^8.2.6",
112
112
  "@salesforce/kit": "^3.1.6",
113
113
  "@salesforce/sf-plugins-core": "^11.2.1",
@@ -251,7 +251,7 @@
251
251
  "exports": "./lib/index.js",
252
252
  "type": "module",
253
253
  "sfdx": {
254
- "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.5.12.crt",
255
- "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.5.12.sig"
254
+ "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.5.13.crt",
255
+ "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.5.13.sig"
256
256
  }
257
257
  }