Upload
others
View
2
Download
0
Embed Size (px)
Citation preview
B1WD-3019-01Z0(00)2011年7月
Windows
Interstage List Creator V1powered by Windows Azure
Windows Azure 概要編
Windows Azure 概要編-まえがき-
2
まえがき
本書は、List Creatorが提供するWindows Azure上での PDF変換機能の詳細について記載しています。
◆ 本書の構成
本書は、次の構成になっています。
第1章 概要
【Windows Azure版】の概要について説明します。
第2章 サポート範囲
【Windows Azure版】のサポートしている機能について説明します。
第3章 アプリケーションの作成
アプリケーションの作成から配置・実行までの流れについて説明します。
第4章 インタフェース仕様
インタフェース仕様について説明します。
第5章 保守
トラブル・エラーメッセージの対応について説明します。
付録A 帳票資源ユーティリティについて
帳票資源ユーティリティについて説明します。
付録B Azureストレージ上の資料採取について
Azureストレージ上の資料採取に用いるツールについて説明します。
付録C 注意事項
【Windows Azure版】を使用する上での注意事項について説明します。
付録D セキュリティについて
インターネット環境での利用とセキュリティについて説明します。
付録E Windows Azureの用語
Windows Azureの用語について説明します。
Windows Azure 概要編-まえがき-
3
◆ 対象読者と前提知識
本書は、【Windows Azure版】を利用するシステム管理者を対象としています。本書を読むためには、
以下の知識が必要です。
● クラウドコンピューティングに対する基本的な知識
● Windows Azure Platformに対する基本的な知識
● Microsoft Visual Studioに対する基本的な知識
● .NET Frameworkに関する知識
● C#、Visual Basicに関する知識
● 使用するオペレーティングシステムに対する基本的な知識
◆ 著作権
Microsoft Corporationのガイドラインにしたがって画面写真を使用しています。
Copyright 2011 FUJITSU LIMITED
マニュアルの体系と読み方
本書をお読みになる前に、オンラインマニュアル“マニュアル体系と読み方”をお読みください。
オンラインマニュアル“マニュアル体系と読み方”には、List Creator のマニュアル体系、マニュアルの読み
方、表記上の規則、対象読者と前提知識、用語の対応表、および商標などについて記載されています。
Windows Azure 概要編-目次-
目次
第 1章 概要 .....................................................................................................................8
1.1. 機能概要 ............................................................................................................................. 9
1.2. 運用形態 ............................................................................................................................11
第 2章 サポート範囲 .....................................................................................................12
2.1. 帳票生成・出力機能のサポート範囲 ................................................................................... 13
2.2. 帳票定義情報のサポート範囲 ............................................................................................ 14
2.2.1. 帳票様式情報のサポート範囲 ...................................................................................... 14
2.2.2. 帳票業務情報のサポート範囲 ...................................................................................... 16
2.3. 情報ファイルのサポート範囲 .............................................................................................. 18
2.3.1. 情報ファイル種別......................................................................................................... 18
2.3.2. PDF文書情報ファイルのサポート範囲 .......................................................................... 18
2.4. 帳票出力環境設定ファイルのサポート範囲 ........................................................................ 22
第 3章 アプリケーションの作成 ...................................................................................23
3.1. 作成手順 ........................................................................................................................... 24
3.2. アプリケーションの開発 ...................................................................................................... 25
3.2.1. サンプルプログラムの概要 ........................................................................................... 25
3.2.2. プロジェクトの新規作成 ................................................................................................ 26
3.2.3. プロジェクトの設定 ....................................................................................................... 26
3.2.4. Webデザインの例 ....................................................................................................... 28
3.2.5. アプリケーション記述例 ................................................................................................ 29
3.2.6. アプリケーションのコンパイル・発行 .............................................................................. 29
3.2.7. アプリケーションのデバッグ .......................................................................................... 29
3.3. Windows Azureへのデプロイ........................................................................................... 30
第 4章 インタフェース仕様 ..........................................................................................31
4.1. SDKモジュール構成 .......................................................................................................... 32
4.2. .NET名前空間................................................................................................................... 33
4.3. クラスインタフェース ........................................................................................................... 34
4.3.1. AzCommonクラス ...................................................................................................... 34
4.3.2. AzFormsクラス ........................................................................................................... 34
4.3.3. AzFormsFileクラス..................................................................................................... 37
4.3.4. AzPrintPropertiesクラス ............................................................................................ 40
4.3.5. AzPrintFormクラス..................................................................................................... 47
4
Windows Azure 概要編-目次-
5
4.3.6. AzStorageクラス......................................................................................................... 49
4.4. 例外 .................................................................................................................................. 51
第 5章 保守 ...................................................................................................................52
5.1. トラブル発生時の対処........................................................................................................ 53
5.1.1. トラブル発生時のメッセージ確認 .................................................................................. 53
5.1.2. トラブルシューティング.................................................................................................. 54
5.1.3. 対処できないトラブルが発生した場合 ........................................................................... 54
付録A 帳票資源ユーティリティについて.....................................................................57
A.1 概要 .................................................................................................................................. 57
A.2 コマンド仕様 ...................................................................................................................... 57
A.2.1 azcontainerコマンド.................................................................................................... 57
A.2.2 azuploadコマンド ........................................................................................................ 58
A.2.3 azdownloadコマンド ................................................................................................... 59
A.3 注意事項 ........................................................................................................................... 60
付録B Azureストレージ上の資料採取について ...........................................................61
B.1 Azureストレージ上の資料採取について............................................................................. 61
B.1.1 Diagnosticsログの出力先と使用するツール ............................................................... 61
B.1.2 事前準備 ..................................................................................................................... 62
B.1.3 実行手順 (CloudXplorer)......................................................................................... 62
B.1.4 実行手順 (TableXplorer) .......................................................................................... 64
付録C 注意事項 ............................................................................................................66
C.1 アプリケーション作成時の注意事項 .................................................................................... 66
C.2 Azureストレージ使用時の注意事項 ................................................................................... 66
C.3 ローカルストレージ使用時の注意事項 ................................................................................ 66
C.4 ファイル、ファイルの格納先の指定に関する注意事項 ......................................................... 66
C.5 トレースログに関する注意事項........................................................................................... 66
C.6 英語環境(英語ロケール)での帳票出力に関する注意事項 ................................................. 67
付録D セキュリティについて.......................................................................................68
D.1 インターネット環境での利用とセキュリティについて ............................................................. 68
D.1.1 資源の保護 ................................................................................................................. 68
D.1.2 アプリケーション作成のための指針 .............................................................................. 68
付録E Windows Azureの用語 .....................................................................................70
Windows Azure 概要編-図目次-
図目次
図 1-1 【Windows Azure版】の運用形態 ...................................................................................11
図 3-1 サンプルプログラムの概要 ............................................................................................. 25
図 3-2 プロジェクトの追加 ......................................................................................................... 27
6
Windows Azure 概要編-表目次-
表目次
表 2-1 帳票生成・出力機能のサポート範囲 ............................................................................... 13
表 2-2 帳票様式情報のサポート範囲 ........................................................................................ 14
表 2-3 帳票業務情報のサポート範囲 ........................................................................................ 16
表 2-4 情報ファイルのサポート範囲........................................................................................... 18
表 2-5 PDF文書情報ファイルのサポート範囲 ............................................................................. 18
表 2-6 帳票出力環境設定ファイルのサポート範囲 ..................................................................... 22
表 4-1 AzFormsクラスのコンストラクタ ...................................................................................... 35
表 4-2 AzFormsクラスのプロパティ ........................................................................................... 35
表 4-3 AzFormsクラスのメソッド ................................................................................................ 35
表 4-4 AzFormsFileクラスのメソッド.......................................................................................... 37
表 4-5 AzFormsFileクラスのプロパティ ..................................................................................... 38
表 4-6 AzPrintPropertiesクラスのコンストラクタ ....................................................................... 40
表 4-7 AzPrintPropertiesクラスのプロパティ(分類ごとの一覧) ................................................ 41
表 4-8 AzPrintPropertiesクラスのメソッド ................................................................................. 42
表 4-9 AzPrintFormクラスのコンストラクタ ................................................................................ 47
表 4-10 AzPrintFormクラスのプロパティ ................................................................................... 47
表 4-11 AzPrintFormクラスのメソッド ........................................................................................ 48
表 4-12 AzStorageクラスのコンストラクタ .................................................................................. 49
表 4-13 AzStorageクラスのプロパティ....................................................................................... 50
7
Windows Azure 概要編-第1章 概要-
8
第1章 概要
本章では、【Windows Azure版】の概要について説明します。
Windows Azure 概要編-第1章 概要-
9
1.1. 機能概要
【Windows Azure版】では、Windows Azure上でPDFファイルの帳票を出力するための機能を提供し
ます。
提供する機能の概要は以下のとおりです。
● 出力インタフェース
.NETインタフェースを使用して、帳票出力アプリケーション(Webロール)を作成できます。
.NETインタフェースのマルチフォーム出力、組合せフォーム出力は未サポートです。
● 出力方法
PDF ファイル出力を行うことができます。PDF メール配信機能、ファイル添付機能は未サポートで
す。
● 帳票定義情報
List Creator デザイナで定義した帳票定義情報を使用できます。
利用可能な帳票形式は以下のとおりです。
- 「フリーフレーム形式」
- 「伝票形式」
- 「集計表形式」
- 「カード形式」
- 「矩形繰返し形式」
- 「タックシール形式」
● 入力データ
「固定長」、「可変長」、「CSV形式」の入力データを使用できます。
XBRL データ対応機能 / Navigator 連携機能は未サポートです。
入力データは、UNICODE(UTF8)が使用できます。
● 資源の配置先
以下の資源は、Azureストレージまたはローカルストレージ上に配置できます。
- 帳票定義情報
- メディアデータファイル
- PDF文書情報ファイル
● PDFファイルの出力先
PDFファイルの出力先には、Azureストレージまたはローカルストレージ上のパスが指定できます。
ローカルストレージ上に生成した PDFファイルの保存が必要な場合は Azureストレージなどへ転送
してください。
Windows Azure 概要編-第1章 概要-
10
● イベントログ
エラーが発生した場合は、エラー内容をイベントログに出力します。
詳細については以下を参照してください
⇒ 5.1.1 トラブル発生時のメッセージ確認
なお、イベントログを参照するためには事前設定が必要です。
詳細については、以下を参照してください。
⇒ 3.2.3 プロジェクトの設定
● トレースログ
トレースログファイルは、トラブル発生時の原因究明や問題解決のために必要な情報です。
1 回の出力要求に対し、1つのトレースログファイルがローカルストレージに作成されます。指定に
より作成されたトレースログファイルを Azureストレージに転送することができます。Azureストレ
ージに転送後ローカルストレージ上のログファイルは自動的に削除されます。
Azureストレージへの転送を指定しない場合は、帳票出力処理が正常終了した場合でも、Azureスト
レージへ転送して参照できるようにアプリケーションで対応してください。
● 英語環境(英語ロケール)での動作保証
【Windows Azure版】では、日本語環境以外に英語環境で帳票を出力することができます。
英語環境での帳票出力については、オンラインマニュアル”解説編”を参照してください。
Windows Azure 概要編-第 - 1章 概要
1.2. 運用形態
以下に、【Windows Azure版】の帳票出力処理の流れについて説明します。
1) 配置
Windows Azure環境に、Azureアプリケーションと帳票資源をデプロイしてください。
2) 出力
List Creatorは、帳票(PDFファイル)およびトレースログファイルを生成し、Azureストレージ
に格納します。格納先は.NET インタフェースで指定します。また、帳票出力時にエラーが発生した
場合はイベントログに出力します。
3) 閲覧/保存
Azureストレージに格納された帳票およびイベントログ・トレースログを閲覧/保存できます。保
存の際は帳票資源ユーティリティを使用します。
Webロール/ Workerロール
Interstage List Creatorpowered by Windows Azure
Azureアプリケーション
Windows Azure開発端末
Interstage List Creatorデザイナ
Microsoft Visual StudioMicrosoft Web Developer
①配置
: 実行/起動
: 出力
: 作成/デプロイ
: 通信
帳票資源 トレースログ帳票
(PDFファイル)
イベントログ
Azure Storage
②出力③閲覧/保存
Webロール/ Workerロール
Interstage List Creatorpowered by Windows Azure
Azureアプリケーション
Windows Azure開発端末
Interstage List Creatorデザイナ
Microsoft Visual StudioMicrosoft Web Developer
①配置
: 実行/起動
: 出力
: 作成/デプロイ
: 通信
帳票資源 トレースログ帳票
(PDFファイル)
イベントログ
Azure Storage
②出力③閲覧/保存
Webロール/ Workerロール
Interstage List Creatorpowered by Windows Azure
Azureアプリケーション
Windows Azure開発端末
Interstage List Creatorデザイナ
Microsoft Visual StudioMicrosoft Web Developer
①配置
: 実行/起動
: 出力
: 作成/デプロイ
: 通信
帳票資源 トレースログ帳票
(PDFファイル)
イベントログ
Azure Storage
②出力③閲覧/保存
図 1-1 【Windows Azure版】の運用形態
備考
‐ 帳票資源の配置および帳票(PDFファイル)の格納先にローカルストレージを指定す
ることも可能です。この場合、生成された帳票およびトレースログファイルをAzureス
トレージへ転送して参照できるようにユーザアプリケーションで対応してください。
11
Windows Azure 概要編-第2章 サポート範囲-
12
第2章 サポート範囲
ここでは、【Windows Azure版】のサポートしている機能について説明します。
Windows Azure 概要編-第2章 サポート範囲-
13
2.1. 帳票生成・出力機能のサポート範囲 帳票生成・出力機能のサポート範囲を以下に示します。
表 2-1 帳票生成・出力機能のサポート範囲
分類 製品種別によるサポート状況
○:サポート
-:未サポート
Windows版 Windows
Azure版
印刷 ○ -
電子保存 ○ -
FAX送信 ○ -
PDFファイル保存 ○ ○(*1)
OWFファイル生成 ○ -
出力方法
Excelファイル出力 ○ -
マルチフォーム出力 ○ - 出力形式
組合せフォーム出力 ○ -
コネクタ連携機能 ○ - 分散出力機能
リモート帳票出力機能 ○ -
帳票Webサービス機能 ○ -
COBOLアプリケーション連携機能 ○ -
上位ツール/データベース連携機能 ○ -
セキュリティ機能 監査証跡ログ機能 ○ -
データ到着監視機能 ○ -
ECM連携機能 ○ -
MeFt連携機能 ○ -
Server2000ホスト連携プレミアム連携機能 ○ -
帳
票
生
成
・
出
力
機
能
他製品連携(PDF変換機能)
List Works連携機能 ○ -
コマンド ○ -
Javaインタフェース ○ -
.NETインタフェース ○ ○(*2)
カスタムコントロール ○ -
CFXカスタムタグインタフェース ○ -
帳票出力インタフェース
COBOLインタフェース ○ -
イ
ン
タ
フ
ェ
ー
ス 帳票Webサービスインタフェース ○ -
*1: PDFメール配信機能、ファイル添付機能は未サポートです。
*2: マルチフォーム出力、組合せフォーム出力は未サポートです。
Windows Azure 概要編-第2章 サポート範囲-
14
2.2. 帳票定義情報のサポート範囲
2.2.1. 帳票様式情報のサポート範囲
帳票様式情報のサポート範囲を以下に示します。
表 2-2 帳票様式情報のサポート範囲
分類 製品種別によるサポート状況
○:サポート
△:サポート(一部の機能が未
サポート)
-:未サポート
Windows版 Windows
Azure版
フリーフレーム形式 ○ ○
カード形式 ○ ○
伝票形式 ○ ○
集計表形式 ○ ○
矩形繰返し形式 ○ ○
帳票形式
タックシール形式 ○ ○
ヘッダ部 ○ ○
ボディ部 ○ ○ 伝票形式
テイル部 ○ ○
集計表形式 パーティション ○ ○
ヘッダ(HEAD) ○ ○
ボディ(BODY) ○ ○
フッタ(FOOT) ○ ○
フレーム ○ ○
ブロック
(部・領域)
フリーフレ
ーム形式
フレームパーティション ○ ○
項目 ○ △(*1)(*2)(*3)
オーバレイ ○ ○
帳票レイアウト情報
オブジェクト
パーティション罫線 ○ ○
可変長 ○ ○
固定長 ○ ○
CSV形式 ○ △(*4) 入力データ形式
XML形式 ○ -
Windows Azure 概要編-第2章 サポート範囲-
15
データ定義 ○ ○ 帳票レイアウト情報
と入力データとの関
連付け情報 拡張定義 ○ ○
*1: 日付項目、および時刻項目は、Windows Azureのタイムゾーンの設定(UTC)にしたがって処理されます。Azure
環境は UTC のため、動作するタイムゾーンを設定可能とし、タイムゾーンにしたがった日時にて処理されま
す。
*2: 以下は未サポートとなります。
矩形テキスト項目の、折返し後の行頭空白抑止
以下のバーコード項目
Intelligent Mail Barcode
GS1 DataBar Omnidirectional
GS1 DataBar Truncated
GS1 DataBar Stacked
GS1 DataBar Stacked Omnidirectional
GS1 DataBar Limited
GS1 DataBar Expanded
GS1 DataBar Expanded Stacked
グラフ出力機能
*3: Unicode の文字を指定することができます。Unicode の文字を使用する場合の帳票定義情報の作成方法や留意
事項についてはデザイナヘルプを参照してください。
*4: ダブルクォーテーション(")が 2 つ続いた場合に、1つのダブルクォーテーションとして扱う指定は未サポー
トです。詳細については、オンラインマニュアル“ 環境設定・帳票運用編” の List Creator の環境設定コマン
ドに関する記載を参照してください。
Windows Azure 概要編-第2章 サポート範囲-
16
2.2.2. 帳票業務情報のサポート範囲
帳票業務情報のサポート範囲を示します。
表 2-3 帳票業務情報のサポート範囲
分類 製品種別によるサポート状況
○:サポート
△:サポート(一部の機能が
未サポート)
-:未サポート
Windows版 Windows
Azure版
全般 ○ -
印刷 ○ △(*1)
電子保存 ○ -
FAX ○ -
ファイル保存する ○ ○
格納先ファイル名 ○ ○(*2)
サブタイトル ○ ○ 概要
作成者 ○ ○
互換性のある形式 ○ ○ セキュリティ
権限 ○ ○
URIによる閲覧制限を行う ○ ○ 閲覧制限
期間による閲覧制限を行う ○ ○(*3)
文字の埋め込み ○ △(*4)
JPEG圧縮時の品質 ○ ○
PDFファイルに添付するファイル名 ○ - 文書管理
バーコード線画 ○ ○
PDFファイル表示時のアプリケーション
の設定
○ ○
PDFファイルの自動印刷を行う ○ ○
ファイル
(PDF) 文書情報
動作
閲覧制限時の動作 ○ ○
ファイル(Excel) ○ -
*1: [印刷]タブの置換フォントのみ有効となります。
*2: ローカルストレージ上のパスを指定可能です。Azure ストレージを使用する場合は、.NET インタフェースで
指定してください。
Windows Azure 概要編-第2章 サポート範囲-
17
*3: Windows Azure環境は UTCのため、動作するタイムゾーンを設定可能とし、タイムゾーンにしたがった日時
にて処理されます。
*4: PDFフォント登録機能は使用できません。帳票設計時に使用する文字にMS明朝を指定した場合、「FUJ明朝」
が出力する PDF ファイルの帳票に使用されます。また、帳票設計時に使用する文字に MS ゴシックを指定し
た場合、「FUJゴシック」が出力する PDFファイルの帳票に使用されます。帳票設計時にその他のフォントを
指定した場合は、「FUJ明朝」に対する埋め込み指定となります。
Windows Azure 概要編-第2章 サポート範囲-
18
2.3. 情報ファイルのサポート範囲
2.3.1. 情報ファイル種別
以下に情報ファイルのサポート範囲を示します。
表 2-4 情報ファイルのサポート範囲
情報ファイル種別 製品種別によるサポート状況
○:サポート
-:未サポート
Windows版 Windows Azure版
置換フォント情報ファイル ○ -
バーコード補正情報ファイル ○ -
帳票出力情報ファイル ○ -
PDF文書情報ファイル ○ ○
PDFメール配信情報ファイル ○ -
ECM情報ファイル ○ -
2.3.2. PDF文書情報ファイルのサポート範囲
以下に、PDF 文書情報ファイルのサポート範囲を示します。
表 2-5 PDF文書情報ファイルのサポート範囲
キーワード名 説明 製品種別によるサポート状況
○:サポート
-:未サポート
Windows版 Windows
Azure版
[MF-PDF] PDF 変換機能用PDF 文書情報ファイルの宣言
です。
○ ○
PDF-AES 値にON を指定した場合、PDF をAES 暗号で暗
号化します。
○ ○
PDF-ANOTATE PDF ファイルのセキュリティオプションとし
て、注釈、フォームフィールドの追加、変更の許
可/ 不許可を設定します。
○ ○
PDF-AUTHOR PDF ファイルの文書情報の作成者を記述しま
す。
○ ○
PDF-AUTOPRINT PDF ファイルに自動印刷方式を設定します。 ○ ○
Windows Azure 概要編-第2章 サポート範囲-
19
PDF-BARBOX バーコード項目のサイズがデフォルトのバーコ
ード幅より小さい場合、収まるように縮小して出
力します。
○ ○
PDF-CENTERWINDOW 値にON を指定した場合、文書ウィンドウを画面
の中央に表示します。
○ ○
PDF-DATADIR PDF ファイルにファイルを埋め込むときに、そ
のファイルが存在するべきフォルダのパスを指
定することができます。
○ -
PDF-DATAFILE PDF ファイルに埋め込む任意のデータファイル
のパス名を指定します。
○ -
PDF-DIRCREATE PDF ファイルを生成するファイルパスに記述さ
れたディレクトリが存在しないときは、ON の場
合にディレクトリ生成を行います。OFF の場合
は、“PDF 作成エラー” となります。
○ -
PDF-DOCTITLE 値にON を指定した場合、PDF-TITLE で指定さ
れている文字列をAdobe Reader のタイトルバ
ーに表示します。OFF を指定するとPDF ファイ
ル名が表示されます。
○ ○
PDF-EMBED PDF ファイルのエンベッドする文字範囲を設定
します。
○ ○(*1)
PDF-FITWINDOW 値にON を指定した場合、最初に表示されるペー
ジのサイズに適合するように文書ウィンドウの
サイズを変更します。
○ ○
PDF-FULLSCREEN ファイルオープン時にAdobe Reader の表示を
フルスクリーンモードにすることができます。
○ ○
PDF-HIDEMENUBAR ファイルオープン時にAdobe Reader のメニュ
ーバーの表示/ 非表示を設定できます。
○ ○
PDF-HIDETOOLBAR ファイルオープン時にAdobe Reader のツール
バーの表示/ 非表示を設定できます。
○ ○
PDF-HIDEWINDOWUI 値にON を指定した場合、文書ウィンドウのユー
ザインタフェース要素(スクロールバーやナビゲ
ーション用コントロールなど)を隠し、文書の内
容だけが表示されます。
○ ○
PDF-INITLAYOUT PDF ファイルを開いたときのページレイアウト
を設定します。
○ ○
Windows Azure 概要編-第2章 サポート範囲-
20
PDF-INITPAGE PDF ファイルを開いたときに表示されるページ
を指定します。
○ ○
PDF-INITZOOM PDF ファイルを開いたときの表示倍率を指定し
ます。
○ ○
PDF-JPEGMODE JPEG データの変換方法を設定します。 ○ ○
PDF-JPEGQUALITY JPEG 圧縮時の品質を設定します。 ○ ○
PDF-KEY128 暗号化キー長を128bit としてPDF 変換を行い
ます。
○ ○
PDF-LAYOUT PDF ファイルのページレイアウトを設定しま
す。
○ ○
PDF-LIMITURI List Creator デザイナでURI 閲覧制限機能を設
定したPDFファイルの閲覧を許可するURI を設
定します。
○ ○
PDF-LIMITURICANCEL List Creator デザイナで設定したURI 閲覧制限
機能を無効にします。
○ ○
PDF-META 値にON を指定した場合、文書情報からメタデー
タを生成してPDF ファイルに埋め込みます。
OFF を指定した場合はメタデータを埋め込みま
せん。
○ ○
PDF-MMR 2 値データをMMR で圧縮します。 ○ ○
PDF-MODIFY PDF ファイルのセキュリティオプションとして
文書の変更の許可/ 不許可を設定します。
○ ○
PDF-NOENCMETA 値にON を指定した場合、PDF ファイルに埋め
込むメタデータを暗号化しません。OFF を指定
した場合は埋め込むメタデータを暗号化します。
○ ○
PDF-NOOCRB 値にON を指定した場合、PDF ファイル中で使
用されるOCR-B フォントのエンベッドを行いま
せん。OFF を指定した場合はOCR-B フォント
の埋め込みが行われます。
○ ○
PDF-OPENPWD Adobe Reader でPDF ファイルを開く際に必要
なパスワードを記述します。
○ ○
PDF-PAGEMODE PDF ファイルを開く際のしおりやサムネールイ
メージの表示方法を設定することができます。
○ ○
PDF-PRINT PDF ファイルのセキュリティ情報として印刷の
許可/ 不許可を設定します。
○ ○
Windows Azure 概要編-第2章 サポート範囲-
21
PDF-RESOURCEPERPAGE PDF ファイルのResource 辞書をページ毎に作
成します。
○ ○
PDF-SECUPWD Acrobat でPDF ファイルのセキュリティオプシ
ョンを変更する際に必要なパスワード(セキュリ
ティオプション変更パスワード)を記述します。
○ ○
PDF-SELECT PDF ファイルのセキュリティオプションとして
テキストとグラフィックスの選択の許可/ 不許可
を設定します。
○ ○
PDF-SUBTITLE PDF ファイルの文書情報のサブタイトルを記述
します。
○ ○
PDF-TITLE PDF ファイルの文書情報のタイトルを記述しま
す。
○ ○
PDF-YENNONADJUST 値にON を指定した場合、PDF ファイル中で使
用される文字コード(Unicode)「0x005C」を
「0x00A5」に変換しません。OFF を指定した場
合は変換します。
○ ○
*1: PDFフォント登録機能は使用できません。帳票設計時に使用する文字をMS明朝を指定した場合、「FUJ明朝」
が出力する PDF ファイルの帳票に使用されます。また、帳票設計時に使用する文字を MS ゴシックを指定し
た場合、「FUJゴシック」が出力する PDFファイルの帳票に使用されます。帳票設計時にその他のフォントを
指定した場合は、「FUJ明朝」に対する埋め込み指定となります。
Windows Azure 概要編-第 - 2章 サポート範囲
22
2.4. 帳票出力環境設定ファイルのサポート範囲
以下に、帳票出力環境設定ファイルのサポート範囲を示します。
表 2-6 帳票出力環境設定ファイルのサポート範囲
キーワード名 説明 製品種別によるサポート状況
○:サポート
-:未サポート
Windows版 Windows
Azure版
GRAPHRESOLUTION 指定した解像度で、グラフ出力用のビットマップを生
成します。
○ -
GRAPHDRAWCOLOR グラフデータ(グラフ属性ファイル)で指定された色
情報を有効にするかどうかを指定します。
○ -
PDFJIS2004MODE PDFファイル保存時、サロゲートペアなどのJIS2004
文字を出力する場合に指定します。
○ ○(*1)
USECHARTYPE UNICODE文字の出力結果が異常となる場合など、
List Creator内部で使用しているUNICODE文字の全
半角を判定するテーブルを変更します。
○ -
UNICODEN 指定した文字をUNICODE半角文字とみなします。
UNICODE文字の出力結果が異常となる場合に指定
します。
○ ○
UNICODEW 指定した文字をUNICODE全角文字とみなします。
UNICODE文字の出力結果が異常となる場合に指定
します。
○ ○
LWMATQUALITY List Creator互換印刷時の動作モードを指定します。 ○ -
STAMPTYPE 画像の透過出力描画方法を指定します。 ○ -
BARCUST4DIR カスタマバーコードの印刷方向拡張を指定します。 ○ ○
PDFCUSTBARPOS PDFファイル保存時のカスタマバーコードの位置ズ
レ補正を指定します。
○ ○
*1: 【Windows Azure版】では、初期値として「Y」(サロゲートペアを出力する)が設定されています。
Windows Azure 概要編-第3章 アプリケーションの作成-
第3章 アプリケーションの作成
【Windows Azure版】が提供するインタフェースを使用したユーザアプリケーション(プログラム)
の作成方法から運用・保守までの流れについて説明します。
23
Windows Azure 概要編-第3章 アプリケーションの作成-
3.1. 作成手順
【Windows Azure版】で.NETインタフェースを利用したユーザアプリケーションは、以下の流れで
作成します。
1) アプリケーション開発ファブリックの準備
[必須ソフトウェア]
- Windows Azure SDK 1.4
- .NET Framework 4
- 開発環境(Visual Studioなど)
上記のソフトウェアはMicrosoftのホームページから入手してください。また、環境設定につ
いてもMicrosoftの情報を参考にしてください。
2) アプリケーションの作成
3) アプリケーションのコンパイル・発行
4) 開発ファブリックからアプリケーションの配置・実行
5) Windows Azureへの配置・実行
‐ クラウド側のオペレーティングシステムとして、以下のいずれかが必要です。
・Windows Azure Guest OS 1.x
・Windows Azure Guest OS 2.x
【Windows Azure版】では”Windows Azure SDK 1.4”を使用します。これをサポートしている
バージョンのWindows Azure Guest OSを使用してください。
24
Windows Azure 概要編-第3章 アプリケーションの作成-
3.2. アプリケーションの開発
ここではWindows Azureアプリケーションの開発方法を、List Creatorのサンプルを用いて説明します。
作成言語はVisual C#を用いてASP.NETアプリケーションを作成します。サンプルプログラムは、
CD-ROMの¥Samplesに格納されています。
‐ ここではVisual Studio 2010を使ったアプリケーション開発手順を説明します。
‐ Visual Studioを実行する場合、必ず「管理者として実行」を選択してください。コンパイ
ル時に管理者の資格情報が必要となります。詳しくはMicrosoftの技術情報を参考にして
ください。
‐ Windows Azureは、アプリケーションからは64bitのオペレーティングシステムとして認
識されます。そのため、64bitのWindows Azureアプリケーションを作成してください。
3.2.1. サンプルプログラムの概要
SDKに格納されているアプリケーションサンプルの概要について説明します。
図 3-1 サンプルプログラムの概要
ユーザがWebページ上の「ボタン」を押すと、PDFファイルの帳票が生成されます。
生成されたPDFファイルの帳票は「ハイパーリンク」から取り出すことができます。
出力完了メッセージやエラーメッセージは「ラベル」に表示されます。
メッセージを出力するラベル
帳票を取り出すためのハイパーリンク
帳票出力ボタン
25
Windows Azure 概要編-第3章 アプリケーションの作成-
3.2.2. プロジェクトの新規作成
Visual Studioを起動後、新しいプロジェクトを作成します。インストールされたテンプレートから
「Visual C#」の「Cloud」を選択し、Windows Azure クラウドサービスプロジェクトを選択します。
名前や格納場所は環境に合わせて設定してください。
その後、作成するロールを選択します。ここでは、「ASP.NET Web ロール」をクラウドサービスソリ
ューションに追加します。
ここでは、Azure Development 環境でアプリケーション開発を行い、その後Windows Azure環境へデ
プロイ手順を前提とします。
3.2.3. プロジェクトの設定
List Cretaorを使ったWindows Azureアプリケーションを作成するために、下記の設定が必要です。
① .NETインタフェースモジュールの参照設定
.NETインタフェースのモジュール(f4gcazif.dll,f4gcdnif.dll) を、参照設定に追加してください。
上記ファイルは、(インストールフォルダ)¥moduleフォルダ内に格納されています。
② List Creatorのモジュールの追加
プロジェクトに追加するモジュールは、(インストールフォルダ)¥module¥ListCREATORフォル
ダの配下にある全てのファイルです。これらをWebロール直下に追加してください。
追加したモジュールすべてのプロパティ[出力ディレクトリにコピー]属性を、[常にコピーする]に
設定してください。
なお、図3-2 のようにList Creatorのモジュールをまとめることもできます。
各モジュールの関係性(役割)については、以下を参照してください。
⇒ 第4章 インタフェース仕様
26
Windows Azure 概要編-第3章 アプリケーションの作成-
図 3-2 プロジェクトの追加
‐ Webロール直下にList Creatorモジュールを配置しない場合、(インストールフォル
ダ)¥sdkフォルダ内に格納されている以下の6つのモジュールをWebロール直下に
配置してください。
F4GCALOG.dll
f4gcccl1.dll
f4gcccml.dll
f4gccloc.dll
F4GCCLOG.dll
LcRegInfo.conf
また、サンプルプログラムの修正が必要です。
27
Windows Azure 概要編-第3章 アプリケーションの作成-
③ .NET信頼レベルの設定
.NETインタフェースはNative Codeを使用して、帳票出力処理を行います。そのためロールの構成
で、.NET信頼レベルに「完全信頼」を設定してください。
④ イベントログの出力設定
④-1) イベントログの資格情報の設定
ロールのプロパティ画面で、イベントログ出力先に接続するための資格情報を設定してください。
④-2) ログの転送設定
ロール初期化時(OnStart)に、以下の設定を行ってください。
ⅰ) Diagnostic Monitorの初期設定
ⅱ) Diagnostic Monitorの開始処理
⑤ Azureストレージの設定および初期化
Azureストレージにアクセスするには接続文字列名やコンテナ名が必要になります。
必要に応じてロールの設定に接続文字列名を追加してください。
Sample ア プ リ ケ ー シ ョ ン の 場 合 、 接 続 文 字 列 名 は 「 DataConnectionString 」 と
「DiagnosticsConnectionString」を追加してください。
アプリケーションの開発時は「Azure Storage Emulator」を使用してください。
⑥ ローカルストレージの設定
List Creatorはローカルストレージを使用します。
ロールのローカルストレージの設定画面でローカルストレージを追加してください。
ローカルストレージの名前は「LocalStorageLC」固定です。
サイズは処理する帳票やデータ量に依存します。
使用する帳票資源、入力データ、生成されたPDFファイルを格納するのに十分な量を確保してくだ
さい。サンプルプログラムでは20MBを指定します。
複数インスタンスを動作させる場合は、多重度に応じたサイズが必要です。
3.2.4. Webデザインの例
Webデザインを編集するために、Default.aspxを開きます。
Web画面上にLabelとHyperLink、buttonを配置します。その後、各プロパティを変更します。
内容は下記を参照してください。
ID Target
Label Msg -
HyperLink HyperLink1 _blank
button GoButton -
28
Windows Azure 概要編-第3章 アプリケーションの作成-
3.2.5. アプリケーション記述例
(インストールフォルダ)¥sampleフォルダ内のサンプルプログラム(Default.aspx.cs、Global.asax.cs、
WebRole.cs)を参考に、アプリケーションの作成を行ってください。
なお、サンプルプログラムの言語はC#です。
3.2.6. アプリケーションのコンパイル・発行
アプリケーションの記述が完了したら、ソリューションのビルドを行います。
なお、詳細については使用する開発ファブリックのドキュメントを参照してください。
3.2.7. アプリケーションのデバッグ
ビルドが完了したアプリケーションの動作確認を、開発ファブリックで行います。以下の手順が必要
です。
1) 作成したアプリケーションを実行し、Azure Storage Emulatorを起動する。
2) 起動したAzure Storage Emulatorに帳票定義情報をデプロイする。
デプロイ方法は、Azure Storage Emulatorの技術情報を参照してください。
3) Webアプリケーションの動作を確認する。
‐ ビルド作業を行う前に、IIS_IUSRSに対するアクセス権を追加してください。IISの
ソリューションに対するアクセス権がない場合、アプリケーションが正常に動作し
ません。
‐ 32bitオペレーティングシステムの開発環境では、上記の手順でデバックを行うこと
ができません。必ず、ステージング環境での動作検証を行ってください。
29
Windows Azure 概要編-第3章 アプリケーションの作成-
3.3. Windows Azureへのデプロイ
ここでは、“3.2 アプリケーションの開発”で作成したアプリケーションをWindows Azureへデプロイす
る手順を説明します。
1) Windows Azure アプリケーションの発行を行います。プロジェクトを右クリックして[発行]を選
択します。Visual Studioで証明書を作成し、Azure Developer Portalにアップロードします。詳
細はMicrosoftの技術情報を参照してください。
2) Storage Accountの情報をプロジェクトの設定に反映します。
アプリケーションの発行方法、Storage Accountの情報取得方法などはWindows Azure の技術情報を
参照してください
‐ Windows Azureへデプロイする前に、サンプルプログラムの編集が必要です。実行す
る環境に合わせて内容を編集してください。
30
Windows Azure 概要編-第4章 インタフェース仕様-
31
第4章 インタフェース仕様
ここでは、【Windows Azure版】が提供する帳票出力のインタフェースについて説明します。
Windows Azure 概要編-第4章 インタフェース仕様-
32
4.1. SDKモジュール構成
.NETインタフェースは、以下の構成となっています。
種類 名前
DLL ファイル f4gcazif.dll
f4gcdnif.dll
Windows Azure 概要編-第4章 インタフェース仕様-
33
4.2. .NET名前空間
【Windows Azure版】が提供する.NETインタフェースには、以下の種類の名前空間があります。
帳票出力を行うためのインタフェース
【Windows Azure版】で帳票出力を行うためのクラスを提供します。
名前空間は以下のとおりです。
fujitsu.listcreator.azure
fujitsu.listcreator
名前空間fujitsu.listcreator.azureで提供されているクラスはfujitsu.listcreatorを参照しています。
定数を名前で指定する場合は、名前空間fujitsu.listcreatorで提供されているクラス名で修飾してく
ださい。
Windows Azure 概要編-第4章 インタフェース仕様-
4.3. クラスインタフェース
以下に、【Windows Azure版】が提供する.NETインタフェースのクラス一覧を示します。
● fujitsu.listcreator.azure
クラス名 説明
AzCommon クラス 各クラスが継承するクラスです。
AzForms クラス 帳票の出力時に使用する帳票と入力データを保持
します。
AzFormsFile クラス 帳票の出力時に使用する帳票と入力データファイ
ルを保持します。
AzPrintProperties クラス 帳票の出力方法、および帳票の出力時に指定するプ
ロパティを保持します。
AzPrintForm クラス 帳票出力を行います。
AzStrorage クラス Azureストレージの接続文字列名とコンテナ名を
保持します。
● fujitsu.listcreator
クラス名 説明
PrintException クラス .NETインタフェースで発生した例外を通知しま
す。
4.3.1. AzCommonクラス
各クラスが継承するクラスです。アプリケーションが直接使用することはありません。
4.3.2. AzFormsクラス
帳票の出力時に使用する帳票と入力データを保持するクラスです。
fujitsu.listcreator.azure.AzCommon
fujitsu.listcreator.azure.AzForms
System.Object
fujitsu.listcreator.azure.AzCommon
34
Windows Azure 概要編-第4章 インタフェース仕様-
4.3.2.1. コンストラクタの概要
AzFormsクラスのコンストラクタを以下に示します。
表 4-1 AzFormsクラスのコンストラクタ
コンストラクタの概要
AzForms(string formname, string assets, AzStorage log)
帳票名と帳票を格納するディレクトリを指定して、帳票と入力データのセットを保持する
AzFormsを作成します。
AzForms(string formname, LocalResource localresource, string relativepath, AzStorage log)
帳票名と帳票を格納するローカルストレージと相対パスを指定して、帳票と入力データの
セットを保持するAzFormsを作成します。
AzForms(string formname, AzStorage storageassets, AzStorage log)
帳票名と帳票を格納するAzureストレージの接続文字列とコンテナ名を指定して、帳票と
入力データのセットを保持するAzFormsを作成します。
4.3.2.2. プロパティの概要
AzFormsクラスのプロパティを以下に示します。
表 4-2 AzFormsクラスのプロパティ
プロパティの分類 プロパティ名(プロパティの設定内容) データ型
ユーザ資源情報に
関するプロパティ
DataCode(入力データの文字コード指定) int
4.3.2.3. メソッドの概要
AzFormsクラスのメソッドを以下に示します。
表 4-3 AzFormsクラスのメソッド
メソッドの分類 メソッドの概要
pushRecord(string record) レコード(行)出力
に関するメソッド
void
帳票を出力するための入力データとなるレ
コード(行)文字列を追加します。
35
Windows Azure 概要編-第4章 インタフェース仕様-
4.3.2.4. コンストラクタの詳細
AzForms(string formname, string assets, AzStorage log)
AzForms(string formname, LocalResource localresource, string relativepath, AzStorage log)
AzForms(string formname, AzStorage storageassets, AzStorage log)
用途
帳票と入力データのセットを保持する Formsオブジェクトを生成します。
パラメータ
formname : 帳票名を指定します。
assets : 帳票を格納するディレクトリのフルパスを指定します。
localresource : 帳票を格納するローカルストレージのLocalResourceオブジェクトを指
定します。
relativepath : ローカルストレージ内の帳票を格納するディレクトリの相対パスを指定
します。
storageassets : 帳票を格納するAzureストレージを指定します。
log : トレースログ格納Azureストレージを指定します。Azureストレージに格
納しないで、ファイルシステムに残す場合はnull、または空のAzStorage
インスタンスを指定します。
例外
PrintException
4.3.2.5. プロパティの詳細
4.3.2.5.1. ユーザ資源に関するプロパティ
DataCode(入力データの文字コード指定)
入力データの文字コードを指定します。
CODE_UTF8 :UNICODE(UTF8)
‐ このプロパティは、pushRecordメソッドを指定する前に指定してください。
pushRecordメソッド指定後、このプロパティは指定できません。
36
Windows Azure 概要編-第4章 インタフェース仕様-
4.3.2.6. メソッドの詳細
4.3.2.6.1. レコード(行)出力に関するメソッド
void
pushRecord(string record)
用途
帳票を出力するための入力データとなるレコード(行)文字列を追加します。
パラメータ
record : レコード(行)文字列を指定します。
1レコード(行)ずつレコード(行)文字列をセットしてください。
レコード(行)文字列には改行コードを含めないでください。
例外
PrintException
注意
帳票出力時の文字コードを指定する場合、このメソッド指定前に DataCodeプロパティで文字コ
ードを指定してください。
4.3.3. AzFormsFileクラス
帳票の出力時に使用する帳票を保持するクラスです。
4.3.3.1. コンストラクタの概要
AzFormsFileクラスのコンストラクタを以下に示します。
表 4-4 AzFormsFileクラスのメソッド
37
コンストラクタの概要
AzFormsFile(string assets, AzStorage log)
帳票を格納するディレクトリ(ファイルシステム)を指定して、帳票を保持するAzFormsFileを
作成します。(入力データはファイルシステム上)
AzFormsFile(LocalResource localresource, string relativepath, AzStorage log)
帳票を格納するローカルストレージと相対パスを指定して、帳票を保持するAzFormsFileを作成
します。(入力データはファイルシステム上)
fujitsu.listcreator.azure.AzCommon
fujitsu.listcreator.azure.AzFormsFile
Windows Azure 概要編-第4章 インタフェース仕様-
AzFormsFile(LocalResource localresource, string relativepath,LocalResource localresourcedata,
AzStorage log)
帳票を格納するローカルストレージと相対パス、入力データ格納ローカルストレージを指定し
て、帳票を保持するAzFormsFileを作成します。
AzFormsFile(AzStorage storageassets, AzStorage log)
帳票を格納するAzureストレージの接続文字列名とコンテナ名を指定して、帳票を保持する
AzFormsFileを作成します。(入力データはファイルシステム上)
AzFormsFile(string assets, LocalResource localresourcedata, AzStorage log)
帳票を格納するディレクトリ(ファイルシステム)と入力データ格納ローカルストレージを指定
して、帳票を保持するAzFormsFileを作成します。
AzFormsFile(string assets, Azstorage storagedata, AzStorage log)
帳票を格納するディレクトリ(ファイルシステム)と入力データ格納Azureストレージの接続文
字列名とコンテナ名を指定して、帳票を保持するAzFormsFileを作成します。
AzFormsFile(LocalResource localresource, string relativepath, AzStorage storagedata, AzStorage log)
帳票を格納するローカルストレージと相対パス、入力データ格納Azureストレージの接続文字列
名とコンテナ名を指定して、帳票を保持するAzFormsFileを作成します。
AzFormsFile(AzStorage storageassets, AzStorage storagedata, AzStorage log)
帳票を格納するAzureストレージの接続文字列名とコンテナ名と入力データ格納Azureストレー
ジの接続文字列名とコンテナ名を指定して、帳票を保持するAzFormsFileを作成します。
AzFormsFile(AzStorage storageassets, LocalResource localresourcedata, AzStorage log)
帳票を格納するAzureストレージの接続文字列名とコンテナ名と入力データ格納ローカルストレ
ージを指定して、帳票を保持するAzFormsFileを作成します。
4.3.3.2. プロパティの概要
AzFormsFileクラスのプロパティを以下に示します。
表 4-5 AzFormsFileクラスのプロパティ
プロパティの分類 プロパティ名(プロパティの設定内容) データ型
帳票名 ScriptFile string
データファイル名 DataFile (*1) string
ユーザ資源情報に関す
るプロパティ
DataCode(入力データの文字コード指定) int
*1: Azureストレージ上に格納した場合は、ファイル名のみ有効になります。
38
Windows Azure 概要編-第4章 インタフェース仕様-
39
4.3.3.3. メソッドの概要
AzFormsFileクラスの公開メソッドはありません。
4.3.3.4. コンストラクタの詳細
AzFormsFile(string assets, AzStorage log)
AzFormsFile(LocalResource localresource, string relativepath, AzStorage log)
AzFormsFile(LocalResource localresource, string relativepath,LocalResource localresourcedata,
AzStorage log)
AzFormsFile(AzStorage storageassets, AzStorage log)
AzFormsFile(string assets, LocalResource localresourcedata, AzStorage log)
AzFormsFile(string assets, Azstorage storagedata, AzStorage log)
AzFormsFile(LocalResource localresource, string relativepath, AzStorage storagedata, AzStorage
log)
AzFormsFile(AzStorage storageassets, AzStorage storagedata, AzStorage log)
AzFormsFile(AzStorage storageassets, LocalResource localresourcedata, AzStorage log)
用途
帳票名と帳票を格納するディレクトリを指定して、帳票を保持する AzFormsFileオブジェクトを
生成します。
パラメータ
assets : 帳票を格納するローカルストレージのディレクトリをフルパスで指
定します。
localresource : 帳票を格納するローカルストレージのLocalResourceオブジェクト
を指定します。
relativepath : ローカルストレージ内の帳票を格納するディレクトリの相対パスを
指定します。
storageassets : 帳票を格納するAzureストレージを指定します。
storagedata : 入力データ格納Azureストレージを指定します。
log : トレースログ格納Azureストレージを指定します。Azureストレージ
に格納しないで、ファイルシステムに残す場合はnull、または空の
AzStorageインスタンスを指定します。
localresourcedata : 入力データ格納ローカルストレージのLocalResourceオブジェクト
を指定します。
Windows Azure 概要編-第4章 インタフェース仕様-
例外
PrintException
4.3.3.5. プロパティの詳細
4.3.3.5.1. ユーザ資源情報に関するプロパティ
ScriptFile(帳票名)
帳票名を指定します。
DataFile(データファイル名)
入力データのファイル名を指定します。
コンストラクタで入力ファイルの格納先に Azureストレージを指定した場合は、ファイル名
のみ有効となります。
ローカルストレージから読み込む場合は、DataFileプロパティをローカルストレージ内の相
対パスとして扱います。
DataCode(入力データの文字コード指定)
入力データの文字コードを指定します。
CODE_UTF8 :UNICODE(UTF8)
‐ 英語環境(英語ロケール)で運用する場合、帳票名・データファイル名に日本語(全
角文字、半角カナ文字)は指定できません。
4.3.3.6. メソッドの詳細
AzFormsFileクラスの公開メソッドはありません。
4.3.4. AzPrintPropertiesクラス
帳票の出力方法、および帳票出力時に指定するプロパティを保持するクラスです。
4.3.4.1. コンストラクタの概要
AzPrintPropertiesクラスのコンストラクタを以下に示します。
表 4-6 AzPrintPropertiesクラスのコンストラクタ
40
コンストラクタの概要
AzPrintProperties()
空のAzPrintPropertiesオブジェクトを生成します。
System.Object
fujitsu.listcreator.azure.AzPrintProperties
Windows Azure 概要編-第4章 インタフェース仕様-
4.3.4.2. プロパティの概要(プロパティ一覧)
AzPrintPropertiesクラスのプロパティについて、プロパティ分類ごとに、サポート範囲を示します。
また、サポートするプロパティについて、プロパティ分類ごとに示します。
表 4-7 AzPrintPropertiesクラスのプロパティ(分類ごとの一覧)
プロパティの分類 プロパティ名(プロパティの設定内容) データ型
BarCodeData(バーコードデータのBASE64 エンコード指定) int ユーザ資源情報に
関するプロパティ VisualDir(メディアデータ格納ディレクトリ) string
識別情報に関する
プロパティ
OutputName(タイトル) string
TimeZone(タイムゾーン指定) string
DirectMethod(出力方法) int
OutputMode(出力方法) int
ReplaceString(SET 演算子の置換文字列) string
LFCode(改行コード制御指定) int
FFCode(改ページコード制御指定) int
動作情報に関する
プロパティ
NoData(入力データにデータがない場合の動作指定) bool
KeepPdf(ファイル保存時の格納先ファイル名) string
StorageOutput(格納先Azureストレージ) AzStorage
AddUniqueName(出力ファイル名にタイムスタンプおよび
GUIDを付加する指定)
int
LocalResourceOutput(格納先ローカルストレージ指定) LocalResource
PdfSubTitle(PDF ファイルのサブタイトル) string
PdfAuthor(PDF ファイルの作成者) string
PdfPrint(PDF ファイルの印刷許可指定) int
PdfModify(PDF ファイルの文書変更許可指定) int
PdfSelect(PDF ファイルのテキストとグラフィックスの選択
許可指定)
int
PdfAnnotate(PDF ファイルの注釈とフォームフィールドの追
加と変更許可指定)
int
PDFファイル保存
情報に関するプロ
パティ
PdfPwd(PDF ファイルを開くパスワード) string
41
Windows Azure 概要編-第4章 インタフェース仕様-
PdfSecuPwd(PDF ファイルのセキュリティオプション変更パ
スワード)
string
PdfLimit(PDF ファイルの閲覧期限/ 閲覧期間) string
PdfEmbed(PDF ファイルの文字の埋め込み指定) int
PdfReference(PDF ファイルの埋め込み文字検索指定) bool
PdfJpegQuality(PDF ファイルのJPEG 圧縮時の品質指定) int
PdfAutoPrint(PDF ファイルの自動印刷指定) int
PdfHideToolBar(PDF ファイル表示時のアプリケーションの
ツールバー表示指定)
int
PdfHideMenuBar(PDF ファイル表示時のアプリケーション
のメニューバー表示指定)
int
PdfFullScreen(PDF ファイル表示時のアプリケーションの全
画面表示指定)
int
PdfDocEnvFile(PDF 文書情報ファイル名) string
4.3.4.3. メソッドの概要
AzPrintPropertiesクラスのメソッドを以下に示します。
表 4-8 AzPrintPropertiesクラスのメソッド
メソッドの概要
setExecBuffer(string param) void
prprint コマンドのオプションを指定します。
4.3.4.4. コンストラクタの詳細
AzPrintProperties()
用途
空の AzPrintPropertiesオブジェクトを生成します。
4.3.4.5. プロパティの詳細
【Windows版】と共通なプロパティについての説明は省略します。
説明が省略されたプロパティについては、オンラインマニュアル“アプリケーション作成ガイド”を
参照してください。
42
Windows Azure 概要編-第4章 インタフェース仕様-
4.3.4.5.1. ユーザ資源情報に関するプロパティ
VisualDir(メディアデータ格納ディレクトリ)
帳票出力サーバのメディアデータ格納ディレクトリをフルパスで指定します。
複数のメディアデータ格納ディレクトリを指定する場合は、「セミコロン(;)」で区切って指
定します。指定した複数のディレクトリ配下に同一名のメディアデータがある場合は、先に指定
したディレクトリ配下のメディアデータが有効になります。
組込みメディア項目のデータがファイル名のみの場合、メディアデータ格納ディレクトリ配下
を検索します。
メディアデータを Azureストレージ(ブロブ)に格納した場合は以下の形式で指定します。
指定されたファイル名がブロブのリファレンス名として動作します。
運用環境の場合:
http://(ストレージアカウント名).blob core.wa.fj-cloud.net/ (コンテナ名)/
開発ファブリック(開発ストレージ)の場合:
http://127.0.0.1:10000/devstoreaccount1/(コンテナ名)/
‐ ‐ このプロパティで指定したストレージのコンテナは、パブリックアクセスが可能である必
要があります。
‐ 入力データに、組み込みメディア項目のファイル名をURIで指定することはできません。
4.3.4.5.2. 動作情報に関するプロパティ
備考
‐ 帳票出力時のList Creatorの動作(優先順序含む)や留意事項などについては、オンライ
ンマニュアル“環境設定・帳票運用編”を参照してください。
また、入力データなどに関する留意事項については、オンラインマニュアル“帳票設計
編”を参照してください。
TimeZone(タイムゾーン指定)
UTC(協定世界時)からの時差を指定します。
記述形式は以下のとおりです。
+HHMM (進める場合)
-HHMM (遅らせる場合)
HH:時(00~23)
MM:分(00~59)
省略した場合は、ローカルタイムで出力されます。
DirectMethod(出力方法)
OutputMode(出力方法)
帳票の出力方法を指定します。
【Windows Azure版】では PDFファイル保存のみ指定可能です。
43
Windows Azure 概要編-第4章 インタフェース仕様-
DirectMethodプロパティは、帳票で指定されている出力方法に関係なく出力方法を指定した
い場合に指定してください。
OutputModeプロパティは、帳票で指定されている出力方法のうち、特定の出力方法で出力
したい場合に指定してください。
以下に、指定できる値を示します。
OUTPUTMODE_DEFAULT:
帳票に定義されている出力方法で帳票を出力します。ただし、【Windows
Azure版】では PDFファイル保存のみサポートとなります。
OUTPUTMODE_PDF:
PDFファイル保存を指定します。
なお、帳票の出力方法は、以下の優先順序で有効になります。
1) DirectMethodプロパティで指定した出力方法
(ただし、「OUTPUTMODE_DEFAULT」を指定した場合は、OutputModeプロパテ
ィで指定した値が有効となります)
2) OutputModeプロパティで指定した出力方法
3) 帳票で指定されている出力方法
‐ ‐ 【Windows Azure版】では、PDFファイル保存のみサポートしているため、
DirectMethodプロパティには、必ずOUTPUTMODE_PDFを指定してください。
4.3.4.5.3. PDFファイル保存情報に関するプロパティ
‐ ‐ PDF変換機能のサポート範囲、使用する資源、および留意事項については、オン
ラインマニュアル“PDF変換機能編”、および、以下を参照してください。
⇒ 第2章 サポート範囲
KeepPdf(ファイル保存時の格納先ファイル名)
PDFファイルをローカルストレージに出力する場合は、格納先ファイル名(PDFファイル名)
を 259文字以内かつ 512バイト以内のフルパスで指定します。
PDFファイルを Azureストレージに出力する場合は、格納先ファイル名(PDFファイル名)
のみ指定します。パスは有効となりません。
PDFファイルをローカルストレージに出力する場合は、格納先ファイル名(PDFファイル名)
を相対パスで指定します。
44
Windows Azure 概要編-第4章 インタフェース仕様-
‐ フォルダ名のみの指定はできません。
‐ 同一名ファイルがすでに存在するときにPDFファイル保存に失敗した場合は、元の
PDFファイルも削除されることがあります。
備考
‐ 生成されるPDFファイルには、帳票を出力したユーザのアクセス権が設定されます。
‐ 指定されたフォルダが存在しない場合、フォルダが自動生成されます。
フォルダには、親フォルダと同じアクセス権が設定されます。自動生成されたフォ
ルダに対し、帳票を出力するユーザがアクセス権を持たない場合は、PrintFormクラ
スのPrintOutメソッド呼び出し時にエラーになります。
‐ 同一名ファイルがすでに存在する場合は、ファイルを上書きする権限があれば新し
いファイルに置き換えられます。ファイルを上書きする権限がない場合は、
PrintFormクラスのPrintOutメソッド呼び出し時にエラーになります。
PdfDocEnvFile(PDF文書情報ファイル名)
PDF文書情報ファイル名をフルパスで指定します。
帳票資源を Azureストレージまたはローカルストレージに格納した場合は、帳票資源と同一
の場所に格納されている必要があります。
Azureストレージが指定されている場合はファイル名のみ有効となり、ローカルストレージの
場合は相対パスとして扱われます。
StorageOutput(格納先Azureストレージ)
生成される PDFファイルを Azureストレージに格納する場合に、接続文字列とコンテナ名を
格納した AzStorageクラスのインスタンスを指定します。
AddUniqueName(出力ファイル名にタイムスタンプおよびGUIDを付加する指定)
Azureストレージに格納される PDFファイル名が重複することを避けるために、ファイル名
の生成方法を指定します。
0:KeepPdfプロパティで指定されたファイル名を変更しません。
1:KeepPdfプロパティで指定されたファイル名に UTCタイムスタンプ文字列を追加
します。
2:KeepPdfプロパティで指定されたファイル名に UTCタイムスタンプ文字列および
GUID文字列を追加します。
LocalResourceOutput(格納先ローカルストレージ指定)
生成される PDFファイルをローカルストレージに格納する場合に、LocalResourceオブジェ
クトでローカルストレージを指定します。
KeepPdfプロパティでの指定はローカルストレージ内の相対パスとして扱われます。
格納先 Azureストレージの指定と重複した場合は、Azureストレージに格納されます。
45
Windows Azure 概要編-第4章 インタフェース仕様-
46
4.3.4.6. メソッドの詳細
【Windows版】と共通なメソッドの説明は省略します。
説明が省略されたプロパティについてはオンラインマニュアル”アプリケーション作成ガイド”を参照
してください。
Void setExecBuffer(string param)
用途
prprintコマンドのオプションを指定します。
prprintコマンドのオプションは、以下の優先順位で有効になります。
1)AzPrintPropertiesクラスの各プロパティで指定した値
2)このメソッドで指定した値
パラメータ
param : prprint コマンドのオプションを指定します。
prprint コマンドのオプションについては、オンラインマニュアル”アプリケーション作成ガ
イド”を参照してください。
例外
PrintException
注意
- 以下のコマンドオプションを指定しないでください。
・-atdirect
Windows Azure 概要編-第4章 インタフェース仕様-
4.3.5. AzPrintFormクラス
AzFormsまたはAzFormsFile、AzPrintPropertiesにしたがって、帳票出力を行うクラスです。
4.3.5.1. コンストラクタの概要
AzPrintFormクラスのコンストラクタを以下に示します。
表 4-9 AzPrintFormクラスのコンストラクタ
コンストラクタの概要
AzPrintForm ()
空のAzPrintFormオブジェクトを生成します。
AzPrintForm (string lcpath)
List Creatorの格納フォルダを指定して、AzPrintFormオブジェクトを生成します。
AzPrintForm (string lcdrive, string lcdir)
List Creatorの格納フォルダを指定して、AzPrintFormオブジェクトを生成します。
47
4.3.5.2. プロパティの概要
AzPrintForm クラスのプロパティを以下に示します。
表 4-10 AzPrintFormクラスのプロパティ
プロパティの分類 プロパティ名(プロパティの設定内容) データ型
PDFファイル保存情報
に関するプロパティ
OutputName(出力ファイル名取得) string
PDFファイル保存情報
に関するプロパティ
OutputPdfUri(出力ファイルURI取得) string
トレースログに関する
プロパティ
TraceLogFile (トレースログファイル
取得)
string
トレースログに関する
プロパティ
TraceLogUri(トレースログファイル
URI取得)
string
System.Object
fujitsu.listcreator.azure.AzPrintForm
Windows Azure 概要編-第4章 インタフェース仕様-
4.3.5.3. メソッドの概要
AzPrintFormクラスのメソッドを以下に示します。
表 4-11 AzPrintFormクラスのメソッド
メソッドの概要
PrintOut(AzCommon form, AzPrintProperties prop) Void
AzFormsまたはAzFormsFile、およびAzPrintProperties にしたが
って帳票出力を行います。
4.3.5.4. コンストラクタの詳細
AzPrintForm()
AzPrintForm(string lcpath)
AzPrintForm(string lcdrive, string lcdir)
用途
List Creatorの格納フォルダを指定して、AzPrintFormオブジェクトを生成します。
パラメータ
lcpath : List Creatorの実行モジュールを格納したロールのパッケージ内でのフォルダ
を指定します。
省略時の値は、@”¥approot¥bin”となります。(SDK1.4でロールのルートにモジ
ュールを置いたときのフォルダ)
lcdrive : List Creatorの実行モジュールを格納したドライブを指定します。
lcdir : List Creatorの実行モジュールを格納したフォルダを指定します。
例外
PrintException
4.3.5.5. プロパティの詳細
4.3.5.5.1. PDFファイル保存情報に関するプロパティ
OutputPdfName(出力ファイル名取得)
生成された PDFファイル名を取得します。
OutputPdfUri(出力ファイルURI取得)
Azureストレージに格納された PDFファイルの URIを取得します。
48
Windows Azure 概要編-第4章 インタフェース仕様-
4.3.5.5.2. トレースログに関するプロパティ
TraceLogFile(トレースログファイル取得)
トレースログファイルのフルパスを取得します。トレースログを Azureストレージに転送す
る場合は、ファイル名のみとなります。
TraceLogUri(トレースログファイルURI取得)
Azureストレージに転送されたトレースログファイルの URIを取得します。
‐ PrintOut メソッドが正常に終了した場合、必ずトレースログを取得してください。
‐ トレースログをAzureストレージに転送しない場合は、自動的に削除されません。トレ
ースログが不要となった場合は、ユーザアプリケーションで削除してください。
備考
‐ PrintException が発生した場合、このプロパティは使用できません。PrintException メ
ソッドの TraceLogFile プロパティで取得してください。PrintException オブジェクト
の TraceLogFile プロパティにはフルパスで通知されますが、Azureストレージに転送
した場合はファイル名のみ有効となります(転送前のフルパスが通知されています)。
4.3.5.6. メソッドの詳細
詳細については、オンラインマニュアル “アプリケーション作成ガイド”のPrintFormクラスに関する
記述を参照してください。
4.3.6. AzStorageクラス
Azureストレージの接続文字列名とコンテナ名を保持するクラスです。
4.3.6.1. コンストラクタの概要
AzStorageクラスのコンストラクタを以下に示します。
表 4-12 AzStorageクラスのコンストラクタ
49
コンストラクタの概要
AzStorage ()
空のAzStorageオブジェクトを生成します。接続文字列名とコンテナ名をプロパティで指定します。
AzStorage (string DataConnectionString, string ContainerName)
接続文字列名とコンテナ名を指定して、AzStorageオブジェクトを生成します。
System.Object
fujitsu.listcreator.azure.AzStorage
Windows Azure 概要編-第4章 インタフェース仕様-
4.3.6.2. プロパティの概要
AzStorage クラスのプロパティを以下に示します。
表 4-13 AzStorageクラスのプロパティ
プロパティの分類 プロパティ名(プロパティの設定内容) データ型
ストレージに関する
プロパティ
DataConnectionString(接続文字列名) string
ストレージに関する
プロパティ
ContainerName (コンテナ名) string
4.3.6.3. メソッドの概要
AzStorageクラスの公開メソッドはありません。
4.3.6.4. コンストラクタの詳細
AzStorage()
AzStorage(string DataConnectionString, string ContainerName)
用途
Azure Storageに接続するための、AzStorageオブジェクトを生成します。
パラメータ
DataConnectionString : Azureストレージの接続文字列名を指定します。
ContainerName : Azureストレージのコンテナ名を指定します。
例外
例外はありません。
4.3.6.5. プロパティの詳細
4.3.6.5.1. ストレージに関するプロパティ
DataConnectionString (接続文字列名)
Azureストレージの接続文字列名を指定します。
ContainerName(コンテナ名)
Azureストレージのコンテナ名を指定します。
‐ プロパティが正しく指定されていない場合、トレースログの格納先はファイルシステ
ムとなります。
50
Windows Azure 概要編-第 - 4章 インタフェース仕様
51
4.4. 例外
PrintExceptionクラスの例外が発生した場合は AsFormsクラスまたは AsFormsFileクラスで指定し
た Azureストレージにトレースログが転送されます。
PrintExceptionクラスの例外以外に、以下の例外が throwされます。
ArgumentNullException
Azureストレージを使用する場合、接続文字列名またはコンテナ名に nullが指定されています。
StorageClientException
Azureストレージでエラーが発生した場合(指定したファイルがなかった場合など)。
NotSupportedException
未サポートのメソッドが呼び出されました。未サポートのプロパティが指定されました。
RoleEnvironmentException
ローカルストレージが定義されていない。または名前に誤りがある可能性があります。
Windows Azure 概要編-第5章 保守-
52
第5章 保守
本章では、トラブル・エラーメッセージの対応について説明します。
Windows Azure 概要編-第5章 保守-
53
5.1. トラブル発生時の対処
List Creator ご利用中にトラブルや不具合などが発生した場合、以下の手順で対応してください。
なお、開発ファブリックにて発生するトラブルについては、開発環境のマニュアルや、オンラインマ
ニュアル”トラブルシューティング・メッセージ集” を参照してください。
1) イベントログなどが通知されていないかの確認とその対処をする
⇒ 5.1.1トラブル発生時のメッセージ確認
2) トラブル事例を参照し、対処する
⇒ 5.1.2 トラブルシューティング
3) 1)、2)でトラブルが解決しなかった場合、トラブル調査に必要な情報を採取し、当社技術員へ連
絡する
⇒ 5.1.3 対処できないトラブルが発生した場合
5.1.1. トラブル発生時のメッセージ確認
List Creatorを利用した帳票出力を行ってエラーが発生した場合は、その情報としてイベントログなど
にメッセージが通知されます。
したがって、List Creator をお使いの途中で不具合が発生した場合は、まず何かメッセージやログが
通知されていないかを確認してください。トラブルが発生した場合、発生したトラブルの状況および利
用環境を詳細に把握し記録することがとても重要です。
【Windows Azure版】における帳票出力時のイベントログは、ロールの DiagnosticMonitorで設定し
た Storage の テーブル (テーブル名“WADWindowsEventLogsTable”)に以下のように出力されます。
ProviderName EventID Level Channel RawXml の
<Data>タグ
ListCREATOR
ListCREATOR:MeFt
ListCREATOR:e-Doc
(【Windows版】と同じ)
【Windows版】と同じ 2(エラー)
3(警告)
4(情報)
Application メッセージ
イベントログのメッセージおよび原因と対処方法の詳細については、以下を参照してください。
⇒ 5.1.1.1 エラー詳細コードの原因と対処方法
Windows Azure 概要編-第5章 保守-
5.1.1.1. エラー詳細コードの原因と対処方法
【Windows Azure版】のみ発生するエラー詳細情報(ERROR CODE)の原因と対処方法について説
明します。
【Windows版】と共通のイベントログのメッセージおよび原因と対処方法の詳細については、オンラ
インマニュアル”トラブルシューティング・メッセージ集” 第2章 エラーメッセージと対処方法を参照し
てください。
● ソースが「ListCREATOR:MeFt」のイベントログ
エラー詳細:10-0013
【原因】:未サポートの機能(PDFファイル保存以外)が指定されました。
【対処】:PDFファイル保存以外は指定しないでください。
エラー詳細:32-3051
【原因】:未サポートの機能が定義されました。
【対処】:帳票定義情報に未サポートの機能を定義していないか確認する。
エラー詳細:42-3ed2
【原因】:未サポートの機能(グラフ出力)が指定されました。
【対処】:グラフ出力は指定しないでください。
5.1.2. トラブルシューティング
【Windows Azure版】を使用した場合に発生するトラブルの事例と対処方法については、オンライン
マニュアル”トラブルシューティング・メッセージ集” 第3章 トラブルシューティングを参照してくださ
い。
5.1.3. 対処できないトラブルが発生した場合
対処できないトラブルが発生した場合は、トラブル調査用情報を採取し、当社技術員にお渡しくださ
い。
トラブル調査用情報と取得方法は、以下のとおりです。
● イベントログ トラブルが発生した日時を含むWindowsのイベントログを保存してください。
イベントログの出力先については、以下を参照してください。
⇒ 5.1.1トラブル発生時のメッセージ確認
イベントログの詳細な保存方法については、Microsoft社の技術情報を参照してください。
54
Windows Azure 概要編-第5章 保守-
55
● トレースログ トレースログを採取する場合、あらかじめユーザアプリケーション側でトレースログをAzureストレー
ジに転送する設定を行う必要があります。
詳細については、AzPrintFormクラスのトレースログに関するプロパティを参照してください。
⇒ 4.3.5 AzPrintFormクラス
Azureストレージ上のトレースログを採取する場合、帳票資源ユーティリティを使用してください。帳
票資源ユーティリティについては、以下を参照してください。
⇒ 付録A 帳票資源ユーティリティについて
● フォーマッティングログ 以下のようなトラブルが発生した場合、迅速なトラブル解決のために、帳票レイアウトと入力データ
のフォーマッティング処理に関する詳細なログ情報(以降、フォーマッティングログ)が必要になりま
す。
思ったとおりの出力結果にならない
プロパティの指定どおりに出力されない
フォーマッティングログはトレースログとして一緒にパックされますが、通常は採取されません。フ
ォーマッティングログは以下の手順で採取してください。。
1) Webロールへリモートデスクトップ接続でログインしてください。
2) 以下のフォルダを開いてください。
- ( Webサイトのあるドライブ):¥approot¥bin¥ListCREATOR
Webサイトのあるドライブについては、サーバーマネージャを開き、デプロイされた IIS上のWeb
サイトの Pathから確認してください。
(例:デプロイされた IIS上のWebサイトの Path が『E:¥siteroot/』の場合は『E』)
3) 手順2)で開いたフォルダにあるList Creator のファイルの名前を以下のように変更してください。
ⅰ)「config.bip」を「config.bip.org」など、他の名前に変更してください。
ⅱ)「config.meftplog」を「config.bip」に変更してください。
4) 問題が起きた帳票を出力するアプリケーションを実行してください。
● その他情報 支障がなければ、以下の情報を併せて当社技術員にお知らせください。
帳票出力時に指定した帳票資源(帳票定義情報、入力データ、メディアデータファイル、PDF文書情
報ファイル)
現象が発生したときの詳細情報。例えば以下のような情報
業務への影響度
発生頻度
Windows Azure 概要編-第 - 5章 保守
56
動作環境
運用形態(オペレーティングシステム、搭載メモリ、搭載ディスク量、ディスク空き容量など)
インストールした List Creatorのバージョン
ユーザアプリケーションの開発環境およびバージョン
使用した【Windows Azure版】のメソッドと、呼び出しパラメータの内容
できるだけ詳しい操作手順や条件
Windows Azure 概要編-付録A 帳票資源ユーティリティについて-
付録A 帳票資源ユーティリティについて
A.1 概要
帳票資源ユーティリティは、【Windows Azure版】で使用する帳票資源の操作を、Azureストレージに
対して行うコマンド群です。
帳票資源ユーティリティには以下のコマンドがあります。
- azcontainerコマンド(コンテナを作成・削除する)
- azuploadコマンド(コンテナにファイルをアップロードする)
- azdownload コマンド(コンテナからファイルをダウンロード(コピー)、またはダウンロ
ード後にストレージから削除(移動)する)
A.2 コマンド仕様
A.2.1 azcontainerコマンド
[機能・概要]
Azureストレージ内でのコンテナの作成および削除を行います。
コンテナのアクセス権はパブリックアクセス可能となります。
作成時に同名のコンテナが既に存在していた場合は、エラーとなります。
削除時に存在しないコンテナを指定した場合は、エラーとなります。
[記述形式]
コンテナを作成する場合
コンテナを削除する場合
azcontainer create
コンテナ名
ストレージ URI
アカウント名
アカウントキー
コンテナ名
ストレージ URI
アカウント名
アカウントキー
azcontainer delete
57
Windows Azure 概要編-付録A 帳票資源ユーティリティについて-
[オプションの説明]
コマンドのオプションについて説明します。
create
コンテナを作成する場合に指定します。
delete
コンテナを削除する場合に指定します。
コンテナ名
作成または削除するコンテナの名前を指定します。
コンテナ名には英小文字のみ指定可能です。
ストレージURI
コンテナを格納する、または格納されているストレージの URIを指定します。
コンテナ名は含みません。
アカウント名
Windows Azureのアカウント名を指定します。
アカウントキー
『アカウント名』で指定したアカウントに対するアカウントキーを指定します。
[記述例]
コンテナを作成する場合
コンテナ名が「testcontainer」、ストレージURIが「http://myaccount.blob.core.wa.fj-cloud.net」、
アカウント名が「myaccount」、アカウントキーが「accountkey」として、コンテナを作成する。
コンテナを削除する場合
コンテナ名が「testcontainer」、ストレージURIが「http://myaccount.blob.core.wa.fj-cloud.net」、
アカウント名が「myaccount」、アカウントキーが「accountkey」として、コンテナを削除する。
azcontainer create testcontainer http://myaccount.blob.core.wa.fj-cloud.net myaccount
accountkey
azcontainer delete testcontainer http://myaccount.blob.core.wa.fj-cloud.net myaccount
accountkey
A.2.2 azuploadコマンド
[機能・概要]
ローカルからAzureストレージ内のコンテナへ、ファイルのアップロードを行います。
アップロードできるファイルの最大サイズは64Mbyteです。
[記述形式]
コマンドの形式を示します。
58
Windows Azure 概要編-付録A 帳票資源ユーティリティについて-
[オプションの説明]
コマンドのオプションについて説明します。
ファイル名
アップロードするファイルをフルパスで指定します。
ファイル名にはワイルドカードが使用可能です。
ストレージURI
ファイルをアップロードするストレージ URIを指定します。
ストレージ URIにはコンテナ名まで含めて指定してください。
アカウント名
Windows Azureのアカウント名を指定します。
アカウントキー
『アカウント名』で指定したアカウントに対するアカウントキーを指定します。
[記述例]
アップロード対象のファイル名へのフルパスが「c:¥assets¥*.*」、ストレージURIが
「http://myaccount.blob.core.wa.fj-cloud.net/testcontainer」、アカウント名が「myaccount」、
アカウントキーが「accountkey」として、コンテナを作成する。
azupload c:¥¥assets¥¥*.* http://myaccount.blob.core.wa.fj-cloud.net/testcontainer myaccount
azupload ファイル名
ストレージ URI
アカウント名
アカウントキー
A.2.3 azdownloadコマンド
[機能・概要]
Azureストレージ内のコンテナからローカルへ、ファイルのダウンロードを行います。
ダウンロード(コピー)と、ダウンロード後ストレージから削除(移動)が可能です。
ローカルパスに既に同名のファイルが存在した場合は、上書きされます。
[記述形式]
コマンドの形式を示します。
[ ]は、省略できることを示します。
[del]
アカウントキー
アカウント名
ストレージ URI
ローカルパス
azdownload ファイル名
59
Windows Azure 概要編-付録 - A 帳票資源ユーティリティについて
[オプションの説明]
ファイル名
ダウンロードするファイルをフルパスで指定します。
ファイル名にはワイルドカードが使用可能です。
ローカルパス
ダウンロードするファイルの格納先をフルパスで指定します。
ストレージURI
ダウンロードするファイルが格納されているストレージ URIを指定します。
ストレージ URIにはコンテナ名まで含めて指定してください。
アカウント名
Windows Azureのアカウント名を指定します。
アカウントキー
『アカウント名』で指定したアカウントに対するアカウントキーを指定します。
del
ファイルをダウンロード後にストレージから削除(移動)する場合に指定します。
省略した場合は、ファイルをダウンロード後にストレージからの削除を行いません。
[記述例]
ファイルをダウンロード(コピー)する場合
ダウンロード対象のファイル名が「*.trslog」、ストレージ URIが
「http://myaccount.blob.core.wa.fj-cloud.net/tracelog」、アカウント名が「myaccount」、アカウ
ントキーが「accountkey」として、ファイルをダウンロード(コピー)する。
ファイルをダウンロード後にストレージから削除(移動)する場合
ダウンロード対象のファイル名が「*.trslog」、ストレージ URIが
「http://myaccount.blob.core.wa.fj-cloud.net/tracelog」、アカウント名が「myaccount」、アカウ
ントキーが「accountkey」として、ファイルをダウンロードにストレージから削除(移動)する。
azdownload *.trslog c:¥log http://myaccount.blob.core.wa.fj-cloud.net/tracelog myaccount
azdownload *.trslog c:¥log http://myaccount.blob.core.wa.fj-cloud.net/tracelog myaccount accountkey
A.3 注意事項
アカウント名およびアカウントキーはあらかじめサポートポータルサイトで取得しておいてください。
アカウント名、アカウントキーまたはストレージ URIの指定に誤りがある場合は、リモートサーバか
らエラーが通知されます。
ファイル名指定にマッチするファイルが存在しない場合は、エラーになります。
実行環境に.NET Framework 4.0が必要です。
60
Windows Azure 概要編-付録B Azureストレージ上の資料採取について-
付録B Azureストレージ上の資料採取について
B.1 Azureストレージ上の資料採取について
ロールのインスタンスからAzure ストレージに転送されたDiagnosticsログなど、Azure ストレージ
上にあるデータを採取するには、ストレージにアクセスするツールを使用します。
この種のツールには多くのものがありますが、ここでは一例としてCloudXplorer(ブロブ用 )と
TableXplorer(テーブル用)というフリーのツールを使った手順を紹介します。すでにお使いのツールがあ
りましたら、そちらをご利用頂いて構いません。
B.1.1 Diagnosticsログの出力先と使用するツール
Diagnosticsログは種類に応じてブロブとテーブルに出力されます。
以下の表は、Diagnosticsログの出力先と、AzureストレージからDiagnosticsログを採取する場合、
どちらのツールを使用するかを表したものです。以下を参照して必要なツールを選択してください。
・ブロブに格納されるログ(CloudXplorerを使用)
ログの種類 出力先のコンテナ名/テーブル名
IISログ wad-iis-logfiles
IIS失敗ログ wad-iis-failedreqlogfiles
クラッシュダンプ wad-crash-dumps
その他のログファイル(*1) ユーザ設定に依る
*1: 必要に応じて、ユーザ側で追加してください
・テーブルに格納されるログ(TableXplorerを使用)
ログの種類 出力先のコンテナ名/テーブル名
トレースログ WADLogsTable
パフォーマンスカウンタ WADPerformanceCountersTable
イベントログ WADWindowsEventLogsTable
インフラログ WADDiagnosticInfrastructureLogsTable
入手方法
ツールは次の URL からダウンロードしてください。
CloudXplorer
http://clumsyleaf.com/products/cloudxplorer
TableXplorer
http://clumsyleaf.com/products/tablexplorer
61
Windows Azure 概要編-付録B Azureストレージ上の資料採取について-
B.1.2 事前準備
1) ソフトのインストール
ツールをダウンロードして、ストレージにアクセスしたいコンピュータ上(例えばローカルのコン
ピュータ)にインストールしてください。
以下の表はDiagnosticsログの出力先です。AzureストレージからDiagnosticsログを採取する場合
どちらのツールを使用するか、参照してください。
2) configファイルの編集(URLの変更)
CloudXplorerloudXplorer
ClumsyLeaf.CloudXplorer.UI.exe.configを編集します。以下の部分を変更してください。
configファイルは32bitオペレーティングシステムでは、「%PROGRAMFILES%¥ClumsyLeaf
Software¥CloudXplorer¥」に、64bitオペレーティングシステムでは「%PROGRAMFILES(X86)
%ClumsyLeaf Software¥CloudXplorer」にあります。
TableXplorer
ClumsyLeaf.TableXplorer.UI.exe.configを編集します。以下のように変更してください。
configファイルは32bitオペレーティングシステムでは、「%PROGRAMFILES%¥ClumsyLeaf
Software¥TableXplorer¥」に、64bitオペレーティングシステムでは「%PROGRAMFILES(X86)
%ClumsyLeaf Software¥TableXplorer」があります。
<add key="azureStorageEndpoint" value="http://table.core.windows.net"/>
↓
<add key="azureStorageEndpoint" value="http://table.core.wa.fj-cloud.net "/>
<add key="azureStorageEndpoint" value="http://blob.core.windows.net"/>
<add key="azureStorageEndpoint" value="http://blob.core.wa.fj-cloud.net "/>
↓
B.1.3 実行手順 (CloudXplorer)
1) CloudXplorer を起動します。
2) File] → [Accounts…]をクリックします。
62
Windows Azure 概要編-付録B Azureストレージ上の資料採取について-
3) [File] → [Accounts…]をクリックします。
4) [Name:]、[Secret Key:]にストレージアカウント名、キーを入力し、Path delimiterに “///” を
入力してください。
63
Windows Azure 概要編-付録B Azureストレージ上の資料採取について-
5) ブロブのデータをダウンロードする場合は次の手順にしたがってください。
(ア)左側のペインから、採取したいブロブが保存されているコンテナをクリックします。
(イ)右側のペインで、採取したいブロブを選択します。ディレクトリ構造になっている場合は、
全て展開してください。
(ウ)上部のボタンから、[Download] をクリックして、ローカルのコンピュータにファイルを保
存します。また、ツール内であれば、ドラッグ&ドロップを利用することもできます。
B.1.4 実行手順 (TableXplorer)
1) CloudXplorerと同様の手順(⇒ B.1.3 実行手順 (CloudXplorer))で、ストレージアカウント
名とキーを入力します。
64
Windows Azure 概要編-付録B Azureストレージ上の資料採取について-
2) テーブルのデータをダウンロードする場合は次の手順にしたがってください。
(ア)左側のペインから、 採取したいデータが保存されているテーブルをクリックします。
(イ)メニューの [Export data] ボタンを押します。
(ウ)保存場所のパスを選択します、この時ファイル名を拡張子付きで入力してください。
]を選
(オ) て、データを採取してください。
お、一度に表示されるデータ数は1000個までです。それ以上のデータがある場合は、メニューから
次
(エ)保存形式を選びます。[Export as CSV]を選択してください。[Separator]はComma[ ,
択してください。
Exportをクリックし
な
のページを表示して、資料を採取してください。
65
Windows Azure 概要編-付録C 注意事項-
付録C 注意事項
C.1 アプリケーション作成時の注意事項
Windows Azure環境でのListCreator実行モジュールの格納先は¥approot¥bin¥ListCREATORとな
っています。そのため、以下の処理でインスタンス化する必要があります。
const string LcPath = @"¥approot¥bin¥ListCREATOR;
AzPrintForm(LcPath);
出力要求ページ数が多い場合は、ロードバランサの制約により、要求を拒否される場合があります。
その場合は、WorkerロールとWebロールを分けるなど、工夫をしてください。
詳細はMicrosoftの技術情報を参照してください。
C.2 Azureストレージ使用時の注意事項
List Creatorは Azureストレージのブロブのリファレンス名をファイル名として動作します。そのた
め、ブロブのリファレンス名にはスラッシュ(/)を使用しないでください。
ブロブにアップロードする場合、1つのファイルが 64MB以上にならないようにしてください。
C.3 ローカルストレージ使用時の注意事項
パラメータおよびプロパティに LocalResourceオブジェクトを指定する場合は、以下の処理でオブジ
ェクトを取得します。
LocalResource local resource= RoleEnvironment.GetLocalResource("ローカルストレージ名");
C.4 ファイル、ファイルの格納先の指定に関する注意事項
帳票資源の格納先などのファイルパスを指定する場合、フォルダ名やディレクトリ名の末尾には、パ
スの区切り文字(「円マーク(¥)」または「スラッシュ(/)」)を指定しないでください。
帳票資源の格納先、帳票の出力先、トレースログなどのファイルパスを指定する場合、ドライブ名か
ら始まるパスを、フルパスで指定してください。
C.5 トレースログに関する注意事項
トレースログは、障害発生時に、原因究明や問題解決のために、必要になりますので、必ず取得して
ください。また、取得したトレースログを参照できるようにしてください。
生成されたトレースログは自動的に削除されません。トレースログが不要となった場合は、ユーザア
66
Windows Azure 概要編-付録C 注意事項-
67
プリケーションや帳票資源ユーティリティで削除してください。帳票資源ユーティリティについては以
下を参照してください。
⇒ 付録A 帳票資源ユーティリティについて
C.6 英語環境(英語ロケール)での帳票出力に関する注意事項
英語環境にて帳票出力を行う場合、いくつか注意事項があります。詳細は、オンラインマニュアル”解
説編”の英語環境での留意事項に関する記述を参照してください。
Windows Azure 概要編-付録D セキュリティについて-
付録D セキュリティについて
D.1 インターネット環境での利用とセキュリティについて
ネットワーク環境では、不正なアクセスによるシステムおよび資源の改ざんや破壊、情報の漏えいな
どの危険があります。このため、アプリケーションでユーザ制限を行うなど、自己防衛手段を講じる必
要があります。このようにセキュリティは、作成されたアプリケーションおよびその運用環境全体の適
切な設定と使用方法によって確保される必要があります。
D.1.1 資源の保護
プログラム、データに関する資源(データベース、データファイルなど)およびプログラムの動作に必要
な各種の定義・情報ファイルは、プログラムによるアクセス制限を行い、不正なアクセスや改ざんから
保護してください。特に重要な資源は、ファイアウォールを配置したイントラネット環境内に保持して
ください。
D.1.2 アプリケーション作成のための指針
セキュリティを考慮したアプリケーションを作成するための参考にしてください。
1) 事前確認と処理結果の通知
対話・応答を行う処理の場合、重要なデータへのアクセスや処理については、事前の確認および処
理結果を通知して、誤った処理を検知できる設計を行ってください。また、ログを記録すると処理の
解析に役立ちます。
2) 匿名性
ユーザの実名、実物を識別できるデータについては、特に漏えいの危険性を考慮してください。
3) インタフェースの検査
外部インタフェースについては、バッファオーバフロー(バッファオーバラン)やクロスサイトスク
リプティングなどを考慮して、セキュリティホールの作り込みを防止してください。バッファオーバ
フローを防止するためには、外部インタフェースの入力データの長さ、型や属性などの検査が有効で
す。クロスサイトスクリプティングは、動的に生成されたページ中に意図しないタグが含まれないよ
うにする事で防止できます。例えば、出力時にメタキャラクタをエスケープする方法があります。
4) 繰り返し実行
同じ接続先からの一定時間内でのリクエスト数を制限するなどの考慮をしてください。
68
Windows Azure 概要編-付録D セキュリティについて-
69
5) 監査ログの記録
アプリケーションによるログ出力処理の作成などにより、セキュリティに関するイベントを記録し
て、セキュリティ侵害が発生した場合の分析や追跡方法を考慮してください。
6) セキュリティのためのルールの制定
セキュリティに関する脆弱な処理が無い堅牢なアプリケーションを作成するためには、セキュリテ
ィ侵害の脅威から保護すべき重要な資源を特定し、資源のアクセスやインタフェース設計のために特
定のルールを制定することが有効です。
7) 通信データの暗号化
通信データを暗号化して、インターネット上での接続を保護してください。通信データを暗号化す
るためには、SSL を利用して Web サーバと Web ブラウザの間の HTTP メッセージを暗号化する
方法があります。
Windows Azure 概要編-付録E Windows Azureの用語-
付録E Windows Azureの用語
Windows Azureの用語について説明します。
用語 説明
キュー 一時的なデータの保存用のストレージです。Webロール、Workerロール、
または外部アプリケーションとの間での通信手段として使用します。
クラウド(クラウドコ
ンピューティング)
ネットワークを介してサービスを提供/利用するコンピューティング形
態のことです。
コンテナ ブロブを束ねるフォルダのことです。
ストレージ Windows Azureでのデータ格納先です。
テーブル 表形式の構造をもったストレージです。データを特定するためのキーと、
それに対応する値の集合で表現されます(Key-Value型ストア)。
デプロイ アプリケーションをWindows Azure Platformに配置することです。
ブロック ブロブを分割したものです。ブロックに分割することでファイルのアッ
プロード時間を短縮でき、また、アップロードに失敗した際には差分の
みアップロードすればよいというメリットがあります。
ブロブ 主にバイナリデータを保存するためのストレージです。
ローカルストレージ Windows Azure上で動作する、Webロール・Workerロール内に確保され
るストレージ領域です。ロールインスタンス単位で確保されるため、イ
ンスタンス間での共有はできません。また、ロールを再起動・再配置し
た場合、データが削除されます。
ロール コンピュートサービス上で実行できるアプリケーションのことです。
Webロール HTTPリクエストを処理するためのロールです。Webアプリケーション、
Webサービスに相当します。
Workerロール バックグラウンドプロセスを実行するためのロールです。Windowsサー
ビスに相当します。
70