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