UNIFI 1.9.4、または UNIFI 1.9.9 または 1.9.12 を搭載した waters_connect で MSConvert をセットアップする方法 - WKB78812

目的または目標

MSConvert を UNIFI とインターフェースで連結して、MSConvert を使用してデータをエクスポートし、さまざまな形式に変換できるようにする。

環境

• UNIFI 1.9.4  (WebAPI 1.3)
• UNIFI 1.9.9 (PublicAPI 1.8)
• UNIFI 1.9.12 を搭載した waters_connect (PublicAPI 1.9)
• Proteowizard MSConvert

手順

注：この手順は、UNIFI 1.9.13 および PublicAPI 1.10 を搭載した waters_connect または waters_connect のその他の最新リリースに適用できません。waters_connect の他のバージョンについては、特定の記事が存在します。関連するリリースノートの説明に従って、インストールされている UNIFI のバージョンに適した UNIFI APIバージョンをインストールします。

1. Proteowizard MSConvert をインストールします。
   • インストーラーは、Sourceforge からダウンロードできます。
2. Windows 10 の検索オプションで、「PC 情報」と入力し、「PC 情報」を開いて、PC 名をメモします。
   • これはステップ 17 の MY_PC_NAME です。
   • サーバーシステムでは、API はサーバーにインストールされます。その場合、この時点でサーバーの完全修飾ドメイン名を見つけて、後の手順で「MY-PC-NAME」と表示されている箇所に使用する必要があります。
3. UNIFI を開き、管理者アカウントでログインします。
4. UNIFI［管理］で、［外部アプリケーションセキュリティの設定］を選択します。
5. UNIFI の管理者ロールで Waters UNIFI クライアント登録アプリケーションにログインします。
6. 「新規クライアント」をクリックします。
7. ［クライアント名］フィールドで、resourceownerclient を指定します。
8. ［クライアント ID］フィールドで、resourceownerclient を指定します。
9. ［OAuth 2.0 フロー］フィールドで、ドロップダウンオプションから ResourceOwner を選択します。
10. ［作成］ボタンをクリックします。
11. 前のステップで作成した resourceownerclient の横にある［クライアントの編集］ボタンをクリックします。
12. ［プロパティ］を選択し、［アクセストークンの有効期間］および［更新］を86400に設定し、有効チェックボックスを選択します。
    
13.  ［シークレット］をクリックし、［クライアントハッシュ］を SHA-512 に設定して、値フィールドに「secret」と入力し、［クライアントのシークレットの追加］ボックスの横にある追加ボタンをクリックします。
    • 
14. UNIFI ワークステーションで Windows の［スタート］メニューのアイコンをクリックして、MSConvert アプリケーションを起動します。
15. 「ネットワークリソースを開く」で「UNIFI」を選択します。これにより、MS Convert UNIFI ブラウザーが開きます。

16. ［MSConvert UNIFI］ブラウザーインターフェースの［Server location］（サーバーの場所）フィールドに「http://MY_PC_NAME:50034/unifi/v1」と入力します。

    • ヒント：MY_PC_NAME はステップ 3 で得られました。

    • ヒント：MSConvert と UNIFI が同じ PC にある場合、MY_PC_NAME の代わりに localhost を使用できます。

    • 注：API のインストール中に TLS が有効になった場合は、場所フィールドに https を使用します（例：https://MY_PC_NAME:50034/unifi/v1）。

17. ［Connect］（接続）を押します。

18. ［Log in to UNIFI Server］（UNIFI サーバーへのログイン）ポップアップウィンドウで、UNIFI 管理者アカウントのユーザー名とパスワードを指定します（デフォルトでは、両方とも「administrator」になっています）。

19. MSConvert のバージョンに［Show advanced options］（詳細設定オプションを表示する）チェックボックスがある場合：

    • そのチェックボックスを選択します。

    • API1.3 (UNIFI 1.9.4)、API 1.8 (UNIFI 1.9.9) または API 1.9 (UNIFI 1.9.12) を使用している場合は、識別サーバーのフィールドに、以下の通り次を入力します：http://MY_PC_NAME:50333、または https://localhost:50333。

• 注：MSConvert の最近のバージョン（3.0.22 以降）では、ステップ 17 で指定した内容に基づいて、詳細設定オプションが自動表示されることがあります。詳細設定オプションを開くと、以下のように表示される場合、詳細設定オプションのみを使用でき、UNIFI のユーザー名とパスワードを指定するだけです。

21. ［OK］を押します。UNIFI データベースとの接続が確立されます。

22. MSConvert UNIFI ブラウザーでの作業を完了したら、画面の右上の［Disconnect］（切断）ボタンをクリックします。

    • これにより、管理者をログアウトします。

    • この後のユーザーは、自分の UNIFI アカウント名とパスワードを使用してログインし、［Disconnect］（切断）ボタンを押してログアウトする必要があります。これにより、UNIFI は各ユーザーの MSConvert ブラウザーを介した UNIFI データベースへのアクセスを記録できます。新しいユーザーがログインするたびに、詳細設定オプションで Identity Server のアドレスを再入力する必要がある場合があります。

追加情報

MSConvert UNIFI ブラウザーにログインする各ユーザーは、UNIFI でアクセスできるフォルダーおよびプロジェクトのサブセットにのみアクセスできます。

すべての MSConvert ユーザーが UNIFI 管理者アカウントまたは他のユーザーのアカウントを使用してログインすることを許可しないでください。すべての MSConvert UNIFI ブラウザーユーザーが、セッションの終わりに［Disconnect］（切断）ボタンを使用してログアウトすることを確認します。