テンプレートの編集 - プロジェクトの途中でカスタムスクリプトを実行する (midscripts)

プロジェクトで実行するスクリプトはプログラムです。サーバーでは、全員がプログラムの実行を許可されているわけではありません。通常、memoQ TMSはセキュリティ上の理由からプログラムの実行が許可されていません。

オンラインプロジェクトでスクリプトを実行する前に、memoQ TMSがスクリプトを実行することを許可する必要があります。

管理者かつ熟練者である必要があります：memoQ TMSコンピュータの管理者でない場合や、実行内容を熟知していない場合は、以下の手順を行わないでください。

これはmemoQで行うことではありません。手順を完了するまで、memoQウィンドウは脇に置いておいてください。

1. Remote Desktopを使って、管理者としてmemoQ TMSコンピュータにサインインします。(つまり、memoQ TMSプログラムだけでなく、マシン全体の管理者でなければなりません。)
2. Control Panelを開きます。Programs and Featuresを選択します。memoQ TMSを選択します。変更をクリックします。memoQ TMSデプロイメントツールが開きます。
3. DeploymentプログラムのmemoQ TMSセクションで、詳細をクリックし、続いてConfigure custom code executionを選択します。Configure custom code executionウィンドウが表示されます。

   

4. 原則として、ここでは仮想サービスアカウントを選択します。次へをクリックします。Administratorなどのビルトインアカウントは使用しないでください。このアカウントラジオボタンで特定のアカウントを使うことができます。しかし、その他のことに一切に使用しないよう、この設定は非常に気を付ける必要があります。特定のアカウントを使用するのは、場合、またはスクリプトがネットワーク上の別のコンピュータにアクセスする必要がある場合にのみ、特定のアカウントを使用します。
5. デプロイメントツールが、設定が有効かどうかをチェックします。サーバーコンピュータの管理者である必要があります。また、選択したアカウントはサービスとしてログオンできる必要があります。ウィンドウに2つの緑のチェックマークが表示されている場合は、次へをクリックします。エラーがある場合は、戻るをクリックして設定を変更します。
6. デプロイメントツールが、スクリプトとプログラムを実行するためにmemoQ TMSを設定します。これには少し時間がかかる場合があります。Settings have been saved successfullyメッセージが表示されたら、完了をクリックします。
7. memoQ TMSの再起動を促すメッセージが表示されます。OKをクリックします。
8. デプロイメントツールでStop memoQ TMSをクリックします。Start memoQ TMSリンクが表示されたら、Start memoQ TMSをクリックします。
9. デプロイメントツールが、memoQ TMSが再び実行中であることをレポートしたら、これを閉じます。

プログラムには、プロジェクトテンプレートに格納できないファイルが必要かもしれません。こうしたファイルはプロジェクトテンプレートに格納することもできますが、その場合、プロジェクトの進行中に変更したり修正することができません。それをするには、プロジェクトを丸ごと作り直す必要があります。

このため、一部(実際は大半)のプログラムファイルは、プロジェクトテンプレートの外に置く必要があります。

カスタムコード実行を設定すると、サービスユーザーはLog on locallyシステム権限とサーバー上のC:\ProgramData\memoQ Server\Scriptingフォルダの権限を取得します。このフォルダ下に、カスタムまたはScriptsという名前の別のフォルダを作成し、プログラムファイルを配置します。

このようにしておけば、バグ修正などのためにプログラムファイルを置換する必要が生じた場合、このフォルダで行うことができます。既存のプロジェクトは、すぐにその更新されたプログラムファイルを使います。

始める前に、少なくとも次の2つのファイルが必要です：

• プロジェクトで実際の処理を行うメインプログラムファイル。他のファイルが必要な場合もあります。そのファイルをメインプログラムファイルでコピーする必要があります。
• メインプログラムファイルを開始するただ一つのコマンドが書き込まれたバッチファイル。これはプロジェクトテンプレートの中に置くファイルです。

1. メインプログラムファイルをサーバーのサービスユーザーの文書フォルダにコピーします。(例：c:\Users\_svc_mqsinternal\Documents\Scripting) memoQ TMSは、サービスユーザーの名の元でメインプログラムファイルを実行します。
2. バッチファイルがサーバーの正しいフォルダを指していることをチェックします。例えば、バッチファイルには次のコマンドを含めることができます：

   c:\Users\_svc_mqsinternal\Documents\Scripting\C_Converter.exe %1 %2 %3 %4 %5 %6 %7 %8 %9

