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 e3559a13f3 Website updated to 0757d1b
e3559a13f3 is described below
commit e3559a13f38323e5aab2eb85056ef5ce3599a0d5
Author: jenkins <[email protected]>
AuthorDate: Sat Nov 7 15:34:48 2026 +0000
Website updated to 0757d1b
---
manual/next/hop-tools/hop-import.html | 89 +++++++++++++++++++++++++++++------
1 file changed, 75 insertions(+), 14 deletions(-)
diff --git a/manual/next/hop-tools/hop-import.html
b/manual/next/hop-tools/hop-import.html
index ff9326890e..0a48ffd080 100644
--- a/manual/next/hop-tools/hop-import.html
+++ b/manual/next/hop-tools/hop-import.html
@@ -3001,7 +3001,7 @@ See <a
href="../hop-vs-kettle/import-kettle-projects.html" class="xref page">Imp
<h2 id="_usage"><a class="link" href="#_usage">Usage</a></h2>
<div class="sectionbody">
<div class="paragraph">
-<p>Usage help can be obtained by running hop-import with the <code>-h</code>
option, even when other options are specified:</p>
+<p>Run <code>hop import -h</code> to see the options, also when other options
are given. <code>hop-import.sh -h</code> and <code>hop-import.bat -h</code>
show the same list:</p>
</div>
<div class="paragraph">
<p> <br></p>
@@ -3011,15 +3011,19 @@ See <a
href="../hop-vs-kettle/import-kettle-projects.html" class="xref page">Imp
<div class="content">
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">Usage:
<main class> [-efhlp] [-c=<targetConfigFilename>]
[-i=<inputFolderName>]
- [-j=<jdbcPropertiesFilename>]
- [-k=<kettlePropertiesFilename>]
[-o=<outputFolderName>]
- [-s=<sharedXmlFilename>] [-t=<type>]
+<pre class="highlightjs highlight"><code class="language-none hljs">Usage: hop
import [-efhlpv] [--no-apply-naming-schemes]
+ [-c=<targetConfigFilename>]
[-i=<inputFolderName>]
+ [-j=<jdbcPropertiesFilename>]
[-k=<kettlePropertiesFilename>]
+ [-n=<namingSchemeName>] [-o=<outputFolderName>]
+ [-P=<projectName>]
[-r=<defaultPipelineRunConfiguration>]
+ [-s=<sharedXmlFilename>] [-t=<type>]
+ [-w=<defaultWorkflowRunConfiguration>]
+Import metadata
-c, --target-config-file=<targetConfigFilename>
- The target config file to write variables to
+ The target config file to write variable to
-e, --skip-existing Skip existing files in the target folders
-f, --skip-folders Skip import of sub-folders
- -h, --help Displays this help message and quits
+ -h, --help Displays this help message and quits.
-i, --input=<inputFolderName>
The input folder to read from
-j, --jdbc-properties=<jdbcPropertiesFilename>
@@ -3027,19 +3031,31 @@ See <a
href="../hop-vs-kettle/import-kettle-projects.html" class="xref page">Imp
-k, --kettle-properties=<kettlePropertiesFilename>
The kettle.properties file to read from
-l, --list-plugins List the available import plugins
+ -n, --naming-scheme=<namingSchemeName>
+ Naming scheme metadata name in the target folder to
+ apply to relational connections
+ --no-apply-naming-schemes
+ Do not apply a naming scheme; connection names are
+ still aligned to one spelling
-o, --output=<outputFolderName>
The output folder to write to
-p, --skip-hidden Skip import of hidden files and folders
+ -P, --project=<projectName>
+ Import into this project. An existing project's home
+ folder is used as the target folder, an unknown
+ project is registered at the target folder.
+ -r, --pipeline-run-configuration=<defaultPipelineRunConfiguration>
+ The run configuration to set on every imported
+ pipeline. Without it the name found in the source
+ file is kept.
-s, --shared-xml=<sharedXmlFilename>
The shared.xml file to read from
-t, --type=<type> The type of import plugin to use (e.g. kettle)
- -n, --naming-scheme=<name>
- Naming scheme metadata name in the target folder
- to apply to relational connections
- --no-apply-naming-schemes
- Do not apply a naming scheme; connection names are
- still aligned to one spelling
- -v, --version Print version information and exit</code></pre>
+ -v, --version Print version information and exit
+ -w, --workflow-run-configuration=<defaultWorkflowRunConfiguration>
+ The run configuration to set on every imported
+ workflow. Without it the name found in the source
+ file is kept.</code></pre>
</div>
</div>
</div>
@@ -3053,6 +3069,51 @@ See <a
href="../hop-vs-kettle/import-kettle-projects.html" class="xref page">Imp
</div>
</div>
<div class="sect1">
+<h2 id="_run_configurations_and_projects"><a class="link"
href="#_run_configurations_and_projects">Run configurations and
projects</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The job entries in a Kettle job can name a run configuration, for example
<code>Pentaho local</code>, that doesn’t exist in Hop.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>-r</code> sets the run configuration of every imported Pipeline
action, and of the Simple mapping and Metadata injection transforms.</p>
+</li>
+<li>
+<p><code>-w</code> sets the run configuration of every imported Workflow
action.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Without them, a Pipeline or Workflow action keeps the name in the Kettle
file, or gets <code>local</code> when it has none.</p>
+</div>
+<div class="paragraph">
+<p><code>-P</code> imports into a project:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>When the project exists, its home folder is the output folder, and
<code>-o</code> is ignored.</p>
+</li>
+<li>
+<p>Otherwise the project is registered with the <code>-o</code> folder as its
home, after both folders are checked.</p>
+</li>
+</ul>
+</div>
+<div class="listingblock">
+<div class="content">
+<div class="code-lang" data-pagefind-ignore>shell</div><pre class="highlightjs
highlight is-highlighted"><code class="language-shell hljs"
data-lang="shell">hop import \
+ --type kettle \
+ --input /projects/kettle/inventory \
+ --output /projects/hop/inventory \
+ --project inventory \
+ --pipeline-run-configuration local \
+ --workflow-run-configuration local</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
<h2 id="_examples"><a class="link" href="#_examples">Examples</a></h2>
<div class="sectionbody">
<div class="paragraph">