Skip to content

Commit

Permalink
chore(release): 3.12.0 [skip ci]
Browse files Browse the repository at this point in the history
  • Loading branch information
svc-cli-bot committed Nov 26, 2024
1 parent 1d2cf30 commit 93d7252
Show file tree
Hide file tree
Showing 3 changed files with 73 additions and 60 deletions.
6 changes: 6 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
# [3.12.0](https://github.com/salesforcecli/plugin-data/compare/3.11.6...3.12.0) (2024-11-26)

### Features

- multi-stage-output/new csv flags ([#1110](https://github.com/salesforcecli/plugin-data/issues/1110)) ([1d2cf30](https://github.com/salesforcecli/plugin-data/commit/1d2cf30daf33b77d6e129f53d8301e3fde86e05b))

## [3.11.6](https://github.com/salesforcecli/plugin-data/compare/3.11.5...3.11.6) (2024-11-24)

### Bug Fixes
Expand Down
124 changes: 66 additions & 58 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,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/3.11.6/src/commands/data/bulk/results.ts)_
_See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/bulk/results.ts)_

## `sf data create file`

Expand Down Expand Up @@ -194,7 +194,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/3.11.6/src/commands/data/create/file.ts)_
_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/create/file.ts)_

## `sf data create record`

Expand Down Expand Up @@ -250,30 +250,33 @@ EXAMPLES
TracedEntityId=01p17000000R6bLAAS"
```

_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.11.6/src/commands/data/create/record.ts)_
_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/create/record.ts)_

## `sf data delete bulk`

Bulk delete records from an org using a CSV file. Uses Bulk API 2.0.

```
USAGE
$ sf data delete bulk -o <value> -f <value> -s <value> [--json] [--flags-dir <value>] [--api-version <value>] [-w
<value> | -a] [--verbose] [--hard-delete]
$ sf data delete bulk -o <value> -s <value> [--json] [--flags-dir <value>] [--api-version <value>] [-w <value> | -a]
[--verbose] (--line-ending CRLF|LF -f <value>) [--hard-delete]
FLAGS
-a, --async Run the command asynchronously.
-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. Not required if the `target-org`
configuration variable is already set.
-s, --sobject=<value> (required) API name of the Salesforce object, either standard or custom, that you want to
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
--hard-delete Mark the records as immediately eligible for deletion by your org. If you don't specify
this flag, the deleted records go into the Recycle Bin.
--verbose Print verbose output of failed records if result is available.
-a, --async Run the command asynchronously.
-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. Not required if the `target-org`
configuration variable is already set.
-s, --sobject=<value> (required) API name of the Salesforce object, either standard or custom, that you want to
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
--hard-delete Mark the records as immediately eligible for deletion by your org. If you don't specify
this flag, the deleted records go into the Recycle Bin.
--line-ending=<option> Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux
it's `LF`.
<options: CRLF|LF>
--verbose Print verbose output of failed records if result is available.
GLOBAL FLAGS
--flags-dir=<value> Import flag values from a directory.
Expand Down Expand Up @@ -308,7 +311,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/3.11.6/src/commands/data/delete/bulk.ts)_
_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/delete/bulk.ts)_

## `sf data delete record`

Expand Down Expand Up @@ -369,7 +372,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/3.11.6/src/commands/data/delete/record.ts)_
_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/delete/record.ts)_

## `sf data delete resume`

Expand All @@ -386,7 +389,7 @@ FLAGS
variable is already set.
--api-version=<value> Override the api version used for api requests made by this command
--use-most-recent Use the ID of the most recently-run bulk job.
--wait=<value> [default: 0 minutes] Number of minutes to wait for the command to complete before
--wait=<value> [default: 5 minutes] Number of minutes to wait for the command to complete before
displaying the results.
GLOBAL FLAGS
Expand All @@ -408,7 +411,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/3.11.6/src/commands/data/delete/resume.ts)_
_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/delete/resume.ts)_

