Weaveで構築・実行する

説明

PlaidCloudでのほとんどの作業は、目的を1文でWeaveに伝えることから始められます。 Weaveは、何を構築または変更するかを正確に示すカードで回答し、承認するまで何も起こりません。このページの内容はすべてWeaveドックで行われ、どのカードも同じルールに従います。

カードはブラウザーで承認します。Approve 1 change（またはApprove 6 changes）で承認し、 今はしないでそのままにし、変更… ボタンでもう一度依頼します。
Weaveが開始するすべての実行で、ERP転記はオフになります。
Weaveは、PlaidCloudの外部に書き込むステップを実行、変更、スケジュール設定しません。代わりに、ステップのフォームまたはワークフローを案内します。
Weaveは、お使いのロールで許可されていることだけを実行できます。ロールで許可されていない場合、Weaveはその旨を伝え、何も変更しません。

カードの読み方と元に戻す方法については、変更を承認するを参照してください。

Weaveに目的を伝える

プロジェクト、ワークフロー、ステップ、インポート、ディメンションを作成するダイアログは、 Tell Weave what you wantで開きます。1文を入力するボックスがあり、その下に開始方法の候補がいくつかリンクとして表示されます。

ダイアログ	ボックスの問いかけ	開始方法の候補
新規プロジェクト	プロジェクトを説明してください（例付き）	テンプレートから開始、ドキュメントからファイルをインポート、プロジェクトをコピー
新規ワークフロー	このワークフローで何をしますか？	ファイルをテーブルにインポート、別のワークフローからステップをコピー、2つのテーブルを照合
新規ステップ	このステップで何をしますか？	ファイルのインポート、ルックアップ、フィルター
インポート	どのファイルをテーブルにしますか？	ファイルをテーブルにインポート
新規ディメンション	このディメンションには何を保持しますか？	テーブルの列から構築

文を入力してEnterキーを押します。ドックが開き、入力した文が送信されます。改行するにはShift+Enterキーを押します。 新規プロジェクトでは、ボックスに文字が入力されるとWeave に質問がメインのボタンになります。

通常のフォームを使用するにはFill in the form insteadをクリックし、ボックスに戻るにはTell Weave insteadをクリックします。 PlaidCloudは、オブジェクトの種類ごとに最後に使用した方法を記憶します。

ワークフローのキャンバスの新規ステップメニューはDescribe the step… から始まり、現在のステップの後に追加するステップについて同じボックスを開きます。

ボックスは、Weaveチャットがオンで、お使いのロールでそのオブジェクトを作成できる場合に表示されます。それ以外の場合、ダイアログにはフォームが表示されます。

空の一覧とページ

何もない一覧も、Weaveから始められます。

プロジェクト、ワークフロー、テーブル、ディメンション、およびワークフローのステップには、文を入力するボックスが表示されます。
データエディター、UDF、接続、ダッシュボードには、Weave に質問ボタンが表示されます。
空のワークフローのキャンバスには、このワークフローは空です。何をするかをWeaveに伝えるか、ステップを追加してください。 と表示され、ボックス、ファイルのインポートの開始方法、Add a stepが表示されます。
ワークフローのないプロジェクトでは、その概要にStart with Weaveカードが表示されます。

サンプルデータの読み込みなど、一覧の通常のボタンも引き続きその下にあります。

ワークフローを説明して構築の様子を確認する

freight.csvをインポートし、各運送業者の地域を検索して、運送業者別に運賃を合計する のように、ワークフローで行う内容を説明します。Weaveは1枚の計画カードで回答します。カードのタイトルは、たとえばBuild 3 steps in a new workflow “Freight by Carrier”, then run itのようになります。計画の各行には、1つのステップが行う内容がわかりやすい言葉で示されます。

freight.csvを新しいテーブルFreight（Carrier、Amount、Month）にインポートします。
CarrierをキーにCarriersでRegionを検索します。
AmountをCarrierごとに合計してFreight by Carrierに書き込みます。
Freight by Carrierを実行します。この実行ではERP転記はオフです。

計画では、ファイルのインポート、抽出、ルックアップ、結合、ユニオン、集計ができ、後のステップは前のステップが作成したテーブルを読み取れます。ワークフローの実行が計画の最後の行になります。

承認すると、ドックにワークフローを作成中、ステップ 2/3 を構築中、実行中と表示されます。キャンバスでは、各ステップが作成されるたびにBuilt by Weaveの枠線付きで表示され、構築が終わるとその枠線は消えます。ワークフローの上の帯にはWeaveがこのワークフローを構築していますと表示されます。停止するには、帯の停止をクリックします。その後、Weaveは途中で停止しました: Import FreightとLookup Regionを構築しました。 のように、構築済みの内容を伝えます。

Weaveは高度なワークフローに構築します。標準のワークフローへの構築を依頼された場合は、代わりに新しいワークフローを構築することを提案します。
新しいワークフローに、既存のワークフローと同じ名前は付けられません。
WeaveはCSV、Excel、Parquet、DB2のファイルをインポートします。Weaveが構築できない行は、存在しないファイルやヘッダー行のないファイルなど、理由とともにNot added: として一覧表示されます。

