ボタン トリガー トークンの概要Get started with button trigger tokens

ボタン トリガー トークンとはWhat are button trigger tokens?

ボタン トリガー トークンは、ボタン フローが実行されているデバイスから確認でき、使用できるデータ ポイントです。Button trigger tokens are data points that are known and available to the device on which a button flow is running. このトークンは、現在の時刻や特定の時点でのデバイスの地理的場所などの要因に基づいています。These tokens change based on factors such as the current time or the geographic location of the device at a given moment.

たとえば、スマート フォンでボタン フローを実行している場合、日付や現在地だけでなく、現在地とその時刻も電話が把握することができます。For example, if you are running a button flow on a smart phone, it is likely that the phone knows the time at your current location as well as the date and your current address. つまり、電話が位置する日付、時刻、住所はすべてボタン フローが実行されている時刻から決定されることになります。In this context, the time, date and address where the phone is located are all determined at the time the button flow runs. この時刻はデバイスで実行されるすべてのボタン フローが自動的に使用できます。They are automatically available for use in any button flows that are executed on the device. このトリガー トークンを使用すると、現在地を他のユーザーに提供したり、特定のジョブ/サービス通話に費やした時間を把握したりするような、繰り返しの作業を最小限にするために役立つフローを構築することができます。You can use these trigger tokens to build useful flows that will minimize repetitive tasks such as providing your location to someone or tracking how much time you spent on a particular job/service call.

ボタン トリガー トークンの一覧List of button trigger tokens

ボタン フローの作成時に使用できるボタン トリガー トークンの一覧を次に示します。Here's the list of the button trigger tokens that are available for you to use when creating your button flows.

パラメーターParameter 説明Description
市区町村City フローを実行しているデバイスが位置する市区町村。The city in which the device that's running the flow is located.
国/地域Country/Region フローを実行しているデバイスが位置する国/地域。The country/region in which the device that's running the flow is located.
完全な住所Full address フローを実行しているデバイスが位置する完全な住所。The full address where the device that's running the flow is located.
緯度Latitude フローを実行しているデバイスが位置する緯度。The latitude in which the device that's running the flow is located.
経度Longitude フローを実行しているデバイスが位置する経度。The longitude in which the device that's running the flow is located.
郵便番号PostalCode フローを実行しているデバイスが位置する郵便番号。The postal code in which the device that's running the flow is located.
都道府県State フローを実行しているデバイスが位置する都道府県。The state in which the device that's running the flow is located.
番地Street フローを実行しているデバイスが位置する番地。The street on which the device that's running the flow is located.
タイムスタンプTimestamp フローを実行しているデバイスが位置する地域の時間。The time in the area where the device that's running the flow is located.
日付Date フローを実行しているデバイスが位置する地域の日付。The date in the area where the device that's running the flow is located.
ユーザー名User name フローを実行しているデバイスにサインインしているユーザーのユーザー名。The user name of the person signed into the device that's running the flow.
ユーザーの電子メールUser email フローを実行しているデバイスにサインインしているユーザーのメール アドレス。The email address of the person signed into the device that's running the flow.

トリガー トークンを使用するボタン フローを作成するCreate a button flow that uses trigger tokens

ボタンを作成するときに、トリガー トークンを使用してボタンに豊富な機能を追加できます。When you create a button, you can use trigger tokens to add rich functionality to your button.

このチュートリアルでは、Android デバイスでボタン フローを作成します。In this walk-through, we will create a button flow on an Android device. このボタン フローは、トリガー トークンを使用して "在宅勤務" の電子メールの日付と完全な住所を上司に送信します。The button flow will use trigger tokens to send the date and your full address in a "Working from home" email to your boss.

このチュートリアルでは Android デバイスのスクリーンショットが使用されますが、iOS デバイスおよび Windows Phone デバイスでの表示もこれに似ています。In this walk-through, you will see screen-shots from an Android device, however, the experience is similar on iOS and Windows Phone devices as well.

前提条件Prerequisites

開始手順:Let's get started:

  1. Flow を起動し、[参照] を選択しますLaunch Flow and select Browse
    ボタン トリガー トークンbutton trigger token
  2. [ボタン] カテゴリの下にある [Send a 'Working from home today' email to your manager] ('本日在宅勤務' のメールをマネージャーに送信する) サービスを選択しますSelect the Send a 'Working from home today' email to your manager service under the Button category
    ボタン トリガー トークンbutton trigger token
  3. [このテンプレートを使用] を選択しますSelect USE THIS TEMPLATE
    ボタン トリガー トークンbutton trigger token
  4. [Send an email] (電子メールを送信する) カードの [編集] を選択しますSelect Edit on the Send an email card
    ボタン トリガー トークンbutton trigger token
  5. [件名] テキスト ボックスをタップし、"WFH" テキストの後ろのテキスト ボックスに「today -」と入力します。Tap the Subject text box and enter: " today - " into the text box after the "WFH" text. テキスト ボックスをタップしたときにパラメーター/トークンの一覧も開いていることを確認してください。Notice that when you tapped on the text box, a list of parameters/tokens also opened up. 次のステップでは、このトークンの 1 つを使って電子メールの件名に日付を追加します。We'll use one of these tokens in the next step to add the date to the subject of the email.
    ボタン トリガー トークンbutton trigger token
  6. カーソルを [件名] テキスト ボックスに置いた状態で、パラメーターの [manual] (手動) 一覧にスクロールして、[日付] をタップします。With the cursor still in the subject text box, scroll to the manual list of parameters and tap Date. 日付パラメーターが [件名] テキスト ボックスに表示されていることを確認します。Notice the date parameter is now in the Subject text box:
    ボタン トリガー トークンbutton trigger token
  7. [本文] テキスト ボックスにスクロールし、既定のメッセージが表示されたらタップして、追加のトークンが含められるようにします。Scroll to the Body text box and tap after the default message so that additional tokens can be included there.
    ボタン トリガー トークンbutton trigger token
  8. [完全な住所] パラメーターをタップしてから [作成] をタップします。Tap the Full address parameter, then tap Create
    ボタン トリガー トークンbutton trigger token
  9. [完了] をタップします。Tap Done. これで、ボタン フローが作成されました。Your button flow is now created.
    ボタン トリガー トークンbutton trigger token

ボタン フローを実行するRun the button flow

: このボタン フローは電子メールを使用して、現在の場所を送信します。NOTE: This button flow will send your current location via email.

  1. 画面の下部にある [ボタン] カテゴリをタップします。Tap the Buttons category at the bottom of the screen. 使用が許可されているボタンの一覧が表示されます。You will see a list of the buttons that you have permissions to use. 今作成したボタン フローを表すボタンをタップします。Tap the button that represents the button flow you just created:
    ボタン トリガー トークンbutton trigger token
  2. ボタン フローにデバイスの場所に関する情報へのアクセスを許可することを示す [ALLOW] (許可) をタップします。Tap ALLOW to indicate that it's OK for the button flow to access your device's location information:
    ボタン トリガー トークンbutton trigger token
  3. 数分以内に、上司に電子メールが送信されます。Within a few moments, notice that the email was sent to your boss:
    ボタン トリガー トークン

おめでとうございます。日付と完全な住所の両方のトリガー トークンを使用するボタン フローが作成されました。Congratulations, you've just created a button flow that uses both the date and full address trigger tokens.

次のステップNext steps