79
B1WD-3019-02Z0(00) 20125Windows Interstage List Creator V1 powered by Windows Azure (1.1.0) Windows Azure 概要編

Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

  • Upload
    vuthu

  • View
    231

  • Download
    1

Embed Size (px)

Citation preview

Page 1: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

B1WD-3019-02Z0(00)2012年5月

Windows

Interstage List Creator V1powered by Windows Azure (1.1.0)

Windows Azure 概要編

Page 2: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-まえがき-

2

まえがき

本書は、List Creator powered by Windows Azure の概要、サポート範囲、アプリケーションの開発から運用・

保守に関する情報について説明しています。

◆ 本書の構成

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

第1章 概要

【Windows Azure 版】の概要について説明します。

第2章 サポート範囲

【Windows Azure 版】のサポートしている機能について説明します。

第3章 アプリケーションの作成

アプリケーションの作成から配置・実行までの流れについて説明します。

第4章 インタフェース仕様

インタフェース仕様について説明します。

第5章 保守

トラブル・エラーメッセージの対応について説明します。

付録A 帳票資源ユーティリティについて

帳票資源ユーティリティについて説明します。

付録B Azure ストレージ上の資料採取について

Azure ストレージ上の資料採取に用いるツールについて説明します。

付録C 注意事項

【Windows Azure 版】を使用する上での注意事項について説明します。

付録D セキュリティについて

インターネット環境での利用とセキュリティについて説明します。

付録E Windows Azure の用語

Windows Azure の用語について説明します。

Page 3: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-まえがき-

3

◆ 対象読者と前提知識

本書は、【Windows Azure 版】を利用するシステム管理者を対象としています。本書を読むためには、

以下の知識が必要です。

● クラウドコンピューティングに対する基本的な知識

● Windows Azure Platform に対する基本的な知識

● Microsoft Visual Studio に対する基本的な知識

● .NET Framework に関する知識

● C#、Visual Basic に関する知識

● 使用するオペレーティングシステムに対する基本的な知識

◆ 著作権

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

Copyright 2011-2012 FUJITSU LIMITED

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

本書をお読みになる前に、【Windows Azure 版】のオンラインマニュアル“マニュアル体系と読み方”をお読

みください。

【Windows Azure 版】のオンラインマニュアル“マニュアル体系と読み方”には、List Creator のマニュア

ル体系、マニュアルの読み方、表記上の規則、対象読者と前提知識、用語の対応表、および商標などについて

記載されています。

Page 4: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-目次-

目次

第 1 章 概要 .....................................................................................................................9

1.1. 機能概要 ........................................................................................................................... 10

1.2. 運用形態 ........................................................................................................................... 12

第 2 章 サポート範囲 .....................................................................................................13

2.1. 帳票生成・出力機能のサポート範囲 ................................................................................... 14

2.2. 帳票定義情報のサポート範囲 ............................................................................................ 15

2.2.1. 帳票様式情報のサポート範囲 ...................................................................................... 15

2.2.2. 帳票業務情報のサポート範囲 ...................................................................................... 17

2.3. 情報ファイルのサポート範囲 .............................................................................................. 19

2.3.1. 情報ファイル種別......................................................................................................... 19

2.3.2. PDF 文書情報ファイルのサポート範囲 ........................................................................ 19

2.3.3. Excel 文書情報ファイルのサポート範囲 ...................................................................... 22

2.4. 帳票出力環境設定ファイルのサポート範囲 ........................................................................ 24

2.5. Excel 環境設定ファイルのサポート範囲............................................................................ 25

第 3 章 アプリケーションの作成 ...................................................................................26

3.1. 作成手順 ........................................................................................................................... 27

3.2. アプリケーションの開発 ...................................................................................................... 28

3.2.1. サンプルプログラムの概要 ........................................................................................... 28

3.2.2. プロジェクトの新規作成 ................................................................................................ 29

3.2.3. プロジェクトの設定 ....................................................................................................... 29

3.2.4. Web デザインの例...................................................................................................... 31

3.2.5. アプリケーション記述例 ................................................................................................ 32

3.2.6. アプリケーションのコンパイル・発行 .............................................................................. 32

3.2.7. アプリケーションのデバッグ .......................................................................................... 32

3.3. Windows Azure へのデプロイ............................................................................................ 33

第 4 章 インタフェース仕様 ..........................................................................................34

4.1. SDK モジュール構成 ........................................................................................................ 35

4.2. .NET 名前空間 ................................................................................................................. 36

4.3. クラスインタフェース ........................................................................................................... 37

4.3.1. AzCommon クラス..................................................................................................... 37

4.3.2. AzForms クラス ......................................................................................................... 37

4.3.3. AzFormsFile クラス ................................................................................................... 40

4

Page 5: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-目次-

4.3.4. AzPrintProperties クラス .......................................................................................... 43

4.3.5. AzPrintForm クラス ................................................................................................... 52

4.3.6. AzStorage クラス ....................................................................................................... 55

4.4. 例外 .................................................................................................................................. 57

第 5 章 保守 ...................................................................................................................58

5.1. トラブル発生時の対処........................................................................................................ 59

5.1.1. トラブル発生時のメッセージ確認 .................................................................................. 59

5.1.2. トラブルシューティング.................................................................................................. 60

5.1.3. 対処できないトラブルが発生した場合 ........................................................................... 61

付録A 帳票資源ユーティリティについて.....................................................................63

A.1 概要 .................................................................................................................................. 63

A.2 コマンド仕様 ...................................................................................................................... 63

A.2.1 azcontainer コマンド .................................................................................................. 63

A.2.2 azupload コマンド ...................................................................................................... 64

A.2.3 azdownload コマンド ................................................................................................. 65

A.3 注意事項 ........................................................................................................................... 66

A.4 エラーメッセージと対処方法 ............................................................................................... 67

付録B Azure ストレージ上の資料採取について .........................................................68

B.1 Azure ストレージ上の資料採取について ........................................................................... 68

B.1.1 Diagnostics ログの出力先と使用するツール.............................................................. 68

B.1.2 事前準備 ..................................................................................................................... 69

B.1.3 実行手順 (CloudXplorer)......................................................................................... 70

B.1.4 実行手順 (TableXplorer) .......................................................................................... 72

付録C 注意事項 ............................................................................................................74

C.1 アプリケーション作成時の注意事項 .................................................................................... 74

C.2 Azure ストレージ使用時の注意事項 ................................................................................. 74

C.3 ローカルストレージ使用時の注意事項 ................................................................................ 74

C.4 ファイル、ファイルの格納先の指定に関する注意事項 ......................................................... 74

C.5 トレースログに関する注意事項........................................................................................... 75

C.6 Excel シート名指定時に関する注意事項........................................................................... 75

C.7 英語環境(英語ロケール)での帳票出力に関する注意事項 ................................................. 75

付録D セキュリティについて.......................................................................................76

D.1 インターネット環境での利用とセキュリティについて ............................................................. 76

D.1.1 資源の保護 ................................................................................................................. 76

D.1.2 アプリケーション作成のための指針 .............................................................................. 76

5

Page 6: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-目次-

6

付録E Windows Azure の用語....................................................................................78

Page 7: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-図目次-

図目次

図 1-1 【Windows Azure 版】の運用形態 ................................................................................ 12

図 3-1 サンプルプログラムの概要 ............................................................................................. 28

図 3-2 プロジェクトの追加 ......................................................................................................... 30

7

Page 8: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-表目次-

表目次

表 2-1 帳票生成・出力機能のサポート範囲 ............................................................................... 14

表 2-2 帳票様式情報のサポート範囲 ........................................................................................ 15

表 2-3 帳票業務情報のサポート範囲 ........................................................................................ 17

表 2-4 情報ファイルのサポート範囲........................................................................................... 19

表 2-5 PDF 文書情報ファイルのサポート範囲 ........................................................................... 19

表 2-6 Excel 文書情報ファイルのサポート範囲 ......................................................................... 22

表 2-7 帳票出力環境設定ファイルのサポート範囲 ..................................................................... 24

表 2-8 Excel 環境設定ファイルのサポート範囲 ......................................................................... 25

表 4-1 AzForms クラスのコンストラクタ..................................................................................... 38

表 4-2 AzForms クラスのプロパティ ......................................................................................... 38

表 4-3 AzForms クラスのメソッド .............................................................................................. 38

表 4-4 AzFormsFile クラスのメソッド ........................................................................................ 40

表 4-5 AzFormsFile クラスのプロパティ ................................................................................... 41

表 4-6 AzPrintProperties クラスのコンストラクタ...................................................................... 43

表 4-7 AzPrintProperties クラスのプロパティ(分類ごとの一覧)............................................... 44

表 4-8 AzPrintProperties クラスのメソッド ............................................................................... 45

表 4-9 AzPrintForm クラスのコンストラクタ .............................................................................. 52

表 4-10 AzPrintForm クラスのプロパティ ................................................................................. 52

表 4-11 AzPrintForm クラスのメソッド ...................................................................................... 53

表 4-12 AzStorage クラスのコンストラクタ ................................................................................ 55

表 4-13 AzStorage クラスのプロパティ ..................................................................................... 55

8

Page 9: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第1章 概要-

第1章 概要

本章では、【Windows Azure 版】の概要について説明します。

9

Page 10: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第1章 概要-

1.1. 機能概要

【Windows Azure 版】では、Windows Azure 上でPDF ファイルおよびExcel ファイルの帳票を出

力するための機能を提供します。

提供する機能の概要は以下のとおりです。

● 帳票Web サービスインタフェース

Web サービスを使用した帳票出力を行うアプリケーションを作成できます。Web サービスとは、

SOAP プロトコルにより呼び出し可能なアプリケーションサービスです。 帳票 Web サービスイン

タフェースの詳細については、【Windows Azure 版】のオンラインマニュアル"帳票 Web サービス機

能編"を参照してください。

● 出力インタフェース

.NET インタフェースを使用して、帳票出力アプリケーション(Web ロール)を作成できます。

