Designer R tool

Rツール

Version:
Current
Last modified: May 02, 2020

R ツールは、R ユーザー向けのコード エディターです。R は、統計分析に使用できるオープン ソースのコード ベースです。このツールを使用する前に、R に堪能である必要があります。

Alteryx パブリック ギャラリーの互換性

Gallery.alteryx.com でワークフローの公開を予定していますか? まず、免除の申請を行なう必要があります。この制限は、Alteryx Server および Alteryx ギャラリーのプライベート インスタンスには適用されません。

デザイナーの R

デザイナは有効な R スクリプトを読み取り、ツールを通過します。R ツールからの出力は、R の出力と一致します。

R サポート

デザイナーは顧客の R コードを受け入れますが、Alteryx は顧客の R コードのサポートを提供しません。

Alteryxは、R スクリプトのグローバル変数である [AlteryxFullUpdate] を使用して、メタ情報更新を行います。完全なメタインフォの更新は、AlteryxFullUpdateTRUEに設定すると発生します。これは、最初にワークフローを開くか、F5キーで更新するときに発生します。

AlteryxFullUpdate = TRUEの場合、標準の読み取りおよび書き込み機能は使用できません。R スクリプトに読み取りのような関数が含まれている場合。オルタレックスまたは書き込み。Alteryx FullUpdate = TRUEの間に Alteryx がエラーが発生します。

AlteryxFullUpdate = TRUEがワークフローの実行時に生成されるメタインフォデザイナとは異なる場合があります。これにより、エラーが発生する可能性があります。

ツール設定

