| ] |
自動プロジェクト作成ルールを使用すると、Phraseが統合コネクタを介して特定のフォルダを監視する方法や、そのフォルダ内で新規または更新されたコンテンツが検出された場合に新しいプロジェクトを作成する方法を設定できます。
-
ほとんどのAPC設定はプロジェクトテンプレートで処理されます。プロジェクトテンプレートは、ファイルの保存先、ソース言語とターゲット言語、およびワークフローのステップを定義します。プロセスや財務に関する詳細も、プロバイダーや見積もりおよび分析の生成など、プロジェクトテンプレートで定義されます。
-
個別のAPCは同じプロジェクトテンプレートを共有できますが、各APCはそれぞれ独自のプロジェクトを作成します。異なるAPCによって監視されているファイルやフォルダからのジョブは、単一のプロジェクトに統合されません。
-
APCによって作成されたプロジェクトは、そのAPC専用となります。APCは、APC自身が作成したTMSプロジェクトにのみジョブをインポートできます。手動または他のプロセスによって作成された、別の既存のTMSプロジェクトにジョブをインポートすることはできません。
翻訳をリポジトリにエクスポートする:
-
ジョブは、プロジェクトステータスがに設定されるとエクスポートされます。
-
ジョブは、 > を選択することで手動でエクスポートできます。変更されていないファイルもエクスポートされます。
-
各ターゲットファイルは、APC設定で指定されたターゲットパスに保存されます。
再インポート:
-
ジョブは、ジョブテーブルのメニューから再インポートできます。
前提条件:
-
少なくとも1つのコネクタと、プロファイル内のプロジェクトテンプレートが必要です。
-
（オプション）またはのいずれかがタイプとして選択されたメールテンプレート。
-
ジョブ同期（Phrase Stringsコネクタ）を使用する場合、監視対象として複数のフォルダーまたはファイルを設定できます。
ジョブ同期の場合、エクスポート時にジョブのロケールおよびジョブ自体を完了としてマークするオプションを、Phrase Stringsコネクタの設定で有効にできます。これらの設定により、対応するTMSジョブがエクスポートされると、エクスポートされたジョブのロケール、最終的にはジョブ全体がStringsで「完了」とマークされ、APCはそのコンテンツの監視を停止します。これらのオプションが有効になっていない場合、Stringsのジョブは進行中のままとなり、そのコンテンツへのソース更新がAPCによって検出され、再インポートがトリガーされる可能性があります。
注意
APCごとに10,000ファイルを超えて監視すると、ファイルのインポートエラーやパフォーマンスの問題が発生する可能性があります。UIでエラーが発生した場合は、監視対象のファイル数を減らし、手動でAPC監視をトリガーしてインポートを再試行することをお勧めします。
APCごとに最大10個の監視対象フォルダーを設定できます。
以下の手順に従ってください。
-
新しいAPCを作成します
-
設定
ページから、自動プロジェクト作成をクリックします。
ページが開きます。
-
［新規］ をクリックします。
ページが開きます。
-
APCの名前を入力します（左上）。
-
必要に応じて、プロジェクトテンプレートを選択します。
-
有効/無効ステータスを設定します（左上）。
すべての必須フィールドに入力すると、保存ボタンが有効になります。
-
-
作成とエクスポートを設定します
-
プロジェクトの作成方法を選択します。
-
以下を選択します：
-
APCを継続的なプロジェクトとして設定するかどうかを選択します。
-
変更がいつ、どこで検出されるかに基づいて新しいプロジェクトを作成する方法を、ドロップダウンリストから選択します。
-
-
ドロップダウンリストからプロジェクトテンプレートを選択します。
-
ソース言語はプロジェクトテンプレートで定義され、すべてのターゲット言語またはそのサブセットを選択できます。APCに対して選択されたターゲット言語は、APCが監視するすべてのファイルとフォルダーに適用されます。APCは、同じルール内の異なるファイルやサブフォルダーに異なるターゲット言語セットを割り当てることはできません。異なるファイルやサブフォルダーに対して異なるターゲット言語セットでジョブを作成するには（例：ドイツ語のみを必要とするファイルと、ドイツ語、スペイン語、フランス語を必要とする別のファイル）、各ファイルまたはフォルダーごとに個別のAPCを設定し、それぞれのAPCが該当するファイルまたはフォルダーのみに対応し、そのコンテンツに必要なターゲット言語のみで構成されていることを確認してください。
-
プロジェクトテンプレートの詳細を表示を選択して、選択したプロジェクトテンプレートの設定をプレビューします。
-
（ステップ2）でのファイル選択では、デフォルトのソースロケール（コネクタで設定されたソースロケール）でエントリが表示されます。プロジェクトテンプレートが選択されている場合、そのテンプレートのソースロケールのエントリが表示されます。プロジェクトテンプレートとコネクタのソースロケールの間の設定や潜在的な不一致に関係なく、プロジェクトテンプレートのソースロケールに従ってジョブが正しく作成されます。
-
-
翻訳をエクスポートするための条件を選択します。
は、エクスポート対象となるワークフロー状態の翻訳です。ユーザーはどのコンテンツをエクスポートするかを決定できます。例として、最終ワークフローステップからの翻訳や、それより前のステップからの翻訳などが挙げられます。
最大5つのエクスポートを定義できます（1つあたり最大5つまで定義可能です）。どのコンテンツを（どのワークフローステップから）エクスポートするか、およびいつエクスポートをトリガーするかを設定します。
は、エクスポートをトリガーするイベントを提供します。
-
選択したワークフローステップが完了したときに翻訳がエクスポートされます。特定のワークフローステップが1つのターゲット言語に対して完了すると、他のターゲット言語の完了を待たずに、その言語のエクスポートがトリガーされます。
-
翻訳は、プロジェクト全体が完了した時点、つまりすべてのワークフローステップのすべてのジョブが完了した時点でエクスポートされます。
-
-
-
モニタリング
-
フォルダまたはファイルを監視をクリックして、新規または更新されたコンテンツを監視するフォルダを選択します。
ウィンドウが開き、アカウント用に構成されたすべてのコネクタのリストが表示されます。
必要なコネクタがリストにない場合は、ウィンドウ左上のプラスボタン
をクリックして追加できます。
-
コネクタをクリックすると、フォルダー一覧が表示されます。
-
特定のフォルダーまたはファイルを選択します。
すべてのオプションがすべてのコネクタで利用できるわけではありません。
-
何も選択されていない場合は、フォルダー全体が、変更や新しいファイルの監視対象となります。
-
サブフォルダーを含めると、選択したフォルダーおよびそのサブフォルダーの監視が有効になります。
-
は、どのファイルがすでに翻訳に使用されたかを示すために、ファイルベースのコネクタで使用できます。
を使用すると、正規表現を定義して、フォルダー内で監視対象とするファイルをフィルタリングできます。これはフォルダーのフィルタリングには使用できません。
-
-
確認をクリックします。
選択したフォルダーまたはファイルが、コネクタの名前と種類、および監視対象エンティティへのパスとともに一覧表示されます。参照をクリックして、選択を変更します。
一部のコネクタでは、フォルダーまたはファイルを監視を再度クリックすることで、リストにフォルダーやファイルを追加できます。これは現在、以下の統合で利用可能です：Strings、Contentful、WordPress、Kontent.ai、Git、GitHub、GitLab、およびZendesk Guide。
-
複数のフォルダーまたはファイルを監視できるのは、1つのコネクタ内のみです。
-
監視対象のコネクタに変更を加えると、以前に保存された設定は削除されます。
保存をクリックして、フォルダーとファイルの選択を確定します。
-
-
モニターを追加をクリックして、またはのトリガーを選択します。
監視ウィンドウで、Webhookまたはスケジュール（あるいはその両方）を指定します。
ウェブフックベースのモニタリング
-
Webhookトークンは、の監視を選択し、APCセットアップ中に追加をクリックすると自動的に生成されます。
-
各APCは、独自の固有のトークンを受け取ります。このトークンは共有されず、他のAPC間で再利用することはできません。
-
Webhook URLを呼び出すと、その特定のAPCで直ちに変更検出がトリガーされます。Webhookが再度実行されたときに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によって監視されているリモートフォルダーからすべてのファイルをインポートします。
強制インポートが有効な場合、保存されている履歴に関係なく、フォルダーフィルターに一致するすべてのファイルが変更されたものとして扱われます。これは、構成変更後にファイルを再処理する場合や、再インポートが必要な場合に役立ちます。
-
選択式強制インポート
監視対象フォルダーからインポートするファイルを選択します。選択したファイルのみが変更検出をバイパスします。フォルダー内の残りのファイルは影響を受けず、次回のスケジュールされた検出実行時に通常通り評価されます。
-
-
削除
アクティブなプロジェクトに関連付けられている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のエクスポート設定を構成します。
この例では、英語の翻訳を同じGoogleドライブ上のターゲットフォルダーにエクスポートするようにAPCが設定されています。
-
プロジェクトが完了すると、エクスポートによってAPCがトリガーされ、ピボット言語から目的のターゲット言語へコンテンツを翻訳するための別のプロジェクトが作成されます。
この例では、エクスポートによってAPCがトリガーされ、英語からドイツ語へコンテンツを翻訳するための別のプロジェクトが作成されます。
備考
このユースケースを適用するには、コネクタおよびプロジェクトテンプレートを設定する必要があります。
大規模なプロジェクトの場合、ピボット言語を使用した翻訳は、APIsを介したカスタムスクリプトによっても実現できます。