.NET インタフェースのマルチフォーム出力、組合せフォーム出力は未サポートです。

● 出力方法

PDF ファイル保存および Excel ファイル出力を行うことができます。PDF メール配信機能、ファ

イル添付機能は未サポートです。

● 帳票定義情報

List Creator デザイナで定義した帳票定義情報を使用できます。

利用可能な帳票形式は以下のとおりです。

- 「フリーフレーム形式」

- 「伝票形式」

- 「集計表形式」

- 「カード形式」

- 「矩形繰返し形式」

- 「タックシール形式」

● 入力データ

「固定長」、「可変長」、「CSV 形式」の入力データを使用できます。

XBRL データ対応機能 / Navigator 連携機能は未サポートです。

入力データは、UNICODE(UTF8)が使用できます。

● 資源の配置先

以下の資源は、Azure ストレージまたはローカルストレージ上に配置できます。

- 帳票定義情報

- メディアデータファイル

10

Page 11: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第1章 概要-

- PDF 文書情報ファイル

- Excel 文書情報ファイル

● PDF ファイルおよびExcel ファイルの出力先

PDF ファイルおよび Excel ファイルの出力先には、Azure ストレージまたはローカルストレージ上

のパスが指定できます。

ローカルストレージ上に生成したPDF ファイルおよびExcel ファイルの保存が必要な場合はAzure

ストレージなどへ転送してください。

● イベントログ

エラーが発生した場合は、エラー内容をイベントログに出力します。

詳細については以下を参照してください

⇒ 5.1.1 トラブル発生時のメッセージ確認

なお、イベントログを参照するためには事前設定が必要です。

詳細については、以下を参照してください。

⇒ 3.2.3 プロジェクトの設定

● トレースログ

トレースログファイルは、トラブル発生時の原因究明や問題解決のために必要な情報です。

1 回の出力要求に対し、1つのトレースログファイルがローカルストレージに作成されます。指定に

より作成されたトレースログファイルを Azure ストレージに転送することができます。Azure スト

レージに転送後ローカルストレージ上のログファイルは自動的に削除されます。

Azure ストレージへの転送を指定しない場合は、帳票出力処理が正常終了した場合でも、Azure ス

トレージへ転送して参照できるようにアプリケーションで対応してください。

● 英語環境(英語ロケール)での動作保証

【Windows Azure 版】では、日本語環境以外に英語環境で帳票を出力することができます。

英語環境での帳票出力については、【Windows Azure 版】のオンラインマニュアル”解説編”を参照し

てください。

11

Page 12: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第1章 概要-

1.2. 運用形態

以下に、【Windows Azure 版】の帳票出力処理の流れについて説明します。

1) 配置

Windows Azure 環境に、Azure アプリケーションと帳票資源をデプロイしてください。

2) 出力

List Creator は、帳票(PDF ファイルおよび Excel ファイル)およびトレースログファイルを生

成し、Azure ストレージに格納します。格納先は.NET インタフェースで指定します。また、帳票出

力時にエラーが発生した場合はイベントログに出力します。

3) 閲覧/保存

Azure ストレージに格納された帳票およびイベントログ・トレースログを閲覧/保存できます。保

存の際は帳票資源ユーティリティを使用します。

Web ロール/ Worker ロール

Interstage List Creatorpowered by Windows Azure

Azureアプリケーション

Windows Azure開発端末

Interstage List Creatorデザイナ

Microsoft Visual StudioMicrosoft Web Developer

①配置

: 実行/起動

: 出力

: 作成/デプロイ

: 通信

帳票資源 トレースログ帳票

(PDF ファイル / Excel ファイル)

イベントログ

Azure Storage

②出力③閲覧/保存

Web ロール/ Worker ロール

Interstage List Creatorpowered by Windows Azure

Azureアプリケーション

Windows Azure開発端末

Interstage List Creatorデザイナ

Microsoft Visual StudioMicrosoft Web Developer

①配置

: 実行/起動

: 出力

: 作成/デプロイ

: 通信

帳票資源 トレースログ帳票

(PDF ファイル / Excel ファイル)

イベントログ

Azure Storage

②出力③閲覧/保存

図 1-1 【Windows Azure 版】の運用形態

備考

‐ 帳票資源の配置および帳票(PDF ファイルおよびExcel ファイル)の格納先にローカルスト

レージを指定することも可能です。この場合、生成された帳票およびトレースログファイルを

Azure ストレージへ転送して参照できるようにユーザアプリケーションで対応してください。

12

Page 13: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

第2章 サポート範囲

ここでは、【Windows Azure 版】のサポートしている機能について説明します。

13

Page 14: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

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: マルチフォーム出力、組合せフォーム出力は未サポートです。

14

Page 15: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

2.2. 帳票定義情報のサポート範囲

2.2.1. 帳票様式情報のサポート範囲

帳票様式情報のサポート範囲を以下に示します。

表 2-2 帳票様式情報のサポート範囲

分類 製品種別によるサポート状況

○:サポート

△:サポート(一部の機能が未サポ

ート)

-:未サポート

Windows 版 Windows

Azure 版

フリーフレーム形式 ○ ○

カード形式 ○ ○

伝票形式 ○ ○

集計表形式 ○ ○

矩形繰返し形式 ○ ○

帳票形式

タックシール形式 ○ ○

ヘッダ部 ○ ○

ボディ部 ○ ○ 伝票形式

テイル部 ○ ○

集計表形式 パーティション ○ ○

ヘッダ(HEAD) ○ ○

ボディ(BODY) ○ ○

フッタ(FOOT) ○ ○

フレーム ○ ○

ブロック

(部・領域)

フリーフレ

ーム形式

フレームパーティション ○ ○

項目 ○ △(*1)(*2)(*3)

オーバレイ ○ ○

帳票レイアウト

情報

オブジェクト

パーティション罫線 ○ ○

可変長 ○ ○

固定長 ○ ○

CSV 形式 ○ △(*4) 入力データ形式

XML 形式 ○ -

15

Page 16: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

データ定義 ○ ○ 帳票レイアウト

情報と入力デー

タとの関連付け

情報

拡張定義 ○ ○

*1: 日付項目、および時刻項目は、Windows Azure のタイムゾーンの設定(UTC)にしたがって処理されます。

Windows Azure 環境は UTC のため、動作するタイムゾーンを設定可能とし、タイムゾーンにしたがった日時

にて処理されます。

*2: 以下は未サポートとなります。

矩形テキスト項目の、折返し後の行頭空白抑止

以下のバーコード項目(PDF ファイル保存の場合)

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

なお、Excel ファイル出力の場合は、上記を含めすべてのバーコード項目が未サポートです。

グラフ出力機能

*3: Unicode の文字を指定することができます。Unicode の文字を使用する場合の帳票定義情報の作成方法や留意

事項についてはデザイナヘルプを参照してください。

