@salesforce/plugin-data 4.0.37 → 4.0.38

package/README.md

@@ -144,7 +144,7 @@ EXAMPLES
     $ sf data bulk results --job-id 7507i000fake341G --target-org my-scratch
 ```
 
-_See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/bulk/results.ts)_
+_See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/bulk/results.ts)_
 
 ## `sf data create file`
 
@@ -193,7 +193,7 @@ EXAMPLES
     $ sf data create file --file path/to/astro.png --parent-id a03fakeLoJWPIA3
 ```
 
-_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/create/file.ts)_
+_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/create/file.ts)_
 
 ## `sf data create record`
 
@@ -249,7 +249,7 @@ EXAMPLES
       TracedEntityId=01p17000000R6bLAAS"
 ```
 
-_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/create/record.ts)_
+_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/create/record.ts)_
 
 ## `sf data delete bulk`
 
@@ -309,7 +309,7 @@ FLAG DESCRIPTIONS
     and can be enabled only by a system administrator.
 ```
 
-_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/delete/bulk.ts)_
+_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/delete/bulk.ts)_
 
 ## `sf data delete record`
 
@@ -370,7 +370,7 @@ EXAMPLES
     $ sf data delete record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
 ```
 
-_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/delete/record.ts)_
+_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/delete/record.ts)_
 
 ## `sf data delete resume`
 
@@ -409,7 +409,7 @@ EXAMPLES
     $ sf data delete resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/delete/resume.ts)_
+_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/delete/resume.ts)_
 
 ## `sf data export bulk`
 
@@ -483,7 +483,7 @@ EXAMPLES
       --result-format json --async
 ```
 
-_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/export/bulk.ts)_
+_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/export/bulk.ts)_
 
 ## `sf data export resume`
 
@@ -519,7 +519,7 @@ EXAMPLES
     $ sf data export resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/export/resume.ts)_
+_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/export/resume.ts)_
 
 ## `sf data export tree`
 
@@ -579,7 +579,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/export/tree.ts)_
+_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/export/tree.ts)_
 
 ## `sf data get record`
 
@@ -643,7 +643,7 @@ EXAMPLES
     $ sf data get record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
 ```
 
-_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/get/record.ts)_
+_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/get/record.ts)_
 
 ## `sf data import bulk`
 
@@ -701,7 +701,7 @@ EXAMPLES
     $ sf data import bulk --file accounts.csv --sobject Account --async
 ```
 
-_See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/import/bulk.ts)_
+_See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/import/bulk.ts)_
 
 ## `sf data import resume`
 
@@ -737,7 +737,7 @@ EXAMPLES
     $ sf data import resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/import/resume.ts)_
+_See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/import/resume.ts)_
 
 ## `sf data import tree`
 
@@ -801,7 +801,7 @@ FLAG DESCRIPTIONS
     - files(array) - Files: An array of files paths to load
 ```
 
-_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/import/tree.ts)_
+_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/import/tree.ts)_
 
 ## `sf data query`
 
@@ -854,7 +854,7 @@ EXAMPLES
     $ sf data query --query "SELECT Name FROM ApexTrigger" --use-tooling-api
 ```
 
-_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/query.ts)_
+_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/query.ts)_
 
 ## `sf data resume`
 
@@ -891,7 +891,7 @@ EXAMPLES
     $ sf data resume --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA
 ```
 
-_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/resume.ts)_
+_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/resume.ts)_
 
 ## `sf data search`
 
@@ -941,7 +941,7 @@ EXAMPLES
     $ sf data search --file query.txt --target-org my-scratch --result-format csv
 ```
 
-_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/search.ts)_
+_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/search.ts)_
 
 ## `sf data update bulk`
 
@@ -1002,7 +1002,7 @@ EXAMPLES
     $ sf data update bulk --file accounts.csv --sobject Account --async
 ```
 
-_See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/update/bulk.ts)_
+_See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/update/bulk.ts)_
 
 ## `sf data update record`
 
@@ -1064,7 +1064,7 @@ EXAMPLES
       "ExpirationDate=2017-12-01T00:58:04.000+0000"
 ```
 
-_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/update/record.ts)_
+_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/update/record.ts)_
 
 ## `sf data update resume`
 
@@ -1100,7 +1100,7 @@ EXAMPLES
     $ sf data update resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/update/resume.ts)_
+_See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/update/resume.ts)_
 
 ## `sf data upsert bulk`
 
@@ -1157,7 +1157,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/upsert/bulk.ts)_
+_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/upsert/bulk.ts)_
 
 ## `sf data upsert resume`
 
