This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/hop-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new a3f5a0f960 Website updated to 2ff35d7
a3f5a0f960 is described below
commit a3f5a0f960edfcb0470720792e6e24b0d6e4b3d9
Author: jenkins <[email protected]>
AuthorDate: Thu Oct 29 12:05:40 2026 +0000
Website updated to 2ff35d7
---
manual/next/hop-run/index.html | 3 +-
manual/next/projects/projects-environments.html | 44 +++++++++++++++++++++++++
manual/next/workflow/actions/workflow.html | 3 ++
3 files changed, 49 insertions(+), 1 deletion(-)
diff --git a/manual/next/hop-run/index.html b/manual/next/hop-run/index.html
index db7aa77c95..dce85e5bc1 100644
--- a/manual/next/hop-run/index.html
+++ b/manual/next/hop-run/index.html
@@ -3074,7 +3074,8 @@ The project name is taken from that environment, so you
do not need <code>-j</co
<td class="tableblock halign-left valign-top"><p
class="tableblock"><code><code>-j</code></code></p></td>
<td class="tableblock halign-left valign-top"><p
class="tableblock"><code><code>--project</code></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name
of the project to use when running a pipeline or workflow.
-Not needed when <code>-e</code> is set.</p></td>
+Ignored when <code>-e</code> is set: the project of that environment is used.
+To use a workflow of another project, see <a
href="../projects/projects-environments.html#_run_a_workflow_from_another_project"
class="xref page">Run a workflow from another project</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock"><code><code>-l</code></code></p></td>
diff --git a/manual/next/projects/projects-environments.html
b/manual/next/projects/projects-environments.html
index 92a2967755..5a7c416744 100644
--- a/manual/next/projects/projects-environments.html
+++ b/manual/next/projects/projects-environments.html
@@ -3711,6 +3711,50 @@ All open files will be restored, including their zoom
level and other UI setting
</ul>
</div>
</div>
+</div>
+<div class="sect1">
+<h2 id="_run_a_workflow_from_another_project"><a class="link"
href="#_run_a_workflow_from_another_project">Run a workflow from another
project</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p><code>hop-run -e</code> takes the project from the environment, and the
variables from the configuration files of that environment.
+When <code>-e</code> is set, <code>-j</code> is ignored.</p>
+</div>
+<div class="paragraph">
+<p>A <a href="../workflow/actions/workflow.html" class="xref
page">Workflow</a> or <a href="../workflow/actions/pipeline.html" class="xref
page">Pipeline</a> action that runs a file from another project runs it in the
project and environment of the calling workflow.
+It does not switch to an environment of the other project, so variables that
are only defined in the configuration files of its environments are not set.</p>
+</div>
+<div class="paragraph">
+<p>To set them, add the configuration file of the other project to the
environment of the calling project.
+In Hop Gui, choose <strong>Edit environment…​</strong> and add the
file on the <strong>Configuration files</strong> tab with
<strong>Select…​</strong>.
+With hop-conf, for example when environment <code>sales-dev</code> of project
<code>sales</code> runs a workflow of project <code>crm</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<div class="code-lang" data-pagefind-ignore>bash</div><pre class="highlightjs
highlight is-highlighted"><code class="language-bash hljs"
data-lang="bash">./hop-conf.sh --environment-modify --environment=sales-dev \
+
--environment-config-files=/data/environments/sales-dev/variables.json,/data/environments/crm-dev/variables.json</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>--environment-config-files</code> replaces the whole list, so keep
the files the environment already has: <code>./hop-conf.sh
--environments-list</code> shows them.
+The files are applied in the order of the list, so when two files set the same
variable, the last one wins.
+To add a file for a single run without changing the environment, pass it to
hop-run with <code>--environment-conf-files</code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+This brings the variables of the other project, not its metadata, such as
database connections and run configurations.
+When the workflow needs those as well, set the other project as <strong>Parent
project to inherit from</strong> on the <strong>Parent project</strong> tab of
the calling project, or run <code>./hop-conf.sh --project-modify
--project=sales --project-parent=crm</code>.
+The calling project then reads the metadata of both projects and the project
variables of the parent, but not the configuration files of the parent’s
environments.
+A project has one parent, and also inherits from the parent’s own parent.
+</td>
+</tr>
+</table>
+</div>
+</div>
</div>
</article>
<nav class="pagination" data-pagefind-ignore aria-label="Page">
diff --git a/manual/next/workflow/actions/workflow.html
b/manual/next/workflow/actions/workflow.html
index a0c0f84016..8085b7ba53 100644
--- a/manual/next/workflow/actions/workflow.html
+++ b/manual/next/workflow/actions/workflow.html
@@ -2984,6 +2984,9 @@
<li>
<p>The <a href="../../pipeline/transforms/pipeline-executor.html" class="xref
page">Pipeline Executor transform</a> that executes a sub-pipeline from a
pipeline.</p>
</li>
+<li>
+<p><a
href="../../projects/projects-environments.html#_run_a_workflow_from_another_project"
class="xref page">Run a workflow from another project</a> for the variables
and metadata that a workflow from another project can use.</p>
+</li>
</ul>
</div>
</div>