*4: ダブルクォーテーション(")が 2 つ続いた場合に、1 つのダブルクォーテーションとして扱う指定は未サポー

トです。詳細については、【Windows Azure 版】のオンラインマニュアル“環境設定・帳票運用編” の List

Creator の環境設定コマンドに関する記載を参照してください。

16

Page 17: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

2.2.2. 帳票業務情報のサポート範囲

帳票業務情報のサポート範囲を示します。

表 2-3 帳票業務情報のサポート範囲

分類 製品種別によるサポート状況

○:サポート

△:サポート(一部の機能が未サポ

ート)

-:未サポート

Windows 版 Windows

Azure 版

全般 ○ -

印刷 ○ △(*1)

電子保存 ○ -

FAX ○ -

ファイル保存する ○ ○

格納先ファイル名 ○ ○(*2)

サブタイトル ○ ○ 概要

作成者 ○ ○

互換性のある形式 ○ ○ セキュリティ

権限 ○ ○

URI による閲覧制限を行う ○ ○ 閲覧制限

期間による閲覧制限を行う ○ ○(*3)

文字の埋め込み ○ △(*4)

JPEG 圧縮時の品質 ○ ○

PDF ファイルに添付するファイル

○ - 文書管理

バーコード線画 ○ ○

PDF ファイル表示時のアプリケー

ションの設定

○ ○

PDF ファイルの自動印刷を行う ○ ○

ファイル

(PDF) 文書情報

動作

閲覧制限時の動作 ○ ○

ファイル保存する ○ ○

格納先ファイル名 ○ ○(*2)

ファイル

(Excel)

シート名 ○ ○

17

Page 18: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

明細出力モード(連続) ○ ○

バーコード補正情報 ○ -

サブタイトル ○ ○ 文書情報 概要

作成者 ○ ○

*1: [印刷]タブの置換フォントのみ有効となります。

*2: ローカルストレージ上のパスを指定可能です。Azure ストレージを使用する場合は、.NET インタフェースで

指定してください。

*3: Windows Azure 環境は UTC のため、動作するタイムゾーンを設定可能とし、タイムゾーンにしたがった日時

にて処理されます。

*4: PDF フォント登録機能は使用できません。帳票設計時に使用する文字に MS 明朝を指定した場合、「FUJ 明

朝」が出力する PDF ファイルの帳票に使用されます。また、帳票設計時に使用する文字に MS ゴシックを指

定した場合、「FUJ ゴシック」が出力する PDF ファイルの帳票に使用されます。帳票設計時にその他のフォ

ントを指定した場合は、「FUJ 明朝」に対する埋め込み指定となります。

18

Page 19: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

2.3. 情報ファイルのサポート範囲

2.3.1. 情報ファイル種別

以下に情報ファイルのサポート範囲を示します。

表 2-4 情報ファイルのサポート範囲

情報ファイル種別 製品種別によるサポート状況

○:サポート

-:未サポート

Windows 版 Windows

Azure 版

置換フォント情報ファイル ○ -

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

帳票出力情報ファイル ○ -

PDF 文書情報ファイル ○ ○

PDF メール配信情報ファイル ○ -

Excel 文書情報ファイル ○ ○

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 ファイルの文書情報の作成者を記述します。 ○ ○

19

Page 20: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

PDF-AUTOPRINT PDF ファイルに自動印刷方式を設定します。 ○ ○

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 ファイルを開いたときのページレイアウト

を設定します。

○ ○

20

Page 21: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

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 ファイルのセキュリティ情報として印刷の

許可/ 不許可を設定します。

○ ○

PDF-RESOURCEPERPAG

E

PDF ファイルのResource 辞書をページ毎に作成

します。

○ ○

21

Page 22: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

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 明朝」に対する埋め込み指定となります。

2.3.3. Excel 文書情報ファイルのサポート範囲

以下に、Excel 文書情報ファイルのサポート範囲を示します。

表 2-6 Excel 文書情報ファイルのサポート範囲

キーワード名 説明 製品種別によるサポート状況

○:サポート

-:未サポート

Windows 版 Windows

Azure 版

[MF-XLSX] Excel 文書情報ファイルの宣言です。 ○ ○

XLSX-SHEETPWD シート保護パスワードを指定します。 ○ ○

XLSX-SAVEPWD ブックの書き込みパスワードを指定します。 ○ ○

XLSX-TITLE タイトルを指定します。 ○ ○

XLSX-SUBTITLE サブタイトルを指定します。 ○ ○

XLSX-AUTHOR 作成者を指定します。 ○ ○

XLSX-CTLWMSG 重複する警告メッセージの出力の有無を指定し

ます。

○ ○

22

Page 23: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

XLSX-OFFICE シート数拡張を指定します。 ○ ○

XLSX-EXTFUNC 拡張機能の出力を指定します。 ○ ○

XLSX-MDASHARE 組込みメディア項目のイメージデータ共用を指

定します。

○ ○

XLSX-STRSTYLE 文字列の書式を指定します。 ○ ○

XLSX-JUSTPAGEPRT ページ印刷調整を指定します。 ○ ○

XLSX-HATCHDRAWMODE 網がけ描画モードを指定します。 ○ ○

XLSX-LINEDRAWMODE 罫線描画モードを指定します。 ○ ○

23

Page 24: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

2.4. 帳票出力環境設定ファイルのサポート範囲

以下に、帳票出力環境設定ファイルのサポート範囲を示します。

表 2-7 帳票出力環境設定ファイルのサポート範囲

キーワード名 説明 製品種別によるサポート状況

○:サポート

-:未サポート

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」(サロゲートペアを出力する)が設定されています。

24

Page 25: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第2章 サポート範囲-

25

2.5. Excel 環境設定ファイルのサポート範囲

以下に、Excel 環境設定ファイルのサポート範囲を示します。

表 2-8 Excel 環境設定ファイルのサポート範囲

キーワード名 説明 製品種別によるサポート状況

○:サポート

-:未サポート

Windows 版 Windows

Azure 版

XLSX-OFFICE シート数拡張を指定します。 ○ ○

XLSX-EXTFUNC 拡張機能の出力を指定します。 ○ ○

XLSX-MDASHARE 組込みメディア項目のイメージデータ共用を指

定します。

○ ○

XLSX-STRSTYLE 文字列の書式を指定します。 ○ ○

XLSX-JUSTPAGEPRT ページ印刷調整を指定します。 ○ ○

XLSX-HATCHDRAWMODE 網がけ描画モードを指定します。 ○ ○

XLSX-LINEDRAWMODE 罫線描画モードを指定します。 ○ ○

Page 26: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第3章 アプリケーションの作成-

第3章 アプリケーションの作成

【Windows Azure 版】が提供するインタフェースを使用したユーザアプリケーション(プログラム)

の作成方法から運用・保守までの流れについて説明します。

26

Page 27: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第3章 アプリケーションの作成-

27

3.1. 作成手順

【Windows Azure 版】で.NET インタフェースを利用したユーザアプリケーションは、以下の流れ

で作成します。

1) アプリケーション開発ファブリックの準備

[必須ソフトウェア]

- Windows Azure SDK 1.6

- .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.6”を使用します。これをサポートしてい

るバージョンのWindows Azure Guest OS を使用してください。

Page 28: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第3章 アプリケーションの作成-

3.2. アプリケーションの開発

ここではWindows Azure アプリケーションの開発方法を、List Creator のサンプルを用いて説明しま

す。作成言語はVisual C#を用いてASP.NET アプリケーションを作成します。サンプルプログラムは、

(インストールフォルダ)¥Samples に格納されています。

‐ ここではVisual Studio 2010 を使ったアプリケーション開発手順を説明します。

‐ Visual Studio を実行する場合、必ず「管理者として実行」を選択してください。コンパイル

時に管理者の資格情報が必要となります。詳しくはMicrosoft の技術情報を参考にしてくださ

い。

‐ Windows Azure は、アプリケーションからは64bit のオペレーティングシステムとして認識

されます。そのため、64bit のWindows Azure アプリケーションを作成してください。

3.2.1. サンプルプログラムの概要

(インストールフォルダ)¥Samples に格納されているサンプルプログラムの概要について説明します。

図 3-1 サンプルプログラムの概要

ユーザがWeb ページ上の「ボタン」を押すと、PDF ファイルの帳票が生成されます。

生成されたPDF ファイルの帳票は「ハイパーリンク」から取り出すことができます。

メッセージを出力するラベル

帳票を取り出すためのハイパーリンク

帳票出力ボタン

出力完了メッセージやエラーメッセージは「ラベル」に表示されます。

28

Page 29: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第3章 アプリケーションの作成-

3.2.2. プロジェクトの新規作成

Visual Studio を起動後、新しいプロジェクトを作成します。インストールされたテンプレートから

「Visual C#」の「Cloud」を選択し、Windows Azure クラウドサービスプロジェクトを選択します。

名前や格納場所は環境に合わせて設定してください。

その後、作成するロールを選択します。ここでは、「ASP.NET Web ロール」をクラウドサービスソリ

ューションに追加します。

ここでは、Azure Development 環境でアプリケーション開発を行い、その後Windows Azure 環境へ

デプロイ手順を前提とします。

3.2.3. プロジェクトの設定

Windows Azure アプリケーションを作成するために、下記の設定が必要です。

① .NET インタフェースモジュールの参照設定

.NET インタフェースのモジュール(f4gcacif.dll, f4gcazif.dll,f4gcdnif.dll) を、参照設定に追加して

ください。

上記ファイルは、(インストールフォルダ)¥module フォルダ内に格納されています。

② List Creator のモジュールの追加

プロジェクトに追加するモジュールは、(インストールフォルダ)¥module¥ListCREATOR フォル

ダの配下にある全てのファイルです。これらをWeb ロール直下に追加してください。

追加したモジュールすべてのプロパティ[出力ディレクトリにコピー]属性を、[常にコピーする]に

設定してください。

なお、図3-2 のようにList Creator のモジュールをまとめることもできます。

各モジュールの関係性(役割)については、以下を参照してください。

⇒ 第4章 インタフェース仕様

29

Page 30: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第3章 アプリケーションの作成-

図 3-2 プロジェクトの追加

‐ Web ロール直下にList Creator モジュールを配置しない場合、(インストールフォ

ルダ)¥sdk フォルダ内に格納されている以下の6つのモジュールをWeb ロール直

下に配置してください。

F4GCALOG.dll

f4gcccl1.dll

f4gcccml.dll

f4gccloc.dll

F4GCCLOG.dll

LcRegInfo.conf

また、サンプルプログラムの修正が必要です。

30

Page 31: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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 -

31

Page 32: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第3章 アプリケーションの作成-

32

3.2.5. アプリケーション記述例

(インストールフォルダ)¥sample フォルダ内のサンプルプログラム(Default.aspx.cs、Global.asax.cs、

WebRole.cs)を参考に、アプリケーションの作成を行ってください。

なお、サンプルプログラムの言語はC# です。

3.2.6. アプリケーションのコンパイル・発行

アプリケーションの記述が完了したら、ソリューションのビルドを行います。

なお、詳細については使用する開発ファブリックのドキュメントを参照してください。

3.2.7. アプリケーションのデバッグ

ビルドが完了したアプリケーションの動作確認を、開発ファブリックで行います。以下の手順が必要

です。

1) 作成したアプリケーションを実行し、Azure Storage Emulator を起動する。

2)

3)

起動したAzure Storage Emulator に帳票定義情報をデプロイする。

デプロイ方法は、Azure Storage Emulator の技術情報を参照してください。

Web アプリケーションの動作を確認する。

‐ ビルド作業を行う前に、IIS_IUSRS に対するアクセス権を追加してください。IIS の

ソリューションに対するアクセス権がない場合、アプリケーションが正常に動作し

ません。

‐ 32bit オペレーティングシステムの開発環境では、上記の手順でデバックを行うこと

ができません。必ず、ステージング環境での動作検証を行ってください。

Page 33: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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 へデプロイする前に、サンプルプログラムの編集が必要です。実行

する環境に合わせて内容を編集してください。

33

Page 34: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

第4章 インタフェース仕様

ここでは、【Windows Azure 版】が提供する帳票出力のインタフェースについて説明します。

34

Page 35: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

4.1. SDK モジュール構成

.NET インタフェースは、以下の構成となっています。

種類 名前

DLL ファイル f4gcacif.dll

f4gcazif.dll

f4gcdnif.dll

35

Page 36: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

4.2. .NET 名前空間

【Windows Azure 版】が提供する.NET インタフェースには、以下の種類の名前空間があります。

帳票出力を行うためのインタフェース

【Windows Azure 版】で帳票出力を行うためのクラスを提供します。

名前空間は以下のとおりです。

fujitsu.listcreator.azure

fujitsu.listcreator

名前空間fujitsu.listcreator.azure で提供されているクラスはfujitsu.listcreator を参照していま

す。

定数を名前で指定する場合は、名前空間fujitsu.listcreator で提供されているクラス名で修飾して

ください。

36

Page 37: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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 クラス

