B1X1-0203-07Z0(00)2016年11月

Windows

FUJITSU SoftwareInterstage List Creator V10.5.0

SQL Server Integration Services連携機能編

まえがき

本書は、List Creatorが提供するMicrosoft SQL Server Integration Services連携機能のセットアップ方法、使用方法、エラーメッセージ

などについて説明しています。

本書の構成

本書は、次の構成になっています。

第1章 SSIS連携機能とは

SSIS連携機能の概要について説明します。

第2章 SSIS連携機能を使用するための準備

SSIS連携機能を使用するために必要なソフトウェアのインストールとセットアップについて説明します。

第3章 SSIS連携機能の基本的な使い方

SSIS連携機能の基本的な使い方の例を説明します。

第4章 SSIS連携機能の詳細

SSIS連携機能の詳細を説明します。

第5章 エラーメッセージ

SSIS連携機能で通知されるエラーメッセージの原因と対処方法について説明します。

第6章 運用上の注意

SSIS連携機能の使用上の注意について説明します。

輸出管理規制について

本ドキュメントを輸出または第三者へ提供する場合は、お客様が居住する国および米国輸出管理関連法規等の規制をご確認のうえ、

必要な手続きをおとりください。

著作権

Microsoft Corporationのガイドラインに従って画面写真を使用しています。

Copyright 2012-2016 FUJITSU LIMITED

- i -

マニュアルの体系と読み方

本書をお読みになる前に、オンラインマニュアル“マニュアル体系と読み方”をお読みください。

オンラインマニュアル“マニュアル体系と読み方”には、List Creatorのマニュアル体系、マニュアルの読み方、表記上の規則、対象読

者と前提知識、用語の対応表、および商標などについて記載されています。

- ii -

目　次

第1章 SSIS連携機能とは.......................................................................................................................................................... 11.1 機能概要............................................................................................................................................................................................. 11.2 システム構成....................................................................................................................................................................................... 2

第2章 SSIS連携機能を使用するための準備.............................................................................................................................. 32.1 必須ソフトウェアのインストール...........................................................................................................................................................3

2.1.1 SQL Serverのインストール............................................................................................................................................................32.1.2 List Creatorのインストール........................................................................................................................................................... 32.1.3 SSIS連携機能モジュールのインストール.................................................................................................................................... 3

2.2 開発環境のセットアップ...................................................................................................................................................................... 32.2.1 ツールボックスへアイテムを追加................................................................................................................................................. 3

第3章 SSIS連携機能の基本的な使い方.................................................................................................................................... 53.1 サンプルデータの準備........................................................................................................................................................................53.2 サンプル帳票の修正...........................................................................................................................................................................53.3 SSISパッケージの作成および実行.....................................................................................................................................................7

第4章 SSIS連携機能の詳細....................................................................................................................................................144.1 帳票出力までの流れ.........................................................................................................................................................................144.2 ［List Creator変換先］アイテムのプロパティ......................................................................................................................................154.3 帳票資源の準備と配置.....................................................................................................................................................................15

第5章 エラーメッセージ.............................................................................................................................................................175.1 エラーメッセージの出力先および形式.............................................................................................................................................17

第6章 運用上の注意................................................................................................................................................................226.1 注意事項........................................................................................................................................................................................... 226.2 サポート範囲......................................................................................................................................................................................22

- iii -

第1章 SSIS連携機能とは

SSIS連携機能の概要について説明します。

1.1 機能概要

SSISは、データウェアハウジング対応のETL（抽出、変換、読み込み）パッケージを含む、高いパフォーマンスデータ統合ソリューショ

ンを構築するためのプラットフォームです。SSISパッケージに、業務システムから必要とされるデータを抽出/変換し、変換先アダプター

に変換結果をロードする定義を行い、実行することができます。

List CreatorのSSIS連携機能は、SSISにList Creator データ変換先を提供します。これにより、プログラミングレスでデータベースから

データを抽出してList Creatorにデータを入力し、帳票出力を可能にします。SSISパッケージの定義時に、変換先アダプターとしてListCreatorを選択することにより、GUIによるデータ抽出、加工、帳票出力を定義/実行することができます。

