@salesforce/plugin-data 4.0.21 → 4.0.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -25
- package/lib/bulkDataRequestCache.js +2 -15
- package/lib/bulkDataRequestCache.js.map +1 -1
- package/lib/bulkIngest.js +1 -23
- package/lib/bulkIngest.js.map +1 -1
- package/lib/commands/data/delete/resume.js +1 -1
- package/lib/commands/data/delete/resume.js.map +1 -1
- package/lib/commands/data/upsert/resume.js +1 -1
- package/lib/commands/data/upsert/resume.js.map +1 -1
- package/oclif.manifest.json +313 -313
- package/package.json +4 -4
package/oclif.manifest.json
CHANGED
|
@@ -2403,13 +2403,13 @@
|
|
|
2403
2403
|
"resume:query:data"
|
|
2404
2404
|
]
|
|
2405
2405
|
},
|
|
2406
|
-
"data:
|
|
2406
|
+
"data:update:bulk": {
|
|
2407
2407
|
"aliases": [],
|
|
2408
2408
|
"args": {},
|
|
2409
|
-
"description": "
|
|
2409
|
+
"description": "You can use this command to update millions of Salesforce object records based on a file in comma-separated values (CSV) format.\n\nAll the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag. The first column of every line in the CSV file must be an ID of the record you want to update. The CSV file can contain only existing records; if a record in the file doesn't currently exist in the Salesforce object, the command fails. Consider using \"sf data upsert bulk\" if you also want to insert new records.\n\nBulk updates can take a while, depending on how many records are in the CSV file. If the command times out, or you specified the --async flag, the command displays the job ID. To see the status and get the results of the job, run \"sf data update resume\" and pass the job ID to the --job-id flag.\n\nFor information and examples about how to prepare your CSV files, see \"Prepare Data to Ingest\" in the \"Bulk API 2.0 and Bulk API Developer Guide\" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_data.htm).",
|
|
2410
2410
|
"examples": [
|
|
2411
|
-
"
|
|
2412
|
-
"
|
|
2411
|
+
"Update Account records from a CSV-formatted file into an org with alias \"my-scratch\"; if the update doesn't complete in 10 minutes, the command ends and displays a job ID:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch",
|
|
2412
|
+
"Update asynchronously and use the default org; the command immediately returns a job ID that you then pass to the \"sf data update resume\" command:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --async"
|
|
2413
2413
|
],
|
|
2414
2414
|
"flags": {
|
|
2415
2415
|
"json": {
|
|
@@ -2427,89 +2427,55 @@
|
|
|
2427
2427
|
"multiple": false,
|
|
2428
2428
|
"type": "option"
|
|
2429
2429
|
},
|
|
2430
|
-
"
|
|
2431
|
-
"
|
|
2432
|
-
|
|
2433
|
-
|
|
2434
|
-
|
|
2435
|
-
"
|
|
2436
|
-
"deprecateAliases": true,
|
|
2437
|
-
"name": "target-org",
|
|
2438
|
-
"noCacheDefault": true,
|
|
2439
|
-
"required": true,
|
|
2440
|
-
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
2441
|
-
"hasDynamicHelp": true,
|
|
2442
|
-
"multiple": false,
|
|
2443
|
-
"type": "option"
|
|
2444
|
-
},
|
|
2445
|
-
"api-version": {
|
|
2446
|
-
"aliases": [
|
|
2447
|
-
"apiversion"
|
|
2448
|
-
],
|
|
2449
|
-
"deprecateAliases": true,
|
|
2450
|
-
"description": "Override the api version used for api requests made by this command",
|
|
2451
|
-
"name": "api-version",
|
|
2452
|
-
"hasDynamicHelp": false,
|
|
2453
|
-
"multiple": false,
|
|
2454
|
-
"type": "option"
|
|
2430
|
+
"async": {
|
|
2431
|
+
"char": "a",
|
|
2432
|
+
"name": "async",
|
|
2433
|
+
"summary": "Don't wait for the command to complete.",
|
|
2434
|
+
"allowNo": false,
|
|
2435
|
+
"type": "boolean"
|
|
2455
2436
|
},
|
|
2456
|
-
"
|
|
2457
|
-
"
|
|
2458
|
-
|
|
2459
|
-
|
|
2460
|
-
"
|
|
2461
|
-
"name": "loglevel",
|
|
2462
|
-
"hasDynamicHelp": false,
|
|
2437
|
+
"wait": {
|
|
2438
|
+
"char": "w",
|
|
2439
|
+
"name": "wait",
|
|
2440
|
+
"summary": "Time to wait for the command to finish, in minutes.",
|
|
2441
|
+
"hasDynamicHelp": true,
|
|
2463
2442
|
"multiple": false,
|
|
2464
2443
|
"type": "option"
|
|
2465
2444
|
},
|
|
2466
2445
|
"file": {
|
|
2467
|
-
"aliases": [
|
|
2468
|
-
"csvfile"
|
|
2469
|
-
],
|
|
2470
2446
|
"char": "f",
|
|
2471
|
-
"deprecateAliases": true,
|
|
2472
2447
|
"name": "file",
|
|
2473
2448
|
"required": true,
|
|
2474
|
-
"summary": "CSV file that contains the
|
|
2449
|
+
"summary": "CSV file that contains the Salesforce object records you want to update.",
|
|
2475
2450
|
"hasDynamicHelp": false,
|
|
2476
2451
|
"multiple": false,
|
|
2477
2452
|
"type": "option"
|
|
2478
2453
|
},
|
|
2479
2454
|
"sobject": {
|
|
2480
|
-
"aliases": [
|
|
2481
|
-
"sobjecttype"
|
|
2482
|
-
],
|
|
2483
2455
|
"char": "s",
|
|
2484
|
-
"deprecateAliases": true,
|
|
2485
2456
|
"name": "sobject",
|
|
2486
2457
|
"required": true,
|
|
2487
|
-
"summary": "API name of the Salesforce object, either standard or custom,
|
|
2458
|
+
"summary": "API name of the Salesforce object, either standard or custom, which you are updating.",
|
|
2488
2459
|
"hasDynamicHelp": false,
|
|
2489
2460
|
"multiple": false,
|
|
2490
2461
|
"type": "option"
|
|
2491
2462
|
},
|
|
2492
|
-
"
|
|
2493
|
-
"
|
|
2494
|
-
"
|
|
2495
|
-
|
|
2496
|
-
],
|
|
2497
|
-
"name": "wait",
|
|
2498
|
-
"summary": "Number of minutes to wait for the command to complete before displaying the results.",
|
|
2499
|
-
"default": "0 minutes",
|
|
2500
|
-
"hasDynamicHelp": true,
|
|
2463
|
+
"api-version": {
|
|
2464
|
+
"description": "Override the api version used for api requests made by this command",
|
|
2465
|
+
"name": "api-version",
|
|
2466
|
+
"hasDynamicHelp": false,
|
|
2501
2467
|
"multiple": false,
|
|
2502
2468
|
"type": "option"
|
|
2503
2469
|
},
|
|
2504
|
-
"
|
|
2505
|
-
"char": "
|
|
2506
|
-
"
|
|
2507
|
-
|
|
2508
|
-
|
|
2509
|
-
"
|
|
2510
|
-
"
|
|
2511
|
-
"
|
|
2512
|
-
"type": "
|
|
2470
|
+
"target-org": {
|
|
2471
|
+
"char": "o",
|
|
2472
|
+
"name": "target-org",
|
|
2473
|
+
"noCacheDefault": true,
|
|
2474
|
+
"required": true,
|
|
2475
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
2476
|
+
"hasDynamicHelp": true,
|
|
2477
|
+
"multiple": false,
|
|
2478
|
+
"type": "option"
|
|
2513
2479
|
},
|
|
2514
2480
|
"line-ending": {
|
|
2515
2481
|
"dependsOn": [
|
|
@@ -2539,55 +2505,47 @@
|
|
|
2539
2505
|
"TAB"
|
|
2540
2506
|
],
|
|
2541
2507
|
"type": "option"
|
|
2542
|
-
},
|
|
2543
|
-
"external-id": {
|
|
2544
|
-
"aliases": [
|
|
2545
|
-
"externalid"
|
|
2546
|
-
],
|
|
2547
|
-
"char": "i",
|
|
2548
|
-
"deprecateAliases": true,
|
|
2549
|
-
"name": "external-id",
|
|
2550
|
-
"required": true,
|
|
2551
|
-
"summary": "Name of the external ID field, or the Id field.",
|
|
2552
|
-
"hasDynamicHelp": false,
|
|
2553
|
-
"multiple": false,
|
|
2554
|
-
"type": "option"
|
|
2555
2508
|
}
|
|
2556
2509
|
},
|
|
2557
2510
|
"hasDynamicHelp": true,
|
|
2558
2511
|
"hiddenAliases": [],
|
|
2559
|
-
"id": "data:
|
|
2512
|
+
"id": "data:update:bulk",
|
|
2560
2513
|
"pluginAlias": "@salesforce/plugin-data",
|
|
2561
2514
|
"pluginName": "@salesforce/plugin-data",
|
|
2562
2515
|
"pluginType": "core",
|
|
2563
2516
|
"strict": true,
|
|
2564
|
-
"summary": "Bulk
|
|
2517
|
+
"summary": "Bulk update records to an org from a CSV file. Uses Bulk API 2.0.",
|
|
2565
2518
|
"enableJsonFlag": true,
|
|
2566
2519
|
"isESM": true,
|
|
2567
2520
|
"relativePath": [
|
|
2568
2521
|
"lib",
|
|
2569
2522
|
"commands",
|
|
2570
2523
|
"data",
|
|
2571
|
-
"
|
|
2524
|
+
"update",
|
|
2572
2525
|
"bulk.js"
|
|
2573
2526
|
],
|
|
2574
2527
|
"aliasPermutations": [],
|
|
2575
2528
|
"permutations": [
|
|
2576
|
-
"data:
|
|
2577
|
-
"
|
|
2578
|
-
"
|
|
2579
|
-
"data:bulk:
|
|
2580
|
-
"bulk:data:
|
|
2581
|
-
"bulk:
|
|
2529
|
+
"data:update:bulk",
|
|
2530
|
+
"update:data:bulk",
|
|
2531
|
+
"update:bulk:data",
|
|
2532
|
+
"data:bulk:update",
|
|
2533
|
+
"bulk:data:update",
|
|
2534
|
+
"bulk:update:data"
|
|
2582
2535
|
]
|
|
2583
2536
|
},
|
|
2584
|
-
"data:
|
|
2585
|
-
"aliases": [
|
|
2537
|
+
"data:update:record": {
|
|
2538
|
+
"aliases": [
|
|
2539
|
+
"force:data:record:update"
|
|
2540
|
+
],
|
|
2586
2541
|
"args": {},
|
|
2587
|
-
"
|
|
2542
|
+
"deprecateAliases": true,
|
|
2543
|
+
"description": "Specify the record you want to update 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 update fails; the error displays how many records were found.\n\nWhen using field-value pairs for both identifying the record and specifiyng the new field values, 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 updates a record in Salesforce objects by default. Use the --use-tooling-api flag to update a Tooling API object.",
|
|
2588
2544
|
"examples": [
|
|
2589
|
-
"
|
|
2590
|
-
"
|
|
2545
|
+
"Update the Name field of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name=NewAcme\"",
|
|
2546
|
+
"Update the Name field of an Account record whose current name is 'Old Acme':\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Old Acme'\" --values \"Name='New Acme'\"",
|
|
2547
|
+
"Update the Name and Website fields of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name='Acme III' Website=www.example.com\"",
|
|
2548
|
+
"Update the ExpirationDate field of a record of the Tooling API object TraceFlag using the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> -t --sobject TraceFlag --record-id 7tf170000009cUBAAY --values \"ExpirationDate=2017-12-01T00:58:04.000+0000\""
|
|
2591
2549
|
],
|
|
2592
2550
|
"flags": {
|
|
2593
2551
|
"json": {
|
|
@@ -2614,92 +2572,156 @@
|
|
|
2614
2572
|
"deprecateAliases": true,
|
|
2615
2573
|
"name": "target-org",
|
|
2616
2574
|
"noCacheDefault": true,
|
|
2617
|
-
"
|
|
2575
|
+
"required": true,
|
|
2576
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
2618
2577
|
"hasDynamicHelp": true,
|
|
2619
2578
|
"multiple": false,
|
|
2620
2579
|
"type": "option"
|
|
2621
2580
|
},
|
|
2622
|
-
"
|
|
2581
|
+
"api-version": {
|
|
2623
2582
|
"aliases": [
|
|
2624
|
-
"
|
|
2583
|
+
"apiversion"
|
|
2625
2584
|
],
|
|
2626
|
-
"char": "i",
|
|
2627
2585
|
"deprecateAliases": true,
|
|
2628
|
-
"
|
|
2629
|
-
"
|
|
2586
|
+
"description": "Override the api version used for api requests made by this command",
|
|
2587
|
+
"name": "api-version",
|
|
2630
2588
|
"hasDynamicHelp": false,
|
|
2631
2589
|
"multiple": false,
|
|
2632
2590
|
"type": "option"
|
|
2633
2591
|
},
|
|
2634
|
-
"
|
|
2635
|
-
"
|
|
2636
|
-
"
|
|
2592
|
+
"loglevel": {
|
|
2593
|
+
"deprecated": {
|
|
2594
|
+
"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."
|
|
2595
|
+
},
|
|
2596
|
+
"hidden": true,
|
|
2597
|
+
"name": "loglevel",
|
|
2598
|
+
"hasDynamicHelp": false,
|
|
2599
|
+
"multiple": false,
|
|
2600
|
+
"type": "option"
|
|
2601
|
+
},
|
|
2602
|
+
"sobject": {
|
|
2603
|
+
"aliases": [
|
|
2604
|
+
"sobjecttype"
|
|
2637
2605
|
],
|
|
2638
|
-
"
|
|
2639
|
-
"
|
|
2640
|
-
"
|
|
2641
|
-
"
|
|
2606
|
+
"char": "s",
|
|
2607
|
+
"deprecateAliases": true,
|
|
2608
|
+
"name": "sobject",
|
|
2609
|
+
"required": true,
|
|
2610
|
+
"summary": "API name of the Salesforce or Tooling API object that contains the record you're updating.",
|
|
2611
|
+
"hasDynamicHelp": false,
|
|
2612
|
+
"multiple": false,
|
|
2613
|
+
"type": "option"
|
|
2642
2614
|
},
|
|
2643
|
-
"
|
|
2644
|
-
"
|
|
2645
|
-
|
|
2646
|
-
|
|
2647
|
-
"
|
|
2615
|
+
"record-id": {
|
|
2616
|
+
"aliases": [
|
|
2617
|
+
"sobjectid"
|
|
2618
|
+
],
|
|
2619
|
+
"char": "i",
|
|
2620
|
+
"deprecateAliases": true,
|
|
2621
|
+
"name": "record-id",
|
|
2622
|
+
"summary": "ID of the record you’re updating.",
|
|
2623
|
+
"hasDynamicHelp": false,
|
|
2648
2624
|
"multiple": false,
|
|
2649
2625
|
"type": "option"
|
|
2650
2626
|
},
|
|
2651
|
-
"
|
|
2652
|
-
"
|
|
2653
|
-
"name": "
|
|
2627
|
+
"where": {
|
|
2628
|
+
"char": "w",
|
|
2629
|
+
"name": "where",
|
|
2630
|
+
"summary": "List of <fieldName>=<value> pairs that identify the record you want to update.",
|
|
2654
2631
|
"hasDynamicHelp": false,
|
|
2655
2632
|
"multiple": false,
|
|
2656
2633
|
"type": "option"
|
|
2657
2634
|
},
|
|
2658
|
-
"
|
|
2659
|
-
"
|
|
2660
|
-
|
|
2661
|
-
|
|
2662
|
-
"
|
|
2663
|
-
"name": "loglevel",
|
|
2635
|
+
"values": {
|
|
2636
|
+
"char": "v",
|
|
2637
|
+
"name": "values",
|
|
2638
|
+
"required": true,
|
|
2639
|
+
"summary": "Fields that you're updating, in the format of <fieldName>=<value> pairs.",
|
|
2664
2640
|
"hasDynamicHelp": false,
|
|
2665
2641
|
"multiple": false,
|
|
2666
2642
|
"type": "option"
|
|
2643
|
+
},
|
|
2644
|
+
"use-tooling-api": {
|
|
2645
|
+
"aliases": [
|
|
2646
|
+
"usetoolingapi"
|
|
2647
|
+
],
|
|
2648
|
+
"char": "t",
|
|
2649
|
+
"deprecateAliases": true,
|
|
2650
|
+
"name": "use-tooling-api",
|
|
2651
|
+
"summary": "Use Tooling API so you can update a record in a Tooling API object.",
|
|
2652
|
+
"allowNo": false,
|
|
2653
|
+
"type": "boolean"
|
|
2654
|
+
},
|
|
2655
|
+
"perflog": {
|
|
2656
|
+
"deprecated": {
|
|
2657
|
+
"version": "57"
|
|
2658
|
+
},
|
|
2659
|
+
"hidden": true,
|
|
2660
|
+
"name": "perflog",
|
|
2661
|
+
"summary": "Get API performance data.",
|
|
2662
|
+
"allowNo": false,
|
|
2663
|
+
"type": "boolean"
|
|
2667
2664
|
}
|
|
2668
2665
|
},
|
|
2669
2666
|
"hasDynamicHelp": true,
|
|
2670
2667
|
"hiddenAliases": [],
|
|
2671
|
-
"id": "data:
|
|
2668
|
+
"id": "data:update:record",
|
|
2672
2669
|
"pluginAlias": "@salesforce/plugin-data",
|
|
2673
2670
|
"pluginName": "@salesforce/plugin-data",
|
|
2674
2671
|
"pluginType": "core",
|
|
2675
2672
|
"strict": true,
|
|
2676
|
-
"summary": "
|
|
2673
|
+
"summary": "Updates a single record of a Salesforce or Tooling API object.",
|
|
2677
2674
|
"enableJsonFlag": true,
|
|
2678
2675
|
"isESM": true,
|
|
2679
2676
|
"relativePath": [
|
|
2680
2677
|
"lib",
|
|
2681
2678
|
"commands",
|
|
2682
2679
|
"data",
|
|
2683
|
-
"
|
|
2684
|
-
"
|
|
2680
|
+
"update",
|
|
2681
|
+
"record.js"
|
|
2682
|
+
],
|
|
2683
|
+
"aliasPermutations": [
|
|
2684
|
+
"force:data:record:update",
|
|
2685
|
+
"data:force:record:update",
|
|
2686
|
+
"data:record:force:update",
|
|
2687
|
+
"data:record:update:force",
|
|
2688
|
+
"force:record:data:update",
|
|
2689
|
+
"record:force:data:update",
|
|
2690
|
+
"record:data:force:update",
|
|
2691
|
+
"record:data:update:force",
|
|
2692
|
+
"force:record:update:data",
|
|
2693
|
+
"record:force:update:data",
|
|
2694
|
+
"record:update:force:data",
|
|
2695
|
+
"record:update:data:force",
|
|
2696
|
+
"force:data:update:record",
|
|
2697
|
+
"data:force:update:record",
|
|
2698
|
+
"data:update:force:record",
|
|
2699
|
+
"data:update:record:force",
|
|
2700
|
+
"force:update:data:record",
|
|
2701
|
+
"update:force:data:record",
|
|
2702
|
+
"update:data:force:record",
|
|
2703
|
+
"update:data:record:force",
|
|
2704
|
+
"force:update:record:data",
|
|
2705
|
+
"update:force:record:data",
|
|
2706
|
+
"update:record:force:data",
|
|
2707
|
+
"update:record:data:force"
|
|
2685
2708
|
],
|
|
2686
|
-
"aliasPermutations": [],
|
|
2687
2709
|
"permutations": [
|
|
2688
|
-
"data:
|
|
2689
|
-
"
|
|
2690
|
-
"
|
|
2691
|
-
"data:
|
|
2692
|
-
"
|
|
2693
|
-
"
|
|
2710
|
+
"data:update:record",
|
|
2711
|
+
"update:data:record",
|
|
2712
|
+
"update:record:data",
|
|
2713
|
+
"data:record:update",
|
|
2714
|
+
"record:data:update",
|
|
2715
|
+
"record:update:data"
|
|
2694
2716
|
]
|
|
2695
2717
|
},
|
|
2696
|
-
"data:update:
|
|
2718
|
+
"data:update:resume": {
|
|
2697
2719
|
"aliases": [],
|
|
2698
2720
|
"args": {},
|
|
2699
|
-
"description": "
|
|
2721
|
+
"description": "When the original \"sf data update bulk\" command either times out or is run with the --async flag, it displays a job ID. To see the status and get the results of the bulk update, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk update job.",
|
|
2700
2722
|
"examples": [
|
|
2701
|
-
"
|
|
2702
|
-
"
|
|
2723
|
+
"Resume a bulk update job of your default org using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
|
|
2724
|
+
"Resume the most recently run bulk update job for an org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
|
|
2703
2725
|
],
|
|
2704
2726
|
"flags": {
|
|
2705
2727
|
"json": {
|
|
@@ -2717,94 +2739,38 @@
|
|
|
2717
2739
|
"multiple": false,
|
|
2718
2740
|
"type": "option"
|
|
2719
2741
|
},
|
|
2720
|
-
"
|
|
2721
|
-
"
|
|
2722
|
-
"
|
|
2723
|
-
"summary": "Don't wait for the command to complete.",
|
|
2742
|
+
"use-most-recent": {
|
|
2743
|
+
"name": "use-most-recent",
|
|
2744
|
+
"summary": "Use the job ID of the bulk update job that was most recently run.",
|
|
2724
2745
|
"allowNo": false,
|
|
2725
2746
|
"type": "boolean"
|
|
2726
2747
|
},
|
|
2727
|
-
"
|
|
2728
|
-
"char": "
|
|
2729
|
-
"name": "
|
|
2730
|
-
"summary": "
|
|
2731
|
-
"hasDynamicHelp": true,
|
|
2732
|
-
"multiple": false,
|
|
2733
|
-
"type": "option"
|
|
2734
|
-
},
|
|
2735
|
-
"file": {
|
|
2736
|
-
"char": "f",
|
|
2737
|
-
"name": "file",
|
|
2738
|
-
"required": true,
|
|
2739
|
-
"summary": "CSV file that contains the Salesforce object records you want to update.",
|
|
2740
|
-
"hasDynamicHelp": false,
|
|
2741
|
-
"multiple": false,
|
|
2742
|
-
"type": "option"
|
|
2743
|
-
},
|
|
2744
|
-
"sobject": {
|
|
2745
|
-
"char": "s",
|
|
2746
|
-
"name": "sobject",
|
|
2747
|
-
"required": true,
|
|
2748
|
-
"summary": "API name of the Salesforce object, either standard or custom, which you are updating.",
|
|
2749
|
-
"hasDynamicHelp": false,
|
|
2750
|
-
"multiple": false,
|
|
2751
|
-
"type": "option"
|
|
2752
|
-
},
|
|
2753
|
-
"api-version": {
|
|
2754
|
-
"description": "Override the api version used for api requests made by this command",
|
|
2755
|
-
"name": "api-version",
|
|
2748
|
+
"job-id": {
|
|
2749
|
+
"char": "i",
|
|
2750
|
+
"name": "job-id",
|
|
2751
|
+
"summary": "Job ID of the bulk update.",
|
|
2756
2752
|
"hasDynamicHelp": false,
|
|
2757
2753
|
"multiple": false,
|
|
2758
2754
|
"type": "option"
|
|
2759
2755
|
},
|
|
2760
|
-
"
|
|
2761
|
-
"char": "
|
|
2762
|
-
"name": "
|
|
2763
|
-
"
|
|
2764
|
-
"
|
|
2765
|
-
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
2756
|
+
"wait": {
|
|
2757
|
+
"char": "w",
|
|
2758
|
+
"name": "wait",
|
|
2759
|
+
"summary": "Time to wait for the command to finish, in minutes.",
|
|
2760
|
+
"default": "5 minutes",
|
|
2766
2761
|
"hasDynamicHelp": true,
|
|
2767
2762
|
"multiple": false,
|
|
2768
2763
|
"type": "option"
|
|
2769
|
-
},
|
|
2770
|
-
"line-ending": {
|
|
2771
|
-
"dependsOn": [
|
|
2772
|
-
"file"
|
|
2773
|
-
],
|
|
2774
|
-
"name": "line-ending",
|
|
2775
|
-
"summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
|
|
2776
|
-
"hasDynamicHelp": false,
|
|
2777
|
-
"multiple": false,
|
|
2778
|
-
"options": [
|
|
2779
|
-
"CRLF",
|
|
2780
|
-
"LF"
|
|
2781
|
-
],
|
|
2782
|
-
"type": "option"
|
|
2783
|
-
},
|
|
2784
|
-
"column-delimiter": {
|
|
2785
|
-
"name": "column-delimiter",
|
|
2786
|
-
"summary": "Column delimiter used in the CSV file.",
|
|
2787
|
-
"hasDynamicHelp": false,
|
|
2788
|
-
"multiple": false,
|
|
2789
|
-
"options": [
|
|
2790
|
-
"BACKQUOTE",
|
|
2791
|
-
"CARET",
|
|
2792
|
-
"COMMA",
|
|
2793
|
-
"PIPE",
|
|
2794
|
-
"SEMICOLON",
|
|
2795
|
-
"TAB"
|
|
2796
|
-
],
|
|
2797
|
-
"type": "option"
|
|
2798
2764
|
}
|
|
2799
2765
|
},
|
|
2800
2766
|
"hasDynamicHelp": true,
|
|
2801
2767
|
"hiddenAliases": [],
|
|
2802
|
-
"id": "data:update:
|
|
2768
|
+
"id": "data:update:resume",
|
|
2803
2769
|
"pluginAlias": "@salesforce/plugin-data",
|
|
2804
2770
|
"pluginName": "@salesforce/plugin-data",
|
|
2805
2771
|
"pluginType": "core",
|
|
2806
2772
|
"strict": true,
|
|
2807
|
-
"summary": "
|
|
2773
|
+
"summary": "Resume a bulk update job that you previously started. Uses Bulk API 2.0.",
|
|
2808
2774
|
"enableJsonFlag": true,
|
|
2809
2775
|
"isESM": true,
|
|
2810
2776
|
"relativePath": [
|
|
@@ -2812,30 +2778,25 @@
|
|
|
2812
2778
|
"commands",
|
|
2813
2779
|
"data",
|
|
2814
2780
|
"update",
|
|
2815
|
-
"
|
|
2781
|
+
"resume.js"
|
|
2816
2782
|
],
|
|
2817
2783
|
"aliasPermutations": [],
|
|
2818
2784
|
"permutations": [
|
|
2819
|
-
"data:update:
|
|
2820
|
-
"update:data:
|
|
2821
|
-
"update:
|
|
2822
|
-
"data:
|
|
2823
|
-
"
|
|
2824
|
-
"
|
|
2785
|
+
"data:update:resume",
|
|
2786
|
+
"update:data:resume",
|
|
2787
|
+
"update:resume:data",
|
|
2788
|
+
"data:resume:update",
|
|
2789
|
+
"resume:data:update",
|
|
2790
|
+
"resume:update:data"
|
|
2825
2791
|
]
|
|
2826
2792
|
},
|
|
2827
|
-
"data:
|
|
2828
|
-
"aliases": [
|
|
2829
|
-
"force:data:record:update"
|
|
2830
|
-
],
|
|
2793
|
+
"data:upsert:bulk": {
|
|
2794
|
+
"aliases": [],
|
|
2831
2795
|
"args": {},
|
|
2832
|
-
"
|
|
2833
|
-
"description": "Specify the record you want to update 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 update fails; the error displays how many records were found.\n\nWhen using field-value pairs for both identifying the record and specifiyng the new field values, 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 updates a record in Salesforce objects by default. Use the --use-tooling-api flag to update a Tooling API object.",
|
|
2796
|
+
"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)",
|
|
2834
2797
|
"examples": [
|
|
2835
|
-
"
|
|
2836
|
-
"
|
|
2837
|
-
"Update the Name and Website fields of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name='Acme III' Website=www.example.com\"",
|
|
2838
|
-
"Update the ExpirationDate field of a record of the Tooling API object TraceFlag using the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> -t --sobject TraceFlag --record-id 7tf170000009cUBAAY --values \"ExpirationDate=2017-12-01T00:58:04.000+0000\""
|
|
2798
|
+
"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",
|
|
2799
|
+
"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"
|
|
2839
2800
|
],
|
|
2840
2801
|
"flags": {
|
|
2841
2802
|
"json": {
|
|
@@ -2889,129 +2850,131 @@
|
|
|
2889
2850
|
"multiple": false,
|
|
2890
2851
|
"type": "option"
|
|
2891
2852
|
},
|
|
2892
|
-
"
|
|
2853
|
+
"file": {
|
|
2893
2854
|
"aliases": [
|
|
2894
|
-
"
|
|
2855
|
+
"csvfile"
|
|
2895
2856
|
],
|
|
2896
|
-
"char": "
|
|
2857
|
+
"char": "f",
|
|
2897
2858
|
"deprecateAliases": true,
|
|
2898
|
-
"name": "
|
|
2859
|
+
"name": "file",
|
|
2899
2860
|
"required": true,
|
|
2900
|
-
"summary": "
|
|
2861
|
+
"summary": "CSV file that contains the IDs of the records to update or delete.",
|
|
2901
2862
|
"hasDynamicHelp": false,
|
|
2902
2863
|
"multiple": false,
|
|
2903
2864
|
"type": "option"
|
|
2904
2865
|
},
|
|
2905
|
-
"
|
|
2866
|
+
"sobject": {
|
|
2906
2867
|
"aliases": [
|
|
2907
|
-
"
|
|
2868
|
+
"sobjecttype"
|
|
2908
2869
|
],
|
|
2909
|
-
"char": "
|
|
2870
|
+
"char": "s",
|
|
2910
2871
|
"deprecateAliases": true,
|
|
2911
|
-
"name": "
|
|
2912
|
-
"
|
|
2872
|
+
"name": "sobject",
|
|
2873
|
+
"required": true,
|
|
2874
|
+
"summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
|
|
2913
2875
|
"hasDynamicHelp": false,
|
|
2914
2876
|
"multiple": false,
|
|
2915
2877
|
"type": "option"
|
|
2916
2878
|
},
|
|
2917
|
-
"
|
|
2879
|
+
"wait": {
|
|
2918
2880
|
"char": "w",
|
|
2919
|
-
"
|
|
2920
|
-
|
|
2881
|
+
"exclusive": [
|
|
2882
|
+
"async"
|
|
2883
|
+
],
|
|
2884
|
+
"name": "wait",
|
|
2885
|
+
"summary": "Number of minutes to wait for the command to complete before displaying the results.",
|
|
2886
|
+
"default": "0 minutes",
|
|
2887
|
+
"hasDynamicHelp": true,
|
|
2888
|
+
"multiple": false,
|
|
2889
|
+
"type": "option"
|
|
2890
|
+
},
|
|
2891
|
+
"async": {
|
|
2892
|
+
"char": "a",
|
|
2893
|
+
"exclusive": [
|
|
2894
|
+
"wait"
|
|
2895
|
+
],
|
|
2896
|
+
"name": "async",
|
|
2897
|
+
"summary": "Run the command asynchronously.",
|
|
2898
|
+
"allowNo": false,
|
|
2899
|
+
"type": "boolean"
|
|
2900
|
+
},
|
|
2901
|
+
"line-ending": {
|
|
2902
|
+
"dependsOn": [
|
|
2903
|
+
"file"
|
|
2904
|
+
],
|
|
2905
|
+
"name": "line-ending",
|
|
2906
|
+
"summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
|
|
2921
2907
|
"hasDynamicHelp": false,
|
|
2922
2908
|
"multiple": false,
|
|
2909
|
+
"options": [
|
|
2910
|
+
"CRLF",
|
|
2911
|
+
"LF"
|
|
2912
|
+
],
|
|
2923
2913
|
"type": "option"
|
|
2924
2914
|
},
|
|
2925
|
-
"
|
|
2926
|
-
"
|
|
2927
|
-
"
|
|
2928
|
-
"required": true,
|
|
2929
|
-
"summary": "Fields that you're updating, in the format of <fieldName>=<value> pairs.",
|
|
2915
|
+
"column-delimiter": {
|
|
2916
|
+
"name": "column-delimiter",
|
|
2917
|
+
"summary": "Column delimiter used in the CSV file.",
|
|
2930
2918
|
"hasDynamicHelp": false,
|
|
2931
2919
|
"multiple": false,
|
|
2920
|
+
"options": [
|
|
2921
|
+
"BACKQUOTE",
|
|
2922
|
+
"CARET",
|
|
2923
|
+
"COMMA",
|
|
2924
|
+
"PIPE",
|
|
2925
|
+
"SEMICOLON",
|
|
2926
|
+
"TAB"
|
|
2927
|
+
],
|
|
2932
2928
|
"type": "option"
|
|
2933
2929
|
},
|
|
2934
|
-
"
|
|
2930
|
+
"external-id": {
|
|
2935
2931
|
"aliases": [
|
|
2936
|
-
"
|
|
2932
|
+
"externalid"
|
|
2937
2933
|
],
|
|
2938
|
-
"char": "
|
|
2934
|
+
"char": "i",
|
|
2939
2935
|
"deprecateAliases": true,
|
|
2940
|
-
"name": "
|
|
2941
|
-
"
|
|
2942
|
-
"
|
|
2943
|
-
"
|
|
2944
|
-
|
|
2945
|
-
|
|
2946
|
-
"deprecated": {
|
|
2947
|
-
"version": "57"
|
|
2948
|
-
},
|
|
2949
|
-
"hidden": true,
|
|
2950
|
-
"name": "perflog",
|
|
2951
|
-
"summary": "Get API performance data.",
|
|
2952
|
-
"allowNo": false,
|
|
2953
|
-
"type": "boolean"
|
|
2936
|
+
"name": "external-id",
|
|
2937
|
+
"required": true,
|
|
2938
|
+
"summary": "Name of the external ID field, or the Id field.",
|
|
2939
|
+
"hasDynamicHelp": false,
|
|
2940
|
+
"multiple": false,
|
|
2941
|
+
"type": "option"
|
|
2954
2942
|
}
|
|
2955
2943
|
},
|
|
2956
2944
|
"hasDynamicHelp": true,
|
|
2957
2945
|
"hiddenAliases": [],
|
|
2958
|
-
"id": "data:
|
|
2946
|
+
"id": "data:upsert:bulk",
|
|
2959
2947
|
"pluginAlias": "@salesforce/plugin-data",
|
|
2960
2948
|
"pluginName": "@salesforce/plugin-data",
|
|
2961
2949
|
"pluginType": "core",
|
|
2962
2950
|
"strict": true,
|
|
2963
|
-
"summary": "
|
|
2951
|
+
"summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.",
|
|
2964
2952
|
"enableJsonFlag": true,
|
|
2965
2953
|
"isESM": true,
|
|
2966
2954
|
"relativePath": [
|
|
2967
2955
|
"lib",
|
|
2968
2956
|
"commands",
|
|
2969
2957
|
"data",
|
|
2970
|
-
"
|
|
2971
|
-
"
|
|
2972
|
-
],
|
|
2973
|
-
"aliasPermutations": [
|
|
2974
|
-
"force:data:record:update",
|
|
2975
|
-
"data:force:record:update",
|
|
2976
|
-
"data:record:force:update",
|
|
2977
|
-
"data:record:update:force",
|
|
2978
|
-
"force:record:data:update",
|
|
2979
|
-
"record:force:data:update",
|
|
2980
|
-
"record:data:force:update",
|
|
2981
|
-
"record:data:update:force",
|
|
2982
|
-
"force:record:update:data",
|
|
2983
|
-
"record:force:update:data",
|
|
2984
|
-
"record:update:force:data",
|
|
2985
|
-
"record:update:data:force",
|
|
2986
|
-
"force:data:update:record",
|
|
2987
|
-
"data:force:update:record",
|
|
2988
|
-
"data:update:force:record",
|
|
2989
|
-
"data:update:record:force",
|
|
2990
|
-
"force:update:data:record",
|
|
2991
|
-
"update:force:data:record",
|
|
2992
|
-
"update:data:force:record",
|
|
2993
|
-
"update:data:record:force",
|
|
2994
|
-
"force:update:record:data",
|
|
2995
|
-
"update:force:record:data",
|
|
2996
|
-
"update:record:force:data",
|
|
2997
|
-
"update:record:data:force"
|
|
2958
|
+
"upsert",
|
|
2959
|
+
"bulk.js"
|
|
2998
2960
|
],
|
|
2961
|
+
"aliasPermutations": [],
|
|
2999
2962
|
"permutations": [
|
|
3000
|
-
"data:
|
|
3001
|
-
"
|
|
3002
|
-
"
|
|
3003
|
-
"data:
|
|
3004
|
-
"
|
|
3005
|
-
"
|
|
2963
|
+
"data:upsert:bulk",
|
|
2964
|
+
"upsert:data:bulk",
|
|
2965
|
+
"upsert:bulk:data",
|
|
2966
|
+
"data:bulk:upsert",
|
|
2967
|
+
"bulk:data:upsert",
|
|
2968
|
+
"bulk:upsert:data"
|
|
3006
2969
|
]
|
|
3007
2970
|
},
|
|
3008
|
-
"data:
|
|
2971
|
+
"data:upsert:resume": {
|
|
3009
2972
|
"aliases": [],
|
|
3010
2973
|
"args": {},
|
|
3011
|
-
"description": "
|
|
2974
|
+
"description": "The command uses the job ID returned from the \"<%= config.bin %> data upsert bulk\" command or the most recently-run bulk upsert job.",
|
|
3012
2975
|
"examples": [
|
|
3013
|
-
"Resume a bulk
|
|
3014
|
-
"Resume the most recently run bulk
|
|
2976
|
+
"Resume a bulk upsert job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
|
|
2977
|
+
"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"
|
|
3015
2978
|
],
|
|
3016
2979
|
"flags": {
|
|
3017
2980
|
"json": {
|
|
@@ -3029,55 +2992,92 @@
|
|
|
3029
2992
|
"multiple": false,
|
|
3030
2993
|
"type": "option"
|
|
3031
2994
|
},
|
|
3032
|
-
"
|
|
3033
|
-
"
|
|
3034
|
-
|
|
3035
|
-
|
|
3036
|
-
|
|
2995
|
+
"target-org": {
|
|
2996
|
+
"aliases": [
|
|
2997
|
+
"targetusername",
|
|
2998
|
+
"u"
|
|
2999
|
+
],
|
|
3000
|
+
"char": "o",
|
|
3001
|
+
"deprecateAliases": true,
|
|
3002
|
+
"name": "target-org",
|
|
3003
|
+
"noCacheDefault": true,
|
|
3004
|
+
"summary": "Username or alias of the target org. Not required if the \"target-org\" configuration variable is already set.",
|
|
3005
|
+
"hasDynamicHelp": true,
|
|
3006
|
+
"multiple": false,
|
|
3007
|
+
"type": "option"
|
|
3037
3008
|
},
|
|
3038
3009
|
"job-id": {
|
|
3010
|
+
"aliases": [
|
|
3011
|
+
"jobid"
|
|
3012
|
+
],
|
|
3039
3013
|
"char": "i",
|
|
3014
|
+
"deprecateAliases": true,
|
|
3040
3015
|
"name": "job-id",
|
|
3041
|
-
"summary": "
|
|
3016
|
+
"summary": "ID of the job you want to resume.",
|
|
3042
3017
|
"hasDynamicHelp": false,
|
|
3043
3018
|
"multiple": false,
|
|
3044
3019
|
"type": "option"
|
|
3045
3020
|
},
|
|
3021
|
+
"use-most-recent": {
|
|
3022
|
+
"exclusive": [
|
|
3023
|
+
"job-id"
|
|
3024
|
+
],
|
|
3025
|
+
"name": "use-most-recent",
|
|
3026
|
+
"summary": "Use the ID of the most recently-run bulk job.",
|
|
3027
|
+
"allowNo": false,
|
|
3028
|
+
"type": "boolean"
|
|
3029
|
+
},
|
|
3046
3030
|
"wait": {
|
|
3047
|
-
"char": "w",
|
|
3048
3031
|
"name": "wait",
|
|
3049
|
-
"summary": "
|
|
3032
|
+
"summary": "Number of minutes to wait for the command to complete before displaying the results.",
|
|
3050
3033
|
"default": "5 minutes",
|
|
3051
3034
|
"hasDynamicHelp": true,
|
|
3052
3035
|
"multiple": false,
|
|
3053
3036
|
"type": "option"
|
|
3037
|
+
},
|
|
3038
|
+
"api-version": {
|
|
3039
|
+
"description": "Override the api version used for api requests made by this command",
|
|
3040
|
+
"name": "api-version",
|
|
3041
|
+
"hasDynamicHelp": false,
|
|
3042
|
+
"multiple": false,
|
|
3043
|
+
"type": "option"
|
|
3044
|
+
},
|
|
3045
|
+
"loglevel": {
|
|
3046
|
+
"deprecated": {
|
|
3047
|
+
"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."
|
|
3048
|
+
},
|
|
3049
|
+
"hidden": true,
|
|
3050
|
+
"name": "loglevel",
|
|
3051
|
+
"hasDynamicHelp": false,
|
|
3052
|
+
"multiple": false,
|
|
3053
|
+
"type": "option"
|
|
3054
3054
|
}
|
|
3055
3055
|
},
|
|
3056
3056
|
"hasDynamicHelp": true,
|
|
3057
3057
|
"hiddenAliases": [],
|
|
3058
|
-
"id": "data:
|
|
3058
|
+
"id": "data:upsert:resume",
|
|
3059
3059
|
"pluginAlias": "@salesforce/plugin-data",
|
|
3060
3060
|
"pluginName": "@salesforce/plugin-data",
|
|
3061
3061
|
"pluginType": "core",
|
|
3062
3062
|
"strict": true,
|
|
3063
|
-
"summary": "Resume a bulk
|
|
3063
|
+
"summary": "Resume a bulk upsert job that you previously started. Uses Bulk API 2.0.",
|
|
3064
3064
|
"enableJsonFlag": true,
|
|
3065
3065
|
"isESM": true,
|
|
3066
3066
|
"relativePath": [
|
|
3067
3067
|
"lib",
|
|
3068
3068
|
"commands",
|
|
3069
3069
|
"data",
|
|
3070
|
-
"
|
|
3070
|
+
"upsert",
|
|
3071
3071
|
"resume.js"
|
|
3072
3072
|
],
|
|
3073
3073
|
"aliasPermutations": [],
|
|
3074
3074
|
"permutations": [
|
|
3075
|
-
"data:
|
|
3076
|
-
"
|
|
3077
|
-
"
|
|
3078
|
-
"data:resume:
|
|
3079
|
-
"resume:data:
|
|
3080
|
-
"resume:
|
|
3075
|
+
"data:upsert:resume",
|
|
3076
|
+
"upsert:data:resume",
|
|
3077
|
+
"upsert:resume:data",
|
|
3078
|
+
"data:resume:upsert",
|
|
3079
|
+
"resume:data:upsert",
|
|
3080
|
+
"resume:upsert:data"
|
|
3081
3081
|
]
|
|
3082
3082
|
},
|
|
3083
3083
|
"force:data:bulk:delete": {
|
|
@@ -3517,5 +3517,5 @@
|
|
|
3517
3517
|
]
|
|
3518
3518
|
}
|
|
3519
3519
|
},
|
|
3520
|
-
"version": "4.0.
|
|
3520
|
+
"version": "4.0.23"
|
|
3521
3521
|
}
|