バッチファイルはC_Converter.exeというプログラムを開始し、最大で9個の引数をこれに渡します。このプログラムは、サーバーのC:\Users\_svc_mqsinternal\Documents\Scriptingフォルダにあるはずです。これはコンピュータ上のフォルダではありません。

実は、このコマンドは自分のバッチファイル内にコピーすることが可能で、他のプログラムを呼び出している場合は、.exeファイルの名前を置換するだけです。このとき、当然フォルダをチェックします。

1. memoQに戻り、同じサーバーに接続し、それからプロジェクトテンプレートを編集します。プロジェクトテンプレートは同じサーバーに存在する必要があります。

   オンラインプロジェクト、オンラインテンプレート：オンラインプロジェクトを作成するときに、決してローカルプロジェクトを使わないでください。テンプレートが同じサーバーに存在することを確認してください。

2. 自動操作を選択します。プロジェクトの自動化タブで、プログラムの実行を開始させるイベントを選択します。選択済みトリガに動作を追加リストの隣にある+記号をクリックします。このトリガに追加する動作を選択ウィンドウでカスタムコードを実行を選択します。追加をクリックします。カスタムコードの詳細を指定ウィンドウが表示されます。

   カスタムコードを実行動作がすでに存在する場合：選択済みトリガに動作を追加でそれを選択します。その隣にある設定アイコンをクリックします。カスタムコードの詳細を指定ウィンドウが表示されます。

3. コードを実行するために必要なファイルを選択で、ファイルを追加をクリックします。メインプログラムを開始するバッチファイルを見つけて開きます。ここにはメインプログラムを追加しないでください。

   スクリプトファイルまたはバッチファイルを置換するには：コードを実行するために必要なファイルを選択リストからファイルを選択します。削除をクリックします。続いてファイルを追加をクリックして新しいファイルを追加します。

4. コードを実行するために必要なファイルを選択リストからバッチファイルを選択します。コマンドとして設定をクリックします。
5. 次にコマンドを設定します。コマンド名は、バッチファイルの名前と同じです。コマンドライン引数にメインプログラムが必要とする引数を入力します。プロジェクト文書を変更している場合は、{入力ファイルパス}と{出力ファイルパス}を追加する必要があります。この場合、プログラムは、MQXLIFF文書を入力ファイルとして取得し、やはりMQXLIFF文書を出力ファイルとして生成する必要があります。

   文書関連のプレースホルダは、このプログラムを開始するイベントが文書に関連する場合に限って意味を持ちます。

プログラムには、他のコマンドライン引数も必要な場合があります。

他のプレースホルダを使えば、プログラムがプロジェクトの識別子や、ソースとターゲット言語を処理することもできます。多くの場合、プログラムはこれらを使って、異なる目的の異なるファイルを分けておくためにフォルダを見つけたり作成したりします。

プレースホルダを挿入するには：プレースホルダの挿入をクリックし、メニューからプレースホルダを選択します。

プレースホルダのリストを確認するには、ここを展開してください。

• 入力ファイルパス：プロジェクト文書の完全なパスと名前。このパスの正体を理解する必要はありません。memoQが自動的に生成するものです。
• 出力ファイルパス：プロジェクトで更新される変換されたプロジェクト文書の完全なパスと名前。このパスの正体を理解する必要はありません。memoQが自動的に生成するものです。
• 割り当て先：作業するために文書を取得するユーザー(翻訳者、レビュー担当者1またはレビュー担当者2)の名前。
• 期限：文書の現在のワークフロー手順(翻訳、レビュー1、レビュー2)の期限。
• 最終期限：文書の最終的なワークフロー手順の期限。これは納品期限です。
• ワークフローステータス：ドキュメントのワークフローステップ (翻訳、レビュー1、レビュー2) およびステータス (開始前、進行中、完了)。
• SrcLangIso2：プロジェクトのソース言語の2文字のコード。
• SrcLangIso3：プロジェクトのソース言語の3文字のコード。
• TrgLangListIso2：プロジェクトのターゲット言語の2文字コードのリスト。
• TrgLangListIso3：プロジェクトのターゲット言語の3文字コードのリスト。
• プロジェクトGUID：プロジェクトのグローバルに一意の識別子。これは長い数字で、同じものが二度使われることはありません。
• 文書GUID：現在の文書のグローバルに一意の識別子。

