ワークフローの構築
重要
Some context (right-click) menu options are not available for Basic users. These are identified as "Full User".
ワークフローは、データを処理するさまざまな機能を実行する接続ツールで構成されています。ワークフローを作成するには、ツールを追加してツール同士を接続します。これらのツールとワークフロープロパティも設定します。新しいワークフローを作成するには、[ファイル] > [新しいワークフロー]を選択します。
ワークフロー接続は、ワークフロー 設定 ウィンドウで選択したワークフローレイアウトに基づいて、垂直方向または水平方向に、ダウンストリームへと移動します。
ツールの追加または削除
ツールをワークフローに追加するには、ツールパレットからツールをクリックしてワークフローキャンバスにドラッグするか、ワークフローを右クリックし、メニューにアクセスしてツールを挿入します。詳細については、ツールカテゴリを参照してください。
ワークフローからツールを削除するには、ツールを選択し、キーボードの Delete キーを使用します。
ツールの接続
ワークフローでツールを接続するには、ツールパレットからツールを選択して、キャンバスの別のツールの出力アンカーの近くまでドラッグします。既存のツールの出力アンカーを、追加したばかりのツールにドラッグすることもできます。
接続は、ツールの左側 (または上部) から接続し、ツールの右側 (または下部) へ通ります。いくつかのツールは、複数の入力アンカーで示される複数の入力を受け入れます。いくつかのツールには、グレーの入力アンカーで示されるオプション入力があります。出力アンカー付きのツールはすべて、複数のストリームに出力できます。
入力と出力の接続インジケーターを表示するツールを選択します。ツールへのコネクタ入力は緑色で、ツールからのコネクタ出力は青色です。
その接続を選択してキーボードのDeleteキーを使用するか、右クリックして[接続を削除]を選択します。下流のツールは削除されません。
その接続を選択し、[接続設定]ウィンドウを使用して[ワイヤレス]チェックボックスを選択します。または、キャンバス上でその接続を右クリックして、[接続をワイヤレスにする]を選択します。ワイヤレスになっていると、接続矢印は非表示に設定されます。入力/出力アンカーには、ワイヤレス接続を示すマークが付きます。バーの色は、アンカーに出入りする接続の数を示します。1つのバーは1つの接続、2つのバーは2つの接続、3つのバーは3つ以上の接続を示します。
Connections with a staple can also be made wireless. Both sides of a connection with a staple are made wireless together. If 1 or more connections are not wireless, the staple is visible. If all connections are wireless, then the staple also disappears.
Preview Feature
Connection Staples are in Preview during the 2025.2 release and require a Full User role.
Connection Staples are a new visual and functional enhancement in Designer that lets you group and organize connections between tools on the canvas. Staples visually group related tool connections, reducing clutter and helping users quickly identify which tools work together as part of a logical process. Staples are lightweight, non-intrusive, and do not affect the logic or execution of the workflow.
Connection Staples Limitations
There are several important limitations to be aware of when you use connection staples:
Staples are not compatible with older versions of Designer. This means that if you add connection staples in Designer 25.2, those staples are not supported when the workflow is opened in a previous version of Designer.
Staples don't work with a single connection. You must select at least 2 connections.
Staples don't connect to Interface tools and In-Database tools.
You can't add new connections to existing staples.
There are no staple configuration options, and you can't add annotations to staples.
Staples do not work with more than 20 tool connections.
To add a Connection Staple...
Select at least 2 or more connections and right-click to open the connection context menu. The connections can be from the same or different tools, and there is no limit on the number of connections that you can staple.
Select Add Connection Staple (Preview). The selected connections are grouped into a "staple" on the canvas.
Once a connection staple is in place, select a tool to see which connection from the input/output of the staple it is associated with. Additionally, when a staple is on the canvas, you can access the staple's context menu by right-clicking on the staple. The context menu has these options:
Zoom: Select to...
Zoom In
Zoom Normal: Return to the default zoom level.
Zoom Out
All: Zoom to fit all tools in the window.
Selected tools: Zoom to fit all selected tools in the window.
Make Connections Wireless: All connections going through the staple are made wireless.
Remove Connection Staple (Preview): Select one or more staples to delete the staple and rewire the connections.
その接続を選択し、接続設定ウィンドウの[折れ線]セクションを使用して色を変更します。または、キャンバス上で接続を選択し、右クリックして[接続の色を変更]を選択します。
これはワークフローレベルの設定で、[ユーザー設定] > [テーマ] > [接続設定]での接続の色設定が上書きされることに注意してください。カスタムの接続の色は、24.2より前のDesignerバージョンで有効ではありませんが、ワークフローが中断することはありません。
There are several options for inserting tools into an existing connection:
接続を右クリックし、[接続に挿入] を選択し、ツールを選択します。
ツールパレットまたはキャンバス上の任意の場所からツールをドラッグし、既存の接続の上にカーソルを乗せます。
出力アンカーを右クリックして、[直後に挿入] を選択し、ツールを選択します。
You can use the Paste in Connection option to insert a tool or group of tools into an existing connection. To access this option...
First, select and copy a tool or group of tools on the canvas.
Next, right-click on an existing connection and select Paste Tools in Connection. The copied tools are inserted into the connection. Note that you can also drag the selected tools over a connection to insert them.
The original connection automatically disconnects between the 2 tools and makes 2 new connections: one for input and one for output. The downstream tool shifts automatically based on the length of the grouped tools. Additionally, only open anchors can get new connections.
If you make a mistake while inserting a group of tools into a connection, you can use the Undo (Ctrl+Z) option in the toolbar.
可能なツール接続のリストを表示し、同時に複数の接続を行うことができます。これは、複数のデータ入力を1つの下流ツールに接続する場合に便利です。
複数の接続を行うには、以下の手順に従います。
キャンバス上のツールを選択します。ツールが入力と出力の両方を受け入れる場合は、ツールの入力アンカーまたは出力アンカーを選択して、そのアンカーとの可能な接続のリストをそれぞれ取得します。
選択したアンカーを右クリックし、[可能な接続を表示] を選択します。
[可能な接続]ウィンドウで、[出力接続]リストから1つ以上のツールを選択し、[入力接続]リストから1つ以上のツールに接続します。
[接続タイプ]で、接続を[有線]にするか[ワイヤレス]にするかを選択します。
[接続]を選択します。
選択した複数のツールで可能な接続を表示すると、出力アンカーと出力アンカーの有効な接続のみが表示されます。
任意の接続をダブルクリックして、設定 ウィンドウでプロパティを表示および変更します。
名前: 接続の名前を入力します。
ワイヤレス: 接続をワイヤレスに設定する場合に選択します。
折れ線: 接続にカスタムの色を選択する場合には[...]ボタンを選択します。
フィールド: テーブルで、接続を通過するデータを表示します。
ワイヤレス接続の場合、カラーバー付きのワイヤレス接続アイコン
は、アンカーに出入りする接続の数を示します。
1 本のバーは 1 つの接続を表します。
2 本のバーは 2 つの接続を表します。
3 本のバーは 3 つ以上の接続を表します。
ツールが選択されていないと、接続が非表示になります。
ワークフロータブの右クリックオプション
キャンバスでワークフロータブを選択して開いたあと、このタブを右クリックすると、以下のオプションを含むメニューが表示されます。
閉じる: ワークフローを閉じます。
このページ以外のすべてを閉じる: このワークフローを除く、すべての開いているワークフローを閉じます。
すべて閉じる: 開いているすべてのワークフローを閉じます。
複製: このワークフローの複製を作成します。
Designer で、パスの依存関係を相対パスから絶対パスに変更できます。詳しくは、ワークフロー依存関係 を参照してください。
ツールの右クリックオプション
キャンバス上のツールを選択し、右クリックして次のオプションを含むメニューを表示します。
切り取り: 選択したツールをキャンバスから切り取ります。
コピー: 選択したツールをコピーします。
削除: 選択したツールを削除します。
ズーム: 以下から選択します。
拡大
等倍:ズームをキャンセルします。
縮小
すべて: ウィンドウ内のすべてのツールに合わせてズームします。
選択したツール: ウィンドウ内の選択したすべてのツールに合わせてズームします。
可能な接続の表示:選択したツールとの間で使用可能なツール接続のリストを表示します。
新しいコンテナに追加: 選択したツールをコンテナツールに追加します。詳細については、ツールコンテナツールを参照してください。
新しいコントロールコンテナに追加: 選択したツールをコントロールコンテナツールに追加します。詳細については、コントロールコンテナツールを参照してください。
前面へ移動: ツールがオーバーラップしている場合に、選択したツールを前面に送ります。これは、コメントボックスを重ねたり、重なっているツール注釈を順序付けするのに便利です。詳細については、コメントツールを参照してください。
背面へ移動: ツールがオーバーラップしている場合に、選択したツールを背面に送ります。これは、コメントボックスを重ねたり、重なっているツール注釈を順序付けするのに便利です。詳細については、コメントツールを参照してください。
[出力接続を有線にする]と[出力接続をワイヤレスにする]を切り替えて、接続の表示方法を変更します。ワイヤレス接続の場合の入力アンカーと出力アンカーには、ワイヤレス接続アイコンが表示され、アンカーに出入りする接続の数を示す色付きのバーが表示されます (ツールが選択されていない限り接続は見えません)。
1 本のバーは 1 つの接続を表します。
2 本のバーは 2 つの接続を表します。
3 本のバーは 3 つ以上の接続を表します。
マクロに変換: ワークフローのすべてまたは一部をマクロに変換します。重要な制限と手順については、マクロに変換するを参照してください。
ワークフローのキャッシュと実行: ワークフローを実行し、選択したツールまですべてのデータをキャッシュします。
ツールをキャッシュするには、以下の手順に従います。
ツールを右クリックします。
ワークフローのキャッシュと実行を選択します。Alteryx は、複数のキャッシュポイントを同時に作成します。Ctrl キーを押しながら個々のキャッシュポイントをクリックすると、複数のキャッシュポイントを操作できます。
注意事項と制限事項:
すべてのツールをキャッシュできるわけではありません。
このツールは、最大 5 つの出力アンカーを持つことができ、ループの一部になることはできません。
インデータベースツール、機械学習ツール、Python ツールはキャッシュできません。
1つのワークフローで複数のキャッシュを使用できます。
キャッシュされたツールを操作すると、キャッシュをクリアせずにツールの設定を表示できます。ただし、ツールの設定を変更すると、キャッシュデータが解放されます。
Alteryx は、ワークフローを閉じるときにキャッシュを消去します。
キャッシュのクリア: キャッシュを削除します。ツールのキャッシュを消去するには、以下の手順に従います。
ツールを右クリックします。
[キャッシュを消去] を選択します。Alteryxは複数のキャッシュポイントを同時にクリアできます。1 つ以上のツールのキャッシュを個別に消去するには、そのツールを選択し、右クリックしてメニューを表示します。
選択したツールまで実行: このオプションは、AMP Engineからのみ使用でき、特定のツールまでワークフローを部分的に実行できます。これは、ワークフロー全体を実行することなく、特定の部分をテストして変更できるため、ワークフローの開発とテストに特に役立ちます。
[選択したツールまで実行]を選択すると、ワークフローはすぐに実行され、選択したツールより後のすべてのツールは、ワークフローで無効状態に表示されます。
このオプションは、1つのワークフロー内の複数のツールに(それらが別々のデータストリームの一部である限り)適用できます。これを行うには、複数のツールを選択(Ctrlキーを押しながらキャンバス上で各ツールを選択)し、選択したツールのいずれかを右クリックして、[選択したツールまで実行]を選択します。
この設定は、キャッシュされたワークフローと互換性があります。
無効なツールオーバーレイをクリアするには、[実行]ボタンまたはCtrl+Rキーボードショートカットを使用して、ワークフロー全体を実行します。
マクロ入力に変換: 選択した入力ツールをマクロ入力ツールに変換します。
直後に挿入: 選択したツールの後に挿入するツールを選択します。詳細については、ツールカテゴリを参照してください。
直後に閲覧ツールを追加: 選択したツールの後に、閲覧ツール を追加します。選択したツールに複数の出力アンカーがある場合は、各出力に閲覧ツールを追加するオプションが使用可能になります。
Open Macro: If the tool is a macro, select this option to open the underlying macro in a new workflow tab. You can also double-click the tool on the canvas to open the macro.
プロパティ: 選択したツールの 設定 ウィンドウにフォーカスを移します。
整列オプションを表示するには、2 つ以上のツールを選択します。
水平方向に整列: 選択したツールが、最初にキャンバス上に配置したツールと水平方向に整列されます。
垂直方向に整列: 選択したツールは、最初にキャンバス上に配置したツールと垂直方向に整列します。
整列オプションを表示するには、3 つ以上のツールを選択します。
水平方向に配置: 選択したツールは、水平軸に沿って、均等なスペースを空けて配置されます。
垂直方向に配置: 選択したツールは、垂直軸に沿って配置されたツール間に均等なスペースを持つように配置されます。
Tool Double-click Options
Certain tools on the workflow canvas give you quick access to additional features via a double-click. This option is available for the Browse tool and any tools that are macros:
Macros: Double-click the tool icon (on the canvas) for a tool that is a macro to open the underlying macro workflow in a new workflow tab and quickly inspect the macro details.
Browse tool: Double-click the Browse tool icon (on the canvas) to open the dataset in a new Results window and quickly investigate the workflow data.
ワークフローの注釈
ツールの[設定]ウィンドウ > [注釈]で個々のツールに注釈を追加するか、ワークフローにコメントツールを追加します。詳細については、次のリソースを参照してください。
キャンバスオプション
ワークフローの実行: ワークフローを実行します。Ctrl+R を使用してワークフローを実行することもできます。ワークフローの実行中にアイコンが 停止 に変わります。
ワークフローの停止: ワークフローを停止します。Ctrl+R を使用してワークフローを停止することもできます。
分析アプリとして実行: 分析アプリを実行します。
スケジュールにワークフローを追加: 特定の時間と頻度で実行するワークフローをスケジュールします。
アクティブドキュメント: 開いているワークフロー、アプリ、またはマクロを表示します。
空のワークフローの新規作成: 新しいワークフロー (.yxmd) を作成します。
ズームイン: 標準ズームを 3/2 拡大します。
ズームアウト: 標準ズームを 2/3 縮小します。
コピーと貼り付け
キャンバスに貼り付けるアイテムの場所を制御するには、アイテムを選択してコピー (Ctrl+C) し、アイテムを貼り付ける場所を選択してから貼り付けます (Ctrl+V)。Designer は、カーソルと同じ位置にアイテムを貼り付けます。
ファイルの保存
保存されていないワークフローが 1 つまたは複数あるときにアプリケーションを終了しようとすると、Designer によって未保存のワークフローを保存するよう求められます。Designerに次のワークフローへの変更を保存しますか?と表示され、以下のオプションがあります。
選択した内容の保存: 保存するワークフローを選択してから、[選択した内容の保存] を選択します。Designer は、選択したワークフローを保存して閉じます。選択していないワークフローは保存されません。
変更を破棄する: すべての変更を破棄して保存せずに終了するには、[変更を破棄する] を選択します。
キャンセル: [キャンセル] を選択すると、キャンバスに戻ります。