@salesforce/plugin-data 2.5.15 → 2.5.17

package/README.md

@@ -92,14 +92,6 @@ sf plugins
 - [`sf force:data:bulk:delete`](#sf-forcedatabulkdelete)
 - [`sf force:data:bulk:status`](#sf-forcedatabulkstatus)
 - [`sf force:data:bulk:upsert`](#sf-forcedatabulkupsert)
-- [`sf force:data:record:create`](#sf-forcedatarecordcreate)
-- [`sf force:data:record:delete`](#sf-forcedatarecorddelete)
-- [`sf force:data:record:get`](#sf-forcedatarecordget)
-- [`sf force:data:record:update`](#sf-forcedatarecordupdate)
-- [`sf force:data:soql:bulk:report`](#sf-forcedatasoqlbulkreport)
-- [`sf force:data:soql:query`](#sf-forcedatasoqlquery)
-- [`sf force:data:tree:export`](#sf-forcedatatreeexport)
-- [`sf force:data:tree:import`](#sf-forcedatatreeimport)
 
 ## `sf data:create:record`
 
@@ -110,7 +102,7 @@ USAGE
   $ sf data:create:record -o <value> -s <value> -v <value> [--json] [--api-version <value>] [-t]
 
 FLAGS
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're inserting a record
                             into.
   -t, --use-tooling-api     Use Tooling API so you can insert a record in a Tooling API object.
@@ -153,7 +145,7 @@ EXAMPLES
       TracedEntityId=01p17000000R6bLAAS"
 ```
 
-_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/v2.5.4/src/commands/data/create/record.ts)_
+_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/create/record.ts)_
 
 ## `sf data:delete:bulk`
 
@@ -165,10 +157,10 @@ USAGE
 
 FLAGS
   -a, --async               Run the command asynchronously.
-  -f, --file=<value>        (required) CSV file that contains the IDs of the records to delete.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -f, --file=<value>        (required) CSV file that contains the IDs of the records to update or delete.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   -s, --sobject=<value>     (required) API name of the Salesforce object, either standard or custom, that you want to
-                            delete records from.
+                            update or delete records from.
   -w, --wait=<value>        [default: 0 minutes] Number of minutes to wait for the command to complete before displaying
                             the results.
   --api-version=<value>     Override the api version used for api requests made by this command
@@ -197,7 +189,7 @@ EXAMPLES
     $ sf data:delete:bulk --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch
 ```
 
-_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/v2.5.4/src/commands/data/delete/bulk.ts)_
+_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/delete/bulk.ts)_
 
 ## `sf data:delete:record`
 
@@ -209,7 +201,7 @@ USAGE
 
 FLAGS
   -i, --record-id=<value>   ID of the record you’re deleting.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're deleting a record
                             from.
   -t, --use-tooling-api     Use Tooling API so you can delete a record from a Tooling API object.
@@ -255,7 +247,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/v2.5.4/src/commands/data/delete/record.ts)_
+_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/delete/record.ts)_
 
 ## `sf data:delete:resume`
 
@@ -292,7 +284,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/v2.5.4/src/commands/data/delete/resume.ts)_
+_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/delete/resume.ts)_
 
 ## `sf data:export:tree`
 
@@ -304,7 +296,7 @@ USAGE
 
 FLAGS
   -d, --output-dir=<value>  Directory in which to generate the JSON files; default is current directory.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   -p, --plan                Generate multiple sObject tree files and a plan definition file for aggregated import.
   -q, --query=<value>       (required) SOQL query, or filepath of a file that contains the query, to retrieve records.
   -x, --prefix=<value>      Prefix of generated files.
@@ -335,7 +327,7 @@ EXAMPLES
   Export records retrieved with the specified SOQL query into a single JSON file in the current directory; the command
   uses your default org:
 
-    $ sf data:export:tree --query "SELECT Id, Name, (SELECT Name, Address__c FROM Properties**r) FROM Broker__c"
+    $ sf data:export:tree --query "SELECT Id, Name, (SELECT Name, Address__c FROM Properties__r) FROM Broker__c"
 
   Export data using a SOQL query in the "query.txt" file and generate JSON files for each object and a plan that
   aggregates them:
@@ -349,7 +341,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/v2.5.4/src/commands/data/export/tree.ts)_
+_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/export/tree.ts)_
 
 ## `sf data:get:record`
 
@@ -361,7 +353,7 @@ USAGE
 
 FLAGS
   -i, --record-id=<value>   ID of the record you’re retrieving.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're retrieving a record
                             from.
   -t, --use-tooling-api     Use Tooling API so you can retrieve a record from a Tooling API object.
@@ -410,7 +402,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/v2.5.4/src/commands/data/get/record.ts)_
+_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/get/record.ts)_
 
 ## `sf data:import:tree`
 
@@ -423,7 +415,7 @@ USAGE
 FLAGS
   -f, --files=<value>...    Comma-separated and in-order JSON files that contain the records, in sObject tree format,
                             that you want to insert.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   -p, --plan=<value>        Plan definition file to insert multiple data files.
   --api-version=<value>     Override the api version used for api requests made by this command
   --config-help             Display schema information for the --plan configuration file to stdout; if you specify this
@@ -460,7 +452,7 @@ EXAMPLES
     $ sf data:import:tree --plan Account-Contact-plan.json
 ```
 
-_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/v2.5.4/src/commands/data/import/tree.ts)_
+_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/import/tree.ts)_
 
 ## `sf data:query`
 
@@ -474,7 +466,7 @@ USAGE
 FLAGS
   -b, --bulk                    Use Bulk API 2.0 to run the query.
   -f, --file=<value>            File that contains the SOQL query.
-  -o, --target-org=<value>      (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>      (required) Username or alias of the target org.
   -q, --query=<value>           SOQL query to execute.
   -r, --result-format=<option>  [default: human] Format to display the results; the --json flag overrides this flag.
                                 <options: human|json|csv>
@@ -522,7 +514,7 @@ EXAMPLES
     $ sf data:query --query "SELECT Id FROM Contact" --bulk --wait 0
 ```
 
-_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/v2.5.4/src/commands/data/query.ts)_
+_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/query.ts)_
 
 ## `sf data:query:resume`
 