図1.1 SQL Server Integration Services連携機能概要

図1.2 SQL Server Business Intelligence Development Studio画面

- 1 -

1.2 システム構成

システム構成には以下の2つがあります。

・ SQL ServerとList Creatorを同じサーバにインストールするスタンドアロン型構成（図1.3）

・ SQL ServerとList Creatorを別々のサーバにインストールするコネクタ連携型構成（図1.4）

SQL ServerとList Creatorを別々の環境にインストールする場合は、データベースサーバにList Creator Connectorをインストールし、サー

バ間を接続します。

図1.3 SQL Serverと同一サーバでデータベースと帳票出力を運用

図1.4 SQL Serverと別サーバでデータベースと帳票出力を運用

- 2 -

第2章 SSIS連携機能を使用するための準備

SSIS連携機能を使用するために必要なソフトウェアのインストールとセットアップについて説明します。SSIS連携機能を使用するため

には必須ソフトウェアのインストールおよび開発環境のセットアップが必要です。SSIS連携機能を使用するためにList Creator実行環境

の特別なセットアップはありません。

2.1 必須ソフトウェアのインストール

2.1.1 SQL Serverのインストール

開発環境にはDevelopment Studioが必要です。

実行環境にはSSISコンポーネントが必要です。

SQL Serverのインストールについては、SQL Serverのドキュメントを参照してください。

2.1.2 List Creatorのインストール

開発環境にはList Creator Standard Edition、List Creator Enterprise Edition、List Creator デザイナ、List Creator Connectorのいずれか

が必要です。

実行環境にはList Creator Standard Edition、List Creator Enterprise Edition、List Creator Connectorのいずれかが必要です。

List Creatorのインストールについては、ソフトウェア説明書を参照してください。

2.1.3 SSIS連携機能モジュールのインストール

開発環境および実行環境にList Creatorが提供するSSIS連携機能モジュールが必要です。

インストール手順は、ソフトウェア説明書を参照してください。

インストール対象 開発環境 実行環境

SSISコンポーネント － ◎

Development Studio ◎ －

List Creator Standard Edition ○ ○

List Creator Enterprise Edition ○ ○

List Creator デザイナ ○ －

List Creator Connector ○ ○

List Creator SSIS連携モジュール ◎ ◎

2.2 開発環境のセットアップ

2.2.1 ツールボックスへアイテムを追加

Development Studioのツールボックスに［List Creator変換先］アイテムを追加する必要があります。追加方法を説明します。

1. Development Studioのプルダウンメニュー［ツール］の［ツールボックスアイテムの選択］を選択します。

⇒ツールボックスアイテムの選択ダイアログボックスが表示されます。

2. ［SSISデータフロー項目］タブを選択します。

⇒SSISデータフロー項目一覧が表示されます。

- 3 -

3. 名前欄の［List Creator変換先］にチェックを付け、［OK］ボタンをクリックします。

4. ［データフロー］タブのデザイナ画面を表示し、ツールボックスのデータフロー変換先の中に［List Creator変換先］が表示されて

いることを確認します。

- 4 -

第3章 SSIS連携機能の基本的な使い方

サンプル帳票を使用して、SSIS連携機能の基本的な使い方を説明します。

SQL Server 2005/SQL Server 2008とList Creator デザイナが同一サーバにインストールおよびセットアップされていることを前提に説明

します。

1. サンプルデータの準備

2. サンプル帳票の修正

3. SSISパッケージの作成および実行

必要な環境

3.1 サンプルデータの準備

サンプルデータファイル「data.txt」をテキストエディタなどで作成します。

「data.txt」の記述例を以下に示します。

郵便番号,郵便,住所1,住所2,得意先,売上日,伝票番号,担コード,明細番号,商品コード,商品名,数,価格,バー

0000000,川崎市中原区,上小田中X-X-X,△△△電気,20070308,03101,005,0020,カラーテレビ,3,120000,1234567890

0000000,川崎市中原区,上小田中X-X-X,△△△電気,20070308,03101,005,0022,カラオケセット,1,82000,1234567890

