uip codedapp push

「uip codedapp push」の構文とオプション - ローカル ソースを Studio Web のコード化されたアプリ プロジェクトにアップロードします。

uip codedapp push uploads local source to a Studio Web project. It uploads the build output in --build-dir (default dist) and the project's source files from the project root, after an optional resource import. Use it to ship local edits back to a project that was originally pulled from Studio Web.

概要

uip codedapp push [options]

オプション

フラグ	説明
--project-id <id>	WebApp project ID. When omitted, read from the UIPATH_PROJECT_ID environment variable, then from UIPATH_PROJECT_ID in the .env file. Refer to Project ID.
--solution-name <name>	Name of the Studio Web solution to create when no project ID is set. Goes with --project-name.
--project-name <name>	Name of the coded app project to create in that solution when no project ID is set. Goes with --solution-name.
--build-dir <dir>	ビルド出力ディレクトリ。既定値は [ dist] です。
--ignore-resources	参照リソースのインポートをスキップします。
--allow-large-files	Allow pushing files between 2 MB and 10 MB without a confirmation prompt. Required in non-interactive runs when any file is 2 MB or larger.
-v, --version <version>	明示的なコード バージョンを設定します (例: 2.0.0)。
--verbose	詳細な進行状況ログを表示します。
--base-url <url>	UiPath ベース URL (認証の上書き)。
--org-id <id>	組織 ID (認証の上書き)。
--tenant-id <id>	テナント ID (認証の上書き)。
--access-token <token>	アクセス トークン (認証の上書き)。

プロジェクト ID

push uploads into an existing Studio Web project. It takes the project ID from the first of these that is set: --project-id, the UIPATH_PROJECT_ID environment variable, or UIPATH_PROJECT_ID in the .env file of the current directory.

When none is set, push creates a new Studio Web solution with a coded app project in it, and saves the new project ID as UIPATH_PROJECT_ID in .env, so the next push reuses it:

• With --solution-name and --project-name, it creates the solution and project with those names, without prompting.
• At an interactive terminal without them, it asks whether to create a new solution or use an existing one, and prompts for any missing name.
• In a non-interactive run, both names are required. Without them, push fails and names the options to pass.

Passing --solution-name or --project-name while a project ID is set from any of the three sources is refused, so a push never goes to an existing project when you asked for a new one.

Excluding files

push reads exclusion patterns from .gitignore and .uipignore in the project root. .uipignore uses the same syntax as .gitignore, and its patterns take precedence when the two files disagree. The following are always excluded, with or without an ignore file:

• .uipath/ および node_modules/
• .gitignore, .uipignore, .gitkeep
• .env files, including .env.local, .env.*.local, .env.development, .env.production, .env.test, and .env.example
• Any other file or folder whose name starts with a dot

File checks

Before uploading, push checks every file it would send:

チェック	結果
File extension not in the allowed set of web-related types	Push blocked. The disallowed files are listed.
File of 10 MB or larger	Push blocked.
File of 2 MB or larger, below 10 MB	Interactive: confirmation prompt. Non-interactive: push blocked unless you pass --allow-large-files.
action-schema.json present and invalid	Push blocked.

例

# Push from the default ./dist build directory
uip codedapp push --project-id a1b2c3d4-0000-0000-0000-000000000001

# Custom build directory and explicit version
uip codedapp push --project-id a1b2c3d4-0000-0000-0000-000000000001 \
    --build-dir build \
    --version 2.0.0

# Push files between 2 MB and 10 MB without a prompt (CI)
uip codedapp push --project-id a1b2c3d4-0000-0000-0000-000000000001     --allow-large-files

# First push: create a new Studio Web solution and coded app project (CI)
uip codedapp push --solution-name "Finance Apps" --project-name "InvoiceViewer"

# Skip resource imports
uip codedapp push --project-id a1b2c3d4-0000-0000-0000-000000000001 \
    --ignore-resources

データシェイプ(--output json)

{
  "Code": "PushCompleted",
  "Data": { "message": "Push completed successfully." }
}

A failed push returns Result: "Failure" with Message: "Push failed" and the cause in Instructions.

関連

• uip codedapp pull — 編集する前にリモート プロジェクトをローカル ディスクにフェッチします。
• uip codedapp pack — ビルドがプッシュされたら、公開用にパッケージ化します。

参照

• Coded Apps ツール概要
• グローバル オプション
• 終了コード