@@ -558,7 +550,7 @@ EXAMPLES
     $ sf data:query:resume --bulk-query-id 7500x000005BdFzXXX
 ```
 
-_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/v2.5.4/src/commands/data/query/resume.ts)_
+_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/query/resume.ts)_
 
 ## `sf data:resume`
 
@@ -571,7 +563,7 @@ USAGE
 FLAGS
   -b, --batch-id=<value>    ID of the batch whose status you want to view; you must also specify the job ID.
   -i, --job-id=<value>      (required) ID of the job whose status you want to view.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   --api-version=<value>     Override the api version used for api requests made by this command
 
 GLOBAL FLAGS
@@ -593,7 +585,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/v2.5.4/src/commands/data/resume.ts)_
+_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/resume.ts)_
 
 ## `sf data:update:record`
 
@@ -606,7 +598,7 @@ USAGE
 
 FLAGS
   -i, --record-id=<value>   ID of the record you’re updating.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that contains the record you're
                             updating.
   -t, --use-tooling-api     Use Tooling API so you can update a record in a Tooling API object.
@@ -621,7 +613,7 @@ DESCRIPTION
   Updates a single record of a Salesforce or Tooling API object.
 
   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 delete fails; the error displays how many records were
+  If your list of fields identifies more than one record, the update fails; the error displays how many records were
   found.
 
   When using field-value pairs for both identifying the record and specifiyng the new field values, use the format
@@ -653,7 +645,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/v2.5.4/src/commands/data/update/record.ts)_
+_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/update/record.ts)_
 
 ## `sf data:upsert:bulk`
 
@@ -666,11 +658,11 @@ USAGE
 
 FLAGS
   -a, --async                Run the command asynchronously.
-  -f, --file=<value>         (required) CSV file that contains the IDs of the records to delete.
+  -f, --file=<value>         (required) CSV file that contains the IDs of the records to update or delete.
   -i, --external-id=<value>  (required) Name of the external ID field, or the Id field.
-  -o, --target-org=<value>   (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>   (required) Username or alias of the target org.
   -s, --sobject=<value>      (required) API name of the Salesforce object, either standard or custom, that you want to
-                             delete records from.
+                             update or delete records from.
   -w, --wait=<value>         [default: 0 minutes] Number of minutes to wait for the command to complete before
                              displaying the results.
   --api-version=<value>      Override the api version used for api requests made by this command
@@ -704,7 +696,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/v2.5.4/src/commands/data/upsert/bulk.ts)_
+_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/upsert/bulk.ts)_
 
 ## `sf data:upsert:resume`
 
@@ -741,7 +733,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/v2.5.4/src/commands/data/upsert/resume.ts)_
+_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/data/upsert/resume.ts)_
 
 ## `sf force:data:bulk:delete`
 
@@ -753,7 +745,7 @@ USAGE
 
 FLAGS
   -f, --file=<value>        (required) CSV file that contains the IDs of the records to delete.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   -s, --sobject=<value>     (required) API name of the Salesforce object, either standard or custom, that you want to
                             delete records from.
   -w, --wait=<value>        [default: 0 minutes] Number of minutes to wait for the command to complete before displaying
@@ -785,7 +777,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/v2.5.4/src/commands/force/data/bulk/delete.ts)_
+_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/force/data/bulk/delete.ts)_
 
 ## `sf force:data:bulk:status`
 
@@ -798,7 +790,7 @@ USAGE
 FLAGS
   -b, --batch-id=<value>    ID of the batch whose status you want to view; you must also specify the job ID.
   -i, --job-id=<value>      (required) ID of the job whose status you want to view.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
   --api-version=<value>     Override the api version used for api requests made by this command
 
 GLOBAL FLAGS
@@ -820,7 +812,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/v2.5.4/src/commands/force/data/bulk/status.ts)_
+_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/force/data/bulk/status.ts)_
 
 ## `sf force:data:bulk:upsert`
 
@@ -834,7 +826,7 @@ USAGE
 FLAGS
   -f, --file=<value>         (required) CSV file that contains the records to upsert.
   -i, --external-id=<value>  (required) Name of the external ID field, or the Id field.
-  -o, --target-org=<value>   (required) Org alias or username to use for the target org.
+  -o, --target-org=<value>   (required) Username or alias of the target org.
   -r, --serial               Run batches in serial mode.
   -s, --sobject=<value>      (required) API name of the Salesforce object, either standard or custom, that you want to
                              upsert records to.
@@ -876,430 +868,6 @@ EXAMPLES
       --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/v2.5.4/src/commands/force/data/bulk/upsert.ts)_
-
-## `sf force:data:record:create`
-
-Create and insert a record into a Salesforce or Tooling API object.
-
-```
-USAGE
-  $ sf force:data:record:create -o <value> -s <value> -v <value> [--json] [--api-version <value>] [-t]
-
-FLAGS
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
-  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're inserting a record
-                            into.
-  -t, --use-tooling-api     Use Tooling API so you can insert a record in a Tooling API object.
-  -v, --values=<value>      (required) Values for the flags in the form <fieldName>=<value>, separate multiple pairs
-                            with spaces.
-  --api-version=<value>     Override the api version used for api requests made by this command
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Create and insert a record into a Salesforce or Tooling API object.
-
-  You must specify a value for all required fields of the object.
-
-  When 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.
-
-  This command inserts a record into Salesforce objects by default. Use the --use-tooling-api flag to insert into a
-  Tooling API object.
-
-ALIASES
-  $ sf force:data:record:create
-
-EXAMPLES
-  Insert a record into the Account object of your default org; only the required Name field has a value:
-
-    $ sf force:data:record:create --sobject Account --values "Name=Acme"
-
-  Insert an Account record with values for two fields, one value contains a space; the command uses the org with alias
-  "my-scratch":
-
-    $ sf force:data:record:create --sobject Account --values "Name='Universal Containers' Website=www.example.com" \
-      --target-org my-scratch
-
-  Insert a record into the Tooling API object TraceFlag:
-
-    $ sf force:data:record:create --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"
-```
-
-## `sf force:data:record:delete`
-
-Deletes a single record from a Salesforce or Tooling API object.
-
-```
-USAGE
-  $ sf force:data:record:delete -o <value> -s <value> [--json] [--api-version <value>] [-i <value>] [-w <value>] [-t]
-
-FLAGS
-  -i, --record-id=<value>   ID of the record you’re deleting.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
-  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're deleting a record
-                            from.
-  -t, --use-tooling-api     Use Tooling API so you can delete a record from a Tooling API object.
-  -w, --where=<value>       List of <fieldName>=<value> pairs that identify the record you want to delete.
-  --api-version=<value>     Override the api version used for api requests made by this command
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Deletes a single record from a Salesforce or Tooling API object.
-
-  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.
-
-  When 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.
-
-  This command deletes a record from Salesforce objects by default. Use the --use-tooling-api flag to delete from a
-  Tooling API object.
-
-ALIASES
-  $ sf force:data:record:delete
-
-EXAMPLES
-  Delete a record from Account with the specified (truncated) ID:
-
-    $ sf force:data:record:delete --sobject Account --record-id 00180XX
-
-  Delete a record from Account whose name equals "Acme":
-
-    $ sf force:data:record:delete --sobject Account --where "Name=Acme"
-
-  Delete a record from Account identified with two field values, one that contains a space; the command uses the org
-  with alias "my-scratch":
-
-    $ sf force:data:record:delete --sobject Account --where "Name='Universal Containers' Phone='(123) 456-7890'" \
-      --target-org myscratch
-
-  Delete a record from the Tooling API object TraceFlag with the specified (truncated) ID:
-
-    $ sf force:data:record:delete --use-tooling-api --sobject TraceFlag --record-id 7tf8c
-```
-
-## `sf force:data:record:get`
-
-Retrieve and display a single record of a Salesforce or Tooling API object.
-
-```
-USAGE
-  $ sf force:data:record:get -o <value> -s <value> [--json] [--api-version <value>] [-i <value>] [-w <value>] [-t]
-
-FLAGS
-  -i, --record-id=<value>   ID of the record you’re retrieving.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
-  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're retrieving a record
-                            from.
-  -t, --use-tooling-api     Use Tooling API so you can retrieve a record from a Tooling API object.
-  -w, --where=<value>       List of <fieldName>=<value> pairs that identify the record you want to display.
-  --api-version=<value>     Override the api version used for api requests made by this command
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Retrieve and display a single record of a Salesforce or Tooling API object.
-
-  Specify the record you want to retrieve 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 command fails; the error displays how many records
-  were found.
-
-  When 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.
-
-  The command displays all the record's fields and their values, one field per terminal line. Fields with no values are
-  displayed as "null".
-
-  This command retrieves a record from Salesforce objects by default. Use the --use-tooling-api flag to retrieve from a
-  Tooling API object.
-
-ALIASES
-  $ sf force:data:record:get
-
-EXAMPLES
-  Retrieve and display a record from Account with the specified (truncated) ID:
-
-    $ sf force:data:record:get --sobject Account --record-id 00180XX
-
-  Retrieve a record from Account whose name equals "Acme":
-
-    $ sf force:data:record:get --sobject Account --where "Name=Acme"
-
-  Retrieve a record from Account identified with two field values, one that contains a space; the command uses the org
-  with alias "my-scratch":
-
-    $ sf force:data:record:get --sobject Account --where "Name='Universal Containers' Phone='(123) 456-7890'" \
-      --target-org myscratch
-
-  Retrieve a record from the Tooling API object TraceFlag with the specified (truncated) ID:
-
-    $ sf force:data:record:get --use-tooling-api --sobject TraceFlag --record-id 7tf8c
-```
-
-## `sf force:data:record:update`
-
-Updates a single record of a Salesforce or Tooling API object.
-
-```
-USAGE
-  $ sf force:data:record:update -o <value> -s <value> -v <value> [--json] [--api-version <value>] [-i <value>] [-w <value>]
-    [-t]
-
-FLAGS
-  -i, --record-id=<value>   ID of the record you’re updating.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
-  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that contains the record you're
-                            updating.
-  -t, --use-tooling-api     Use Tooling API so you can update a record in a Tooling API object.
-  -v, --values=<value>      (required) Fields that you're updating, in the format of <fieldName>=<value> pairs.
-  -w, --where=<value>       List of <fieldName>=<value> pairs that identify the record you want to update.
-  --api-version=<value>     Override the api version used for api requests made by this command
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Updates a single record of a Salesforce or Tooling API object.
-
-  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 delete fails; the error displays how many records were
-  found.
-
-  When 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.
-
-  This command updates a record in Salesforce objects by default. Use the --use-tooling-api flag to update a Tooling API
-  object.
-
-ALIASES
-  $ sf force:data:record:update
-
-EXAMPLES
-  Update the Name field of an Account record with the specified (truncated) ID:
-
-    $ sf force:data:record:update --sobject Account --record-id 001D0 --values "Name=NewAcme"
-
-  Update the Name field of an Account record whose current name is 'Old Acme':
-
-    $ sf force:data:record:update --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:
-
-    $ sf force:data:record:update --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:
-
-    $ sf force:data:record:update -t --sobject TraceFlag --record-id 7tf170000009cUBAAY --values \
-      "ExpirationDate=2017-12-01T00:58:04.000+0000"
-```
-
-## `sf force:data:soql:bulk:report`
-
-View the status of a bulk query.
-
-```
-USAGE
-  $ sf force:data:soql:bulk:report [--json] [-o <value>] [--api-version <value>] [-r human|json|csv] [--use-most-recent | -i
-    <value>]
-
-FLAGS
-  -i, --bulk-query-id=<value>   Job ID of the bulk query.
-  -o, --target-org=<value>      Org alias or username to use for the target org.
-  -r, --result-format=<option>  [default: human] Format to display the results; the --json flag overrides this flag.
-                                <options: human|json|csv>
-  --api-version=<value>         Override the api version used for api requests made by this command
-  --use-most-recent             Use the most recent bulk query ID from cache.
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  View the status of a bulk query.
-
-  Run this command using the job ID returned from the "sf data query --bulk" command.
-
-ALIASES
-  $ sf force:data:soql:bulk:report
-
-EXAMPLES
-  View the status of a bulk query with the specified ID:
-
-    $ sf force:data:soql:bulk:report --bulk-query-id 7500x000005BdFzXXX
-```
-
-## `sf force:data:soql:query`
-
-Execute a SOQL query.
-
-```
-USAGE
-  $ sf force:data:soql:query -o <value> [--json] [--api-version <value>] [-q <value>] [-f <value>] [-w <value> [-b | -t]]
-    [--async ] [--all-rows] [-r human|json|csv]
-
-FLAGS
-  -b, --bulk                    Use Bulk API 2.0 to run the query.
-  -f, --file=<value>            File that contains the SOQL query.
-  -o, --target-org=<value>      (required) Org alias or username to use for the target org.
-  -q, --query=<value>           SOQL query to execute.
-  -r, --result-format=<option>  [default: human] Format to display the results; the --json flag overrides this flag.
-                                <options: human|json|csv>
-  -t, --use-tooling-api         Use Tooling API so you can run queries on Tooling API objects.
-  -w, --wait=<value>            Time to wait for the command to finish, in minutes.
-  --all-rows                    Include deleted records. By default, deleted records are not returned.
-  --api-version=<value>         Override the api version used for api requests made by this command
-  --async                       Use Bulk API 2.0, but don't wait for the job to complete.
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Execute a SOQL query.
-
-  Specify the SOQL query at the command line with the --query flag or read the query from a file with the --file flag.
-
-  If your query returns more than 10,000 records, specify the --bulk flag. The command then runs the query using Bulk
-  API 2.0, which has higher limits than the default API used by the command.
-
-  When using --bulk, the command waits 3 minutes by default for the query to complete. Use the --wait parameter to
-  specify a different number of minutes to wait, or set --wait to 0 to immediately return control to the terminal. If
-  you set --wait to 0, or you use the --async flag, or the command simply times out, the command displays an ID. Pass
-  this ID to the the "data query resume" command using the --bulk-query-id flag to get the results; pass the ID to the
-  "data resume" command to get the job status.
-
-ALIASES
-  $ sf force:data:soql:query
-
-EXAMPLES
-  Specify a SOQL query at the command line; the command uses your default org:
-
-    $ sf force:data:soql:query --query "SELECT Id, Name, Account.Name FROM Contact"
-
-  Read the SOQL query from a file called "query.txt"; the command uses the org with alias "my-scratch":
-
-    $ sf force:data:soql:query --file query.txt --target-org my-scratch
-
-  Use Tooling API to run a query on the ApexTrigger Tooling API object:
-
-    $ sf force:data:soql:query --query "SELECT Name FROM ApexTrigger" --use-tooling-api
-
-  Use Bulk API 2.0 to run a query that returns many rows, and return control to the terminal immediately:
-
-    $ sf force:data:soql:query --query "SELECT Id FROM Contact" --bulk --wait 0
-```
-
-## `sf force:data:tree:export`
-
-Export data from an org into one or more JSON files.
-
-```
-USAGE
-  $ sf force:data:tree:export -o <value> -q <value> [--json] [--api-version <value>] [-p] [-x <value>] [-d <value>]
-
-FLAGS
-  -d, --output-dir=<value>  Directory in which to generate the JSON files; default is current directory.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
-  -p, --plan                Generate multiple sObject tree files and a plan definition file for aggregated import.
-  -q, --query=<value>       (required) SOQL query, or filepath of a file that contains the query, to retrieve records.
-  -x, --prefix=<value>      Prefix of generated files.
-  --api-version=<value>     Override the api version used for api requests made by this command
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Export data from an org into one or more JSON files.
-
-  Specify a SOQL query, either directly at the command line or read from a file, to retrieve the data you want to
-  export. The exported data is written to JSON files in sObject tree format, which is a collection of nested,
-  parent-child records with a single root record. Use these JSON files to import data into an org with the "sf data
-  import tree" command.
-
-  If your SOQL query references multiple objects, the command generates a single JSON file by default. You can specify
-  the --plan flag to generate separate JSON files for each object and a plan definition file that aggregates them. You
-  then specify just this plan definition file when you import the data into an org.
-
-  The SOQL query can return a maximum of 2,000 records. For more information, see the REST API Developer Guide.
-  (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm).
-
-ALIASES
-  $ sf force:data:tree:export
-
-EXAMPLES
-  Export records retrieved with the specified SOQL query into a single JSON file in the current directory; the command
-  uses your default org:
-
-    $ sf force:data:tree:export --query "SELECT Id, Name, (SELECT Name, Address__c FROM Properties**r) FROM \
-      Broker__c"
-
-  Export data using a SOQL query in the "query.txt" file and generate JSON files for each object and a plan that
-  aggregates them:
-
-    $ sf force:data:tree:export --query query.txt --plan
-
-  Prepend "export-demo" before each generated file and generate the files in the "export-out" directory; run the
-  command on the org with alias "my-scratch":
-
-    $ sf force:data:tree:export --query query.txt --plan --prefix export-demo --output-dir export-out --target-org \
-      my-scratch
-```
-
-## `sf force:data:tree:import`
-
-Import data from one or more JSON files into an org.
-
-```
-USAGE
-  $ sf force:data:tree:import -o <value> [--json] [--api-version <value>] [-f <value> | -p <value>] [--config-help]
-
-FLAGS
-  -f, --files=<value>...    Comma-separated and in-order JSON files that contain the records, in sObject tree format,
-                            that you want to insert.
-  -o, --target-org=<value>  (required) Org alias or username to use for the target org.
-  -p, --plan=<value>        Plan definition file to insert multiple data files.
-  --api-version=<value>     Override the api version used for api requests made by this command
-  --config-help             Display schema information for the --plan configuration file to stdout; if you specify this
-                            flag, all other flags except --json are ignored.
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Import data from one or more JSON files into an org.
-
-  The JSON files that contain the data are in sObject tree format, which is a collection of nested, parent-child records
-  with a single root record. Use the "sf data export tree" command to generate these JSON files.
-
-  If you used the --plan flag when exporting the data to generate a plan definition file, use the --plan flag to
-  reference the file when you import. If you're not using a plan, use the --files flag to list the files. If you specify
-  multiple JSON files that depend on each other in a parent-child relationship, be sure you list them in the correct
-  order.
-
-  The sObject Tree API supports requests that contain up to 200 records. For more information, see the REST API
-  Developer Guide.
-  (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm)
-
-ALIASES
-  $ sf force:data:tree:import
-
-EXAMPLES
-  Import the records contained in two JSON files into the org with alias "my-scratch":
-
-    $ sf force:data:tree:import --files Contact.json,Account.json --target-org my-scratch
-
-  Import records using a plan definition file into your default org:
-
-    $ sf force:data:tree:import --plan Account-Contact-plan.json
-```
+_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/2.5.17/src/commands/force/data/bulk/upsert.ts)_
 
 <!-- commandsstop -->

package/messages/bulk.operation.command.md

@@ -1,10 +1,10 @@
 # flags.sobject.summary
 
-API name of the Salesforce object, either standard or custom, that you want to delete records from.
+API name of the Salesforce object, either standard or custom, that you want to update or delete records from.
 
 # flags.csvfile.summary
 
-CSV file that contains the IDs of the records to delete.
+CSV file that contains the IDs of the records to update or delete.
 
 # flags.wait.summary
 

package/messages/record.update.md

@@ -4,7 +4,7 @@ Updates a single record of a Salesforce or Tooling API object.
 
 # 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 delete fails; the error displays how many records were found.
+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.
 
 When 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.
 

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.5.15",
+  "version": "2.5.17",
   "commands": {
     "data:query": {
       "id": "data:query",
@@ -412,7 +412,7 @@
           "name": "file",
           "type": "option",
           "char": "f",
-          "summary": "CSV file that contains the IDs of the records to delete.",
+          "summary": "CSV file that contains the IDs of the records to update or delete.",
           "required": true,
           "multiple": false,
           "aliases": [
@@ -423,7 +423,7 @@
           "name": "sobject",
           "type": "option",
           "char": "s",
-          "summary": "API name of the Salesforce object, either standard or custom, that you want to delete records from.",
+          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
           "required": true,
           "multiple": false,
           "aliases": [
@@ -1095,7 +1095,7 @@
     "data:update:record": {
       "id": "data:update:record",
       "summary": "Updates a single record of a Salesforce or Tooling API object.",
-      "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 delete 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": "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.",
       "strict": true,
       "pluginName": "@salesforce/plugin-data",
       "pluginAlias": "@salesforce/plugin-data",
@@ -1273,7 +1273,7 @@
           "name": "file",
           "type": "option",
           "char": "f",
-          "summary": "CSV file that contains the IDs of the records to delete.",
+          "summary": "CSV file that contains the IDs of the records to update or delete.",
           "required": true,
           "multiple": false,
           "aliases": [
@@ -1284,7 +1284,7 @@
           "name": "sobject",
           "type": "option",
           "char": "s",
-          "summary": "API name of the Salesforce object, either standard or custom, that you want to delete records from.",
+          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
           "required": true,
           "multiple": false,
           "aliases": [

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/plugin-data",
-    "version": "2.5.15",
+    "version": "2.5.17",
     "description": "Plugin for salesforce data commands",
     "author": "Salesforce",
     "main": "lib/index.js",
@@ -109,7 +109,7 @@
         "@salesforce/core": "^5.3.1",
         "@salesforce/kit": "^3.0.9",
         "@salesforce/sf-plugins-core": "^3.1.23",
-        "@salesforce/ts-types": "^2.0.6",
+        "@salesforce/ts-types": "^2.0.8",
         "chalk": "^4.1.0",
         "csv-parse": "^4.16.3",
         "csv-stringify": "^6.4.0",
@@ -118,21 +118,21 @@
     },
     "devDependencies": {
         "@oclif/plugin-command-snapshot": "^4.0.13",
-        "@salesforce/cli-plugins-testkit": "^4.3.6",
+        "@salesforce/cli-plugins-testkit": "^4.4.6",
         "@salesforce/dev-config": "^4.0.1",
         "@salesforce/dev-scripts": "^5.10.0",
         "@salesforce/plugin-command-reference": "^3.0.33",
-        "@salesforce/plugin-settings": "^1.4.29",
+        "@salesforce/plugin-settings": "^1.4.33",
         "@salesforce/prettier-config": "^0.0.3",
         "@salesforce/ts-sinon": "^1.4.14",
         "@swc/core": "1.3.31",
         "@types/chai-as-promised": "^7.1.6",
-        "@types/shelljs": "^0.8.10",
+        "@types/shelljs": "^0.8.13",
         "@typescript-eslint/eslint-plugin": "^5.62.0",
         "@typescript-eslint/parser": "^5.62.0",
-        "chai": "^4.3.8",
+        "chai": "^4.3.10",
         "chai-as-promised": "^7.1.1",
-        "eslint": "^8.50.0",
+        "eslint": "^8.51.0",
         "eslint-config-prettier": "^8.9.0",
         "eslint-config-salesforce": "^2.0.2",
         "eslint-config-salesforce-license": "^0.2.0",
@@ -140,11 +140,11 @@
         "eslint-plugin-header": "^3.1.1",
         "eslint-plugin-import": "^2.28.0",
         "eslint-plugin-jsdoc": "^44.2.7",
-        "eslint-plugin-sf-plugin": "^1.16.5",
+        "eslint-plugin-sf-plugin": "^1.16.9",
         "husky": "^7.0.4",
         "mocha": "^9.1.3",
         "nyc": "^15.1.0",
-        "oclif": "^3.15.0",
+        "oclif": "^3.17.2",
         "prettier": "^2.8.8",
         "pretty-quick": "^3.1.0",
         "shelljs": "~0.8.4",
@@ -260,7 +260,7 @@
         }
     },
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/2.5.15.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/2.5.15.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/2.5.17.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/2.5.17.sig"
     }
 }