zx-powerapps-cli
ZX scripts to simplify interactive Powerapps CLI (PAC
) usage
Getting started
npm install @bsorrentino/zx-powerapps-cli --save-dev
Scripts
zx-clone-flow
Clone a flow whitin an exported solution on local file system.
This script doesn't require connection to dataverse environment
Usage
npx zx-clone-flow [--solution <solution folder>] [--flow <flow json file name>] [--uuid <new flow uuid>]
Interactive arguments :
-
Local solution's folder (could provide it on command line using:
--solution
). -
Flow json file name in the form
<Prefix>-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.json
present in<solution path>/Worlflows
(could provide it on command line using:--flow
)
Non-Interactive arguments :
-
New Flow UUID in the form
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
, if not provided a new one will be automatically generated
zx-export-solution
Export solution from powerapps a environment unpacking and saving it on local file system.
Solution is exported in both Managed and Unmanged package type
Usage
npx zx-export-solution [--authindex <n>]
[--solution <solution name>]
[--keepzip]
[--unpackonly]
Interactive arguments :
if --unpackonly
is not specified
-
Authentication profile's index (could provide it on command line using:
--authindex
). -
Solution's name that you've to export (could provide it on command line using:
--solution
).Take note that available solutions will be displayed before
- Publish customization
-
Create settings
the file generated will be
<solution>_settings/<auth profile>_settings.json
if --unpackonly
is specified
-
solution zip file (could provide it on command line using:
--zipfile
). -
Package type that you've to export
Managed, Unmanaged, Both
(could provide it on command line using:--package
). -
Local solution's folder (could provide it on command line using:
--solution
).
Non-Interactive arguments :
-
--keepzip
: keeps original exported packages zip -
--unpackonly
: perform only solution unpacking and skips export
zx-import-solution
Pack solution from local file system and import it in a powerapps environment
Usage
npx zx-import-solution [--authindex <n>]
[--solution <solution folder>]
[--package Managed|Unmanaged|Both]
[--packonly]
[--noversion]
[--publish-changes]
Interactive arguments :
if --packonly
is not specified
-
Authentication profile's index (could provide it on command line using:
--authindex
). -
Local solution's folder (could provide it on command line using:
--solution
). -
Use settings file
This will be asked only if the settings file
<solution>_settings/<auth profile>_settings.json
exists
if --packonly
is specified
-
Local solution's folder (could provide it on command line using:
--solution
).
Non-Interactive arguments :
-
--packonly
: perform only packing and skips import -
--noversion
: remove version from generated zip -
----publish-changes
: publish your changes upon a successful import
zx-version-bump
Update local and remote solution's version
Usage
npx zx-version-bump [--authindex <n>] [--solution <solution folder>]
Such command interactively ask for :
- Local solution's folder (if not provided on command line)
- Version bump strategy increment build version / increment revision version
- Authentication profile's index (if not provided on command line).
- Update online version with the same version of the local one
zx-unpack-msapps
Unpack canvas app bundles (.msapp) contained in an exported solution
Usage
npx zx-unpack-msapps [--solution <solution folder>]
Such command interactively ask for :
- Solution's folder (if not provided on command line)