各クラスが継承するクラスです。アプリケーションが直接使用することはありません。

System.Object

fujitsu.listcreator.azure.AzCommon

4.3.2. AzForms クラス

帳票の出力時に使用する帳票と入力データを保持するクラスです。

fujitsu.listcreator.azure.AzCommon

fujitsu.listcreator.azure.AzForms

37

Page 38: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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

帳票を出力するための入力データとなるレ

コード(行)文字列を追加します。

38

Page 39: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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 メソッド指定後、このプロパティは指定できません。

39

Page 40: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

4.3.2.6. メソッドの詳細

4.3.2.6.1. レコード(行)出力に関するメソッド

void

pushRecord(string record)

用途

帳票を出力するための入力データとなるレコード(行)文字列を追加します。

パラメータ

record : レコード(行)文字列を指定します。

1レコード(行)ずつレコード(行)文字列をセットしてください。

レコード(行)文字列には改行コードを含めないでください。

例外

PrintException

注意

帳票出力時の文字コードを指定する場合、このメソッド指定前に DataCode プロパティで文字コ

ードを指定してください。

4.3.3. AzFormsFile クラス

帳票の出力時に使用する帳票を保持するクラスです。

fujitsu.listcreator.azure.AzCommon

fujitsu.listcreator.azure.AzFormsFile

4.3.3.1. コンストラクタの概要

AzFormsFile クラスのコンストラクタを以下に示します。

表 4-4 AzFormsFile クラスのメソッド

コンストラクタの概要

AzFormsFile(string assets, AzStorage log)

帳票を格納するディレクトリ(ファイルシステム)を指定して、帳票を保持するAzFormsFile を

作成します。(入力データはファイルシステム上)

AzFormsFile(LocalResource localresource, string relativepath, AzStorage log)

帳票を格納するローカルストレージと相対パスを指定して、帳票を保持するAzFormsFile を作成

します。(入力データはファイルシステム上)

40

Page 41: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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 ストレージ上に格納した場合は、ファイル名のみ有効になります。

41

Page 42: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

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 : ローカルストレージ内の帳票を格納するディレクトリの相対パスを

指定します。

帳票を格納するAzure ストレージを指定します。 storageassets :

入力データ格納Azure ストレージを指定します。 storagedata :

トレースログ格納Azure ストレージを指定します。Azure ストレー

ジに格納しないで、ファイルシステムに残す場合はnull、または空の

AzStorage インスタンスを指定します。

log :

入力データ格納ローカルストレージのLocalResource オブジェクト

を指定します。

localresourcedata :

42

Page 43: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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 クラス

帳票の出力方法、および帳票出力時に指定するプロパティを保持するクラスです。

System.Object

fujitsu.listcreator.azure.AzPrintProperties

4.3.4.1. コンストラクタの概要

AzPrintProperties クラスのコンストラクタを以下に示します。

表 4-6 AzPrintProperties クラスのコンストラクタ

コンストラクタの概要

AzPrintProperties()

空のAzPrintProperties オブジェクトを生成します。

43

Page 44: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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(PDF ファイル格納先Azure ストレージ) AzStorage

AddUniqueName(PDF ファイル名にタイムスタンプおよびGUID を

付加する指定)

int

LocalResourceOutput(PDF ファイル格納先ローカルストレージ指定) LocalResource

PdfSubTitle(PDF ファイルのサブタイトル) string

PdfAuthor(PDF ファイルの作成者) string

PdfPrint(PDF ファイルの印刷許可指定) int

PdfModify(PDF ファイルの文書変更許可指定) int

PdfSelect(PDF ファイルのテキストとグラフィックスの選択許可指

定)

int

PdfAnnotate(PDF ファイルの注釈とフォームフィールドの追加と変

更許可指定)

int

PDF ファイル保存

情報に関するプロ

パティ

PdfPwd(PDF ファイルを開くパスワード) string

44

Page 45: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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

KeepXlsx(Excel ファイル出力時の格納先ファイル名) string

StorageOutputXlsx(Excel ファイル格納先Azure ストレージ) AzStorage

AddUniqueNameXlsx(Excel ファイル名にタイムスタンプおよび

GUID を付加する指定)

int

LocalResourceOutputXlsx(Excel ファイル格納先ローカルストレージ

指定)

LocalResource

XlsxDocEnvFile(Excel 文書情報ファイル名) string

XlsxOutputForm(Excel ファイル出力時の明細の出力方法) int

Excel ファイル出

力情報に関するプ

ロパティ

XlsxSheetName(出力するExcel ファイルのシート名指定) string

4.3.4.3. メソッドの概要

AzPrintProperties クラスのメソッドを以下に示します。

表 4-8 AzPrintProperties クラスのメソッド

メソッドの概要

setExecBuffer(string param) void

prprint コマンドのオプションを指定します。

45

Page 46: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

4.3.4.4. コンストラクタの詳細

AzPrintProperties()

用途

空の AzPrintProperties オブジェクトを生成します。

4.3.4.5. プロパティの詳細

【Windows 版】と共通なプロパティについての説明は省略します。

説明が省略されたプロパティについては、【Windows Azure 版】のオンラインマニュアル“アプリケ

ーション作成ガイド”を参照してください。

4.3.4.5.1. ユーザ資源情報に関するプロパティ

VisualDir(メディアデータ格納ディレクトリ)

帳票出力サーバのメディアデータ格納ディレクトリをフルパスで指定します。

複数のメディアデータ格納ディレクトリを指定する場合は、「セミコロン(;)」で区切って指

定します。指定した複数のディレクトリ配下に同一名のメディアデータがある場合は、先に指定

したディレクトリ配下のメディアデータが有効になります。

組込みメディア項目のデータがファイル名のみの場合、メディアデータ格納ディレクトリ配下

を検索します。

メディアデータを Azure ストレージ(ブロブストレージ)に格納した場合は以下の形式で指定

します。

指定されたファイル名がブロブのリファレンス名として動作します。

運用環境の場合:

http://(ストレージアカウント名).blob core.windows.net/ (コンテナ名)/

開発ファブリック(開発ストレージ)の場合:

http://127.0.0.1:10000/devstoreaccount1/(コンテナ名)/

‐ ‐ このプロパティで指定したストレージのコンテナは、パブリックアクセスが可能である必

要があります。

‐ 入力データに、組み込みメディア項目のファイル名をURI で指定することはできません。

4.3.4.5.2. 動作情報に関するプロパティ

備考

‐ 帳票出力時のList Creator の動作(優先順序含む)や留意事項などについては、【Windows

Azure 版】のオンラインマニュアル“環境設定・帳票運用編”を参照してください。

また、入力データなどに関する留意事項については、【Windows Azure 版】のオンライン

マニュアル“帳票設計編”を参照してください。

46

Page 47: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

47

TimeZone(タイムゾーン指定)

UTC(協定世界時)からの時差を指定します。

記述形式は以下のとおりです。

+HHMM (進める場合)

-HHMM (遅らせる場合)

HH:時(00~23)

MM:分(00~59)

省略した場合は、ローカルタイムで出力されます。

DirectMethod(出力方法)

OutputMode(出力方法)

帳票の出力方法を指定します。

【Windows Azure 版】では PDF ファイル保存および Excel ファイル出力のみ指定可能です。

DirectMethod プロパティは、帳票で指定されている出力方法に関係なく出力方法を指定した

い場合に指定してください。

OutputMode プロパティは、帳票で指定されている出力方法のうち、特定の出力方法で出力

したい場合に指定してください。

以下に、指定できる値を示します。

OUTPUTMODE_DEFAULT:

帳票に定義されている出力方法で帳票を出力します。

OUTPUTMODE_PDF:

PDF ファイル保存を指定します。

OUTPUTMODE_EXCEL:

Excel ファイル出力を指定します。

なお、帳票の出力方法は、以下の優先順序で有効になります。

1) DirectMethod プロパティで指定した出力方法

(ただし、「OUTPUTMODE_DEFAULT」を指定した場合は、OutputMode プロパテ

ィで指定した値が有効となります)

2) OutputMode プロパティで指定した出力方法

3) 帳票で指定されている出力方法

4.3.4.5.3. PDF ファイル保存情報に関するプロパティ

‐ ‐ PDF 変換機能のサポート範囲、使用する資源、および留意事項については、

【Windows Azure 版】のオンラインマニュアル“PDF 変換機能編”、および、以

下を参照してください。

⇒ 第2章 サポート範囲

Page 48: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

KeepPdf(ファイル保存時の格納先ファイル名)

PDF ファイルをファイルシステムに出力する場合は、格納先ファイル名(PDF ファイル名)

を 259 文字以内かつ 512 バイト以内のフルパスで指定します。

PDF ファイルを Azure ストレージに出力する場合は、格納先ファイル名(PDF ファイル名)

のみ指定します。パスは有効となりません。

PDF ファイルをローカルストレージに出力する場合は、格納先ファイル名(PDF ファイル

名)を相対パスで指定します。

‐ フォルダ名のみの指定はできません。

‐ 同一名ファイルがすでに存在するときにPDF ファイル保存に失敗した場合は、元の

PDF ファイルも削除されることがあります。

備考

‐ 生成されるPDF ファイルには、帳票を出力したユーザのアクセス権が設定されま

す。

‐ 指定されたフォルダが存在しない場合、フォルダが自動生成されます。

フォルダには、親フォルダと同じアクセス権が設定されます。自動生成されたフォ

ルダに対し、帳票を出力するユーザがアクセス権を持たない場合は、AzPrintForm

クラスのPrintOut メソッド呼び出し時にエラーになります。

‐ 同一名ファイルがすでに存在する場合は、ファイルを上書きする権限があれば新し

いファイルに置き換えられます。ファイルを上書きする権限がない場合は、

AzPrintForm クラスのPrintOut メソッド呼び出し時にエラーになります。

PdfDocEnvFile(PDF 文書情報ファイル名)

PDF 文書情報ファイル名をフルパスで指定します。

