Project references（项目引用 (Project references)）

In Foundry, Projects define a conceptual boundary around related work as well as a security boundary for applying and managing access. Using data across project boundaries must be treated with extra care.

Referencing a resource

Project references provide a mechanism for users with higher permissions - typically the owners of a dataset or pipeline - to allow the discovery and use of data in pipelines in other projects. Project references add an increased layer of scrutiny for moving persistently data between projects by explicitly acknowledging when a dataset is imported into a project.

To reference a resource, go to the Project navigation panel at the root level of the project. Click the +Add button to add a reference to a dataset. In the below image, the datasets flights and training_data are added as references in the project. This means that you can use flights and training_data as inputs to a saved dataset in a Contour analysis.

• To reference a resource, you must have compass:import-resource-from on the resource (usually expanded from the Viewer role) and compass:import-resource-to on the destination project (usually expanded from the Editor role).
• These roles can be customized using Custom Roles.

Project-scoped analyses

In order to save a dataset at the end of your path in a project-scoped analysis, all inputs and outputs must be in project scope.

• All input datasets to the path must be in project scope: they must be in the same project as the workbook, or added as a reference in the project.
• The output dataset must be in the same project as the analysis.

See the project scope settings for an analysis in the Settings tab of the sidebar. Any input or output datasets that are out of scope will be listed in the project scoping dialog. You may choose to add a reference directly from the dialog.

There is also a callout in the Result board when an input dataset is out of scope. Clicking Add references will open the project scoping dialog.

:::callout{theme="neutral"} There is no need to add a reference to use an input dataset in a Contour analysis unless you are saving a resulting dataset. :::

Enabling project scoping on your analysis

For analyses created prior to project scoping being enabled by default, you can enable project scoping in the Settings sidebar panel. Before you can enable project scoping, you must address any out-of-scope inputs by adding a reference to inputs and any out-of-scope outputs by moving the output to the project for the analysis.

---

中文翻译

---

项目引用 (Project references)

在 Foundry 中，项目 (Projects) 定义了相关工作的概念边界，以及用于应用和管理访问权限的安全边界。跨项目边界使用数据时必须格外谨慎。

引用资源 (Referencing a resource)

项目引用 (Project references) 为具有更高权限的用户（通常是数据集或管道的所有者）提供了一种机制，允许在其他项目的管道中发现和使用数据。项目引用通过明确确认数据集何时被导入到项目中，为在项目之间持久移动数据增加了额外的审查层级。

要引用资源，请转到项目根级别的项目导航面板 (Project navigation panel)。点击 +Add 按钮以添加对数据集的引用。在下图中，数据集 flights 和 training_data 被添加为项目中的引用。这意味着您可以在 Contour 分析中将 flights 和 training_data 用作已保存数据集的输入。

• 要引用资源，您必须对资源拥有 compass:import-resource-from 权限（通常由查看者角色 (Viewer role) 扩展而来），并对目标项目拥有 compass:import-resource-to 权限（通常由编辑者角色 (Editor role) 扩展而来）。
• 这些角色可以使用自定义角色 (Custom Roles) 进行定制。

项目范围分析 (Project-scoped analyses)

为了在项目范围分析的路径末尾保存数据集，所有输入和输出都必须在项目范围内。

• 路径中的所有输入数据集必须在项目范围内：它们必须与分析工作簿位于同一项目中，或者已作为引用添加到项目中。
• 输出数据集必须与分析位于同一项目中。

请参阅侧边栏的"设置 (Settings)"选项卡中分析的"项目范围设置 (Project scope settings)"。任何超出范围的输入或输出数据集都将列在"项目范围设置"对话框中。您可以直接从该对话框中选择添加引用。

当输入数据集超出范围时，"结果 (Result)"面板中也会出现提示信息。点击 添加引用 (Add references) 将打开"项目范围设置"对话框。

:::callout{theme="neutral"} 除非您要保存结果数据集，否则无需添加引用即可在 Contour 分析中使用输入数据集。 :::

在分析中启用项目范围 (Enabling project scoping on your analysis)

对于在默认启用项目范围之前创建的分析，您可以在"设置"侧边栏面板中启用项目范围。在启用项目范围之前，您必须通过为输入添加引用来处理任何超出范围的输入，并通过将输出移动到分析所在项目来处理任何超出范围的输出。