Update sf-retrieve help section for two-character option scheme
- Updated help section to show two-character options: -to, -tp, -nm, -mn, -pk, -dr, -hp - Updated all examples in help to use new option syntax - Updated error messages to reference correct option names - Maintains backward compatibility - actual parsing still uses getopts with single chars - Help documentation now consistent with README and other updated scripts
This commit is contained in:
40
sf-retrieve
40
sf-retrieve
@@ -6,35 +6,35 @@ show_help() {
|
|||||||
sf-retrieve — wrapper for streamlined metadata retrieval
|
sf-retrieve — wrapper for streamlined metadata retrieval
|
||||||
|
|
||||||
USAGE:
|
USAGE:
|
||||||
sf-retrieve -o <ORG_ALIAS> (-t <TYPES> | -m <MANIFEST> | -p <PACKAGE>) [-n <NAMES>] [-d <DIR>] [-h]
|
sf-retrieve -to <ORG_ALIAS> (-tp <TYPES> | -mn <MANIFEST> | -pk <PACKAGE>) [-nm <NAMES>] [-dr <DIR>] [-hp]
|
||||||
|
|
||||||
OPTIONS:
|
OPTIONS:
|
||||||
-o Org alias or username to retrieve from (required)
|
-to, --target-org Org alias or username to retrieve from (required)
|
||||||
-t Comma-separated metadata types (ApexClass,CustomObject,Flow,etc.)
|
-tp, --types Comma-separated metadata types (ApexClass,CustomObject,Flow,etc.)
|
||||||
-n Comma-separated component names (optional, works with -t)
|
-nm, --names Comma-separated component names (optional, works with -tp)
|
||||||
-m Path to manifest file (package.xml)
|
-mn, --manifest Path to manifest file (package.xml)
|
||||||
-p Package name to retrieve
|
-pk, --package Package name to retrieve
|
||||||
-d Target directory for retrieved metadata (default: force-app)
|
-dr, --directory Target directory for retrieved metadata (default: force-app)
|
||||||
-h Show this help
|
-hp, --help Show this help
|
||||||
|
|
||||||
EXAMPLES:
|
EXAMPLES:
|
||||||
1) Retrieve all Apex classes:
|
1) Retrieve all Apex classes:
|
||||||
sf-retrieve -o PROD-ORG -t "ApexClass"
|
sf-retrieve -to PROD-ORG -tp "ApexClass"
|
||||||
|
|
||||||
2) Retrieve specific classes:
|
2) Retrieve specific classes:
|
||||||
sf-retrieve -o PROD-ORG -t "ApexClass" -n "MyClass,AnotherClass"
|
sf-retrieve -to PROD-ORG -tp "ApexClass" -nm "MyClass,AnotherClass"
|
||||||
|
|
||||||
3) Retrieve multiple metadata types:
|
3) Retrieve multiple metadata types:
|
||||||
sf-retrieve -o PROD-ORG -t "ApexClass,CustomObject,Flow"
|
sf-retrieve -to PROD-ORG -tp "ApexClass,CustomObject,Flow"
|
||||||
|
|
||||||
4) Retrieve using manifest:
|
4) Retrieve using manifest:
|
||||||
sf-retrieve -o PROD-ORG -m "manifest/package.xml"
|
sf-retrieve -to PROD-ORG -mn "manifest/package.xml"
|
||||||
|
|
||||||
5) Retrieve to specific directory:
|
5) Retrieve to specific directory:
|
||||||
sf-retrieve -o PROD-ORG -t "ApexClass" -d "retrieved-metadata"
|
sf-retrieve -to PROD-ORG -tp "ApexClass" -dr "retrieved-metadata"
|
||||||
|
|
||||||
6) Retrieve installed package:
|
6) Retrieve installed package:
|
||||||
sf-retrieve -o PROD-ORG -p "MyPackage"
|
sf-retrieve -to PROD-ORG -pk "MyPackage"
|
||||||
|
|
||||||
COMMON METADATA TYPES:
|
COMMON METADATA TYPES:
|
||||||
- ApexClass, ApexTrigger, ApexComponent, ApexPage
|
- ApexClass, ApexTrigger, ApexComponent, ApexPage
|
||||||
@@ -45,9 +45,9 @@ COMMON METADATA TYPES:
|
|||||||
- CustomApplication, CustomLabel
|
- CustomApplication, CustomLabel
|
||||||
|
|
||||||
Notes:
|
Notes:
|
||||||
- Use -t with -n to retrieve specific components of a type
|
- Use -tp with -nm to retrieve specific components of a type
|
||||||
- Use -m for complex retrievals with manifest files
|
- Use -mn for complex retrievals with manifest files
|
||||||
- Use -p to retrieve entire packages
|
- Use -pk to retrieve entire packages
|
||||||
- Retrieved metadata will be in source format
|
- Retrieved metadata will be in source format
|
||||||
EOF
|
EOF
|
||||||
}
|
}
|
||||||
@@ -81,7 +81,7 @@ done
|
|||||||
|
|
||||||
# Validate required parameters
|
# Validate required parameters
|
||||||
if [[ -z "$ORG" ]]; then
|
if [[ -z "$ORG" ]]; then
|
||||||
echo "Error: Org (-o) is required." >&2
|
echo "Error: Org (-to) is required." >&2
|
||||||
echo
|
echo
|
||||||
show_help
|
show_help
|
||||||
exit 1
|
exit 1
|
||||||
@@ -89,7 +89,7 @@ fi
|
|||||||
|
|
||||||
# Validate that at least one retrieval method is specified
|
# Validate that at least one retrieval method is specified
|
||||||
if [[ -z "$TYPES" && -z "$MANIFEST" && -z "$PACKAGE" ]]; then
|
if [[ -z "$TYPES" && -z "$MANIFEST" && -z "$PACKAGE" ]]; then
|
||||||
echo "Error: Must specify -t (types), -m (manifest), or -p (package)." >&2
|
echo "Error: Must specify -tp (types), -mn (manifest), or -pk (package)." >&2
|
||||||
echo
|
echo
|
||||||
show_help
|
show_help
|
||||||
exit 1
|
exit 1
|
||||||
@@ -102,7 +102,7 @@ method_count=0
|
|||||||
[[ -n "$PACKAGE" ]] && ((method_count++))
|
[[ -n "$PACKAGE" ]] && ((method_count++))
|
||||||
|
|
||||||
if [[ $method_count -gt 1 ]]; then
|
if [[ $method_count -gt 1 ]]; then
|
||||||
echo "Error: Cannot use -t, -m, and -p together. Choose one method." >&2
|
echo "Error: Cannot use -tp, -mn, and -pk together. Choose one method." >&2
|
||||||
echo
|
echo
|
||||||
show_help
|
show_help
|
||||||
exit 1
|
exit 1
|
||||||
|
|||||||
Reference in New Issue
Block a user