## `sf data export bulk`

Expand Down Expand Up @@ -482,7 +485,7 @@ EXAMPLES
--result-format json --async
```

_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.11.6/src/commands/data/export/bulk.ts)_
_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/export/bulk.ts)_

## `sf data export resume`

Expand Down Expand Up @@ -518,7 +521,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/3.11.6/src/commands/data/export/resume.ts)_
_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/export/resume.ts)_

## `sf data export tree`

Expand Down Expand Up @@ -579,7 +582,7 @@ EXAMPLES
my-scratch
```

_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.11.6/src/commands/data/export/tree.ts)_
_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/export/tree.ts)_

## `sf data get record`

Expand Down Expand Up @@ -643,7 +646,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/3.11.6/src/commands/data/get/record.ts)_
_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/get/record.ts)_

## `sf data import bulk`

Expand All @@ -663,7 +666,7 @@ FLAGS
you're importing records.
-w, --wait=<value> Time to wait for the command to finish, in minutes.
--api-version=<value> Override the api version used for api requests made by this command
--column-delimiter=<option> Column delimiter used in the CSV file. Default is COMMA.
--column-delimiter=<option> Column delimiter used in the CSV file.
<options: BACKQUOTE|CARET|COMMA|PIPE|SEMICOLON|TAB>
--line-ending=<option> Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and
Linux it's `LF`.
Expand Down Expand Up @@ -701,7 +704,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/3.11.6/src/commands/data/import/bulk.ts)_
_See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/import/bulk.ts)_

## `sf data import resume`

Expand Down Expand Up @@ -737,7 +740,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/3.11.6/src/commands/data/import/resume.ts)_
_See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/import/resume.ts)_

## `sf data import tree`

Expand Down Expand Up @@ -802,7 +805,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/3.11.6/src/commands/data/import/tree.ts)_
_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/import/tree.ts)_

## `sf data query`

Expand Down Expand Up @@ -866,7 +869,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/3.11.6/src/commands/data/query.ts)_
_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/query.ts)_

## `sf data query resume`

Expand All @@ -879,8 +882,7 @@ USAGE
FLAGS
-i, --bulk-query-id=<value> Job ID of the bulk query.
-o, --target-org=<value> Username or alias of the target org. Not required if the "target-org" configuration
variable is already set.
-o, --target-org=<value> Username or alias of the target org.
-r, --result-format=<option> [default: human] Format to display the results; the --json flag overrides this flag.
<options: human|csv|json>
--api-version=<value> Override the api version used for api requests made by this command
Expand All @@ -904,7 +906,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/3.11.6/src/commands/data/query/resume.ts)_
_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/query/resume.ts)_

## `sf data resume`

Expand Down Expand Up @@ -941,7 +943,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/3.11.6/src/commands/data/resume.ts)_
_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/resume.ts)_

## `sf data search`

Expand Down Expand Up @@ -991,7 +993,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/3.11.6/src/commands/data/search.ts)_
_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/search.ts)_

## `sf data update bulk`

Expand All @@ -1011,7 +1013,7 @@ FLAGS
are updating.
-w, --wait=<value> Time to wait for the command to finish, in minutes.
--api-version=<value> Override the api version used for api requests made by this command
--column-delimiter=<option> Column delimiter used in the CSV file. Default is COMMA.
--column-delimiter=<option> Column delimiter used in the CSV file.
<options: BACKQUOTE|CARET|COMMA|PIPE|SEMICOLON|TAB>
--line-ending=<option> Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and
Linux it's `LF`.
Expand Down Expand Up @@ -1052,7 +1054,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/3.11.6/src/commands/data/update/bulk.ts)_
_See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/update/bulk.ts)_

## `sf data update record`

Expand Down Expand Up @@ -1114,7 +1116,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/3.11.6/src/commands/data/update/record.ts)_
_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/update/record.ts)_

## `sf data update resume`

