Skip to content

Commit 366694b

Browse files
dawson-david-salesforcedawson-david-salesforce
authored
Merge pull request #983 from salesforcecli/t/packaging-distribution/W-18782182/Package-Bundle-Version-Create-command
feat: created bundle version create
2 parents 0617b51 + 87b5502 commit 366694b

16 files changed

Lines changed: 1262 additions & 17 deletions

‎command-snapshot.json‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,50 @@
7171
"flags": ["api-version", "flags-dir", "json", "loglevel", "target-dev-hub", "verbose"],
7272
"plugin": "@salesforce/plugin-packaging"
7373
},
74+
{
75+
"alias": ["force:package:bundle:version:create"],
76+
"command": "package:bundle:version:create",
77+
"flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
78+
"flagChars": ["b", "p", "v", "w"],
79+
"flags": [
80+
"api-version",
81+
"bundle",
82+
"definition-file",
83+
"flags-dir",
84+
"json",
85+
"loglevel",
86+
"target-dev-hub",
87+
"verbose",
88+
"wait"
89+
],
90+
"plugin": "@salesforce/plugin-packaging"
91+
},
92+
{
93+
"alias": ["force:package:bundle:version:create:list"],
94+
"command": "package:bundle:version:create:list",
95+
"flagAliases": ["apiversion", "createdlastdays", "target-hub-org", "targetdevhubusername"],
96+
"flagChars": ["c", "s", "v"],
97+
"flags": [
98+
"api-version",
99+
"created-last-days",
100+
"flags-dir",
101+
"json",
102+
"loglevel",
103+
"show-conversions-only",
104+
"status",
105+
"target-dev-hub",
106+
"verbose"
107+
],
108+
"plugin": "@salesforce/plugin-packaging"
109+
},
110+
{
111+
"alias": ["force:package:bundle:version:create:report"],
112+
"command": "package:bundle:version:create:report",
113+
"flagAliases": ["apiversion", "packagecreaterequestid", "target-hub-org", "targetdevhubusername"],
114+
"flagChars": ["i", "v"],
115+
"flags": ["api-version", "flags-dir", "json", "loglevel", "package-create-request-id", "target-dev-hub"],
116+
"plugin": "@salesforce/plugin-packaging"
117+
},
74118
{
75119
"alias": ["force:package:convert"],
76120
"command": "package:convert",

‎messages/bundle_create.md‎

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ A bundle can be listed on AppExchange, installed, or upgraded as a single artifa
1111

1212
Create a package bundle in the Dev Hub org; uses the Dev Hub org with the username devhub@example.com:
1313

14-
sf package bundle create --name “Your bundle name” --description "Your bundle description" --target-dev-hub devhub@example.com
14+
sf package bundle create --name "Your bundle name" --description "Your bundle description" --target-dev-hub devhub@example.com
1515

1616
# flags.name.summary
1717

@@ -20,3 +20,23 @@ Name of the package bundle.
2020
# flags.description.summary
2121

2222
Description of the package bundle.
23+
24+
# flags.wait.summary
25+
26+
Number of minutes to wait for the bundle creation to complete.
27+
28+
# flags.verbose.summary
29+
30+
Display extended bundle creation detail.
31+
32+
# requestInProgress
33+
34+
Creating bundle.
35+
36+
# bundleCreateWaitingStatus
37+
38+
%d minutes remaining until timeout. Create bundle status: %s
39+
40+
# bundleCreateFinalStatus
41+
42+
Create bundle status: %s

‎messages/bundle_version_create.md‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# summary
2+
3+
Create a new package bundle version.
4+
5+
# description
6+
7+
Create a new version of a package bundle with the specified components.
8+
9+
# examples
10+
11+
Create a new version of a package bundle:
12+
13+
sf package bundle version create -b MyBundle -p path/to/definition.json
14+
15+
# flags.bundle.summary
16+
17+
The name or ID of the package bundle to create a version for.
18+
19+
# flags.definition-file.summary
20+
21+
Path to the JSON file containing the list of components to include in the bundle version.
22+
23+
# flags.wait.summary
24+
25+
Number of minutes to wait for the command to complete before timing out.
26+
27+
# flags.verbose.summary
28+
29+
Show verbose output of the command execution.
30+
31+
# flags.verbose.description
32+
33+
Show detailed information about the bundle version creation process.
34+
35+
# bundleVersionCreateWaitingStatus
36+
37+
Waiting for bundle version creation to complete. %s minutes remaining. Current status: %s
38+
39+
# bundleVersionCreateFinalStatus
40+
41+
Package Bundle version creation completed with status: %s
42+
43+
# multipleErrors
44+
45+
The following errors occurred during bundle version creation:%s
46+
47+
# InProgress
48+
49+
Bundle version creation is %s. Use 'sf package bundle version create report -i %s' to check the status later.
50+
51+
# requestInProgress
52+
53+
Creating bundle version...
54+
55+
# packageVersionCreateFinalStatus
56+
57+
Package Bundle version creation completed with status: %s
58+
59+
# packageVersionCreatePerformingValidations
60+
61+
Performing validations on the package bundle version...
62+
63+
# bundleVersionCreateSuccess
64+
65+
Successfully created bundle version for bundle %s

‎messages/bundle_version_create_list.md‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# summary
2+
3+
List package version creation requests.
4+
5+
# description
6+
7+
Shows the details of each request to create a package bundle version in the Dev Hub org.
8+
9+
All filter parameters are applied using the AND logical operator (not OR).
10+
11+
To get information about a specific request, run "<%= config.bin %> package bundle version create report" and supply the request ID.
12+
13+
# flags.status.summary
14+
15+
Status of the version creation request, used to filter the list.
16+
17+
# flags.show-conversions-only.summary
18+
19+
Filter the list output to display only converted package bundle version.
20+
21+
# flags.verbose.summary
22+
23+
Displays additional information at a slight performance cost, such as the version name and number for each package version create request.
24+
25+
# flags.created-last-days.summary
26+
27+
Number of days since the request was created, starting at 00:00:00 of first day to now. Use 0 for today.
28+
29+
# examples
30+
31+
- List all package bundle version creation requests in your default Dev Hub org:
32+
33+
<%= config.bin %> <%= command.id %>
34+
35+
- List package bundle version creation requests from the last 3 days in the Dev Hub org with username devhub@example.com:
36+
37+
<%= config.bin %> <%= command.id %> --created-last-days 3 --target-dev-hub
38+
39+
- List package bundle version creation requests with status Error:
40+
41+
<%= config.bin %> <%= command.id %> --status Error
42+
43+
- List package bundle version creation requests with status Queued:
44+
45+
<%= config.bin %> <%= command.id %> --status Queued
46+
47+
- List package bundle version creation requests with status Success that were created today:
48+
49+
<%= config.bin %> <%= command.id %> --created-last-days 0 --status Success
50+
51+
# id
52+
53+
ID
54+
55+
# status
56+
57+
Status
58+
59+
# package-id
60+
61+
Package Bundle Id
62+
63+
# packageVersionId
64+
65+
Package Bundle Version Id
66+
67+
# createdBy
68+
69+
Created By
70+
71+
# convertedFromVersionId
72+
73+
Converted From Version Id

‎messages/bundle_version_create_report.md‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# summary
2+
3+
Report on the status of a package bundle version creation request.
4+
5+
# description
6+
7+
Use this command to check the status of a package bundle version creation request. The command returns information about the request, including its current status and details about the package bundle version being created.
8+
9+
# examples
10+
11+
- Report on a package bundle version creation request:
12+
13+
<%= config.bin %> <%= command.id %> --package-create-request-id 0Ho0x0000000000000
14+
15+
- Report on a package bundle version creation request using an alias:
16+
17+
<%= config.bin %> force:package:bundle:version:create:report -i 0Ho0x0000000000000
18+
19+
# flags.package-create-request-id.summary
20+
21+
The ID of the package bundle version creation request to report on.
22+
23+
# id
24+
25+
ID
26+
27+
# status
28+
29+
Status
30+
31+
# package-bundle-id
32+
33+
Package Bundle ID
34+
35+
# package-bundle-version-id
36+
37+
Package Bundle Version ID
38+
39+
# version-name
40+
41+
Version Name
42+
43+
# created-date
44+
45+
Created Date
46+
47+
# created-by
48+
49+
Created By

‎schemas/package-bundle-create.json‎

Lines changed: 0 additions & 16 deletions
This file was deleted.

‎schemas/package-bundle-version-create-list.json‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
{
2+
"$schema": "http://json-schema.org/draft-07/schema#",
3+
"$ref": "#/definitions/PackageBundleVersionCreateRequestResults",
4+
"definitions": {
5+
"PackageBundleVersionCreateRequestResults": {
6+
"type": "array",
7+
"items": {
8+
"$ref": "#/definitions/BundleSObjects.PackageBundleVersionCreateRequestResult"
9+
}
10+
},
11+
"BundleSObjects.PackageBundleVersionCreateRequestResult": {
12+
"type": "object",
13+
"additionalProperties": false,
14+
"properties": {
15+
"Id": {
16+
"type": "string"
17+
},
18+
"PackageBundleVersionId": {
19+
"type": "string"
20+
},
21+
"RequestStatus": {
22+
"$ref": "#/definitions/BundleSObjects.PkgBundleVersionCreateReqStatus"
23+
},
24+
"CreatedDate": {
25+
"type": "string"
26+
},
27+
"CreatedById": {
28+
"type": "string"
29+
},
30+
"Error": {
31+
"type": "array",
32+
"items": {
33+
"type": "string"
34+
}
35+
},
36+
"PackageBundleId": {
37+
"type": "string"
38+
},
39+
"VersionName": {
40+
"type": "string"
41+
},
42+
"MajorVersion": {
43+
"type": "string"
44+
},
45+
"MinorVersion": {
46+
"type": "string"
47+
},
48+
"BundleVersionComponents": {
49+
"type": "string"
50+
},
51+
"Ancestor": {
52+
"type": ["string", "null"]
53+
}
54+
},
55+
"required": [
56+
"BundleVersionComponents",
57+
"CreatedById",
58+
"CreatedDate",
59+
"Id",
60+
"MajorVersion",
61+
"MinorVersion",
62+
"PackageBundleId",
63+
"PackageBundleVersionId",
64+
"RequestStatus",
65+
"VersionName"
66+
]
67+
},
68+
"BundleSObjects.PkgBundleVersionCreateReqStatus": {
69+
"type": "string",
70+
"enum": ["Queued", "Success", "Error"]
71+
}
72+
}
73+
}

0 commit comments

Comments
 (0)