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はリモートフォルダーの原文更新を監視しますが、変更が検出されるたびに新しいプロジェクトが作成されるため、詳細な設定は不要です。
-
継続的なプロジェクトの場合、原文更新が検出されたときにどのワークフロー手順を再開する必要があるか、新しい解析と見積もりを生成するかどうか、およびプロジェクト所有者に原文更新について通知するかどうかを指定します。
-
-
ターゲット更新オプションを選択します（Phrase Stringsコネクターでが選択されている場合にのみ有効です）。
ユーザーは、ターゲットの更新についてリモートオンラインリポジトリを監視できます。オンラインリポジトリ内の訳文のコピーに加えられた変更は、自動的に翻訳メモリを更新します。
-
保存をクリックします。
が開きます。
が選択されている場合、自動化のドライランによって最初の反復でベースラインが作成され、その後はベースライン以降の新規/更新されたファイルのみがインポートされるため、不要な使用を削減できます。このオプションは最初の反復でのみ利用可能です。
-
確定をクリックします。
APCがページの一覧に追加されます。
-
自動化ルールを設定すると、指定されたフォルダー内にコンテンツを作成できるようになります。頻度チェックに基づいて、Phraseは指定されたフォルダーを調査し、（ファイル名、メタデータ、サイズなどに基づいて）新規または更新されたコンテンツを特定します。
APCは、コネクターの種類と設定に応じて、2つの変更検出戦略を使用します。
ファイル履歴に基づく検出
これはほとんどのコネクターで使用されます。検出を実行するたびに、APCは監視対象フォルダー内のファイルの一覧を作成し、各ファイルを前回の実行時に保存された記録と比較します。以下のフィールドが比較されます。
-
ハッシュ
-
ファイルサイズ
-
最終更新日
-
納期
実際に利用可能なフィールドはコネクターの提供内容によって異なります。すべてのコネクターがすべてのフィールドを公開しているわけではないためです。利用可能な（nullではない）すべてのフィールドが比較されます。
受信したファイルの利用可能なフィールドのいずれかが保存された記録と異なる場合、ファイルは変更されたとみなされます。実行間で利用可能なフィールドのセットが変更された場合（例：以前は利用できなかったハッシュが利用可能になった場合など）、そのファイルはメタデータが変更されたものとして扱われ、インポートがトリガーされます。
保存されたレコードは、各検出サイクルが成功するたびに更新されます。
差分ベースの検出
Gitベースのコネクターでサブフォルダの監視が有効になっている場合に使用されます。サブフォルダの監視を行わないGitコネクターの場合は、代わりにファイル履歴ベースの検出が使用されます。
ファイルメタデータを比較する代わりに、APCはコネクターに対して、前回の処理済みコミット以降に変更されたファイルの一覧を問い合わせます。
-
初回実行時、APCはフォルダ内のすべてのファイルを取得し、それらすべてを変更済みとして扱います。
-
2回目以降の実行時には、APCは前回の既知のコミット以降に変更されたファイルのみを要求します。
最後に処理されたコミットIDが保存され、次回の検出実行の開始点として使用されます。
インポートまたは更新がスキップされる場合
APCは、以下の条件下でインポートまたは更新のトリガーをスキップします。
-
一致するファイルが見つかりません
監視対象のフォルダからファイルが返されない場合、または設定されたファイル名のフィルタに一致するファイルがない場合、実行はスキップされ、何も行われません。
-
ファイルはこのAPCによってアップロードされました
監視対象のフォルダ内のファイルが以前に同じAPCインスタンスによってアップロードされていた場合（例：翻訳されたファイルが原文フォルダに書き戻された場合など）、APCの出力の再インポートを防ぐため、そのファイルは変更検出から除外されます。
-
コンテンツの変更が検出されません（ファイル履歴ベースのコネクター）
ファイルの利用可能なすべてのフィールドが保存されたレコードと一致する場合、そのファイルは変更されていないものとして扱われ、スキップされます。
-
選択的インポート（選択されたセットに含まれていないファイル）
特定のファイルのみをインポートするように実行が設定されている場合、選択されたセットに含まれていないファイルは現在の実行から除外され、次回の検出サイクルで評価されます。
複数のフォルダが監視されている場合
APCが複数のフォルダを監視する場合、監視対象の各フォルダはそれぞれ独立した検出を実行します。結果は収集され、ダウンストリームのインポートがトリガーされる前にマージされます。
Gitベースのコネクターとサブフォルダ監視を使用するフォルダは差分検出を使用し、その他のすべてのフォルダはファイル履歴ベースの検出を使用します。
Phrase Stringsのジョブを監視するJob Syncコネクターの場合、変更検出は実行のたびに監視フォルダ内のすべてのアクティブなジョブをチェックします。監視フォルダ内に多数のアクティブなジョブがあると、インポートが必要なジョブがわずかであっても、APCの実行完了にかかる時間が大幅に長くなる可能性があります。変更検出を高速に保つには、Phrase Stringsでジョブが完了したらジョブまたはジョブのロケールを完了としてマークし、監視フォルダ内のアクティブなジョブの数を少なく保ってください。
各ターゲットファイルは、プロジェクト設定で指定されたフォルダにエクスポートされます。
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は、正常に監視されているフォルダーの変更のみを監視しています。すべての監視フォルダーがまだ存在するか確認してください。
監視対象フォルダーが修正されたら、監視をトリガーして新規または未処理の変更を処理します。
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がトリガーされ、英語からドイツ語へコンテンツを翻訳するための別のプロジェクトが作成されます。