3.2 サンプル帳票の修正

List Creator デザイナのサンプル帳票“売上伝票”の入力ファイル形式をCSV形式とし、出力先をPDFにした帳票定義情報“売上伝票

a”を作成します。

- 5 -

=操作手順=

1. 入力データ形式をCSV形式にします。

［売上伝票］を開き、データ定義画面の［環境定義］タブで入力データ形式をCSV形式に変更し、［売上伝票a］として保存しま

す。

- 6 -

2. 出力先をPDFファイルにします。

帳票定義一覧の［売上伝票a］のプロパティで［印刷］－［印刷する］のチェックを外します。次に［ファイル］－［ファイルを保存す

る］をチェックし、「格納先ファイル名」を指定します。

3.3 SSISパッケージの作成および実行

フラットファイルからデータを取り出し、List Creatorを呼び出して帳票を出力するSSISパッケージを作成、実行します。

=操作手順=

1. Integration Servicesプロジェクトを新規に作成し、以下のように［フラットファイルソース］と［List Creator変換先］を配置し関連付け

ます。

- 7 -

2. SSISパッケージ名をLCPKG1.dtsxに変更し、フラットファイルソースを右クリックし［編集］を選択します。

- 8 -

3. ファイル名は“3.1 サンプルデータの準備”で準備したデータファイル名を設定します。

［先頭データ行を列名として使用する］をチェックします。

［プレビュー］ページでデータを確認し、［OK］ボタンをクリックします。

- 9 -

4. ［List Creator変換先］を右クリックし［編集］を選択します。

以下のようにコンポーネントのプロパティでCommandType、FormDirectory、FormStyleを設定します。

- 10 -

5. 列マッピングで明細番号を除いてすべてマッピングを行い［OK］ボタンをクリックします。

- 11 -

6. ［ビルド］メニューから［Project1のビルド］を選択します。

7. コマンド プロンプトでSSISパッケージファイルが保存されているディレクトリに移動し、以下のようにSSISパッケージ実行コマンド

を実行します。

>dtexec /f LCPKG1.dtsx

LCPKG1.dtsxのプロパティに表示されている［完全なパス］にパッケージファイルが保存されています。

- 12 -

SSISパッケージファイルを実行すると以下のようなPDFファイルが作成されます。

［売上伝票a］のプロパティで設定したファイルの格納先に以下のようなPDFファイルが作成されます。

- 13 -

第4章 SSIS連携機能の詳細

ここでは、SSIS連携機能の詳細を説明します。

4.1 帳票出力までの流れ

SSIS連携機能を使用し帳票出力する操作の流れを以下に示します。

図4.1 帳票出力までの流れ

1. データソースを準備する。

SSISは以下のようなデータソースを扱えます。

最適なデータソースを選び入力データを準備します。

－ Excelソース

－ OLE DBソース

－ フラットファイルソース

2. 帳票定義情報を準備する。

入力データをどのような帳票に出力するのか決めておく必要があります。

その帳票定義情報をList Creator デザイナで作成しておきます。

3. Development StudioでSSISパッケージを作成する。

SSISパッケージデザイナ上に前述の“1. データソースを準備する。”で設計したデータソースと、［List Creator変換先］アイテムを

配置し関連付けます。また、データソースは必要に応じて各種のデータフロー変換で加工します。SSISパッケージデザイナ上に

配置した［List Creator変換先］アイテムのプロパティを設定します。

［List Creator変換先］アイテムのプロパティを設定については“4.2 ［List Creator変換先］アイテムのプロパティ”を参照してくださ

い。

4. SSISパッケージを実行環境に配置する。

SSISパッケージを配置する前にプロジェクトのビルドまたはリビルトを実行し、SSISパッケージを最新状態にします。ソリューショ

ンエクスプローラを使ってSSISパッケージを実行環境に配置します。SSISパッケージの配置方法はSQL Serverに添付のドキュメ

ントなどを参照してください。

次にList Creatorの帳票資源を配置します。帳票資源の配置については“4.3 帳票資源の準備と配置”を参照してください。

- 14 -

