The PCF AddressFinder Widget is a PowerApps Component Framework (PCF) control for Dynamics 365 and Common Data Service (CDS) the uses the AddressFinder JavaScript Widget to search for New Zealand addresses.

To get a local copy up and running, follow these steps...

• Node.js
• .NET Framework 4.6.2
• .NET Core 2.2 SDK
• Visual Studio Code
• Microsoft PowerApps CLI
• AddressFinder API key

1. Signup for a free AddressFinder plan and get an API key
2. Clone the repo

git clone https://github.com/ryanmichaeljames/pcf-addressfinder-widget.git

3. Navigate to the src folder

cd src

4. Install the NPM packages.

npm install

The following resources should be of help when contributing:

• Create and build a code component
• Debug code components
• Package a code component

To install and use the AddressFinder Widget control within your Dynamics 365 or CDS instance, follow these steps...

1. Download the latest release.
2. Import the solution AddressFinderWidget_x_x_managed.zip file into your Dynamics 365 or CDS instance.
3. Add the AddressFinder Widget control to the desired entity form.
4. Add your AddressFinder API key to the API Key property. If you don't already have an API key you can register for a free account that gives you 500 free lookups a month.
5. Map the entity's address attributes to the AddressFinder Widget's address properties.

There is a know issue where you cannot map account and contact address attributes to a PCF control's properties. Until this issue is resolved by Microsoft you can use the FormXml Manager plugin in the XrmToolBox to map the address attributes to the AddressFinder Widget control's properties. See Binding to Address Fields in a PCF Control.

The following AddressFinder options are optional.

For more information regarding the AddressFinder options see the options section of the AddressFinder Widget documentation.

By default, the AddressFinder Widget control will return New Zealand addresses, even if the Country Code input property is not set. To return Australian addresses the Country Code property must be set to AU.

There are a few subtle differences in the properties that are populated between New Zealand and Australian addresses. This is due to the AddressFinder API returning different properties in the search responses for each country. As a result, the following output properties are only populated by their respective countries.

See the issues for a list of proposed features (and known issues).

Any contributions are more than welcome. 😄

1. Fork the project
2. Create a feature branch

git checkout -b feature/my-feature

3. Commit your changes

git commit -m 'Added my feature'

4. Push the feature branch to origin

git push origin feature/my-feature

5. Open a pull request

This project uses SemVer for versioning. For the versions available, see tags.

This project is distributed under the MIT License. See LICENSE more information.

• AddressFinder JavaScript Widget
• Best-README-Template