PS Dev Helpers

Powershell scripts to improve quality of life for AL developers

Quickstart

Create profile

You need to run this only once.

1. Open Powershell
2. Run $profile. This will create a Powershell profile file.

Add script to profile

1. Open Powershell and run code $profile
2. Include scripts like this: . .\<path to repo>\CloneRepo.ps1.
3. Check the documentation below to see if you need to make additional changes.
4. Restart Powershell to reload the profile

Scripts

FindALObjectIdRanges.ps1 (v0.1)

This scripts collects the IDs of the AL objects in the app, divides it into ranges and outputs a JSON-snippet that can be copied to the app.json key idRanges.

Usage: run GetRanges from a /app or /test directory. Then copy the JSON-snippet to the app.json

RenameSourceFiles

1. Open Powershell in the /app or /test folder.
2. Create a new-names.csv file in the current directory. It should contain two columns: old (current file name) and new (desired file name).
3. Run renamefiles to rename the files.

CloneRepo

This scripts automates the creation of a local dev environment, based on the ticket no you're going to work on.

Configuration: dev root folder

This scripts needs to know where to clone the repo's. Follow these steps to add the required parameter to your PS profile.

1. Run command 'code `$profile'
2. Add this line to the top of the file: $global:DEV_ROOT = 'C:\dev\...'; Replace the path with the full path to the root directory of your AL projects
3. Restart Powershell/Terminal.

Configuration: devops token

This script retrieves the repo's from the 4PS_NL project in DevOps.

1. In Azure DevOps, go to User Settings > Personal Access Tokens > New Token.
2. Name: choose something
3. Expiration: set to end of this year
4. Scopes: choose Custom defined. Then choose Read under section Code
5. Click Create and copy token.
6. In Windows, go to Credential Manager > Windows Credentials > Add a generic credential
7. Internet or network address: devops
8. Username: devops
9. Password: the pat

Usage: run cr from anywhere to start this process