5. SSISパッケージを実行する。

SSISパッケージを実行する方法は以下の方法があります。SSISパッケージの実行方法についてはSQL Serverに添付のドキュメ

ントなどを参照してください。

－ dtexecコマンド プロンプト ユーティリティ

－ dtexecuiユーティリティ

－ SQL Serverエージェントジョブ

4.2 ［List Creator変換先］アイテムのプロパティ

［List Creator変換先］アイテムのプロパティの詳細

［List Creator変換先］アイテムのプロパティの詳細を説明します。

CommandType

List Creatorのシステム構成に合わせて選択します。

SQL Serverと同一サーバで帳票出力サーバを運用する場合は“prprint”を設定します。

SQL Serverと別サーバで帳票出力サーバを運用する場合は“prputex”を設定します。

FormDirectory

帳票定義情報の保管フォルダを設定します。

FormStyle

使用する帳票定義情報名をリストから選択します。

Option1

CommandTypeで設定したコマンドのオプションを必要に応じて設定します。

コマンドオプションの詳細についてはオンラインマニュアル“アプリケーション作成ガイド”を参照してください。

Option2

CommandTypeで設定したコマンドのオプションを必要に応じて設定します。

コマンドオプションの詳細については、オンラインマニュアル“アプリケーション作成ガイド”を参照してください。

補足 Option1とOption2の使い方

SSISパッケージ実行時にパラメタを設定することで、プロパティの内容を変更できます。Option1にList Creatorの出力方法などあまり変

更しないコマンドオプション、Option2に出力ファイル名など実行時に変更したいパラメータを記載することで、SSISパッケージを実行

するコマンド文字列を短くできます。SSISパッケージの実行方法についてはSQL Serverに添付のドキュメントなどを参照してください。

コマンドパラメタでPDFファイル名を変更する例

［List Creator変換先］のプロパティでOption1に-keeppdf、Option2に出力するPDFファイル名を設定している場合について、コマンド プロンプトでのSSISパッケージ実行時にList Creatorが出力するPDFファイル名を変更する例を示します。

例:dtexecコマンドでのSSISパッケージ実行時にOption2のPDFファイル名を指定する場合

>dtexec /f c:\LCPKG1.dtsx /set "\Package\データ フロー タスク.Properties[[List Creator 変換先].[Option2]]";伝票b.pdf

4.3 帳票資源の準備と配置

SSIS連携機能は、スタンドアロン型、コネクタ連携型の運用形態で利用できます。設計した帳票や帳票の出力時に必要なその他の資

源を、動作方法に応じてアプリケーションサーバまたは帳票出力サーバに配置します。

準備する資源は以下のとおりです。資源の配置方法については、オンラインマニュアル“環境設定・帳票運用編”を参照してください。

- 15 -

・ 帳票定義情報

・ メディアデータファイル（使用する場合のみ）

・ 情報ファイル（使用する場合のみ）

－ 置換フォント情報ファイル

－ バーコード補正情報ファイル

－ 帳票出力情報ファイル

－ 電子帳票情報ファイル

－ 電子保存時のFAX受信者情報ファイル

－ FAX送信時のFAX受信者情報ファイル

－ PDFメール配信情報ファイル

－ PDF文書情報ファイル

－ Excel文書情報ファイル

・ PDFファイルに添付するファイル（使用する場合のみ）

・ PDFメール配信時のメールに添付するファイル（使用する場合のみ）

・ PDFメール配信時に使用するメールのテンプレートファイル（使用する場合のみ）

注意

コネクタ連携型で運用する場合、帳票定義情報はアプリケーションサーバに配置してください。

- 16 -

第5章 エラーメッセージ

SSIS連携機能で通知されるエラーメッセージの原因と対処方法について説明します。

5.1 エラーメッセージの出力先および形式

List Creatorの詳細なエラーメッセージはイベントログに出力されます。

また、SSISのエラーメッセージの出力先は、SSISのログ記録で設定することができます。

List Creatorの実行環境の違い

List Creatorの実行環境の違いによって以下のように出力先が異なります。

・ 帳票出力サーバでアプリケーションを実行する場合

