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

The following tutorial walks you through the steps of creating a library in Studio, publishing and using it in other automation projects.

Creating a library is similar to Creating a Basic Process. The difference is packages are for creating reusable components to be used in the context of other projects.

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

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

それでは始めましょう。

ライブラリを作成する

1. Studio を起動します。[ホーム] の Backstage ビューで、新しいライブラリ プロジェクトを作成する [ライブラリ] をクリックします。[新しい空のライブラリ] ウィンドウが表示されます。

   

2. [新しい空のライブラリ] ウィンドウで、以下を実行します。

   • 新しいプロジェクトの名前とこのオートメーションの目的を要約した説明を入力します。この例の場合、QuickLibrary という名前を使用できます。

     注:

     プロジェクト名は 128 文字、説明は 500 文字以内です。

   • プロジェクトを作成する場所を選択します。

   • Select Windows - Legacy for the Compatibility option and VB for Language.

3. [作成] をクリックします。新しいライブラリが Studio で開きます。

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

1. In the Activities panel, search for the Read Range activity under System > File > Workbook, and drop it to the Designer panel.

   • [ブック パス] フィールドで、データを取得する Excel ファイルへのパスを追加します。
   • [シート名] フィールドにスプレッドシートの名前を追加します。この例では、名前は既定の Sheet1 のままです。
   • [範囲] フィールドに読み取るセルの範囲を追加します。この例では、すべてのセルが読み取られるように、フィールドを空のままにします。

2. [範囲を読み込み] アクティビティの [プロパティ] パネルで、DataTable の横のフィールドをクリックし、Ctrl + K キーボード ショートカットを使用して変数フィールドを開き、名前 GetRange を追加します。DataTable 型の変数には、読み取られたセルからのデータが格納されます。

   

   

3. In the Activities panel, search for the Append Range activity under System > File > Workbook. Add it below the Read Range activity.

   • [ブック パス] で、コピーしたデータを追加するファイルへのパスを追加します。

   • [シート名] でシートの名前を追加します。この例では、既定の Sheet のままにします。

   • [データ テーブル] フィールドで、情報を格納する、以前に作成した変数 GetRange を追加します。プロジェクトは以下の画像のようになります。

     

4. リボンで [ファイルを実行] をクリックするか、Ctrl + F6 キーを押してワークフローを実行します。1 番目の Excel スプレッドシートから収集されたデータが、別のスプレッドシートに追加されます。2 番目のスプレッドシートに既に存在するデータは置き換えられません。

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

To add this library as a reusable component to other automation projects, you need to package it as a .nupkg file by publishing the project.

1. ライブラリ プロジェクトを Studio で開きます。

2. リボンで [パブリッシュ] ボタンをクリックします。[ライブラリをパブリッシュ] ウィンドウが開きます。

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

3. [パブリッシュ] をクリックします。パッケージがローカル フォルダーで .nupkg ファイルとして利用可能になります。

   

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

To use the package in another project, you first need to add it as a project dependency. To get started, create a new Process in Studio, as explained in the Creating a Basic Process page.

Read more about project dependencies in the About Dependencies page.

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

1. Studio リボンで、[パッケージを管理] > [設定] をクリックします。既定のフィードとユーザー定義のフィードが表示されます。

2. [ユーザー定義のパッケージ ソース] コンテナーで、[名前] フィールドにフィードの名前を追加します。[ソース] フィールドにライブラリをパブリッシュしたフォルダーへのパスを追加します。

3. [追加] をクリックします。新しいフィードがセクションに追加されます。

   

You need to follow the above steps whenever you want to add or remove a user-defined feed in Studio. Check out the About Activities Packages to read more information about activities feeds.

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

1. [パッケージを管理] ウィンドウで、左側の [すべてのパッケージ] タブの下に以前に追加されたフィードに移動します。フィードで利用可能なパッケージのリストが表示されます。

2. パッケージを検索して選択します。この例のパッケージ名は QuickLibrary です。

3. [インストール]、[保存] の順にクリックします。これにより、パッケージがプロジェクトにインストールされ、[依存関係] の下の [プロジェクト] パネルに表示されます。

   

ライブラリのアクティビティを追加する

1. [アクティビティ] パネルで、パッケージの名前 (この場合はQuick Library) を検索します。

2. デザイナー パネルにアクティビティをドロップします。

3. Studio のリボンで [ファイルを実行] をクリックするか、Ctrl + F6 ショートカット キーを押してアクティビティを実行します。

   

[ シートをコピー ] または [ 範囲をオートフィル] などの他のアクティビティを追加するには、マシンに Microsoft Excel をインストールする必要があります。

再利用可能なコンポーネントのメリットは、繰り返しを減らすことです。一度作成して、他のプロジェクトで再利用します。

上記で作成したライブラリをダウンロードするには、以下のボタンをクリックします。

サンプルをダウンロードする