Plugin Naming Policies and Conventions

Plugins are a great way to extend DSS but sometimes it is difficult to tell which of your installed plugins are locally developed. Your installation of DSS comes with built-in plugins, but you can also add new plugins from the Plugin Store (here are the 2 ways to access), develop your own, or upload plugins from other developers. One way to keep all your ducks in a row is to apply a plugin naming convention. In fact, locally-developed plugins must follow the requirements described in this article.

../../../_images/Dataiku_1-1577741986982.png

Another benefit of following a naming convention is being able to identify the locally-developed plugins in your list of installed plugins. In addition, when you share your plugins, your colleagues will be able to understand the purpose of the plugin.

Note

Dataiku does not provide support for your locally-developed plugins. You are responsible for owning and maintaining the plugins you create.

What does this article contain?

This article describes plugin naming policies and recommendations. Naming is an important area of plugin development that is often overlooked. Dataiku DSS requires that plugin names and identifiers meet certain policies.

What are plugins?

A plugin is a package of reusable components that extends the functionality of Dataiku DSS. When you make your own plugin, you are extending DSS. A plugin is made up of one or more components. A component is a GUI wrapper around custom code that exposes a Dataiku element such as a recipe, dataset, or web app.

What are some examples of plugins?

Plugins range from the very simple to the very complex. For example, plugins can be used to create a connector to read or write data to databases or connect to external APIs. Some examples are connecting with Salesforce data, or get weather forecast by location. You can find more plugins in the plugin store. The possibilities are limitless!

Why should I create plugins?

Plugins turn custom logic into components that can be used by anyone, giving less technical users the ability to collaborate and technical users the ability to standardize the way data is processed. Plugins can easily be shared by the community of users in an organization and even shared across organizations. Since most plugins are open source, anyone can view the underlying code and make contributions to it or adapt it.

Where can I find the code for the public plugins?

You can find the code for some but not all of the public plugins in GitHub (link).

../../../_images/Dataiku_2-1577741987036.png

Plugin naming

The plugin summary displays information about the plugin and its components. You can edit the display name and identifier for the plugin in the Edit tab.

../../../_images/Dataiku_3-1577741986997.png

You can also edit the component display name and component identifier in the Edit tab. Adding a description is a good idea because it documents the reason why you created the component and lets others understand its usefulness and purpose.

../../../_images/Dataiku_4-1577741986989.png

Plugin Naming Policies

A naming error happens when the name of the plugin, or any of its components, labels, or tags, does not meet plugin naming policies. Luckily, you can avoid these errors by following the plugin naming policies below. Most of the policies are required while a few are recommended. (Future: These rules are automatically checked by the plugin dev kit.)

../../../_images/pnmpc1.png ../../../_images/pnmpc2.png ../../../_images/pnmpc3.png ../../../_images/pnmpc4.png ../../../_images/pnmpc5.png

Plugin.json description

../../../_images/Dataiku_12-1577741986986.png ../../../_images/code-section.png

How can I get started if I am new to plugins?

If you are new to plugins, you can get started by reading the latest documentation, completing step-by-step tutorials, and by visiting the Plugin store. From Dataiku DSS, you can find the plugins by selecting Plugins from the administration menu:

../../../_images/Dataiku_13-1577741987099.png

Tip

One of the golden rules of plugins is to never use “import dataiku” in a library. With few exceptions, plugins do not depend on Dataiku unless it is an administrative plugin.