This article is a quick introduction to the new project workspace layout. More general introductory information on data.world can be found in the Getting started guide. If you have been using data.world for awhile and would like information specifically about the changes between the old and new workflows, see our article reviewing the changes.
When you land on a project workspace you can tell what's showing in the main area of the screen by what's highlighted in the Project directory in the left sidebar:
The project workspace has five main parts:
- The left sidebar is the Project directory
- Underneath the header in the center are the tabs and actions for the current object
- Beneath the tabs In the center is the object viewer
- In the right sidebar (when visible) on the top is the About section with information about the currently selected object
- For some objects, the bottom of the right sidebar contains the Project schema
The Project directory is the navigation area of the workspace. At the top is the + Add dropdown which is where you can add files to the project, link datasets to it, add posts or insights, and add new SQL or SPARQL queries.
Below the + Add button are a link to the Home tab, and the main project files (Project summary and Data dictionary). Information about the project summary and the data dictionary can be found in the articles Description and summary, and Data dictionary.
The next section of the Project directory is for project files. Project files are any data resources uploaded or saved directly to the Project--not to a dataset.
Project files cannot be added to other projects or datasets. They are only available in their project. See the article datasets and projects for more information.
Below the project files are connected datasets. The datasets used in this project may also be used in and linked to other projects. When there are changes to the underlying dataset, all projects using the dataset also update. All files and queries associated with a dataset are linked to the project and can be used in it:
More information on how to create a dataset is in the article Creating a dataset.
The last two sections of the project directory, queries and insights, are also specific to the project. The Queries section contains all the stored queries in the project. Learn how to write and use queries in our article Query basics. We also have a SQL tutorial and a SPARQL tutorial to help you learn or improve your query language skills.
Insights are findings, conclusions, or interesting points for discussion about your project. They allow you to capture conclusions from your work, packaging them up in a way that quickly communicates a nugget of information, while giving the viewer the tools they need to dig down into your methods and sources. See Posting insights for details on insights.
Tabs and actions
Whenever you select an object or the + Add button from the Project directory, a new tab opens up under the header bar with a preview of that object. Underneath the tabs are an icon indicating what type of object is shown (the name of the object shown and to the right of the name are any actions that can be taken with that object. and whether it is shared with all users of the project or private only to you. Further to the right is a link to create a new query template, or parameterized query. You can learn more about parameterized queries from the article Using query templates. The last arrow icon is used to either expand or collapse the about and project schema panel. For more information about query-specific actions, see the article Query basics.
The central are of the workspace is devoted to to viewing or interacting with the object selected in the project directory. The viewer renders previews of most file types (for a complete list of files supported by preview see the article Supported file types. When the object is a query, the viewer is split into two parts: the query editor at the top and the query results at the bottom. The query editor is where you compose and run queries against your data. In addition to typing in your text, data.world's query editor also provides auto-complete and auto-format of commands, columns and and tables:
The bottom center of the screen is used to display results of queries or error messages when queries are not written correctly:
In the upper right corner of the project workspace is a pane with the information about the object highlighted in the project directory. It is used for queries and files to give you more information about them that might be relevant for their use:
The project schema shows up at the bottom of the right sidebar whenever the object displayed in the main section is a query. It contains a list of the queryable entities in the project (datasets, tables, and columns). Items can be expanded or collapsed, and selecting either a column or table copies its name to the clipboard for easily pasting into the query editor: