https://github.com/bsorrentino/zx-powerapps-cli
zx scripts for interactive use of powerapps cli (PAC).
https://github.com/bsorrentino/zx-powerapps-cli
cli nodejs powerapps typescript zx
Last synced: 3 months ago
JSON representation
zx scripts for interactive use of powerapps cli (PAC).
- Host: GitHub
- URL: https://github.com/bsorrentino/zx-powerapps-cli
- Owner: bsorrentino
- License: mit
- Created: 2022-02-24T15:56:41.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-23T12:18:47.000Z (over 1 year ago)
- Last Synced: 2025-06-03T10:01:42.404Z (4 months ago)
- Topics: cli, nodejs, powerapps, typescript, zx
- Language: JavaScript
- Homepage:
- Size: 373 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/@bsorrentino/zx-powerapps-cli)
# 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 ] [--flow ] [--uuid ]
```
##### Interactive arguments :
1. **Local solution's folder** (could provide it on command line using: `--solution` ).
1. **Flow json file name** in the form `-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.json` present in `/Worlflows` (could provide it on command line using: `--flow` )
##### Non-Interactive arguments :
1. **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 ]
[--solution ]
[--keepzip]
[--unpackonly]
```
##### Interactive arguments :
if `--unpackonly` is not specified
1. **Authentication profile's index** (could provide it on command line using: `--authindex` ).
1. **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
1. **Publish customization**
1. **Create settings**
> the file generated will be `_settings/_settings.json`
if `--unpackonly` is specified
1. **solution zip file** (could provide it on command line using: `--zipfile` ).
1. **Package type** that you've to export `Managed, Unmanaged, Both` (could provide it on command line using: `--package` ).
1. **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 ]
[--solution ]
[--package Managed|Unmanaged|Both]
[--packonly]
[--noversion]
[--publish-changes]
```
##### Interactive arguments :
if `--packonly` is not specified
1. **Authentication profile's index** (could provide it on command line using: `--authindex` ).
1. **Local solution's folder** (could provide it on command line using: `--solution` ).
1. **Use settings file**
> This will be asked only if the settings file `_settings/_settings.json` exists
if `--packonly` is specified
1. **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 ] [--solution ]
```
Such command interactively ask for :
1. Local solution's folder (if not provided on command line)
1. Version bump strategy **increment build version** / **increment revision version**
1. Authentication profile's index (if not provided on command line).
1. 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 ]
```
Such command interactively ask for :
1. Solution's folder (if not provided on command line)
## Reference
* [Powerapps CLI](https://docs.microsoft.com/en-us/power-apps/developer/data-platform/powerapps-cli#common-commands)
* [Generating Solution Settings File via the Microsoft Power Platform CLI](https://crmchap.co.uk/generating-solution-settings-file-via-the-microsoft-power-platform-cli/)
* [Copy/Duplicate a Flow in a Solution]
[Powerapps CLI]: https://docs.microsoft.com/en-us/power-apps/developer/data-platform/powerapps-cli#common-commands
[ZX]: https://www.npmjs.com/package/zx
[Powerapps CLI (pac)]: https://docs.microsoft.com/en-us/powerapps/developer/data-platform/powerapps-cli
[Copy/Duplicate a Flow in a Solution]: https://powerusers.microsoft.com/t5/Building-Flows/Copy-Duplicate-a-Flow-in-a-Solution/td-p/487483