メインコンテンツへスキップ

変数の作成と管理

このページでは、フロー内で変数を作成および管理する方法について、作成・編集・削除を含めて説明します。

注意

変数を作成する際に利用できる接続タイプ、および変数リストやフロービルダーのパネルに表示される接続タイプの変数は、組織で有効になっているクラウドプロバイダーによって異なります。クラウドプロバイダーが有効になっていない場合、その接続タイプはオプションとして表示されず、そのプロバイダー用の既存の接続タイプ変数も非表示になります。

変数の作成​

変数の作成方法は、変数のスコープによって異なります。グローバル変数は 2 通りの方法で作成できます。CloudFlow のサイドバーで Variables を選択する方法と、フローを定義するときにフロービルダー内で作成する方法です。ローカル変数は、フローを作成または編集しているときに、フロービルダー内でのみ作成できます。

グローバル変数​

グローバル変数は、CloudFlow サイドバーから一元的に作成することも、フロー内から直接作成することもできます。

グローバル変数を一元的に作成する​

CloudFlow サイドバーの Variables からグローバル変数を作成および管理できます。これにより、フローの構築を開始する前に、既知で再利用可能なデータを定義できます。これらのグローバル変数は、作成または編集するとすぐにすべてのフローで利用できるため、時間を節約できます。サイドバーから Variables を選択した場合、ここで管理する変数は組織内のすべてのワークスペースで共有されます。現在選択しているワークスペースだけに限定されません。

  1. 上部ナビゲーションのメガメニューから Automation and operations を選択し、CloudFlow を選択してください。

  2. CloudFlow のサイドバーで Variables を選択してください。

    Create a global variable

  3. Create global variable を選択してください。

  4. 変数を定義します。

    • Name: 変数の用途に合った名前。名前は文字またはアンダースコアで始まり、文字・数字・アンダースコアのみを含む必要があります。

    • （任意）Description: 変数の用途を簡潔に説明するテキスト。

    • Type: 変数のデータタイプ。指定可能な値: string、integer、float、boolean、list、connection。list を選択した場合は Element Type も設定する必要があります。connection を選択した場合は Connection Type も設定する必要があります。

    • Element Type: list 内の各アイテムのタイプ。Type が list の場合にのみ表示されます。指定可能な値: string、integer、float、boolean。

    • Connection Type: 接続のクラウドプロバイダー。Type が connection の場合にのみ表示されます。指定可能な値には AWS や GCP などがあります。表示されるオプションは、組織で有効になっているクラウドプロバイダーによって異なります。

      Create a global connection variable

    • Value: 変数の値。list 変数の場合、アイテムを追加または削除します。各アイテムは要素タイプと一致している必要があります。connection 変数の場合、選択した Connection Type に対して、組織の接続のいずれかを選択します。

  5. Create を選択してください。これで、その変数をフローに追加できるようになります。

フロー内でグローバル変数を作成する​

フロー内からグローバル変数を作成できます。フロー内で作成されたグローバル変数は、すぐにすべてのフローで利用可能になります。

フローで作成されたグローバル変数は、CloudFlow サイドバーの Variables（Global variables タブを開く）から管理します。

  1. 新しいフローを作成するか、既存のフローを編集してください。

  2. フローから Variables を選択してください。変数パネルには Local variables と Global variables の 2 つのタブが表示されます。

    Create a variable from a flow

  3. Global variables タブを選択し、Create global variable を選択してください。

    Create a global variable from a flow

  4. 変数を定義します。

    • Name: 変数の用途に合った名前。名前は文字またはアンダースコアで始まり、文字・数字・アンダースコアのみを含む必要があります。

    • （任意）Description: 変数の用途を簡潔に説明するテキスト。

    • Type: 変数のデータタイプ。指定可能な値: string、integer、float、boolean、list、connection。list を選択した場合は Element Type も設定する必要があります。connection を選択した場合は Connection Type も設定する必要があります。

    • Element Type: list 内の各アイテムのタイプ。Type が list の場合にのみ表示されます。指定可能な値: string、integer、float、boolean。

    • Connection Type: 接続のクラウドプロバイダー。Type が connection の場合にのみ表示されます。指定可能な値には AWS や GCP などがあります。表示されるオプションは、組織で有効になっているクラウドプロバイダーによって異なります。

      Create a global connection variable

    • Value: 変数の値。list 変数の場合、アイテムを追加または削除します。各アイテムは要素タイプと一致している必要があります。connection 変数の場合、選択した Connection Type に対して、組織の接続のいずれかを選択します。

  5. Create を選択してください。これで、その変数をフローに追加できるようになります。

