Configure a Workflow

ロケール一覧アクションのパラメータ編集ウィンドウを開きます。

アクセストークンとプロジェクトフィールドは、実行時に解決される動的な値を必要とします。

1. アクセストークンフィールドのリンクアイコン をクリックし、アクセストークン取得アクションを選択します。

   リンクが緑色に変わり、フィールドが編集可能になります。

2. 参照されるトリガーまたはアクションのプロパティにアクセスする構文は次のとおりです。

   {{$.path.to.value}}

   アクセス トークン取得の出力は次のとおりです。

   { "tokens": {"strings_token":"STRINGS_TOKEN", "tms_token":"TMS_TOKEN"} }

   アクセストークンフィールドの{{$.tokens.strings_token}}に必要な式を作ります。

3. プロジェクト フィールドのリンク アイコン をクリックし、uploads： 作成トリガーを選択します。

   リンクが緑色に変わり、フィールドが編集可能になります。

4. uploads：作成トリガーの出力は次のようになります。

   {
     "branch": {
       "name": "my_branch"
     },
     "event": "uploads:create",
     "message":"ユーザー1がブランチmy_ブランチ\n内のプロジェクト名_1672734591_11でファイルアップロードfile.ymlを初期化しました","
     "project": {
       "created_at":"2023-01-03 08:29:51 UTC",
       "id": "abcdabcdabcdabcd-11",
       "main_format": "yml",
       "name": "name_1672734591_10",
       "point_of_contact": null,
       "project_image_url": null,
       "slug": "name_1672734591_10",
       "updated_at":"2023-01-03 08:29:51 UTC"
     },
     "upload": {
       "created_at":"2023-01-03 08:29:48 UTC",
       "filename": "file.yml",
       "format": "yml",
       "id": "upload-1",
       "state": "initialized",
       "summary": {},
       "tag": null,
       "updated_at":"2023-01-03 08:29:48 UTC"
     },
     "user": {
       "gravatar_uid":"29a2d1baa67d4ea524cf0f247f7bbb94",
       "id":"9c365b9a6f77c247c3de959f6152b231",
       "name":"Joe Sixpack",
       "username": "user-1"
     }
   }
   

   プロジェクトフィールドの{{$.project.id}}に必要な式を作成する。

5. 保存をクリックします。

   パラメータ編集ウィンドウが閉じて、アクションのパラメータが保存されます。

プロジェクトのデフォルトロケールは、ジョブ作成アクションに ID を渡してジョブを作成する必要があります。「 Transform JSON with jq 」アクションは、JSON 入力を受け取り、指定されたフィルターを適用して、再び JSON を出力します。

1. ワークフロー ブロック ウィンドウの[Actions]タブで、Phrase-jqを検索します。

   「 Transform JSON with jq 」アクションブロックを一覧ロケールアクションの下にドラッグ&ドロップして接続します。

2. 「 jq で JSON を変換 」アクションのパラメータ編集ウィンドウを開きます。

3. 「入力の種類」ドロップダウンフィールドから JSON を選択します。

4. 「入力」フィールドのリンクアイコン をクリックし、ロケール一覧アクションを選択します。

   リンクが緑色に変わり、フィールドが編集可能になります。

5. 「入力」フィールドは JSON 入力を取ります。特殊な固定表現（$ ではなく @）を使用すると、参照アクションの出力全体がフィールドに渡されます。

   ［Input］ フィールドに expression {{@.outputs.result}} を入力します。

6. 「Jq」フィールドのリンクアイコン をクリックし、一覧ロケールアクションを選択します。

   リンクが緑色に変わり、フィールドが編集可能になります。

7. デフォルトのプロパティーが true であるすべての要素を含む新しい一覧を返すロケール一覧のフィルタ。

   プロジェクトごとに指定できるデフォルトロケールは 1 つだけで、一覧には識別可能で必要な要素が 1 つあります。この要素は、.[0] 配列構文で直接アクセスされます。

   「Jq」フィールドに式 map(select(.default))|.[0] を入力します。

8. 保存をクリックします。

   パラメータ編集ウィンドウが閉じて、アクションのパラメータが保存されます。

ジョブ作成アクションが設定できるようになり、以前のブロックのパターンを使用します。

1. アクセストークンフィールドのリンクアイコン をクリックし、アクセストークン取得アクションを選択します。

   リンクが緑色に変わり、フィールドが編集可能になります。

   式の{{$.tokens.strings_token}}を入力します。

2. プロジェクト フィールドのリンク アイコン をクリックし、uploads： 作成トリガーを選択します。

   リンクが緑色に変わり、フィールドが編集可能になります。

   式の{{$.project.id}}を入力します。

3. 原文ロケールフィールドのリンクアイコン をクリックし、「 Transform JSON with jq 」アクションを選択します。

   リンクが緑色に変わり、フィールドが編集可能になります。

   式の{{@.outputs.result}}を入力します。

4. 納期は sprig または Expr 関数で計算できますが、この例では API が理解するハードコードされた日付を使用します。

   ［Due date］ フィールドに、「2023-12-31T12:00:00Z」と入力します。

5. 保存をクリックします。

   設定が保存され、［Configure］ タブで詳細を確認できます。

すべてのアクションには、論理 AND および OR を組み合わせた 1 つまたは複数の条件を含めることができます。これらの条件は実行時に評価され、アクションとその子アクションは、条件が true と評価された場合にのみ実行されます。

この例を反映するには、ジョブ作成アクションを選択した状態で、［条件］タブの［条件編集］をクリックするか、ブロックを右クリックして［条件編集］を選択します。

条件編集ウィンドウが開きます。

1. 前のブロックのパターンに従って、変数フィールドを uploads： 作成トリガーにリンクし、式の{{$.upload.tag}}を入力します。

2. 最初のドロップダウンリストから NOT を選択して、文を反転します。

3. 比較ドロップダウン一覧から IsNull を選択します。

4. 保存をクリックします。

   条件は、［Conditions］ タブに表示されます。

アップロードにタグが含まれていない場合、ワークフローはこの時点で停止します(新規/更新されたキー/翻訳がなかったことを意味します)。

ジョブに訳文ロケールが必要になりました。この例では、スペイン語（es-ES）とドイツ語（de-DE）の2つのロケールを作成します。ステップ 3 と同様に、ロケールが パラメータ編集ウィンドウの 2 つの Transform JSON に jq アクションとともに追加されます。

1. 両方のアクションの「入力」フィールドに式の{{@.outputs.result}}を入力し、ロケール一覧アクションにリンクしてパラメータを保存します。

2. 1 つのアクションの Jg フィールドに、式 map(select(.name == "es-ES"))|.[0] を入力し、ロケール一覧アクションにリンクします。

   パラメータを保存。

3. 2 番目のアクションで、式 map(select(.name == "de-DE"))|.[0] を入力し、ロケール一覧アクションにリンクします。

   パラメータを保存。

ロケールがジョブ作成に適用されます。

2 つを設定します。 以前定義したのと同じパターン のジョブアクションにターゲットロケールを追加 します。

これでジョブを開始できます。

「定義と同じパターンでジョブアクションを開始」を設定します。