Automated Project Creationルールを使用すると、Phraseが統合機能コネクターを介して特定のフォルダーを監視する方法や、そのフォルダー内で新規または更新されたコンテンツが検出された場合に新しいプロジェクトを作成する方法を設定できます。
-
ほとんどのAPC設定は、プロジェクトテンプレートで処理されます。プロジェクトテンプレートは、ファイルの保存先、原文言語と訳文言語、およびワークフローステップを定義します。プロセスや財務に関する詳細も、プロバイダーや見積もりおよび分析の生成など、プロジェクトテンプレートで定義されます。
-
個別のAPCで同じプロジェクトテンプレートを共有できますが、各APCはそれぞれ独自のプロジェクトを作成します。異なるAPCによって監視されているファイルやフォルダーからのジョブは、単一のプロジェクトに統合されません。
リポジトリへの訳文のエクスポート:
-
ジョブは、プロジェクトステータスがに設定されるとエクスポートされます。
-
ジョブは、 > を選択することで手動でエクスポートできます。変更されていないファイルもエクスポートされます。
-
各訳文ファイルは、APC設定で指定された訳文パスに保存されます。
再インポート:
-
ジョブは、ジョブテーブルのメニューから再インポートできます。
前提条件:
-
少なくとも1つのコネクターと、プロファイル内のプロジェクトテンプレート。
-
（オプション）メールテンプレート。タイプとしてまたはのいずれかが選択されている必要があります。
-
Job Sync（Phrase Stringsコネクター）を使用する場合、監視対象として複数のフォルダーまたはファイルを指定できます。
Job Syncの場合、ジョブのロケールおよびジョブ自体をエクスポート時に完了としてマークするオプションを、Phrase Stringsコネクターの設定で有効にできます。これらの設定により、対応するTMSジョブがエクスポートされると、エクスポートされたジョブのロケール、最終的にはジョブ全体がStringsで「完了」とマークされ、APCはそのコンテンツの監視を停止します。これらのオプションが有効になっていない場合、Stringsのジョブは進捗中のままとなり、そのコンテンツに対する原文の更新がAPCによって検出され、再インポートがトリガーされる可能性があります。
注意
APCごとに10,000ファイルを超えて監視すると、ファイルのインポートエラーやパフォーマンスの問題が発生する可能性があります。UIでエラーが発生した場合は、監視対象のファイル数を減らし、手動でAPCの監視をトリガーしてインポートを再試行することをお勧めします。
APCごとに設定できる監視フォルダーは最大10個です。
以下の手順に従ってください：
-
APCを作成
-
設定ページから、Automated project creationをクリックします。
ページが開きます。
-
［新規］ をクリックします。
ページが開きます。
-
APCの名前を入力します（左上）。
-
必要に応じてプロジェクトテンプレートを選択します。
-
アクティブ/非アクティブのステータスを設定します（左上）。
必須フィールドがすべて入力されると、保存ボタンがアクティブになります。
-
-
作成とエクスポートを設定します
-
プロジェクトの作成方法を選択します。
-
以下を選択します：
-
APCは継続的なプロジェクトとなります。
-
変更がいつ、どこで検出されるかに基づいて、新しいプロジェクトがどのように作成されるかをドロップダウン一覧から選択します。
-
-
ドロップダウン一覧からプロジェクトテンプレートを選択します。
-
原文言語はプロジェクトテンプレートで定義され、訳文言語のすべてまたは一部を選択できます。APCに対して選択された訳文言語は、APCが監視するすべてのファイルとフォルダーに適用されます。APCは、同じルール内の異なるファイルやサブフォルダーに対して、異なる訳文言語セットを割り当てることはできません。ファイルやサブフォルダーごとに異なる訳文言語セットでジョブを作成するには（例：あるファイルはドイツ語のみが必要で、別のファイルはドイツ語、スペイン語、フランス語が必要な場合）、ファイルまたはフォルダーごとに個別のAPCを設定します。各APCは関連するファイルまたはフォルダーのみを対象とし、そのコンテンツに必要な訳文言語のみで構成します。
-
View project template detailsを選択して、選択したプロジェクトテンプレートの設定をプレビューします。
-
（ステップ2）でのファイル選択では、デフォルトの原文ロケール（コネクターで設定された原文ロケール）のエントリーが表示されます。プロジェクトテンプレートが選択されている場合、そのテンプレートの原文ロケールでエントリーが表示されます。プロジェクトテンプレートとコネクターの原文ロケール間の設定や潜在的な不一致に関係なく、プロジェクトテンプレートの原文ロケールに従い、ジョブが正しく作成されます。
-
-
訳文をエクスポートするための条件を選択します。
は、ワークフローのどの状態で訳文をエクスポートするかを指定します。ユーザーはどのコンテンツをエクスポートするかを決定できます。例として、最終ワークフローステップからの訳文や、それより前のステップからの訳文などが挙げられます。
最大5つまでエクスポートを定義できます。どのコンテンツを（どのワークフローステップから）エクスポートするか、またいつエクスポートをトリガーするかを設定します。
は、エクスポートをトリガーするイベントを提供します。
-
選択したワークフローステップが完了したときに訳文がエクスポートされます。特定のワークフローステップが1つの訳文言語に対して完了すると、他の訳文言語の完了を待たずに、その言語のエクスポートがトリガーされます。
-
プロジェクト全体が完了したとき、つまりすべてのワークフローステップのすべてのジョブが完了したときに、訳文がエクスポートされます。
-
-
-
モニタリング
-
Monitor folder or fileをクリックして、新規または更新されたコンテンツを監視するフォルダーを選択します。
ウィンドウが開き、アカウント用に設定されたすべてのコネクターの一覧が表示されます。
必要なコネクターが一覧にない場合は、ウィンドウ左上のプラスボタン
をクリックして追加できます。
-
コネクターをクリックして、フォルダ一覧を開きます。
-
監視する特定のフォルダまたはファイルを選択します。
すべてのオプションがすべてのコネクターで使用できるわけではありません。
-
何も選択されていない場合は、フォルダ全体が変更または新規ファイルの監視対象となります。
-
サブフォルダを含めることで、選択したフォルダとそのサブフォルダの監視を有効にします。
-
は、ファイルベースのコネクターで、どのファイルがすでに翻訳に使用されたかを示すために使用できます。
を使用すると、顧客は正規表現を定義して、フォルダ内で監視するファイルをフィルタできます。これは、フォルダをフィルタするために使用することはできません。
-
-
確定をクリックします。
選択したフォルダまたはファイルが、コネクターの名前と種類、および監視対象エンティティへのパスとともに一覧表示されます。Browseをクリックして選択を変更します。
一部のコネクターでは、Monitor folder or fileを再度クリックすることで、さらにフォルダやファイルを追加して一覧に含めることができます。これは現在、次の統合で利用可能です：Strings、Contentful、WordPress、Kontent.ai、Git、GitHub、GitLab、およびZendesk Guide。
-
複数のフォルダまたはファイルは、1つのコネクター内でのみ監視できます。
-
監視対象のコネクターに変更が加えられた場合、以前に保存された設定は削除されます。
保存をクリックして、フォルダとファイルの選択を確定します。
-
-
Add monitorをクリックして、またはベースのトリガーを選択します。
監視ウィンドウで、ウェブフックまたはスケジュール（あるいはその両方）を指定します。
ウェブフックベースの監視:
-
ウェブフックトークンは、APCセットアップ中にの監視を選択し、追加をクリックすると自動的に生成されます。
-
各APCは独自のトークンを受け取ります。トークンは共有されず、他のAPC間で再利用することはできません。
-
ウェブフックURLを呼び出すと、その特定のAPCで即座に変更検出がトリガーされます。ウェブフックが再度実行されたときにAPCがすでにチェックを実行している場合、Phraseは追加の実行を1つキューに入れます。実行がすでにキューに入っている間に追加の呼び出しを行っても、追加の実行は作成されません。それらは、保留中の単一の実行が進行することを確定します。
-
-
-
オプションの自動化を設定する
-
必要な自動化を選択します。
-
原文更新オプションを選択します（継続的なプロジェクトでのみ有効）。
-
APCセットアップのセクションでが選択されている場合、APCはRemoteフォルダーの原文更新を監視しますが、変更が検出されるたびに新しいプロジェクトが作成されるため、詳細な設定は不要です。
-
継続的なプロジェクトの場合、原文更新が検出されたときにどのワークフロー手順を再開する必要があるか、新しい解析と見積もりを生成するかどうか、およびプロジェクト所有者に原文更新を通知するかどうかを指定します。
-
-
訳文の更新オプションを選択します（Phrase Stringsコネクターでが選択されている場合のみ有効です）。
ユーザーは、訳文の更新についてリモートのオンラインリポジトリを監視できます。オンラインリポジトリ内の訳文のコピーに加えられた変更は、自動的に翻訳メモリを更新します。
-
保存をクリックします。
が開きます。
が選択されている場合、自動化のドライランによって最初の反復でベースラインが作成され、その後は不要な使用を減らすためにベースライン以降の新規/更新されたファイルのみがインポートされます。このオプションは最初の反復でのみ利用可能です。
-
確定をクリックします。
APCがページの一覧に追加されます。
-
自動化ルールが設定されると、指定されたフォルダー内にコンテンツを作成できるようになります。頻度チェックに基づいて、Phraseは指定されたフォルダーを調査し、（ファイル名、メタデータ、サイズなどに基づいて）新規または更新されたコンテンツを特定します。
APCは、コネクターの種類と設定に応じて2つの変更検出戦略を使用します。
ファイル履歴に基づく検出
これはほとんどのコネクターで使用されます。検出を実行するたびに、APCは監視対象フォルダー内のファイルの一覧を作成し、各ファイルを前回の実行時に保存された記録と比較します。以下のフィールドが比較されます。
-
ハッシュ
-
ファイルサイズ
-
最終更新日
-
納期
実際に利用可能なフィールドはコネクターの提供内容によって異なります。すべてのコネクターがすべてのフィールドを公開しているわけではないためです。利用可能な（nullではない）すべてのフィールドが比較されます。
受信したファイルの利用可能なフィールドのいずれかが保存された記録と異なる場合、ファイルは変更されたとみなされます。利用可能なフィールドのセットが実行間で変更された場合（例：以前は利用できなかったハッシュが利用可能になった場合など）、ファイルはメタデータが変更されたものとして扱われ、インポートがトリガーされます。
保存されたレコードは、各検出サイクルが成功した後に更新されます。
差分ベースの検出
Gitベースのコネクターでサブフォルダの監視が有効になっている場合に使用されます。サブフォルダの監視がないGitコネクターの場合、代わりにファイル履歴ベースの検出が使用されます。
ファイルメタデータを比較する代わりに、APCはコネクターに対して、最後に処理されたコミット以降に変更されたファイルの一覧をクエリします。
-
初回実行時、APCはフォルダ内のすべてのファイルを取得し、それらすべてを変更済みとして扱います。
-
次回の実行以降、APCは最後に認識されたコミット以降に変更されたファイルのみを要求します。
最後に処理されたコミットIDが保存され、次回の検出実行の開始点として使用されます。
インポートまたは更新がスキップされる場合
APCは、以下の条件下でインポートまたは更新のトリガーをスキップします。
-
一致するファイルが見つからない場合
監視対象のフォルダからファイルが返されない場合、または構成されたファイル名のフィルタに一致するファイルがない場合、実行はスキップされ、何も実行されません。
-
ファイルがこのAPCによってアップロードされた場合
監視対象のフォルダ内のファイルが以前に同じAPCインスタンスによってアップロードされていた場合（例：翻訳されたファイルが原文フォルダに書き戻された場合など）、APCの出力の再インポートを防ぐために、そのファイルは変更検出から除外されます。
-
コンテンツの変更が検出されない場合（ファイル履歴ベースのコネクター）
ファイルの利用可能なすべてのフィールドが保存されたレコードと一致する場合、そのファイルは変更されていないものとして扱われ、スキップされます。
-
選択的インポート（ファイルが選択セットに含まれていない場合）
特定のファイルのみをインポートするように実行が構成されている場合、選択セット外のファイルは現在の実行から除外され、次回の検出サイクルで評価されます。
複数のフォルダが監視されている場合
APCが複数のフォルダを監視する場合、監視対象の各フォルダはそれぞれ独立した検出を実行します。結果は収集され、ダウンストリームのインポートがトリガーされる前にマージされます。
Gitベースのコネクターを使用し、サブフォルダ監視が有効になっているフォルダは差分検出を使用します。その他のすべてのフォルダは、ファイル履歴ベースの検出を使用します。
各訳文ファイルは、プロジェクト設定で指定されたフォルダにエクスポートされます。
APCを無効にするには3つの方法があります：
-
設定で手動で無効にする。
-
90日間アクティビティがない場合に自動的に無効になる。
-
組織プロファイルが無効化された後（サブスクリプションの終了時）に自動的に無効になります。
Automated Project Creationルールの一部として使用されるコネクターが、プロジェクトが作成されるべき時に作成されなかったという事象を3回以上連続で検出した場合、影響を受けるユーザーに注意が送信されます。
ページでは、現在利用可能なAPCの概要を確認できます。
APCは、、、、のスケジュール、およびでフィルタリングできます。
特定のAPCが選択されている場合：
-
編集
選択したAPCを編集用に開きます。
-
コピー
選択したAPCのコピーを作成します。
-
モニターをトリガー
原文ファイルをチェックして更新がないか手動で確認し、を更新します。
-
インポートを強制
変更検出をバイパスして、選択したAPCによって監視されているRemoteフォルダからすべてのファイルをインポートします。
強制インポートが有効な場合、フォルダフィルタに一致するすべてのファイルは、保存された履歴に関係なく変更されたものとして扱われます。これは、設定変更後や再インポートが必要な場合に、ファイルを再処理するのに役立ちます。
-
選択的強制インポート
監視対象フォルダからインポートするファイルを選択します。選択したファイルのみが変更検出をバイパスします。フォルダ内の残りのファイルは影響を受けず、次回のスケジュールされた検出実行時に通常通り評価されます。
-
-
削除
アクティブなプロジェクトに関連付けられているAPCは削除できません。
APCの削除は元に戻せません。削除されたAPCは、ごみ箱から復元したり自動的に再作成したりすることはできません。必要な場合は、最初から設定し直す必要があります。これは、APCを手動で無効にする（非アクティブに切り替える）こととは異なり、いつでも再度有効にできます。
特定のAPCをクリックすると、そのAPCの設定ページが開きます。設定ページでは、以下の操作が可能です。
-
タブから、APC設定を確認および更新します。
-
タブから、APCによって実行された操作とそのステータスを追跡します。
-
タブから、APCに対して生成された既存の継続的分析を表示およびダウンロードします。
履歴ログ
APC履歴ログには、APCによって実行されたすべての操作が詳細に記録されます。これにより、ローカリゼーションマネージャーはすべてのAPCイベントを表示、検索、フィルタリングし、特定のAPCに関する問題をトラブルシューティングできます。
備考
検索バーは英語での照会にのみ機能します。すべてのデータは英語で保存されるため、ログはPhraseのエンジニアおよびテクニカルサポート/お客様サクセスチームにとって有用です。
ログは以下のイベントを追跡します：
-
プロジェクト
-
作成
-
ステータス変更
-
-
ジョブ
-
インポート
-
エクスポート
-
原文の更新
-
訳文更新
-
ステータス変更
-
-
モニタリング
-
フォルダ監視
-
-
APC
-
作成
-
無効化
-
ログは以下を追跡しません：
-
手動操作（手動ファイルインポート）
-
APCの機能に影響を与えない操作（APCに影響しないプロジェクトテンプレート設定の更新など）
-
APCに関連しない操作
-
見積もりおよび解析の作成
-
TMの更新
-
送信された通知機能
-
APC構成の変更
APCのステータスは、APC概要ページに表示されます。
-
アクティブ
APCは問題なく実行されています
-
非アクティブ
APCは意図的に非アクティブにされています
-
実行中
APCは監視対象リポジトリからコンテンツを処理しています。処理時間は、監視対象のコンテンツのサイズによって異なります。
APCの処理時間を短縮するには：
-
大量のファイルを蓄積させるのではなく、より小さなバッチでインポートを頻繁にトリガーしてください。
-
大規模なフォルダーやパスの監視を複数のAPCに分割（例：フォルダーや製品エリアごと）し、各APCが処理するファイル数を減らしてください。
-
長期間非アクティブだったAPCを再アクティブ化するのではなく、新しいAPCを作成することで、対象となるジョブの大量のバックログを一度にインポートすることを回避してください。
-
-
注意が必要です
APCは実行中ですが、APCに影響を与える可能性のある変更やマイナーなエラーが発生しているため、ユーザーの対応が必要です。
APCのエラーおよび警告ステータスは、直近の実行結果のみを反映します。これらのステータスはリアルタイムでは更新されません。またはエラー状態は、APCが正常に再実行されるまで表示されたままになります。根本的な問題が解決した場合は、APCを手動でトリガーして、古いステータスをクリアしてください。
理由
詳細
APCのチェックは成功しましたが、ファイルのインポートに失敗しました。
コネクターからのファイルインポートに失敗しました。APC編集ページで、監視対象のファイル構成を確認してください。
ファイル監視が修正されたら、（または）をトリガーして、以前に失敗したファイルを再インポートしてください。
1つのAPCで複数のフォルダーを監視している場合、一部の監視対象フォルダーで失敗が発生しました。
APCは、正常に監視されているフォルダーの変更のみを監視しています。すべての監視対象フォルダーがまだ存在するか確認してください。
監視対象フォルダーが修正されたら、監視をトリガーして、新規または見逃した変更を処理してください。
1つのAPCで1つのフォルダーを監視している場合、監視対象フォルダーで失敗が発生しました。
監視対象フォルダーがまだ存在するか確認してください。
監視対象フォルダーが修正されたら、監視をトリガーして新規または未処理の変更を処理します。
1つのAPCで複数のフォルダーを監視している場合：すべてのフォルダーに何らかの問題がありますが、APCチェックでの失敗は1回または2回のみです。
APC編集ページでフォルダー監視設定を検証してください。監視対象フォルダーが修正されたら、監視をトリガーして新規または未処理の変更を処理します。
コネクターの障害
コネクターの設定を確認してください。
エクスポートのワークフローステップが削除されました。
APCは実行中ですが、エクスポートが実行されません。プロジェクトテンプレートが正しいこと、およびAPCエクスポート設定が正しいことを確認してください。
エクスポートのワークフローステップが変更されました。
APCは実行中であり、APC用に構成されたワークフローステップ番号に対応する番号を持つワークフローステップからエクスポートを実行します。 プロジェクトテンプレートが正しいこと、およびAPCエクスポート設定が正しいことを確認してください。
一部の訳文言語がプロジェクトテンプレートから削除されました。
APCは、削除された言語を新規作成されたプロジェクトで使用しません。
APCからのファイルエクスポートが失敗しました。
ファイルを手動でエクスポートしてください。
-
中止
重大なエラーまたは障害が発生したため、システムによってAPCが非アクティブ化されました。
理由
詳細
すべての原文言語または訳文言語がプロジェクトテンプレートから削除されました。
原文言語および訳文言語、またはどちらかがありません。プロジェクトテンプレートに少なくとも1つの原文言語と1つの訳文言語を追加し、APCのステータスをアクティブに設定してください。APCが再アクティブ化されると、新規作成されたプロジェクトで更新された原文または訳文のロケールが使用されます。
すべての監視対象フォルダーでAPCチェックが3回失敗しました。
監視構成とコネクター設定を検証してから、APCを再アクティブ化し、監視をトリガーしてください。
多言語ローカリゼーションでは、ピボット言語をブリッジ言語として使用し、原文言語から必要な数の訳文言語への翻訳を有効にすることができます。ピボット言語アプローチは、原文の翻訳リソースが限られている場合に特に有効です。
ピボット言語を使用した翻訳は、翻訳プロセスを自動化するためのAPCの使用事例です。以下の例は、従うべき必要な手順をまとめたものです。
-
原文のコンテンツを保存するために、目的のオンラインリポジトリにフォルダを作成します。
この例では、フランス語の原文ファイルがGoogleドライブのフォルダに追加されます。
-
APC監視オプションを設定して、目的のオンラインリポジトリ内のコンテンツの更新を監視します。
-
APCを設定して、必要な原文言語と、訳文言語として使用する選択したピボット言語でプロジェクトを作成します。
この例では、APCはフランス語を原文言語、英語をピボット訳文言語としてプロジェクトを作成するように設定されています。
-
APCのエクスポート設定を構成して、翻訳されたコンテンツを同じオンラインリポジトリ上の対応する訳文言語フォルダにエクスポートします。
この例では、APCは英語の訳文を同じGoogleドライブ上の訳文フォルダにエクスポートするように設定されています。
-
プロジェクトが完了すると、エクスポートによってAPCがトリガーされ、ピボット言語から目的の訳文言語へコンテンツを翻訳するための別のプロジェクトが作成されます。
この例では、エクスポートによってAPCがトリガーされ、英語からドイツ語へコンテンツを翻訳するための別のプロジェクトが作成されます。
備考
この使用事例を適用するには、必要なコネクタとプロジェクトテンプレートを設定する必要があります。
大規模なプロジェクトの場合、ピボット言語を使用した翻訳は、APIを介したカスタムスクリプトによっても実現できます。