Expand Down Expand Up @@ -1150,29 +1152,35 @@ 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/3.11.6/src/commands/data/update/resume.ts)_
_See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/update/resume.ts)_

## `sf data upsert bulk`

Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.

```
USAGE
$ sf data upsert bulk -o <value> -f <value> -s <value> -i <value> [--json] [--flags-dir <value>] [--api-version
<value>] [-w <value> | -a] [--verbose]
$ sf data upsert bulk -o <value> -s <value> -i <value> [--json] [--flags-dir <value>] [--api-version <value>] [-w
<value> | -a] [--verbose] (--line-ending CRLF|LF -f <value>) [--column-delimiter
BACKQUOTE|CARET|COMMA|PIPE|SEMICOLON|TAB]
FLAGS
-a, --async Run the command asynchronously.
-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) Username or alias of the target org. Not required if the `target-org`
configuration variable is already set.
-s, --sobject=<value> (required) API name of the Salesforce object, either standard or custom, that you want to
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
--verbose Print verbose output of failed records if result is available.
-a, --async Run the command asynchronously.
-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) Username or alias of the target org. Not required if the `target-org`
configuration variable is already set.
-s, --sobject=<value> (required) API name of the Salesforce object, either standard or custom, that you
want to 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
--column-delimiter=<option> Column delimiter used in the CSV file.
<options: BACKQUOTE|CARET|COMMA|PIPE|SEMICOLON|TAB>
--line-ending=<option> Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and
Linux it's `LF`.
<options: CRLF|LF>
--verbose Print verbose output of failed records if result is available.
GLOBAL FLAGS
--flags-dir=<value> Import flag values from a directory.
Expand Down Expand Up @@ -1203,7 +1211,7 @@ EXAMPLES
my-scratch
```

_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.11.6/src/commands/data/upsert/bulk.ts)_
_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/upsert/bulk.ts)_

## `sf data upsert resume`

Expand All @@ -1220,7 +1228,7 @@ FLAGS
variable is already set.
--api-version=<value> Override the api version used for api requests made by this command
--use-most-recent Use the ID of the most recently-run bulk job.
--wait=<value> [default: 0 minutes] Number of minutes to wait for the command to complete before
--wait=<value> [default: 5 minutes] Number of minutes to wait for the command to complete before
displaying the results.
GLOBAL FLAGS
Expand All @@ -1242,7 +1250,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/3.11.6/src/commands/data/upsert/resume.ts)_
_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/data/upsert/resume.ts)_

## `sf force data bulk delete`

Expand Down Expand Up @@ -1289,7 +1297,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/3.11.6/src/commands/force/data/bulk/delete.ts)_
_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/force/data/bulk/delete.ts)_

## `sf force data bulk status`

Expand Down Expand Up @@ -1326,7 +1334,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/3.11.6/src/commands/force/data/bulk/status.ts)_
_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/force/data/bulk/status.ts)_

## `sf force data bulk upsert`

Expand Down Expand Up @@ -1384,6 +1392,6 @@ EXAMPLES
--target-org my-scratch
```

_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.11.6/src/commands/force/data/bulk/upsert.ts)_
_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.0/src/commands/force/data/bulk/upsert.ts)_

<!-- commandsstop -->
3 changes: 1 addition & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@salesforce/plugin-data",
"version": "3.11.6",
"version": "3.12.0",
"description": "Plugin for salesforce data commands",
"author": "Salesforce",
"homepage": "https://github.com/salesforcecli/plugin-data",
Expand Down Expand Up @@ -119,7 +119,6 @@
},
"dependencies": {
"@jsforce/jsforce-node": "^3.6.3",
"@oclif/multi-stage-output": "^0.7.5",
"@oclif/multi-stage-output": "^0.7.12",
"@salesforce/core": "^8.6.1",
"@salesforce/kit": "^3.2.2",
Expand Down

0 comments on commit 93d7252

Please sign in to comment.