We've made it simple to get started with Flatfile with our new Flatfile Component. Here's what you'll need to know to begin.
In your Angular Module, you'll need to import the
FlatfileAdapterModule from the
Then you will need to use it in the imports section of the module, and then you'll be ready to use it within your application.
Once you have this setup, in your app component file, you will be able to import and access the
FlatfileMethods module for use.
This brings the
FlatfileButton component into your project.
To launch, the
flatfile-button component, you must have a minimum of
licenseKey as properties in your AppComponent.
In your component html code, you will then be able to call the
flatfile-button component like below.
In order to style the
<flatfile-button> from within your parent component, ensure that your parent component has
ViewEncapsulation.None, pass down a class to
<flatfile-button>, and now you will be able to style the
button one-level down.
Here is a list of all the properties that are configurable with the
<flatfile-button> component. Visit out settings guide to learn about each in greater depth.
settings- Required - Pass in an object containing the import
fields. For a list of the other optional settings, check out our options documentation here.
customer- Required - Pass in an object that identifies the customer uploading the file. This refers the the
setCustomer()function on our SDK, and the same object should be passed in here.
licenseKey- Required - In order to access our product, a license key is required. The license key can be found in your dashboard by logging in here.
onCancel- This allows you to pass in a callback function that will run if the user cancels out of the import.
onData- This allows you to return a new Promise to handle the Flatfile results when returned.
onRecordChange- This provides access to Flatfile's record hooks when a record changes.
onRecordInit- This provides access to Flatfile's record hooks when a record initializes.
fieldHooks- This allows you to pass in one or more field hooks as separate callback functions.