ワークフローを実行またはスケジュール設定する

Month-End CloseをAllocate by Driverから実行して のように、ワークフローまたはその一部の実行をWeaveに依頼します。カードのタイトルは、Run “Month-End Close” from the step “Allocate by Driver” のように実行される内容を示し、次の内容が一覧表示されます。

実行対象 — 実行されるステップの数。
書き込み — 実行によって書き込まれるテーブル。
ERP転記 — 実行に含まれるステップがERPに転記する場合の、この実行ではERP転記はオフです。
元に戻す — 実行は元に戻せません。これらのテーブルの内容が置き換えられます。

標準のワークフローではステップが順番に実行されるため、隣り合っていないステップを実行すると、その間のすべてのステップが対象になり、カードにその旨が示されます。

実行後、Weaveは4分で成功しましたのように結果を伝え、各テーブルの行数と、それが通常の範囲内かどうかも示します。ワークフローがすでに実行中の場合は何も開始されず、終了後にもう一度承認するようWeaveが伝えます。

平日の06:00にMonth-End Closeを実行して のようにワークフローのスケジュール設定をWeaveに依頼したり、ワークフローのスケジュールの変更、オン、オフ、削除を依頼したりできます。スケジュールのカードには、日時、次回の下に次の3回の実行時刻、オンが表示されます。既存のスケジュールを変更する場合は、変更前と変更後が表示されます。承認すると、Weaveが次回の実行日時を伝えます。

ワークフローの実行には、ワークフローを編集できるロールが必要です。スケジュールの変更には、プロジェクトの自動化を変更できるロールも必要です。
Weaveは、ERPに転記するスケジュールをオンにしたり変更したりしません。 このスケジュールはERPに転記します。スケジュールでオンにしてください。 と表示されます。
Weaveは、PlaidCloudの外部にデータを送信するワークフローを実行したりスケジュール設定したりしません。ワークフローから実行してください。

ステップを変更または追加する

Allocate by Driverを人員数で配分するように変更して のように、ステップの変更をWeaveに依頼します。カードのタイトルはChange “Allocate by Driver” で、各設定の変更前と変更後が示され、最後に 次に: ERP転記をオフにしてAllocate by Driverを再実行し、成功することを確認します。 と示されます。承認すると、Weaveは変更を保存してステップを再実行し、結果を伝えます。カードの元に戻すで設定が元に戻ります。

Load Freightの後に、2026年の行だけを残すステップを追加して のように、ステップの追加をWeaveに依頼します。カードのタイトルはAdd a step “Freight 2026” after “Load Freight” で、ステップが作成するテーブルには (new table) ラベルが表示されます。高度なワークフローでは、ステップは直前のステップの右側に配置されます。

Weaveがカードを通じて変更しないものは次のとおりです。

ERPに転記するステップ、またはPlaidCloudの外部に書き込むステップ。
Extract: SQLやImport: SQLなどのSQLステップ、ユーザー定義関数のステップ、スクリプトやPythonを実行するステップ。
テーブルやディメンションを空にする、ドロップする、または削除するもの。

Weaveはどれに該当するかを伝え、ステップのフォームを案内します。他のワークフローを実行するステップや、複数のワークフローに含まれるステップは、変更後に再実行されません。そのワークフローから再実行するようWeaveが伝えます。

Weaveにファイルをドロップする

1つのファイルを、プロジェクトの概要または高度なワークフローのキャンバスにドラッグします。ページにここにファイルまたはAlteryxワークフローをドロップしてくださいと表示され、ファイルがドキュメントにアップロードされて、そのファイル用のカードとともにドックが開きます。

ドロップするもの	Weaveの提案
データファイル: CSV、TSV、TXT、Excel、Parquet	概要では新しいテーブル、キャンバスではファイル名を付けたインポートステップ（ドロップした位置に配置）。
SQLスクリプト（`.sql`）	スクリプトと同じ処理を行うステップ。SQLスクリプトをステップに変換するを参照してください。
Alteryxワークフロー（`.yxmd` または `.yxwz`）	変換したワークフローを含む新しいプロジェクト。Alteryxワークフローを取り込むを参照してください。
`.zip` ファイル	その中のAlteryxワークフローを新しいプロジェクトに移行すること。

Weaveは一度に1つのファイルを扱います。複数のファイルをドロップした場合は、最初のファイルを使用し、その旨を伝えます。フォルダーを取り込むには、zipにしてドロップするか、ドキュメントにアップロードしてドックでその名前を指定します。 Weaveが認識できないファイルはドキュメントに残り、Weaveがその場所を伝えます。

すでにドキュメントにあるファイルを指定することもできます。たとえば、ドキュメントのRevenue Prep.yxmdを変換して のように依頼します。

SQLスクリプトをステップに変換する