R ツールは、複数の入力を受け入れ、接続順(#1、#2など) にラベルを付けます。#2 このツールは、アンカーから最大 5 つのデータ ストリームを出力し、1から5のラベルを付けます。コード内の参照は、入力と出力の形式の違いが同じでなければなりません。

以下の説明では、#1は入力接続ラベルを指し、5は任意の出力アンカーを指します。

R ツールは関数の書き込みを使用します。出力用の Alteryx (DATA_VARIABLE_TO_WRITE、5)

コードの挿入: R コード エディターに挿入できるデザイナ固有のコマンドを一覧表示します。これらのコマンドは、一般的な R コマンドで使用する必要があります。リストは包括的ではありません。

R ツールとインターフェイス ツール: R ツールでインターフェイス ツールにアクセスするには、[構成]ウィンドウの [アノテーション]タブでツール名がインターフェイス ツールの名前である%Question.tool_name%と入力します。

入力の読み取り

読み取り入力: この関数は、接続されたデータ入力で読み取ります。接続された各入力は、接続順にリストされた別個のオプションを作成します。一覧表示された入力を選択して、コード エディタに接続を挿入します。この関数は、AlteryxFullUpdateTRUEまたはFALSEに設定したかどうかにかかわらず使用できます。

読みます。Alteryx ()関数は、入力データを R 環境にストリームします。

オプションのパラメータ

行名: RowNames という名前の新しい列を含む省略可能なパラメータで、行ヘッダーとして扱われるデータの最初の列が設定されています。既定では、デザイナはこのパラメータをFALSEに設定します。

書き込み。オルタレックス (データ可変_TO_WRITE, 5, TRUE)

データ フレームとして: このオプションはデータ テーブルで読み取ります。他のパラメータはありません。

読む。Alteryx("#1"、モード="data.frame")

データ フレームとして: チャンク :このオプションは、大きなデータ テーブルで読み取ります。一度に処理するレコードの数を指定します。

(「#1」、50000、モード = 「data.frame」)

リストとして: このオプションは空間オブジェクトで読み取ります。

read.Alteryx(「#1」、モード=「list」)

リストとして: チャンク: このオプションは、多数の空間レコードを読み取ります。一度に処理するレコードの数を指定します。

read.Alteryx(「#1」、50000、モード=「list」)

入力メタインフォ: このオプションは、データではなく入力からメタインフォを読み取ります。この関数は、メタインフォを含むデータフレームを返します。データフレームの行は入力データの各列を表し、該当する metainfo は 6 列に表示されます。

  • 名前: 文字列、列名
  • : 文字列、データ型
  • サイズ: 整数、データ型のサイズ (バイト)
  • スケール: 整数、FixedDecimal 内の小数点以下の桁数
  • ソース: 文字列、列の種類に関するメタデータ、開始値の後
  • 説明: 文字列 、説明文字列を入力できる省略可能な列

read.AlteryxMetaInfo(「#1」)

進捗状況を設定する

[進行状況の設定]この関数は、ワークフロー内のツール アイコンの進行状況をレポートします。次のいずれかの増分オプションを選択します。

  • 25%
  • 50%
  • 75%
  • 100%

AlteryxProgress(0.25)

出力メッセージ

出力メッセージ: この関数は、結果ウィンドウにメッセージを表示します。メッセージの優先順位によって、Designer がメッセージを報告するタイミングが決まります。メッセージ表示動作を変更するには、ワークフローの構成を参照してください。

メッセージの優先度

通常の優先度メッセージ:実行中のワークフローのキャンバスに R ツールが表示されている場合にのみ、メッセージが表示されます。R ツールがマクロ内に含まれている場合、Designer はメッセージを表示しません。

AlteryxMessage("message", msg.consts$INFO, priority.consts$LOW)

通常の優先度一時的なメッセージ: 同じツールが問題を引き起こし、既存のメッセージの代わりにメッセージが表示されます。

AlteryxMessage("message", msg.consts$INFO, priority.consts$LOW, 5)

中程度の優先度の警告:R ツールが実行中のワークフローのキャンバスに表示されるか、実行中のワークフローのマクロ内に含まれている場合にメッセージが表示されます。

AlteryxMessage("message", msg.consts$WARNING, priority.consts$MEDIUM)

フィールド変換エラー: あるフィールドタイプから別のフィールドタイプにデータを変換できない場合、またはデータがフィールド仕様に収まらない場合に、メッセージが表示されます。

AlteryxMessage( "message"、msg.consts $ FIELD_CONVERSION_ERROR)

優先度の高いエラー: R ツールと実行中のワークフローの関係に関係なく、メッセージが表示されます。デザイナは、フィールド変換エラーを高優先度として扱います。

AlteryxMessage(「message」、msg.consts $ ERROR、priority.consts $ HIGH)

出力を書き込む

出力の書き込み: このオプションは、出力アンカーからデータ ストリームを出力します。すべてのアンカーは、いずれかのデータまたは単一のグラフを生成できます。

パラメーターのオプション

ソース: このオプションパラメータは、メタデータ出力のSource列に文字列を追加します。

書き込み。Alteryx (DATA_VARIABLE_TO_WRITE, 5, ソース="2012 リポジトリの顧客データ")

行名: このオプション パラメータには、行ヘッダーとしてデータの最初の列が設定された RowNames という名前の新しい列が含まれます。このパラメータはデフォルトでFALSEに設定されます。

書き込み。オルタレックス (データ可変_TO_WRITE, 5, TRUE)

パッキングの依存関係

Designer は、ワークフローの依存関係として R コードに付随する余分なファイルを自動的に検出しません。ワークフローをパッケージ化する必要があり、R コードに独自の依存関係がある場合は、[構成]ウィンドウにツール構成を使用する追加のファイルを含めます。

グラフを作成する

グラフの作成: このオプションは、解析のグラフを出力します。デザイナは、出力をレポート ツールが読み取ることができるレポート スニペットとして扱います。グラフ サイズのオプションのいずれかを選択します。

  • 6x6インチ - 96 dpi
  • 8x10インチ - 300 dpi
R
  1. AlteryxGraph(5, width=576, height=576)
  2. xPoints <- c(1, 2, 3, 4)
  3. yPoints <- c(2, 4, 6, 8)
  4. plot(xPoints, yPoints)
  5. invisible(dev.off())

アップデート/メタインフォ

if(AlteryxFullUpdate):この関数はグローバル変数 [AlteryxFullUpdate] で動作します。

書く。AlteryxAddFieldMetaInfo: この関数は、単一の列から名前付き出力にメタインフォを追加します。AlteryxFullUpdate = FALSEの場合、この関数は使用できません。

パラメーターのオプション

以下のパラメータの任意の組み合わせを使用できます。

nOutput: 列のメタデータを出力に追加します。

name: 出力する列の名前を指定します。無効な名前を指定すると、エラーが発生します。

フィールドタイプ: 列のデータ型を表します。無効なフィールドの種類を指定すると、エラーが発生します。フィールドの種類に基づいて、サイズ縮尺を手動で更新する必要がある場合があります。Designer は、複数のフィールド型を有効なフィールド型に変換して受け入れます。

サイズ: 列のサイズを指定します。デザイナは、この値を多数のフィールドタイプに自動的に割り当てます。

scale: 列値の小数点以下の桁数を指定します。デザイナでは、FixedDecimalフィールドタイプにこの値を指定する必要がありますが、他のフィールドタイプには指定できません。

有効なFieldType文字列 サイズオーバーライド スケールオーバーライド 有効なFieldTypeに変換します。
ブール 自動   論理的
Byte 自動    
Int16 自動    
Int32 自動   整数
Int 64 自動    
FixedDecimal 手動 手動  
float型 自動    
double型 自動   数値

文字列

手動    
WString 手動    
V_String      
V_WString     因子、文字
日付 自動    
時間 自動    
日時 自動    
BLOB      
空間オブジェクト      

source: このオプションの列に、列の起点を説明する文字列を設定します。

説明: このオプションの列に説明文字列を設定します。

書く。AlteryxGraphMetaInfo: この関数は、名前付き出力のメタインフォメーションを、AlteryxGraph()を使用して R スクリプト グラフに設定します。AlteryxFullUpdate = FALSEの場合、この関数は使用できません。

パラメーターのオプション

nOutput: 列のメタデータを追加する出力を指定します。

 

Was This Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support.