This quickstart is specifically meant for developers. It will take you through the basic steps required to install the Visualizations SDK. You should have gone through the Quickstart for Developers and Authentication pages before proceeding with this quickstart.
This QuickStart is specifically using the Sandbox environments.
We've built a set of quickstart and example outputs to get you to incorporate the Railz Visualizations into your application fast and with ease. Start by cloning the quickstart examples and running the Railz Visualizations on your local machine. If you don't need an example, you can skip to installing Railz Visualization SDK in React and Angular. You'll need API keys, which you can get by signing up for an account through our Dashboard.
Once you have your API keys (
secret_key), you'll need to:
- Clone Railz Visualizations GitHub repository.
- Update your environment configuration with the Railz API keys.
- Build and run your application to display your first chart.
# clone the repository git clone https://github.com/railz-ai/railz-visualizations.git cd examples/nodejs
This step is important to ensure you are able to authenticate and generate an access token. See details about Authentication here.
.env.example file to
.env, then fill out
# Copy the .env.example file to .env, then fill # out RAILZ_AUTH_URL, RAILZ_CLIENT_ID and RAILZ_CLIENT_SECRET in .env cp .env.example .env
Install dependencies and start the example backend app. Your backend server will be running at http://localhost:4000.
# install dependencies yarn install # Start the backend app yarn start # Server should run at http://localhost:4000
We currently have examples in Angular and React which you can choose from:
- Your Angular frontend server will be running at http://localhost:4200.
- Your React frontend server will be running at http://localhost:3000.
# navigate to folder cd examples/angular # install dependencies yarn install # start the frontend app yarn start # Server should run at http://localhost:4200
# navigate to folder cd examples/react-example # install dependencies yarn install # start the frontend app yarn start # Server should run at http://localhost:3000
You may now display your first chart after starting the examples. To display a chart, you'll need access to your current business names, which should be available in the Railz Dashboard or via the GET /businesses API endpoint.
After launching the quickstart app on
localhost, you'll need to:
- Provide your local backend server URL in the Authentication section of the Basic page's input field. To get an access token, use the 'https://localhost:4000/authenticate' path and then click Authenticate.
- In the Filters section, input a Business Name from your sandbox environment, choose sandbox as the Service Provider, Balance Sheet as the Report Type, and a Start and End Date with a Monthly Report Frequency, then click Submit.
- The loading indicator should appear at this stage, followed by the balance sheets chart. You can experiment with the other filter choices and the other pages for customizations and reusable components.
The all option in the Report Type field is not an acceptable parameter by the SDK.
The Railz Visualizations SDK requires both a server and a client-side component. As described in the quickstart installation above, you will need to:
- Use our /getAccess API endpoint to obtain an access token.
- Display the Railz visualizations component together with your filters and the access token.
Updated 13 days ago
Learn to install the Railz Visualizations SDK in React and Angular.