基本のライブラリを作成する

次のチュートリアルでは、Studio でライブラリを作成し、他のオートメーションプロジェクトでパブリッシュして使用する手順を説明します。

ライブラリの作成は、「基本のプロセスを作成する」に類似しています。違いは、パッケージは、他のプロジェクトのコンテキストで使用される再利用可能なコンポーネントを作成するためのものです。

この例では、Excel スプレッドシートからデータを取得し、別の Excel ファイルに追加します。次に、プロジェクトをパッケージ化してカスタムフィードにパブリッシュし、パッケージを別のプロジェクトにインストールし、そこに含まれるアクティビティを使用する手順について説明します。

この例では、Microsoft Excel をマシンにインストールする必要がない Excel アクティビティを使用しています。

それでは始めましょう。

ライブラリを作成する

Studio を起動します。[ホーム] の Backstage ビューで、新しいライブラリプロジェクトを作成する [ライブラリ] をクリックします。[新しい空のライブラリ] ウィンドウが表示されます。
[新しい空のライブラリ] ウィンドウで、以下を実行します。
- 新しいプロジェクトの名前とこのオートメーションの目的を要約した説明を入力します。この例の場合、QuickLibrary という名前を使用できます。
  注: プロジェクト名は最大 128 文字、説明は最大 500 文字です。
- プロジェクトを作成する場所を選択します。
- [対応 OS] オプションには [Windows - レガシ] を選択し、[言語] には [VB] を選択します。
[作成] をクリックします。新しいライブラリが Studio で開きます。

Excel アクティビティを追加する

[アクティビティ] パネルで、[システム] > [ファイル] > [ワークブック] の下の [範囲を読み込み] アクティビティを検索し、デザイナー パネルにドロップします。
- [ブックパス] フィールドで、データを取得する Excel ファイルへのパスを追加します。
- [シート名] フィールドにスプレッドシートの名前を追加します。この例では、名前は既定の Sheet1 のままです。
- [範囲] フィールドに読み取るセルの範囲を追加します。この例では、すべてのセルが読み取られるように、フィールドを空のままにします。
[範囲を読み込み] アクティビティの [プロパティ] パネルで、DataTable の横のフィールドをクリックし、Ctrl + K キーボードショートカットを使用して変数フィールドを開き、名前 GetRange を追加します。DataTable 型の変数には、読み取られたセルからのデータが格納されます。
[アクティビティ] パネルで、[システム] > [ファイル] > [ワークブック] の下の [範囲を追加] アクティビティを検索します。[範囲を読み込み] アクティビティの下に追加します。
- [ブックパス] で、コピーしたデータを追加するファイルへのパスを追加します。
- [シート名] でシートの名前を追加します。この例では、既定の Sheet のままにします。
- [データテーブル] フィールドで、情報を格納する、以前に作成した変数 GetRange を追加します。プロジェクトは次の図のようになります。
リボンで [ファイルを実行] をクリックするか、Ctrl + F6 キーを押してワークフローを実行します。1 番目の Excel スプレッドシートから収集されたデータが、別のスプレッドシートに追加されます。2 番目のスプレッドシートに既に存在するデータは置き換えられません。

ライブラリをパッケージ化する

このライブラリを再利用可能なコンポーネントとして他のオートメーションプロジェクトに追加するには、プロジェクトをパブリッシュして、ライブラリを .nupkg ファイルとしてパッケージ化する必要があります。

ライブラリプロジェクトを Studio で開きます。
リボンで [パブリッシュ] ボタンをクリックします。[ライブラリをパブリッシュ] ウィンドウが開きます。
- [パッケージのプロパティ] タブで、パッケージ名を入力します。[リリースノート] フィールドで、ライブラリに関する詳細を数か所追加します。これは、新たにパブリッシュされた各バージョンで、ライブラリに加えられた変更を追跡する場合に役立ちます。
- [パブリッシュのオプション] タブで、[パブリッシュ先] > [カスタム] の順に選択し、[カスタム URL] フィールドにローカルフォルダーへのパスを追加します。たとえば、デスクトップに myfeed フォルダーを作成できます。
[パブリッシュ] をクリックします。パッケージがローカルフォルダーで .nupkg ファイルとして利用可能になります。

再利用可能なコンポーネントをインストールする

別のプロジェクトでパッケージを使用するには、最初にこのパッケージをプロジェクトの依存関係として追加する必要があります。「基本のプロセスを作成する」で説明しているように、開始するには Studioで新しいプロセスを作成します。

詳細については、「依存関係について」ページのプロジェクトの依存関係についてをご覧ください。

カスタムフィードを追加する

Studio リボンで、[パッケージを管理] > [設定] をクリックします。既定のフィードとユーザー定義のフィードが表示されます。
[ユーザー定義のパッケージソース] コンテナーで、[名前] フィールドにフィードの名前を追加します。[ソース] フィールドにライブラリをパブリッシュしたフォルダーへのパスを追加します。
[追加] をクリックします。新しいフィードがセクションに追加されます。

Studio でユーザーが定義したフィードを追加または削除する場合は、常に上記の手順に従う必要があります。アクティビティフィードの詳細については、「アクティビティパッケージについて」をご覧ください。

パッケージをインストールする

[パッケージを管理] ウィンドウで、左側の [すべてのパッケージ] タブの下に以前に追加されたフィードに移動します。フィードで利用可能なパッケージのリストが表示されます。
パッケージを検索して選択します。この例のパッケージ名は QuickLibrary です。
[インストール]、[保存] の順にクリックします。これにより、パッケージがプロジェクトにインストールされ、[依存関係] の下の [プロジェクト] パネルに表示されます。