4.1.1

Getting Started

This is the pre-release GoodData developer documentation. The contents of this documentation are under constant construction and the subject to change. Before you proceed, please read the legal information first. With any question, contact your GoodData Account Manager.

About the GoodData UI SDK

The GoodData UI SDK is a library that provides all the building blocks you need to create a smart business application powered by GoodData.

With the GoodData UI SDK, you can:

Supported Technologies

The GoodData UI SDK is built using Node.js, React 15.3.2, and TypeScript.

The GoodData UI SDK is tested against and supports the following:

The GoodData UI SDK may work with other platforms and operating systems but has not been thoroughly tested yet and may not provide all functionalities.

Prerequisites

To integrate the GoodData UI SDK in your application, you must meet the following requirements:

  • Be familiar with the modern JavaScript ecosystem.
  • Have node.js and yarn installed in your development environment. If you do not have these tools installed, you can get them from https://nodejs.org/ (install first) and https://yarnpkg.com/ respectively.
  • Have previous experience with the GoodData platform and being familiar with its main concepts. For more information, see the GoodData online help.
  • Have an account on the GoodData platform. If you do not have a GoodData account yet, create a trial one.

Examples in this documentation use data from the GoodSales demo project that is available for trial GoodData accounts.

Installation

yarn add @gooddata/react-components

Preventing Cross-origin Issues

Your application will need to call the GoodData APIs from https://secure.gooddata.com/gdc/. Modern browsers do not permit this because of the security measure known as the same-origin-policy.

Choose either of the following options to bypass this restriction:

Before You Start Using the GoodData UI SDK

Before you start building your application using the GoodData UI SDK, complete the following tasks:

Familiarize yourself with the main terms used in the GoodData UI SDK

  • visualization is a view into a specific part of your data defined by AFM, resultSpec and a configuration object, usually in a form of a table or graph.
  • AFM (Attribute - Filter - Measure) is unified input for creating a visualization using the GoodData UI SDK. AFM describes what data you want to execute: what to measure by measure - how to slice by attribute - how to filter out by filter.
  • attribute is a descriptor used to break apart measures and provide context to report data. Attributes dictate how measures are calculated and represented.
  • filter is a set of characteristics applied to a visualization or measure to remove values from computed and displayed values.
  • measure is aggregation of facts or counts of distinct attribute values, which are represented as numbers in reports. Measures represent what is being measured in a report; for example, sum of sales or average salary.
  • resultSpec is an object that defines the structure of result data. For example, you can define a custom title and format for each measure, or sorting of data.

For more details on the terminology, see Glossary.

Get your project ID

You will need your project ID for the most components to work.

To get your project ID, see Find the Project ID.

Examples in this documentation use data from the GoodSales demo project with an ID of la84vcyhrq8jwbu4wpipw66q2sqeb923.

Get resource identifiers

To display visualizations, filters, and other resources, get their identifiers either via the gray pages (see Accessing Gray Pages for a Project) or using gdc-catalog-export.

Next Steps

Now, you can start building your application.

We have a number of tutorials to help you start your development:

Create Your First Application from Scratch →