1. プログラムが実行するまでどのくらい待機したいかを選択します。これは進行中のプロジェクトの一部なので、永遠に時間がかかってはいけません。memoQ TMSがプログラムを終了するまでに待機しなければならない秒数を設定します(プログラムが自発的に終了しない場合)。
2. プログラムで文書を処理および変更する必要がある場合は、スクリプト処理のためMQXLIFFで文書をエクスポートチェックボックスをオンにします。これにより、プログラムを実行する前にドキュメントが保存されます。
3. エクスポートされた文書を変更し、その文書からプロジェクトを更新する必要がある場合：スクリプト出力よりプロジェクト内の文書を更新チェックボックスをオンにします。プログラムが実行された後、memoQは、プロジェクトを変更されたMQXLIFFファイルから更新します。

   プログラムが加える変更は軽微なものだけでなければなりません：プログラムは、MQXLIFF文書の形式を厳格に保持しなければなりません。また、memoQが文書の更新に失敗する恐れがあるため、内容を過剰に追加したり削除することは控えてください。

4. 最後に、スクリプトをテストできます。コマンドのテストを実行をクリックします。カスタムコードの実行 - テスト実行ウィンドウが表示されます。

   

5. プログラムが文書を処理する場合：MQXLIFFの文書をエクスポートします。続いて、テキストボックスに文書のパスと名前を入力または貼り付けるか、または参照をクリックしてコンピュータ上で文書を特定します。OKをクリックします。

   memoQはスクリプトとサンプル文書をサーバーにアップロードしますが、外部プログラムはアップロードしません。memoQは、スクリプトをサーバー上で実行しようとします。

6. テストが終わったら、終了コードとともにテスト結果メッセージが表示されます。プログラムの実行が成功した場合、終了コードは0です。エラーが発生した場合のコードは通常-1ですが、異なる数字の場合もあります。
7. 完了したら、OKをクリックします。

memoQは、イベント発生時に中間スクリプトを自動的に実行します。

例えば、翻訳者の納品が遅れたためにレビューの期限を変更する必要が生じた場合、プログラムが実行されるのは翻訳者が文書を納品したときです。

スクリプトを使うには、プロジェクトテンプレートからプロジェクトを作成し、スクリプトが実行するよう設定されたタイミングまでワークフローを進めます。続いて、期待する変化が実際に起こるかどうかをチェックします。

スクリプト(プログラム全体)は、プロジェクトテンプレートに含めることができます。memoQはこれをフォルダに抽出して実行します。スクリプトに問題があることが見つかるまでは、このように機能します。

このため、問題はプロジェクトテンプレートで修正することができます。しかし、スクリプトを置換するなど、テンプレートの内容を変更した場合にその影響を受けるのは、新しいプロジェクトのみです。既存のプロジェクトに問題がある場合、テンプレートでスクリプトを置換してもそれは変わりません。プログラム全体がテンプレート内に存在する場合は、スクリプトを変更する必要がある場合はプロジェクトを作り直す必要があります。

ベストプラクティスは、メインプログラムのロジックをプロジェクトテンプレートに置かないことです。代わりに、プロジェクトの場所となるコンピュータ、つまりローカルプロジェクトの場合は自分のコンピュータ、オンラインプロジェクトの場合はmemoQ TMS、のフォルダにプログラムをコピーします。

それから、単純なバッチファイルをプロジェクトテンプレートに追加します。バッチファイルのタスクは1つだけです。それは、メインプログラムを実行し、実際のmemoQプロジェクトから引数(ファイル名など)を伝えることです。例として、このトピックの前半で紹介した「オンラインプロジェクトのスクリプトを設定する」を見てみましょう。

プロジェクトの進行中にスクリプトに問題が発生した場合は、次のことを行います：

1. メインプログラムを修正するか、ともに作業する開発者に修正してもらいます。
2. 独立したフォルダにプログラムを置換します。
3. プロジェクトのスクリプトが実行する段階に戻ります。
4. 中間スクリプトを開始するイベントに到達します。このとき、memoQが実行するバッチファイルは以前と同じですが、バッチファイルが呼び出すメインプログラムは修正されたため、実行内容は前回と異なるはずです。

   プロジェクトテンプレートを変更する必要はありません。さらに重要な点は、プロジェクトを作り直す必要がないことです。スクリプトが実行するワークフローの段階に戻るだけです。