帳票資源を Azure ストレージまたはローカルストレージに格納した場合は、帳票資源と同一

の場所に格納されている必要があります。

Azure ストレージが指定されている場合はファイル名のみ有効となり、ローカルストレージ

の場合は相対パスとして扱われます。

StorageOutput(PDF ファイル格納先Azure ストレージ)

生成される PDF ファイルを Azure ストレージに格納する場合に、接続文字列とコンテナ名

を格納した AzStorage クラスのインスタンスを指定します。

AddUniqueName(PDF ファイル名にタイムスタンプおよびGUID を付加する指定)

Azure ストレージに格納される PDF ファイル名が重複することを避けるために、ファイル

名の生成方法を指定します。

0:KeepPdf プロパティで指定されたファイル名を変更しません。

48

Page 49: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

1:KeepPdf プロパティで指定されたファイル名に UTC タイムスタンプ文字列を追加

します。

2:KeepPdf プロパティで指定されたファイル名に UTC タイムスタンプ文字列および

GUID 文字列を追加します。

LocalResourceOutput(PDF ファイル格納先ローカルストレージ指定)

生成される PDF ファイルをローカルストレージに格納する場合に、LocalResource オブジェ

クトでローカルストレージを指定します。

KeepPdf プロパティでの指定はローカルストレージ内の相対パスとして扱われます。

格納先 Azure ストレージの指定と重複した場合は、Azure ストレージに格納されます。

4.3.4.5.4. Excel ファイル出力情報に関するプロパティ

‐ ‐ Excel ファイル出力機能のサポート範囲、使用する資源、および留意事項につい

ては、【Windows Azure 版】のオンラインマニュアル“Excel ファイル出力機能編”、

および、以下を参照してください。

⇒ 第2章 サポート範囲

KeepXlsx(Excel ファイル出力時の格納先ファイル名)

Excel ファイルをファイルシステムに出力する場合は、格納先ファイル名(Excel ファイル名)

を 259 文字以内かつ 512 バイト以内のフルパスで指定します。

Excel ファイルを Azure ストレージに出力する場合は、格納先ファイル名(Excel ファイル

名)のみ指定します。パスは有効となりません。

Excel ファイルをローカルストレージに出力する場合は、格納先ファイル名(Excel ファイル

名)を相対パスで指定します。

‐ フォルダ名のみの指定はできません。

‐ 同一名ファイルがすでに存在するときにExcel ファイル出力に失敗した場合は、元

のExcel ファイルも削除されることがあります。

備考

‐ 指定されたフォルダが存在しない場合、フォルダが自動生成されます。

フォルダには、親フォルダと同じアクセス権が設定されます。自動生成されたフォ

ルダに対し、帳票を出力するユーザがアクセス権を持たない場合は、AzPrintForm

クラスのPrintOut メソッド呼び出し時にエラーになります。

‐ 同一名ファイルがすでに存在する場合は、ファイルを上書きする権限があれば新し

いファイルに置き換えられます。ファイルを上書きする権限がない場合は、

AzPrintForm クラスのPrintOut メソッド呼び出し時にエラーになります。

49

Page 50: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

StorageOutputXlsx(Excel ファイル格納先Azure ストレージ)

生成される Excel ファイルを Azure ストレージに格納する場合に、接続文字列とコンテナ名

を格納した AzStorage クラスのインスタンスを指定します。

AddUniqueNameXlsx(Excel ファイル名にタイムスタンプおよびGUID を付加する指定)

Azure ストレージに格納される Excel ファイル名が重複することを避けるために、ファイル

名の生成方法を指定します。

0:KeepXlsx プロパティで指定されたファイル名を変更しません。

1:KeepXlsx プロパティで指定されたファイル名に UTC タイムスタンプ文字列を追

加します。

2:KeepXlsx プロパティで指定されたファイル名に UTC タイムスタンプ文字列およ

び GUID 文字列を追加します。

LocalResourceOutputXlsx(Excel ファイル格納先ローカルストレージ指定)

生成される Excel ファイルをローカルストレージに格納する場合に、LocalResource オブジ

ェクトでローカルストレージを指定します。

KeepXlsx プロパティでの指定はローカルストレージ内の相対パスとして扱われます。

格納先 Azure ストレージの指定と重複した場合は、Azure ストレージに格納されます。

XlsxDocEnvFile(Excel 文書情報ファイル名)

Excel 文書情報ファイル名をフルパスで指定します。

帳票資源を Azure ストレージまたはローカルストレージに格納した場合は、帳票資源と同一

の場所に格納されている必要があります。

Azure ストレージが指定されている場合はファイル名のみ有効となり、ローカルストレージ

の場合は相対パスとして扱われます。

XlsxSheetName(出力するExcel ファイルのシート名指定)

出力する Excel ファイルのシート名の設定方法(命名方法)を指定します。

FORM :帳票名をシート名として出力する場合に指定します。

FIXED :固定文字列をシート名として出力する場合に指定します。固定文字列をシー

ト名とする場合、「FIXED=」に続けてシート名とする文字列を 31 文字以内

で指定します。以下に指定例を示します。

FIXED=SalesByDivision

このプロパティの呼び出しを省略すると、帳票業務情報のプロパティ画面の[ファイル

(Excel)]タブで指定したシート名が有効になります。

50

Page 51: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

‐ 以下の文字をシート名に指定しないでください。「¥」、「/」、「?」、「*」、「[」、「」」、「:」

また、文字列前後の「'」(シングルクォーテーション)も指定できません(文字列間で

は使用できます)。

‐ FIXED とイコール(=)の間に空白が含まれる場合(FIXED =XXXX)は、エラーにな

ります。

‐ 「FIXED=」に続けて固定文字列を指定しなかった場合は、このプロパティが指定され

なかった(省略した)とみなします。

備考

‐ シート名は、全角・半角およびアルファベットの大文字・小文字は区別されず、同じ文

字として扱われます。

‐ 32 文字以上のシート名を指定した場合は、31 文字で収まるように文字が切り詰めら

れます(32 文字以降の文字は切り捨てられます)。

‐ Excel シート名の指定と出力結果の対応、および指定に関する留意事項など、Excel シ

ート名の指定に関する詳細は、【Windows Azure 版】のオンラインマニュアル“Excel

ファイル出力機能編”を参照してください。

4.3.4.6. メソッドの詳細

【Windows 版】と共通なメソッドの説明は省略します。

説明が省略されたプロパティについては【Windows Azure 版】のオンラインマニュアル”アプリケー

ション作成ガイド”を参照してください。

Void setExecBuffer(string param)

用途

prprint コマンドのオプションを指定します。

prprint コマンドのオプションは、以下の優先順位で有効になります。

1)AzPrintProperties クラスの各プロパティで指定した値

2)このメソッドで指定した値

パラメータ

param : prprint コマンドのオプションを指定します。

prprint コマンドのオプションについては、【Windows Azure 版】のオンラインマニュアル”

アプリケーション作成ガイド”を参照してください。

例外

PrintException

注意

- 以下のコマンドオプションを指定しないでください。

・-atdirect

51

Page 52: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

4.3.5. AzPrintForm クラス

AzForms またはAzFormsFile、AzPrintProperties にしたがって、帳票出力を行うクラスです。

System.Object

fujitsu.listcreator.azure.AzPrintForm

4.3.5.1. コンストラクタの概要

AzPrintForm クラスのコンストラクタを以下に示します。

表 4-9 AzPrintForm クラスのコンストラクタ

コンストラクタの概要

AzPrintForm ()

空のAzPrintForm オブジェクトを生成します。

AzPrintForm (string lcpath)

List Creator の格納フォルダを指定して、AzPrintForm オブジェクトを生成します。

AzPrintForm (string lcdrive, string lcdir)

List Creator の格納フォルダを指定して、AzPrintForm オブジェクトを生成します。

4.3.5.2. プロパティの概要

AzPrintForm クラスのプロパティを以下に示します。

表 4-10 AzPrintForm クラスのプロパティ

プロパティの分類 プロパティ名(プロパティの設定内容) データ型

PDF ファイル保存情報

に関するプロパティ

OutputPdfName(出力ファイル名取得) string

PDF ファイル保存情報

に関するプロパティ

OutputPdfUri(出力ファイルURI 取得) string

Excel ファイル出力情

報に関するプロパティ

OutputXlsxName(出力ファイル名取得) string

Excel ファイル出力情

報に関するプロパティ

OutputXlsxUri(出力ファイルURI 取得) string

52

Page 53: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

トレースログに関する

プロパティ

TraceLogFile (トレースログファイル取

得)

string

トレースログに関する

プロパティ

TraceLogUri(トレースログファイル

URI 取得)

string

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”となります。(Windows Azure SDK でロール

のルートにモジュールを置いたときのフォルダ)

lcdrive : List Creator の実行モジュールを格納したドライブを指定します。

lcdir : List Creator の実行モジュールを格納したフォルダを指定します。

例外

PrintException

53

Page 54: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

4.3.5.5. プロパティの詳細

4.3.5.5.1. PDF ファイル保存情報に関するプロパティ

OutputPdfName(出力ファイル名取得)

生成された PDF ファイル名を取得します。

OutputPdfUri(出力ファイルURI 取得)

Azure ストレージに格納された PDF ファイルの URI を取得します。

4.3.5.5.2. Excel ファイル出力情報に関するプロパティ

OutputXlsxName(出力ファイル名取得)

生成された Excel ファイル名を取得します。

OutputXlsxUri(出力ファイルURI 取得)

Azure ストレージに格納された Excel ファイルの URI を取得します。

4.3.5.5.3. トレースログに関するプロパティ

TraceLogFile(トレースログファイル取得)

トレースログファイルのフルパスを取得します。トレースログを Azure ストレージに転送す

る場合は、ファイル名のみとなります。

TraceLogUri(トレースログファイルURI 取得)

Azure ストレージに転送されたトレースログファイルの URI を取得します。

