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 (MATLAB Compiler SDK) を参照してください。

    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 の制限 (MATLAB Compiler)を参照してください。

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

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

    メモ

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

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 (MATLAB Compiler SDK) を参照してください。

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 (MATLAB Compiler SDK) を実行してインストーラーを生成します。mymagicinstaller フォルダーに生成されます。ここでは MyAppInstaller.exe という名前です。

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

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

    • mymagic.bas

    • mymagic.dll

    • mymagic.xla

    • readme.txt

    • ServerConfig.dll

参考

(MATLAB Compiler SDK) | (MATLAB Compiler)