MATLAB Production Server の Excel 統合に対応したデプロイ可能なアーカイブの作成とインストール

サポートされるプラットフォーム: Microsoft® Windows® のみ。

この例では、MATLAB® 関数を使用して Excel® 統合に対応したデプロイ可能なアーカイブを作成する方法を説明します。その後、生成されたアーカイブを MATLAB Production Server™ にデプロイできます。

前提条件

MATLAB Compiler SDK™ で MATLAB Production Server 用の Excel アドインをビルドするには、.NET framework 4.0 以降が必要です。

Excel アドイン ファイル (.xla) を生成するには、Excel で [VBA プロジェクト オブジェクト モデルへのアクセスを信頼する] を有効にします。これを行わない場合、.bas ファイルを Excel にインポートすることでアドインを手動で作成できます。

MATLAB での関数の作成

MATLAB で、パッケージ化する MATLAB プログラムを調べます。

この例では、次のように関数 mymagic.m を記述します。

function y = mymagic(x)

y = magic(x);

MATLAB コマンド プロンプトで、mymagic(3) と入力して関数の出力を確認します。

 ans =
     8     1     6
     3     5     7
     4     9     2

compiler.build.excelClientForProductionServer を使用した Excel 統合に対応するデプロイ可能なアーカイブの作成

プログラムによる方法を使用して、Excel 統合に対応するデプロイ可能なアーカイブを作成します。

  1. mymagic.m を使用して Production Server アーカイブを作成し、ビルド結果を compiler.build.Results オブジェクトに保存します。

    buildResults = compiler.build.productionServerArchive('mymagic.m');

  2. 関数 compiler.build.excelClientForProductionServer を使用して、Excel 統合に対応するデプロイ可能なアーカイブをビルドします。

    mpsxlResults = compiler.build.excelClientForProductionServer(buildResults, ...
'Verbose','on');

    compiler.build コマンドで名前と値の引数を使用して、追加オプションを指定できます。詳細については、compiler.build.excelClientForProductionServer を参照してください。

    compiler.build.Results オブジェクト buildResults には、ビルド タイプ、生成ファイル、含まれるサポート パッケージ、およびビルド オプションに関する情報が含まれています。

    この関数により、現在の作業ディレクトリにある mymagicexcelClientForProductionServer という名前のフォルダーに以下のファイルが生成されます。

    • includedSupportPackages.txt — アセンブリに含まれるすべてのサポート ファイルをリストしたテキスト ファイル。

    • mymagic.bas — VBA プロジェクトにインポートできる VBA モジュール ファイル。

    • mymagic.dll — Excel アドインに必要なダイナミック ライブラリ。

    • mymagic.reg — 未解決のシンボルに関する情報が含まれるテキスト ファイル。

    • mymagic.xla — Excel に直接インストールできる Excel アドイン。

    • mymagicClass.cs — 未解決のシンボルに関する情報が含まれるテキスト ファイル。

    • mccExcludedFiles.log — アプリケーションに含まれていないすべてのツールボックス関数のリストが含まれるログ ファイル。サポートされていない関数の詳細については、MATLAB Compiler の制限を参照してください。

    • readme.txt — パッケージ化およびデプロイの情報が含まれるテキスト ファイル。

    • requiredMCRProducts.txt — MATLAB Runtime がアプリケーションを実行するために必要な製品の製品 ID が含まれるテキスト ファイル。

    メモ

    生成された Excel アドインには MATLAB Runtime またはインストーラーが含まれていません。buildResults オブジェクトを使用してインストーラーを作成するには、compiler.package.excelClientForProductionServer を参照してください。

mcc を使用した Excel 統合に対応するデプロイ可能なアーカイブの作成

compiler.build.excelClientForProductionServer の代わりに次のコマンドを実行することで、mcc 関数を使用してデプロイ可能なアーカイブを作成することもできます。

  1. mcc -W CTF:mymagic -U -d '[Target server directory]' -v [directory containing mymagic.m] 

  2. mcc -W 'mpsxl:mymagic,Class1,version=1.0' -b -d '[Target client directory]' -v [Location of mymagic.m] class{Class1:[location of mymagic.m]}

    メモ

    生成された Excel アドインには MATLAB Runtime またはインストーラーが含まれていません。インストーラーを作成するには、compiler.package.excelClientForProductionServer を参照してください。

Excel 統合に対応したデプロイ可能なアーカイブのサーバーへのインストール

Excel でアドインを使用するには、その前にアーカイブを MATLAB Production Server インスタンスにデプロイしなければなりません。

デプロイ可能なアーカイブをサーバー インスタンスにインストールするには、次を行います。

  1. デプロイ可能なアーカイブ (CTF ファイル) を見つけます。compiler.build.productionServerArchive 関数を使用した場合は mymagicproductionServerArchive フォルダーにあります。mcc を使用した場合、ファイルは作業フォルダーにあります。

    この例でのファイル名は mymagic.ctf です。

  2. アーカイブ ファイルをサーバー インスタンスの auto_deploy フォルダーにコピーします。サーバー インスタンスがこれを自動的にデプロイし、対象のクライアントからの使用を可能にします。

Excel アドインのクライアントへのインストール

  1. compiler.build.productionServerArchive を使用した場合は、結果に対して compiler.package.excelClientForProductionServer を実行してインストーラーを生成します。mymagicinstaller フォルダーに生成されます。ここでは MyAppInstaller.exe という名前です。

  2. インストーラーを開き、その指示に従います。

    クライアントにインストールされるファイルには以下が含まれます。

    • mymagic.bas

    • mymagic.dll

    • mymagic.xla

    • readme.txt

    • ServerConfig.dll

詳細については、MATLAB Production Serverを参照してください。

参考

|