‐ PrintOut メソッドが正常に終了した場合、必ずトレースログを取得してください。

‐ トレースログをAzure ストレージに転送しない場合は、自動的に削除されません。ト

レースログが不要となった場合は、ユーザアプリケーションで削除してください。

備考

‐ PrintException が発生した場合、このプロパティは使用できません。PrintException メ

ソッドの TraceLogFile プロパティで取得してください。PrintException オブジェクト

の TraceLogFile プロパティにはフルパスで通知されますが、Azure ストレージに転送

した場合はファイル名のみ有効となります(転送前のフルパスが通知されています)。

4.3.5.6. メソッドの詳細

詳細については、【Windows Azure 版】のオンラインマニュアル “アプリケーション作成ガイド”の

PrintForm クラスに関する記述を参照してください。

54

Page 55: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

4.3.6. AzStorage クラス

Azure ストレージの接続文字列名とコンテナ名を保持するクラスです。

System.Object

fujitsu.listcreator.azure.AzStorage

4.3.6.1. コンストラクタの概要

AzStorage クラスのコンストラクタを以下に示します。

表 4-12 AzStorage クラスのコンストラクタ

コンストラクタの概要

AzStorage ()

空のAzStorage オブジェクトを生成します。接続文字列名とコンテナ名をプロパティで指定しま

す。

AzStorage (string DataConnectionString, string ContainerName)

接続文字列名とコンテナ名を指定して、AzStorage オブジェクトを生成します。

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 オブジェクトを生成します。

55

Page 56: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

パラメータ

DataConnectionString : Azure ストレージの接続文字列名を指定します。

Azure ストレージのコンテナ名を指定します。 ContainerName :

例外

例外はありません。

4.3.6.5. プロパティの詳細

4.3.6.5.1. ストレージに関するプロパティ

DataConnectionString (接続文字列名)

Azure ストレージの接続文字列名を指定します。

ContainerName(コンテナ名)

Azure ストレージのコンテナ名を指定します。

‐ プロパティが正しく指定されていない場合、トレースログの格納先はファイルシステ

ムとなります。

56

Page 57: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第4章 インタフェース仕様-

57

4.4. 例外

PrintException クラスの例外が発生した場合は AsForms クラスまたは AsFormsFile クラスで指定

した Azure ストレージにトレースログが転送されます。

PrintException クラスの例外以外に、以下の例外が throw されます。

ArgumentNullException

Azure ストレージを使用する場合、接続文字列名またはコンテナ名に null が指定されています。

StorageClientException

Azure ストレージでエラーが発生した場合(指定したファイルがなかった場合など)。

NotSupportedException

未サポートのメソッドが呼び出されました。未サポートのプロパティが指定されました。

RoleEnvironmentException

ローカルストレージが定義されていない。または名前に誤りがある可能性があります。

Page 58: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第5章 保守-

58

第5章 保守

本章では、トラブル・エラーメッセージの対応について説明します。

Page 59: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第5章 保守-

59

5.1. トラブル発生時の対処

List Creator ご利用中にトラブルや不具合などが発生した場合、以下の手順で対応してください。

なお、開発ファブリックにて発生するトラブルについては、開発環境のマニュアルや、【Windows Azure

版】のオンラインマニュアル”トラブルシューティング・メッセージ集” を参照してください。

1) イベントログなどが通知されていないかの確認とその対処をする

⇒ 5.1.1トラブル発生時のメッセージ確認

2) トラブル事例を参照し、対処する

⇒ 5.1.2 トラブルシューティング

3) 1)、2)でトラブルが解決しなかった場合、トラブル調査に必要な情報を採取し、当社技術員へ連

絡する

⇒ 5.1.3 対処できないトラブルが発生した場合

5.1.1. トラブル発生時のメッセージ確認

List Creator を利用した帳票出力を行ってエラーが発生した場合は、その情報としてイベントログな

どにメッセージが通知されます。

したがって、List Creator をお使いの途中で不具合が発生した場合は、まず何かメッセージやログが

通知されていないかを確認してください。トラブルが発生した場合、発生したトラブルの状況および利

用環境を詳細に把握し記録することがとても重要です。

【Windows Azure 版】における帳票出力時のイベントログは、ロールの DiagnosticMonitor で設定

したストレージのテーブル (テーブル名“WADWindowsEventLogsTable”)に以下のように出力されま

す。

ProviderName EventID Level Channel RawXml の

<Data>タグ

ListCREATOR

ListCREATOR:MeFt

ListCREATOR:e-Doc

ListCREATOR:e-DocX

【Windows 版】と同

2(エラー)

3(警告)

4(情報)

Application メッセージ

イベントログのメッセージおよび原因と対処方法の詳細については、以下を参照してください。

⇒ 5.1.1.1 エラー詳細コードの原因と対処方法

Page 60: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第5章 保守-

5.1.1.1. エラー詳細コードの原因と対処方法

【Windows Azure 版】のみ発生するエラー詳細情報(ERROR CODE)の原因と対処方法について説

明します。

【Windows 版】と共通のイベントログのメッセージおよび原因と対処方法の詳細については、

【Windows Azure 版】のオンラインマニュアル”トラブルシューティング・メッセージ集” 第2章 エラ

ーメッセージと対処方法を参照してください。

● ソースが「ListCREATOR:MeFt」のイベントログ

エラー詳細:10-0013

【原因】:未サポートの機能(PDF ファイル保存およびExcel ファイル出力以外)が指定されました。

【対処】:PDF ファイル保存およびExcel ファイル出力以外は指定しないでください。

エラー詳細:32-3051

【原因】:未サポートの機能が定義されました。

【対処】:帳票定義情報に未サポートの機能を定義していないか確認してください。

未サポートの機能については、以下を参照してください。

⇒ 2.2 帳票定義情報のサポート範囲

エラー詳細:32-3350

【原因】:Excel ファイル出力時、未サポートの機能(バーコード)が指定されました。

【対処】:帳票様式情報にバーコード項目を定義しないでください。

エラー詳細:42-3ed2

【原因】:未サポートの機能(グラフ出力)が指定されました。

【対処】:グラフ出力は指定しないでください。

5.1.2. トラブルシューティング

【Windows Azure 版】を使用した場合に発生するトラブルの事例と対処方法について説明します。

【Windows 版】と共通のトラブルの事例については、【Windows Azure 版】のオンラインマニュアル”

トラブルシューティング・メッセージ集” 第3部 トラブルシューティングを参照してください。

5.1.2.1. 大量ページ帳票の出力時にタイムアウトが発生する

原因

Azure の仕様上、Web ロールは実行時間 60 秒でタイムアウトします(ロードバランサーによる

監視)。Web ロールで帳票の出力処理を行っている場合、この制限によりタイムアウトが発生し

ている可能性があります。

60

Page 61: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第5章 保守-

61

対処方法

Worker ロールで帳票の出力処理を行うことで、ロードバランサーによる監視を回避してください。

具体的には、以下の用にアプリケーションを作成してください。

- 帳票の出力処理を Worker ロール(バックグラウンド)で実行させる。

- 帳票の出力要求と結果取得は Web ロール(フロントエンド)で実行させる。

- Worker ロールと Web ロールは非同期で処理させる。

5.1.3. 対処できないトラブルが発生した場合

対処できないトラブルが発生した場合は、トラブル調査用情報を採取し、当社技術員にお渡しくださ

い。

トラブル調査用情報と取得方法は、以下のとおりです。

● イベントログ トラブルが発生した日時を含むWindows のイベントログを保存してください。

イベントログの出力先については、以下を参照してください。

⇒ 5.1.1トラブル発生時のメッセージ確認

イベントログの詳細な保存方法については、Microsoft 社の技術情報を参照してください。

● トレースログ トレースログを採取する場合、あらかじめユーザアプリケーション側でトレースログをAzure ストレ

ージに転送する設定を行う必要があります。

詳細については、AzPrintForm クラスのトレースログに関するプロパティを参照してください。

⇒ 4.3.5 AzPrintForm クラス

Azure ストレージ上のトレースログを採取する場合、帳票資源ユーティリティを使用してください。

帳票資源ユーティリティについては、以下を参照してください。

⇒ 付録A 帳票資源ユーティリティについて

● フォーマッティングログ 以下のようなトラブルが発生した場合、迅速なトラブル解決のために、帳票レイアウトと入力データ

のフォーマッティング処理に関する詳細なログ情報(以降、フォーマッティングログ)が必要になりま

す。

思ったとおりの出力結果にならない

プロパティの指定どおりに出力されない

フォーマッティングログはトレースログとして一緒にパックされますが、通常は採取されません。フ

ォーマッティングログは以下の手順で採取してください。

Page 62: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-第5章 - 保守

62

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 文書情

報ファイル)

現象が発生したときの詳細情報。例えば以下のような情報

業務への影響度

発生頻度

動作環境

運用形態(オペレーティングシステム、搭載メモリ、搭載ディスク量、ディスク空き容量など)

インストールした List Creator のバージョン

ユーザアプリケーションの開発環境およびバージョン

使用した【Windows Azure 版】のメソッドと、呼び出しパラメータの内容

できるだけ詳しい操作手順や条件

Page 63: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A 帳票資源ユーティリティについて-

付録A 帳票資源ユーティリティについて

A.1 概要

帳票資源ユーティリティは、【Windows Azure 版】で使用する帳票資源の操作を、Azure ストレージ

に対して行うコマンド群です。

帳票資源ユーティリティには以下のコマンドがあります。

- azcontainer コマンド(コンテナを作成・削除する)

- azupload コマンド(コンテナにファイルをアップロードする)

- azdownload コマンド(コンテナからファイルをダウンロード(コピー)、またはダウンロ

ード後にストレージから削除(移動)する)

A.2 コマンド仕様

A.2.1 azcontainer コマンド

[機能・概要]

Azure ストレージ内でのコンテナの作成および削除を行います。

コンテナのアクセス権はパブリックアクセス可能となります。