.sql ファイルをドロップするか、スクリプトをドックに貼り付けます。Weaveはそれを読み取り、同じ処理を行う標準ステップを、 Build 6 steps from 4 statements in a new workflow “Revenue Prep”, then run it のような計画カードで提案します。キャンバスにドロップした場合、ステップはそのワークフローに追加されます。

カードには、スクリプトをどのSQL方言として読み取ったかが示されます。Databricks、Spark、Snowflake、 BigQuery、T-SQL、Oracle、PostgreSQL、MySQL、StarRocksのいずれかです。Weaveが方言を推測し、スクリプトが別のデータベース向けに書かれている場合は、どのデータベースかを伝えてもう一度依頼してください。

各行には、AmountをRegionごとに合計してRevenue by Regionに書き込みます のように、ステップが行う内容が示されます。ステップにできないものは、データベース自体を変更する文や、まだプロジェクトにないテーブルなど、文と理由とともにNot added: として一覧表示されます。文は完全に変換されるか、追加されないかのどちらかで、 Weaveが文の一部だけを構築することはありません。

Weaveが読み取るスクリプトは1 MBまでです。それより長いスクリプトは複数のファイルに分割してください。
INSERT、UPDATE、DELETE、MERGE文は、新しいテーブルに書き込むステップ、またはテーブルを更新するステップになります。 Weaveはテーブルを空にしないため、WHEREのないDELETEは追加されません。
スクリプトが作成するテーブルは、その後の文で使用されます。スクリプトが読み取るそれ以外のテーブルは、すでにプロジェクトにある必要があります。
他の計画と同様に、Weaveは高度なワークフローに構築し、最後の実行ではERP転記がオフになります。

Alteryxワークフローを取り込む

1つのワークフロー

Alteryxワークフロー（.yxmd または .yxwz）をプロジェクトの概要にドロップするか、ドキュメント内のワークフローを指定します。 Convert “Revenue Prep” into a new project カードには、次の内容が表示されます。

プロジェクト名 — Revenue Prep (from Alteryx)。カードは、変換したワークフローとそのテーブルを含む新しいプロジェクトを作成し、ワークフローが読み取る入力ファイルを、その横のフォルダーにコピーします。既存のプロジェクトは何も変更されません。
見積もり — ワークフローに含まれるツールのおおよその数と、そのうち変換されるもの、確認が必要なもの、 PlaidCloudに相当するものがないものの数。
保存先 — プロジェクトのファイルが保存されるドキュメントフォルダー。

承認すると、Weaveはワークフローを変換し、作成した内容をOpen the projectとワークフローを開くとともに伝えます。見つからなかった入力ファイルは一覧表示されるため、後でフォルダーに追加できます。元に戻すを選択すると、新しいプロジェクトがごみ箱に移動します。

25 MBを超えるワークフローや、見積もりに時間がかかりすぎるワークフローは、代わりに Alteryxコンバーターで変換されます。

フォルダー全体

Alteryxフォルダー Finance Closeを移行して のように、ドキュメント内のAlteryxワークフローのフォルダーを指定するか、そのフォルダーの .zip をプロジェクトの概要にドロップします。Alteryxワークフローが書き込んだファイルもフォルダーに入れておくと、 Weaveは変換したワークフローの結果をそれらと比較します。

Move 12 Alteryx workflows into a new project カードには、プロジェクトの名前、ワークフローがどのように変換されるかの見積もり、比較対象の出力ファイル、PlaidCloudの外部に書き込むためにチェックから除外するステップが表示されます。すべての実行でERP転記はオフになり、出力ファイルを書き込むステップはチェック中に実行されません。代わりに、それらが書き込むテーブルが比較されます。

大きなフォルダーでは数時間かかることがあります。処理中はPlaidCloudを閉じてもかまいません。ドックでのジョブの進行状況は、展開、変換、出力ファイルのインポート、実行と比較、レポートの作成の順に進みます。最後に、 Finance Close (from Alteryx)の準備ができました: 12件のワークフローのうち9件が指定した出力と一致し、2件が異なり、1件は実行されませんでした。 3件は移行レポートで判断が必要です。のような文が、Open the reportとともに表示されます。

Move-in reportには、判断が必要なワークフローが先に一覧表示され、その後にすべてのワークフローが、認識・変換された内容、確認が必要な内容、Ranかどうか、結果が指定したファイルとMatchするかどうかとともに表示されます。各行には次のボタンがあります。

比較 — そのワークフローの結果と指定したファイルの比較を開きます。
再チェック — そのワークフローの再実行と比較を提案します。
開く — ワークフローを開きます。
割り当て — その行について判断する人を選択します。選ばれた人にはPlaidCloudで通知されます。行を割り当てられるのは、そのワークフローを開けるプロジェクトメンバーだけです。

ワークフローの判断が必要になるのは、変換されなかった場合、PlaidCloudに相当するもののないツールがある場合、実行されなかった場合、指定したファイルと異なる場合、または比較できなかった場合です。