@@ -1196,7 +1196,7 @@ EXAMPLES
     $ sf data upsert resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/data/upsert/resume.ts)_
+_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/upsert/resume.ts)_
 
 ## `sf force data bulk delete`
 
@@ -1243,7 +1243,7 @@ EXAMPLES
     $ sf force data bulk delete --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/force/data/bulk/delete.ts)_
+_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/force/data/bulk/delete.ts)_
 
 ## `sf force data bulk status`
 
@@ -1280,7 +1280,7 @@ EXAMPLES
     $ sf force data bulk status --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/force/data/bulk/status.ts)_
+_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/force/data/bulk/status.ts)_
 
 ## `sf force data bulk upsert`
 
@@ -1338,6 +1338,6 @@ EXAMPLES
       --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.37/src/commands/force/data/bulk/upsert.ts)_
+_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/force/data/bulk/upsert.ts)_
 
 <!-- commandsstop -->

package/oclif.manifest.json

@@ -2116,13 +2116,13 @@
         "tree:import:data"
       ]
     },
-    "data:update:bulk": {
+    "data:upsert:bulk": {
       "aliases": [],
       "args": {},
-      "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).",
+      "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)",
       "examples": [
-        "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",
-        "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"
+        "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",
+        "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"
       ],
       "flags": {
         "json": {
@@ -2140,57 +2140,91 @@
           "multiple": false,
           "type": "option"
         },
-        "async": {
-          "char": "a",
-          "deprecated": true,
-          "name": "async",
-          "summary": "Don't wait for the command to complete.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "char": "w",
-          "name": "wait",
-          "summary": "Time to wait for the command to finish, in minutes.",
+        "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
+          "char": "o",
+          "deprecateAliases": true,
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
+        "api-version": {
+          "aliases": [
+            "apiversion"
+          ],
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "loglevel": {
+          "deprecated": {
+            "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."
+          },
+          "hidden": true,
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "file": {
+          "aliases": [
+            "csvfile"
+          ],
           "char": "f",
+          "deprecateAliases": true,
           "name": "file",
           "required": true,
-          "summary": "CSV file that contains the Salesforce object records you want to update.",
+          "summary": "CSV file that contains the IDs of the records to update or delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "sobject": {
+          "aliases": [
+            "sobjecttype"
+          ],
           "char": "s",
+          "deprecateAliases": true,
           "name": "sobject",
           "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, which you are updating.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+        "wait": {
+          "char": "w",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
+          "default": "0 minutes",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
+        "async": {
+          "char": "a",
+          "deprecated": true,
+          "exclusive": [
+            "wait"
+          ],
+          "name": "async",
+          "summary": "Run the command asynchronously.",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "line-ending": {
           "dependsOn": [
             "file"
@@ -2219,47 +2253,55 @@
             "TAB"
           ],
           "type": "option"
+        },
+        "external-id": {
+          "aliases": [
+            "externalid"
+          ],
+          "char": "i",
+          "deprecateAliases": true,
+          "name": "external-id",
+          "required": true,
+          "summary": "Name of the external ID field, or the Id field.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:bulk",
+      "id": "data:upsert:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Bulk update records to an org from a CSV file. Uses Bulk API 2.0.",
+      "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "update",
+        "upsert",
         "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:update:bulk",
-        "update:data:bulk",
-        "update:bulk:data",
-        "data:bulk:update",
-        "bulk:data:update",
-        "bulk:update:data"
+        "data:upsert:bulk",
+        "upsert:data:bulk",
+        "upsert:bulk:data",
+        "data:bulk:upsert",
+        "bulk:data:upsert",
+        "bulk:upsert:data"
       ]
     },
-    "data:update:record": {
-      "aliases": [
-        "force:data:record:update"
-      ],
+    "data:upsert:resume": {
+      "aliases": [],
       "args": {},
-      "deprecateAliases": true,
-      "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.",
+      "description": "The command uses the job ID returned from the \"<%= config.bin %> data upsert bulk\" command or the most recently-run bulk upsert job.",
       "examples": [
-        "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\"",
-        "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'\"",
-        "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\"",
-        "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\""
+        "Resume a bulk upsert job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "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"
       ],
       "flags": {
         "json": {
@@ -2286,156 +2328,92 @@
           "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "summary": "Username or alias of the target org. Not required if the \"target-org\" configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
-        "api-version": {
-          "aliases": [
-            "apiversion"
-          ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "loglevel": {
-          "deprecated": {
-            "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."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sobject": {
+        "job-id": {
           "aliases": [
-            "sobjecttype"
+            "jobid"
           ],
-          "char": "s",
+          "char": "i",
           "deprecateAliases": true,
-          "name": "sobject",
-          "required": true,
-          "summary": "API name of the Salesforce or Tooling API object that contains the record you're updating.",
+          "name": "job-id",
+          "summary": "ID of the job you want to resume.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "record-id": {
-          "aliases": [
-            "sobjectid"
+        "use-most-recent": {
+          "exclusive": [
+            "job-id"
           ],
-          "char": "i",
-          "deprecateAliases": true,
-          "name": "record-id",
-          "summary": "ID of the record you’re updating.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "name": "use-most-recent",
+          "summary": "Use the ID of the most recently-run bulk job.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "where": {
-          "char": "w",
-          "name": "where",
-          "summary": "List of <fieldName>=<value> pairs that identify the record you want to update.",
-          "hasDynamicHelp": false,
+        "wait": {
+          "name": "wait",
+          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
+          "default": "5 minutes",
+          "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
-        "values": {
-          "char": "v",
-          "name": "values",
-          "required": true,
-          "summary": "Fields that you're updating, in the format of <fieldName>=<value> pairs.",
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "use-tooling-api": {
-          "aliases": [
-            "usetoolingapi"
-          ],
-          "char": "t",
-          "deprecateAliases": true,
-          "name": "use-tooling-api",
-          "summary": "Use Tooling API so you can update a record in a Tooling API object.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "perflog": {
+        "loglevel": {
           "deprecated": {
-            "version": "57"
+            "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."
           },
           "hidden": true,
-          "name": "perflog",
-          "summary": "Get API performance data.",
-          "allowNo": false,
-          "type": "boolean"
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:record",
+      "id": "data:upsert:resume",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Updates a single record of a Salesforce or Tooling API object.",
+      "summary": "Resume a bulk upsert job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "update",
-        "record.js"
-      ],
-      "aliasPermutations": [
-        "force:data:record:update",
-        "data:force:record:update",
-        "data:record:force:update",
-        "data:record:update:force",
-        "force:record:data:update",
-        "record:force:data:update",
-        "record:data:force:update",
-        "record:data:update:force",
-        "force:record:update:data",
-        "record:force:update:data",
-        "record:update:force:data",
-        "record:update:data:force",
-        "force:data:update:record",
-        "data:force:update:record",
-        "data:update:force:record",
-        "data:update:record:force",
-        "force:update:data:record",
-        "update:force:data:record",
-        "update:data:force:record",
-        "update:data:record:force",
-        "force:update:record:data",
-        "update:force:record:data",
-        "update:record:force:data",
-        "update:record:data:force"
+        "upsert",
+        "resume.js"
       ],
+      "aliasPermutations": [],
       "permutations": [
-        "data:update:record",
-        "update:data:record",
-        "update:record:data",
-        "data:record:update",
-        "record:data:update",
-        "record:update:data"
+        "data:upsert:resume",
+        "upsert:data:resume",
+        "upsert:resume:data",
+        "data:resume:upsert",
+        "resume:data:upsert",
+        "resume:upsert:data"
       ]
     },
-    "data:update:resume": {
+    "data:update:bulk": {
       "aliases": [],
       "args": {},
-      "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.",
+      "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).",
       "examples": [
-        "Resume a bulk update job of your default org using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "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"
+        "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",
+        "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"
       ],
       "flags": {
         "json": {
@@ -2453,38 +2431,95 @@
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "name": "use-most-recent",
-          "summary": "Use the job ID of the bulk update job that was most recently run.",
+        "async": {
+          "char": "a",
+          "deprecated": true,
+          "name": "async",
+          "summary": "Don't wait for the command to complete.",
           "allowNo": false,
           "type": "boolean"
         },
-        "job-id": {
-          "char": "i",
-          "name": "job-id",
-          "summary": "Job ID of the bulk update.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "wait": {
           "char": "w",
           "name": "wait",
           "summary": "Time to wait for the command to finish, in minutes.",
-          "default": "5 minutes",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
+        },
+        "file": {
+          "char": "f",
+          "name": "file",
+          "required": true,
+          "summary": "CSV file that contains the Salesforce object records you want to update.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sobject": {
+          "char": "s",
+          "name": "sobject",
+          "required": true,
+          "summary": "API name of the Salesforce object, either standard or custom, which you are updating.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "line-ending": {
+          "dependsOn": [
+            "file"
+          ],
+          "name": "line-ending",
+          "summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "CRLF",
+            "LF"
+          ],
+          "type": "option"
+        },
+        "column-delimiter": {
+          "name": "column-delimiter",
+          "summary": "Column delimiter used in the CSV file.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "BACKQUOTE",
+            "CARET",
+            "COMMA",
+            "PIPE",
+            "SEMICOLON",
+            "TAB"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:resume",
+      "id": "data:update:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk update job that you previously started. Uses Bulk API 2.0.",
+      "summary": "Bulk update records to an org from a CSV file. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2492,25 +2527,30 @@
         "commands",
         "data",
         "update",
-        "resume.js"
+        "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:update:resume",
-        "update:data:resume",
-        "update:resume:data",
-        "data:resume:update",
-        "resume:data:update",
-        "resume:update:data"
+        "data:update:bulk",
+        "update:data:bulk",
+        "update:bulk:data",
+        "data:bulk:update",
+        "bulk:data:update",
+        "bulk:update:data"
       ]
     },
-    "data:upsert:bulk": {
-      "aliases": [],
+    "data:update:record": {
+      "aliases": [
+        "force:data:record:update"
+      ],
       "args": {},
-      "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)",
+      "deprecateAliases": true,
+      "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.",
       "examples": [
-        "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",
-        "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"
+        "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\"",
+        "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'\"",
+        "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\"",
+        "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\""
       ],
       "flags": {
         "json": {
@@ -2564,19 +2604,6 @@
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "aliases": [
-            "csvfile"
-          ],
-          "char": "f",
-          "deprecateAliases": true,
-          "name": "file",
-          "required": true,
-          "summary": "CSV file that contains the IDs of the records to update or delete.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "sobject": {
           "aliases": [
             "sobjecttype"
@@ -2585,111 +2612,121 @@
           "deprecateAliases": true,
           "name": "sobject",
           "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
+          "summary": "API name of the Salesforce or Tooling API object that contains the record you're updating.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "char": "w",
-          "exclusive": [
-            "async"
+        "record-id": {
+          "aliases": [
+            "sobjectid"
           ],
-          "name": "wait",
-          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
-          "default": "0 minutes",
-          "hasDynamicHelp": true,
+          "char": "i",
+          "deprecateAliases": true,
+          "name": "record-id",
+          "summary": "ID of the record you’re updating.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "async": {
-          "char": "a",
-          "deprecated": true,
-          "exclusive": [
-            "wait"
-          ],
-          "name": "async",
-          "summary": "Run the command asynchronously.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "line-ending": {
-          "dependsOn": [
-            "file"
-          ],
-          "name": "line-ending",
-          "summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
+        "where": {
+          "char": "w",
+          "name": "where",
+          "summary": "List of <fieldName>=<value> pairs that identify the record you want to update.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "CRLF",
-            "LF"
-          ],
           "type": "option"
         },
-        "column-delimiter": {
-          "name": "column-delimiter",
-          "summary": "Column delimiter used in the CSV file.",
+        "values": {
+          "char": "v",
+          "name": "values",
+          "required": true,
+          "summary": "Fields that you're updating, in the format of <fieldName>=<value> pairs.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "BACKQUOTE",
-            "CARET",
-            "COMMA",
-            "PIPE",
-            "SEMICOLON",
-            "TAB"
-          ],
           "type": "option"
         },
-        "external-id": {
+        "use-tooling-api": {
           "aliases": [
-            "externalid"
+            "usetoolingapi"
           ],
-          "char": "i",
+          "char": "t",
           "deprecateAliases": true,
-          "name": "external-id",
-          "required": true,
-          "summary": "Name of the external ID field, or the Id field.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "name": "use-tooling-api",
+          "summary": "Use Tooling API so you can update a record in a Tooling API object.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "perflog": {
+          "deprecated": {
+            "version": "57"
+          },
+          "hidden": true,
+          "name": "perflog",
+          "summary": "Get API performance data.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:upsert:bulk",
+      "id": "data:update:record",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.",
+      "summary": "Updates a single record of a Salesforce or Tooling API object.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "upsert",
-        "bulk.js"
+        "update",
+        "record.js"
+      ],
+      "aliasPermutations": [
+        "force:data:record:update",
+        "data:force:record:update",
+        "data:record:force:update",
+        "data:record:update:force",
+        "force:record:data:update",
+        "record:force:data:update",
+        "record:data:force:update",
+        "record:data:update:force",
+        "force:record:update:data",
+        "record:force:update:data",
+        "record:update:force:data",
+        "record:update:data:force",
+        "force:data:update:record",
+        "data:force:update:record",
+        "data:update:force:record",
+        "data:update:record:force",
+        "force:update:data:record",
+        "update:force:data:record",
+        "update:data:force:record",
+        "update:data:record:force",
+        "force:update:record:data",
+        "update:force:record:data",
+        "update:record:force:data",
+        "update:record:data:force"
       ],
-      "aliasPermutations": [],
       "permutations": [
-        "data:upsert:bulk",
-        "upsert:data:bulk",
-        "upsert:bulk:data",
-        "data:bulk:upsert",
-        "bulk:data:upsert",
-        "bulk:upsert:data"
+        "data:update:record",
+        "update:data:record",
+        "update:record:data",
+        "data:record:update",
+        "record:data:update",
+        "record:update:data"
       ]
     },
-    "data:upsert:resume": {
+    "data:update:resume": {
       "aliases": [],
       "args": {},
-      "description": "The command uses the job ID returned from the \"<%= config.bin %> data upsert bulk\" command or the most recently-run bulk upsert job.",
+      "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.",
       "examples": [
-        "Resume a bulk upsert job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "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"
+        "Resume a bulk update job of your default org using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "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"
       ],
       "flags": {
         "json": {
@@ -2707,92 +2744,55 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
-          "char": "o",
-          "deprecateAliases": true,
-          "name": "target-org",
-          "noCacheDefault": true,
-          "summary": "Username or alias of the target org. Not required if the \"target-org\" configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
+        "use-most-recent": {
+          "name": "use-most-recent",
+          "summary": "Use the job ID of the bulk update job that was most recently run.",
+          "allowNo": false,
+          "type": "boolean"
         },
         "job-id": {
-          "aliases": [
-            "jobid"
-          ],
           "char": "i",
-          "deprecateAliases": true,
           "name": "job-id",
-          "summary": "ID of the job you want to resume.",
+          "summary": "Job ID of the bulk update.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "exclusive": [
-            "job-id"
-          ],
-          "name": "use-most-recent",
-          "summary": "Use the ID of the most recently-run bulk job.",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "wait": {
+          "char": "w",
           "name": "wait",
-          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
+          "summary": "Time to wait for the command to finish, in minutes.",
           "default": "5 minutes",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "loglevel": {
-          "deprecated": {
-            "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."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:upsert:resume",
+      "id": "data:update:resume",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk upsert job that you previously started. Uses Bulk API 2.0.",
+      "summary": "Resume a bulk update job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "upsert",
+        "update",
         "resume.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:upsert:resume",
-        "upsert:data:resume",
-        "upsert:resume:data",
-        "data:resume:upsert",
-        "resume:data:upsert",
-        "resume:upsert:data"
+        "data:update:resume",
+        "update:data:resume",
+        "update:resume:data",
+        "data:resume:update",
+        "resume:data:update",
+        "resume:update:data"
       ]
     },
     "force:data:bulk:delete": {
@@ -3232,5 +3232,5 @@
       ]
     }
   },
-  "version": "4.0.37"
+  "version": "4.0.38"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/plugin-data",
-    "version": "4.0.37",
+    "version": "4.0.38",
     "description": "Plugin for salesforce data commands",
     "author": "Salesforce",
     "homepage": "https://github.com/salesforcecli/plugin-data",
@@ -122,7 +122,7 @@
     "dependencies": {
         "@jsforce/jsforce-node": "^3.8.2",
         "@oclif/multi-stage-output": "^0.8.13",
-        "@salesforce/core": "^8.11.4",
+        "@salesforce/core": "^8.12.0",
         "@salesforce/kit": "^3.2.2",
         "@salesforce/sf-plugins-core": "^12.2.2",
         "@salesforce/ts-types": "^2.0.11",
@@ -139,7 +139,7 @@
         "@oclif/test": "^4.1.13",
         "@salesforce/cli-plugins-testkit": "^5.3.39",
         "@salesforce/dev-scripts": "^11.0.2",
-        "@salesforce/plugin-command-reference": "^3.1.52",
+        "@salesforce/plugin-command-reference": "^3.1.54",
         "@salesforce/types": "^1.3.0",
         "eslint-plugin-sf-plugin": "^1.20.24",
         "oclif": "^4.17.46",
@@ -267,7 +267,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.37.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.37.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.38.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.38.sig"
     }
 }