作成時に同名のコンテナが既に存在していた場合は、エラーとなります。

削除時に存在しないコンテナを指定した場合は、エラーとなります。

[記述形式]

コンテナを作成する場合

コンテナを削除する場合

azcontainer create

コンテナ名

ストレージ URI

アカウント名

アカウントキー

azcontainer delete

コンテナ名

ストレージ URI

アカウント名

アカウントキー

63

Page 64: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A 帳票資源ユーティリティについて-

[オプションの説明]

コマンドのオプションについて説明します。

create

コンテナを作成する場合に指定します。

delete

コンテナを削除する場合に指定します。

コンテナ名

作成または削除するコンテナの名前を指定します。

コンテナ名には英小文字のみ指定可能です。

ストレージURI

コンテナを格納する、または格納されているストレージの URI を指定します。

コンテナ名は含みません。

アカウント名

Windows Azure のアカウント名を指定します。

アカウントキー

『アカウント名』で指定したアカウントに対するアカウントキーを指定します。

[記述例]

コンテナを作成する場合

コンテナ名が「testcontainer」、ストレージ URI が「http://myaccount.blob.core.windows.net」、

アカウント名が「myaccount」、アカウントキーが「accountkey」として、コンテナを作成する。

コンテナを削除する場合

azcontainer create testcontainer http://myaccount.blob.core.windows.net myaccount

accountkey

コンテナ名が「testcontainer」、ストレージ URI が「http://myaccount.blob.core.windows.net」、

アカウント名が「myaccount」、アカウントキーが「accountkey」として、コンテナを削除する。

A.2.2 azupload コマンド

[機能・概要]

ローカルからAzure ストレージ内のコンテナへ、ファイルのアップロードを行います。

アップロードできるファイルの最大サイズは64Mbyte です。

[記述形式]

コマンドの形式を示します。

azcontainer delete testcontainer http://myaccount.blob.core.windows.net myaccount

accountkey

64

Page 65: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A 帳票資源ユーティリティについて-

65

[オプションの説明]

コマンドのオプションについて説明します。

ファイル名

アップロードするファイルをフルパスで指定します。

ファイル名にはワイルドカードが使用可能です。

ストレージURI

ファイルをアップロードするストレージ URI を指定します。

ストレージ URI にはコンテナ名まで含めて指定してください。

アカウント名

Windows Azure のアカウント名を指定します。

アカウントキー

『アカウント名』で指定したアカウントに対するアカウントキーを指定します。

[記述例]

アップロード対象のファイル名へのフルパスが「c:¥assets¥*.*」、ストレージURI が

「http://myaccount.blob.core.windows.net/testcontainer」、アカウント名が「myaccount」、

azupload ファイル名

ストレージ URI

アカウント名

アカウントキー

アカウントキーが「accountkey」として、コンテナを作成する。

azupload c:¥¥assets¥¥*.* http://myaccount.blob.core.windows.net/testcontainer myaccount accountkey

A.2.3 d コマンド

[機

可能です。

スに既に同名のファイルが存在した場合は、上書きされます。

[記

[ ること

azdownloa

能・概要]

Azure ストレージ内のコンテナからローカルへ、ファイルのダウンロードを行います。

ダウンロード(コピー)と、ダウンロード後ストレージから削除(移動)が

ローカルパ

述形式]

コマンドの形式を示します。

]は、省略でき を示します。

azdownload ファイル名

ローカルパス

ストレージ URI

ントキー

[del]

アカウント名

アカウ

Page 66: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A 帳票資源ユーティリティについて-

[オプションの説明]

ファ

にはワイルドカードが使用可能です。

ロー

するファイルの格納先をフルパスで指定します。

スト

定します。

URI にはコンテナ名まで含めて指定してください。

アカ

re のアカウント名を指定します。

アカ

del

した場合は、ファイルをダウンロード後にストレージからの削除を行いません。

[記

ファ

account」、アカウン

ファ

A.3 注意事項

ーまたはストレージURI の指定に誤りがある場合は、Windows Azure か

い場合は、エラーになります。

イル名

ダウンロードするファイルをフルパスで指定します

ファイル名

カルパス

ダウンロード

レージURI

ダウンロードするファイルが格納されているストレージ URI を指

ストレージ

ウント名

Windows Azu

ウントキー

『アカウント名』で指定したアカウントに対するアカウントキーを指定します。

ファイルをダウンロード後にストレージから削除(移動)する場合に指定します。

省略

述例]

イルをダウンロード(コピー)する場合

ダウンロード対象のファイル名が「*.trslog」、ストレージ URI が

「http://myaccount.blob.core.windows.net/tracelog」、アカウント名が「my

トキーが「accountkey」として、ファイルをダウンロード(コピー)する。

イルをダウンロード後にストレージから削除(移動)する場合

ダウンロード対象のファイル名が「*.trslog」、ストレージ URI が

「http://myaccount.blob.core.windows.net/tracelog」、アカウント名が「myaccount」、アカウン

azdownload *.trslog c:¥log http://myaccount.blob.core.windows.net/tracelog myaccount accountkey

トキーが「accountkey」として、ファイルをダウンロードにストレージから削除(移動)する。

66

azdownload *.trslog c:¥log http://myaccount.blob.core.windows.net/tracelog myaccount accountkey del

アカウント名およびアカウントキーはあらかじめサポートポータルサイトで取得しておいてください。

アカウント名、アカウントキ

らエラーが通知されます。

ファイル名指定にマッチするファイルが存在しな

Page 67: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A - 帳票資源ユーティリティについて

67

.NET Framework 4.0

A.4

実行環境に が必要です。

エラーメッセージと対処方法

帳票資源ユーティリティ使用時にエラーが発生した場合、エラーメッセージが標準出力に出力されま

す。出力されたエラーメッセージの内容を元に、対処を行ってください。以下に、主なエラーメッセー

ジの内容と対処方法を示します。

エラーメッセージ 対処方法

リモート サーバーがエラーを返しました:

(400) 要求が不適切です

コンテナ名またはアカウント名に英小文字以外を指

定していないか確認してください。

リモート サーバーがエラーを返しました:

(403) 使用不可能

指定したアカウント名またはアカウントキーに誤り

が無いか確認してください。

リモート サーバーがエラーを返しました: URI を指定

(404) 見つかりません

存在しないコンテナ名またはストレージ

していないか確認してください。

リモート サーバーがエラーを返しました:

(409) 競合

既存のコンテナと同名のコンテナを作成しようとし

ていないか確認してください。

リモート サーバーがエラーを返しました: URI に誤りが無いか確認してく

(503) サーバーを使用できません

指定したストレージ

ださい。

パス '(指定したパス)' の一部が見つかりませ

んでした。

指定したアップロード対象のファイルへのフルパス、

またはファイルのダウンロード先のローカルパスに

誤りが無いか確認してください。

要求は中止されました: 要求がキャンセルされ

ました

64Mbyte を超えるサイズのファイルをアップロード

しようとしていないか確認してください。

無効な URI: 機関およびホスト名を解析できま

せんでした。

指定したストレージURI に誤りが無いか確認してく

ださい。

Account-key is invalid.

ださい。

指定したアカウントキーに誤りが無いか確認してく

Page 68: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A 帳票資源ユーティリティについて-

付録B Azure ストレージ上の資料採取について

B.1 Azure ストレージ上の資料採取について

ロールのインスタンスからAzure ストレージに転送されたDiagnostics ログなど、Azure ストレージ

上にあるデータを採取するには、ストレージにアクセスするツールを使用します。

この種のツールには多くのものがありますが、ここでは一例としてCloudXplorer(ブロブ用 )と

TableXplorer(テーブル用)というフリーのツールを使った手順を紹介します。すでにお使いのツールがあ

りましたら、そちらをご利用頂いて構いません。

なお、【Windows Azure 版】で使用するAzure ストレージに対して、資料採取等の操作を行う場合は、

帳票資源ユーティリティがご利用できます。帳票資源ユーティリティについては、以下を参照してくだ

さい。

⇒ 付録A 帳票資源ユーティリティについて

‐ “CloudXplorer”および”TableXplorer”は、弊社での動作保障はしておりません。運用で

影響が無いか十分に評価を行った上で使用してください。

B.1.1 Diagnostics ログの出力先と使用するツール

Diagnostics ログは種類に応じてブロブとテーブルに出力されます。

以下の表は、Diagnostics ログの出力先と、Azure ストレージからDiagnostics ログを採取する場

合、どちらのツールを使用するかを表したものです。以下を参照して必要なツールを選択してくださ

い。

・ブロブに格納されるログ(CloudXplorer を使用)

ログの種類 出力先のコンテナ名/テーブル名

IIS ログ wad-iis-logfiles

IIS 失敗ログ wad-iis-failedreqlogfiles

クラッシュダンプ wad-crash-dumps

その他のログファイル(*1) ユーザ設定に依る

必要に応じて、ユーザ側で追加してください

68

Page 69: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A 帳票資源ユーティリティについて-

69

・テーブルに格納されるログ(TableXplorer を使用)

ログの種類 出力先のコンテナ名/テーブル名

トレースログ WADLogsTable

パフォーマンスカウンタ WADPerformanceCountersTable

イベントログ WADWindowsEventLogsTable

インフラログ WADDiagnosticInfrastructureLogsTable

入手方法

ツールは次の URL からダウンロードしてください。

CloudXplorer

http://clumsyleaf.com/products/cloudxplorer

TableXplorer

http://clumsyleaf.com/products/tablexplorer

B.1.2 事前準備

1)

2)

ソフトのインストール

ツールをダウンロードして、ストレージにアクセスしたいコンピュータ上(例えばローカルのコン

ピュータ)にインストールしてください。

以下の表はDiagnostics ログの出力先です。Azure ストレージからDiagnostics ログを採取する場

合どちらのツールを使用するか、参照してください。

config ファイルの編集(URL の変更)

CloudXplorer

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」があります。

Page 70: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A 帳票資源ユーティリティについて-