ローカル変数​

ローカル変数を作成するには、フローを作成または編集している必要があります。

  1. 上部ナビゲーションのメガメニューから Automation and operations を選択し、CloudFlow を選択してください。

  2. 新しいフローを作成するか、既存のフローを編集してください。

  3. フローから Variables を選択してください。変数パネルには Local variables と Global variables の 2 つのタブが表示されます。

  4. Local variables タブを選択し、Create local variable を選択してください。

    Create a local variable from a flow

  5. 変数を定義します。

    • Name: 変数の用途に合った名前。名前は文字またはアンダースコアで始まり、文字・数字・アンダースコアのみを含む必要があります。

    • （任意）Description: 変数の用途を簡潔に説明するテキスト。

    • Type: データタイプ。string、integer、float、boolean、list、connection。list を選択した場合は Element Type も設定する必要があります。connection を選択した場合は Connection Type も設定する必要があります。

    • Element Type: list 内の各アイテムのタイプ。Type が list の場合にのみ表示されます。指定可能な値: string、integer、float、boolean。Type が list の場合は必須です。

    • Connection Type: 接続のクラウドプロバイダー。Type が connection の場合にのみ表示されます。指定可能な値には AWS や GCP などがあります。表示されるオプションは、組織で有効になっているクラウドプロバイダーによって異なります。

      Create a local connection variable

    • （任意）Value: 変数の値。テンプレート向けには、名前・タイプ・説明のみを指定した変数を定義できます。テンプレートを利用するユーザーは、テンプレート自体を編集することなく、フローをコピーまたは開く際にわかりやすいプレースホルダーを見て値を設定できます。list 変数の場合、アイテムを追加または削除します。各アイテムは要素タイプと一致している必要があります。connection 変数の場合、値を設定する際に、選択した Connection Type に対して組織の接続のいずれかを選択します。

    • Make this variable required: チェックされている場合、この変数に値が設定されていないとフローを実行できません。必須変数を作成する際に、値を設定する必要はありません。例えばサブフローとして使用されるフローの場合、空の必須ローカル変数を作成し、フロー内でパラメータとして指定することで、親フローが実行時に値を渡すようにできます。必須ローカル変数に値がなく（かつパラメータとしても指定されていない）状態で保存または公開しようとすると、フローステータスバーにエラーが表示されます。ステータスエラーを選択すると変数パネルが開きます。

  6. Create を選択してください。これで、その変数をフローから追加できるようになります。

変数の管理​

変数のスコープに応じて、CloudFlow サイドバーまたはフロービルダーから変数を編集および削除できます。変数の編集および削除には、次の制限が適用されます。

  • Published flow: フローが公開されている間は、変数を編集または削除できません。変更を行う前にフローの公開を解除してください。

  • Variable in use: フロー内の 1 つ以上のノードから参照されている変数は削除できません。削除する前に、すべてのノードからその変数を削除してください。

  • Type change: フロー内のいずれかのノードから参照されている間は、変数のタイプを変更できません。タイプを変更する前に、すべてのノードからその変数を削除してください。ノード参照は変数名ではなく変数 ID を使用するため、変数名の変更は常に可能です。

グローバル変数​

グローバル変数は、CloudFlow サイドバーの Variables から管理できます。

  1. 上部ナビゲーションのメガメニューから Automation and operations を選択し、CloudFlow を選択し、CloudFlow サイドバーで Variables を選択してください。

    Create a global variable

  2. 対象のエントリの最も右端にあるケバブメニュー（⋮）を選択し、実行するアクションを選択してください。

    Select the kebab menu from the rightmost end of the global variable entry that you want to manage a variable from a flow

ローカル変数​

フローからローカル変数を編集または削除できます。ローカル変数の 値 はパネル内で直接編集でき、別のフィールドに移動すると自動的に保存され、フロー内でその変数が使用されているすべての箇所に適用されます。変数の三点リーダーメニューを使用して、編集（名前、型、説明、必須、選択した型のオプション）または 削除 を実行できます。

  1. 変数を管理したいフローを開きます。

  2. Variables を選択します。

    フローから変数を作成

  3. ローカル変数 タブを選択します。

  4. エントリの一番右端にあるケバブメニュー（⋮）を選択し、実行するアクションを選択します。

に最終更新