帳票出力サーバのイベントログにエラーメッセージが出力されます。

・ List Creator Connector連携する場合

アプリケーションサーバのイベントログにエラーメッセージが出力されます。

SSISのログ記録の設定

エラーメッセージはSSISのログ記録を有効にすることで出力先や内容を設定することができます。

以下のようにSSISログの構成ダイアログボックスで設定します。

- 17 -

ログの出力先には、例えば以下があります。

・ テキストファイルのSSISログプロバイダ

指定されたテキストファイルにCSV形式でログを出力します。

・ Windows イベントログのSSISログプロバイダ

Windowsのイベントログにメッセージを出力します。

SSIS連携機能においてエラーが発生した場合に、それぞれのログにメッセージを出力するためには、詳細タブにて“OnError”イベント

のメッセージを出力するように設定する必要があります。

- 18 -

詳細はSQL Serverに添付のドキュメントなどを参照してください。

テキストファイルのSSISログプロバイダに出力した場合

エラーメッセージをテキストファイルにCSV形式で出力するには、テキストファイルのSSISログプロバイダを追加する必要があります。

以下のようにSSISログの構成ダイアログボックスで設定します。

- 19 -

プロバイダの種類で“テキストファイルのSSISログプロバイダ”を選択した場合、メッセージは出力ファイルのmessage欄に出力されます。

メッセージ出力例を以下に示します。

メッセージの内容と対処については、オンラインマニュアル“メッセージ集”を参照してください。

例:メッセージ出力結果

#Fields: event,computer,operator,source,sourceid,executionid,starttime,endtime,datacode,databytes,message

OnInformation,,,,,,2006/10/13 11:39:08,2006/10/13 11:39:08,1074016266,0x,検証フェーズを開始しています。

OnError,,,,,,2006/10/13 11:39:08,2006/10/13 11:39:08,91,0x, LCDST_302 CommandTypeプロパティに未サポートのコマンドが指定さ

れました。

OnError,,,,,,2006/10/13 11:39:08,2006/10/13 11:39:08,-1073450901,0x,"コンポーネント "List Creator 変換先" (363)" が検証に

失敗し、検証状態 "VS_ISBROKEN" が返されました。

OnError,,,,,,2006/10/13 11:39:08,2006/10/13 11:39:08,-1073450996,0x,1 つ以上のコンポーネントで検証に失敗しました。

OnError,,,,,,2006/10/13 11:39:08,2006/10/13 11:39:08,-1073594105,0x,タスクの検証中にエラーが発生しました。

Windows イベントログのSSISログプロバイダに出力した場合

エラーメッセージをWindowsのイベントログに出力するには、Windows イベントログのSSISログプロバイダを追加する必要があります。

以下のようにSSISログの構成ダイアログボックスで設定します。

- 20 -

プロバイダの種類で“Windows イベントログのSSISログプロバイダ”を選択した場合、メッセージはSQL Server Integration Servicesのメッ

セージとしてイベントログに出力されます。

そのため、イベントログのソースや形式については、SQL Serverに添付のドキュメントなどを参照してください。

メッセージの内容と対処については、オンラインマニュアル“メッセージ集”を参照してください。

- 21 -

第6章 運用上の注意

ここでは、SSIS連携機能の使用上の注意について説明します。

6.1 注意事項

・ 出力するデータ形式はCSV形式のため帳票定義情報の入力データ形式をCSV形式にする必要があります。

・ マルチフォーム出力はできません。

・ SSIS連携機能では、「Unicodeの文字を使用する」の指定がされている帳票は未サポートとなります。Unicodeの文字を使用する場

合の帳票定義情報の作成方法や留意事項については、デザイナヘルプを参照してください。

6.2 サポート範囲

・ サポートしている帳票形式

SSIS連携機能で扱える帳票定義情報の種類は以下のとおりです。

－ フリーフレーム形式

－ カード形式

－ 伝票形式

－ 集計表形式（*1）

－ 矩形繰り返し形式

－ タックシール形式

*1:集計表形式でRHを使った帳票を扱うことはできません。

- 22 -