B.1.3 実行手順 (CloudXplorer)

1) CloudXplorer を起動します。

2) [File] → [Accounts…]をクリックします。

3) ダイアログボックスが表示されます。[New] → [Windows Azure account...]とクリックします。

70

Page 71: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A 帳票資源ユーティリティについて-

4) [Name:]、[Secret Key:]にストレージアカウント名、キーを入力し、Path delimiterに “///” を

入力してください。

5) ブロブをダウンロードする場合は次の手順にしたがってください。

71

Page 72: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A 帳票資源ユーティリティについて-

(ア)左側のペインから、採取したいブロブが保存されているコンテナをクリックします。

(イ)右側のペインで、採取したいブロブを選択します。ディレクトリ構造になっている場合は、

全て展開してください。

(ウ)上部のボタンから、[Download] をクリックして、ローカルのコンピュータにファイルを保

存します。また、ツール内であれば、ドラッグ&ドロップを利用することもできます。

B.1.4 実行手順 (TableXplorer)

1) CloudXplorer と同様の手順(⇒ B.1.3 実行手順 (CloudXplorer))で、ストレージアカウント

名とキーを入力します。

2) テーブルのデータをダウンロードする場合は次の手順にしたがってください。

72

Page 73: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録A - 帳票資源ユーティリティについて

73

(ア)左側のペインから、 採取したいデータが保存されているテーブルをクリックします。

(イ)メニューの [Export data] ボタンを押します。

(ウ)保存場所のパスを選択します、この時ファイル名を拡張子付きで入力してください。

(エ)保存形式を選びます。[Export as CSV] を選択してください。[Separator]はComma[ , ]を

選択してください。

(オ)[Export] をクリックして、データを採取してください。

なお、一度に表示されるデータ数は1000 個までです。それ以上のデータがある場合は、メニューから

次のページを表示して、資料を採取してください。

Page 74: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

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 以上にならないようにしてくだ

さい。

帳票またはトレースログの出力先に指定したコンテナが存在しない場合、コンテナが自動生成されま

す。自動生成されたコンテナのアクセスレベルは”Public Container” となります。

C.3 ローカルストレージ使用時の注意事項

パラメータおよびプロパティに LocalResource オブジェクトを指定する場合は、以下の処理でオブジ

ェクトを取得します。

LocalResource local resource= RoleEnvironment.GetLocalResource("ローカルストレージ名");

C.4 ファイル、ファイルの格納先の指定に関する注意事項

帳票などの出力ファイル名や帳票資源の格納先などのファイルパスに半角英数字以外(全角および半

角カナ文字)は指定できません。

帳票資源の格納先などのファイルパスを指定する場合、フォルダ名やディレクトリ名の末尾には、パ

スの区切り文字(「円マーク(¥)」または「スラッシュ(/)」)を指定しないでください。

帳票資源の格納先、帳票の出力先、トレースログなどのファイルパスを指定する場合、ドライブ名か

ら始まるパスを、フルパスで指定してください。

74

Page 75: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録C 注意事項-

75

C.5 トレースログに関する注意事項

トレースログは、障害発生時に、原因究明や問題解決のために、必要になりますので、必ず取得して

ください。また、取得したトレースログを参照できるようにしてください。

生成されたトレースログは自動的に削除されません。トレースログが不要となった場合は、ユーザア

プリケーションや帳票資源ユーティリティで削除してください。帳票資源ユーティリティについては

以下を参照してください。

⇒ 付録A 帳票資源ユーティリティについて

C.6 Excel シート名指定時に関する注意事項

Excel シート名に半角英数字以外(全角文字および半角カナ文字)を使用する場合は、帳票業務情報

のプロパティ画面の[ファイル(Excel)]タブの[シート名]で指定してください。

C.7 英語環境(英語ロケール)での帳票出力に関する注意事項

英語環境にて帳票出力を行う場合、いくつか注意事項があります。詳細は、【Windows Azure 版】の

オンラインマニュアル”解説編”の英語環境での留意事項に関する記述を参照してください。

Page 76: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録D セキュリティについて-

76

付録D セキュリティについて

D.1 インターネット環境での利用とセキュリティについて

ネットワーク環境では、不正なアクセスによるシステムおよび資源の改ざんや破壊、情報の漏えいな

どの危険があります。このため、アプリケーションでユーザ制限を行うなど、自己防衛手段を講じる必

要があります。このようにセキュリティは、作成されたアプリケーションおよびその運用環境全体の適

切な設定と使用方法によって確保される必要があります。

D.1.1 資源の保護

プログラム、データに関する資源(データベース、データファイルなど)およびプログラムの動作に必要

な各種の定義・情報ファイルは、プログラムによるアクセス制限を行い、不正なアクセスや改ざんから

保護してください。特に重要な資源は、ファイアウォールを配置したイントラネット環境内に保持して

ください。

D.1.2 アプリケーション作成のための指針

セキュリティを考慮したアプリケーションを作成するための参考にしてください。

1)

2)

3)

4)

事前確認と処理結果の通知

対話・応答を行う処理の場合、重要なデータへのアクセスや処理については、事前の確認および処

理結果を通知して、誤った処理を検知できる設計を行ってください。また、ログを記録すると処理の

解析に役立ちます。

匿名性

ユーザの実名、実物を識別できるデータについては、特に漏えいの危険性を考慮してください。

インタフェースの検査

外部インタフェースについては、バッファオーバフロー(バッファオーバラン)やクロスサイトスク

リプティングなどを考慮して、セキュリティホールの作り込みを防止してください。バッファオーバ

フローを防止するためには、外部インタフェースの入力データの長さ、型や属性などの検査が有効で

す。クロスサイトスクリプティングは、動的に生成されたページ中に意図しないタグが含まれないよ

うにする事で防止できます。例えば、出力時にメタキャラクタをエスケープする方法があります。

繰り返し実行

同じ接続先からの一定時間内でのリクエスト数を制限するなどの考慮をしてください。

Page 77: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録D セキュリティについて-

77

5)

6)

7)

監査ログの記録

アプリケーションによるログ出力処理の作成などにより、セキュリティに関するイベントを記録し

て、セキュリティ侵害が発生した場合の分析や追跡方法を考慮してください。

セキュリティのためのルールの制定

セキュリティに関する脆弱な処理が無い堅牢なアプリケーションを作成するためには、セキュリテ

ィ侵害の脅威から保護すべき重要な資源を特定し、資源のアクセスやインタフェース設計のために特

定のルールを制定することが有効です。

通信データの暗号化

通信データを暗号化して、インターネット上での接続を保護してください。通信データを暗号化す

るためには、SSL を利用して Web サーバと Web ブラウザの間の HTTP メッセージを暗号化する

方法があります。

Page 78: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録E Windows Azure の用語-

付録E Windows Azure の用語

Windows Azure の用語について説明します。

用語 説明

エンドポイント ストレージ上の資源などに対するリクエストの受け口のことです。

オンプレミス 自社管理下のサーバやネットワークによってシステムを運用すること、

またはそのような形態のアプリケーションのことです。

キュー キューストレージにおける、メッセージを管理する単位です。メッセー

ジはキュー配下に格納されます。

キューエンドポイント キューにアクセスするためのエンドポイントのことです。以下のように

表記されます。

https://(ストレージアカウント名).queue.core.windows.net/

キューストレージ 一時的なデータの保存用のストレージです。Web ロール、Worker ロー

ル、または外部アプリケーションとの間での通信手段として使用します。

クラウド(クラウドコン

ピューティング)

ネットワークを介してサービスを提供/利用するコンピューティング形

態のことです。

コンテナ ブロブストレージにおける、ブロブを管理する単位です。ブロブはコン

テナ配下に格納されます。

ストレージ Windows Azure でのデータ格納先です。

帳票資源ユーティリティ 【Windows Azure 版】が提供するコマンド群です。【Windows Azure

版】が使用するAzure ストレージに対して、帳票資源の操作を行うこと

ができます。

テーブル テーブルストレージに格納される、表形式の構造をもったデータです。

データを特定するためのキーと、それに対応する値の集合で表現されま

す(Key-Value 型ストア)。

テーブルエンドポイント テーブルにアクセスするためのエンドポイントのことです。以下のよう

に表記されます。

https://(ストレージアカウント名).table.core.windows.net/

テーブルストレージ テーブルを格納するためのストレージです。

デプロイ アプリケーションをWindows Azure に配置することです。

ブロック ブロブを分割したものです。ブロックに分割することでファイルのアッ

プロード時間を短縮でき、また、アップロードに失敗した際には差分の

みアップロードすればよいというメリットがあります。

ブロブ ブロブストレージに格納されるデータ本体です。

78

Page 79: Windows Azure 概要編 - 富士通のソフトウェア : Fujitsu …software.fujitsu.com/.../b1wd3019/02z000/manual0A.pdfWindows Azure 概要編-第1章 概要- 1.1. 機能概要

Windows Azure 概要編-付録E Windows Azure の用語-

79

ブロブエンドポイント ブロブにアクセスするためのエンドポイントのことです。以下のように

表記されます。

https://(ストレージアカウント名).blob.core.windows.net/

ブロブストレージ 主に大容量のバイナリデータを保存するためのストレージです。

メッセージ キューストレージに格納されるデータ本体です。

ローカルストレージ Windows Azure 上で動作する、Web ロール・Worker ロール内に確保

されるストレージ領域です。ロールインスタンス単位で確保されるため、

インスタンス間での共有はできません。また、ロールを再起動・再配置

した場合、データが削除されます。

ロール コンピュートサービス上で実行できるアプリケーションのことです。

Diagnostics ログ 仮想マシンの診断データとなるログです。Windows Azure Diagnostics

によって収集されます。

Web ロール HTTP リクエストを処理するためのロールです。オンプレミスの環境に

おける、Web アプリケーション、Web サービスに相当します。

Worker ロール バックグラウンドプロセスを実行するためのロールです。オンプレミス

の環境における、Windows サービスに相当します。