30日間の無料評価版をお試しいただけます。

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

Anchor
top
top

Table of Contents
classcontents

最小限の外観の再設定

Styleclass
ClasstopLink

ページトップ

この例では、最小限の作業でインストーラーの外観を再設定します。インストーラーのユーザーインターフェースにおける「Yellowfin」の参照が置き換えられ、一部のイメージは再設定後のバージョンに置き換えられます。

まず、インストーラーに表示されるアプリケーションの名前を設定します:

Code Block
none
none
installer.appname=Real Reports

「Yellowfin」を参照するテキストプロパティを上書きします:

Code Block
none
none
installer.footer.msg= -= www.realreports.com =-
installer.licencefilepanel.msg=A valid licence file is required to install and use Real Reports. If you do not have a licence file, please see your software provider.
installer.finishpanel.supportlink.url=http://www.example.com/support

Windowsサービスの名前と説明を上書きします:

Code Block
none
none
installer.winservice.name=Real Reports
installer.winservice.description=This service starts the Real Reports Server

Yellowfinブランドのサンプルコンテンツをインストールしないようにインストーラーを設定します:

Code Block
none
none
action.yellowfincontent=false

グラフィカルインストーラーの起動時に表示する新しいhtmlファイルを作成し、その新しいhtmlを使用するためのプロパティを追加します:
resource.infopanel.html=resources/installsplash.html

グラフィカルインストーラーでパックアイコンとして使用する新しいイメージを作成します(パックごとに1つ)。新しいイメージを使用するためのプロパティを追加します:

Code Block
none
none
resource.pack.core.img=resources/corepack.png
resource.pack.tutorial.img=resources/tutorialpack.png
resource.pack.geopack.us.img=resources/usgeopack.png
resource.pack.geopack.world.img=resources/worldgeopack.png

上記のすべてのプロパティをcustom.propertiesという名前のファイルに記述します:

Code Block
none
none
# text properties
installer.appname=Real Reports
installer.footer.msg= -= www.realreports.com =-
installer.licencefilepanel.msg=A valid licence file is required to install and use Real Reports. If you do not have a licence file, please see your software provider.
installer.finishpanel.supportlink.url=http://www.example.com/support
installer.winservice.name=Real Reports
installer.winservice.description=This service starts the Real Reports Server

# installer actions
action.yellowfincontent=false

# resources
resource.infopanel.html=resources/installsplash.html
resource.pack.core.img=resources/corepack.png
resource.pack.tutorial.img=resources/tutorialpack.png
resource.pack.geopack.us.img=resources/usgeopack.png
resource.pack.geopack.world.img=resources/worldgeopack.png

カスタマイズされたインストーラーを作成するには:

  1. 既存のインストーラーjarファイルの内容を抽出します。

    Code Block
    none
    none
    jar xvf /path/to/yellowfin-yyyymmdd-full.jar
    
  2. resourcesという名前の新しいディレクトリを作成し、そこに新しいhtmlファイルおよびイメージファイルをコピーします。
  3. 前述のカスタムプロパティファイルをインストールフォルダー構造のルートディレクトリにコピーします。
    ディレクトリには、次のようにインストーラーアーカイブからの既存ファイルと新しいファイルが含まれるはずです:

    Code Block
    none
    none
    META-INF/MANIFEST.MF
    custom.properties
    com/
    default.properties
    resources/corepack.png
    resources/tutorialpack.png
    resources/usgeopack.png
    resources/worldgeopack.png
    resources/installsplash.html
    ...
    
  4. 変更されたjarファイルを作成します。

    Code Block
    none
    none
    jar cvmf META-INF/MANIFEST.MF /path/to/yellowfin-modified.jar
    

外観が再設定されたアプリケーション

Styleclass
ClasstopLink

ページトップ

最小限の外観の再設定の例で、インストーラーの要素は再設定しましたが、Yellowfinアプリケーション自体は変更していません。この例では、その上にさらに手を加えて、一部のアプリケーションUI要素を再設定します。 

インストーラーではなくYellowfinアプリケーション内で表示されるアプリケーション名を設定します:

Code Block
none
none
action.config.appname=Real Reports

インストールディレクトリに作成される一部のファイルの名前を変更します:

Code Block
none
none
installer.warfilename=realreports.war
installer.applogfilename=realreports.log

サポート電子メールアドレスを変更します:

Code Block
none
none
action.config.supportemail=support@example.com

ブロードキャスト電子メールの送信元になる電子メールアドレスおよび名前を変更します:

Code Block
none
none
action.config.broadcastemail=noreply@example.com
action.config.broadcastname=Real Reports

デフォルトの管理者ログオンアカウントの資格情報を変更します:

Code Block
none
none
action.adminuser.username=admin@example.com
action.adminuser.password=secret
action.adminuser.email=admin@example.com

Yellowfinアプリケーションで使用されるYellowfinブランドのイメージを置換します。まず、resourcesの下にcustomimagesという名前のサブディレクトリを作成します。次に、置換するイメージごとに新しいイメージを作成し、元のイメージと同じファイル名を使用してcustomimagesディレクトリに保存します。この例では、ファイルheader_logo.gif、logo.png、およびlogoFooter.pngの新しいバージョンを作成し、customimagesディレクトリに保存します。

Code Block
none
none
action.customimagespath=resources/customimages

カスタムログインページを作成し、resourcesディレクトリに追加します:

Code Block
none
none
action.customindexpage=resources/login.html

カスタムログインページでは、Yellowfinに含まれていないイメージファイルもいくつか使用します。これらのファイルは、先に作成したcustomimagesディレクトリに追加すると、自動的にアプリケーションに追加されます。

これらのプロパティと1番目の例のプロパティを組み合わせた、完全なカスタムプロパティファイルは次のようになります:

Code Block
none
none
# text properties
installer.appname=Real Reports
installer.footer.msg= -= www.realreports.com =-
installer.licencefilepanel.msg=A valid licence file is required to install and use Real Reports. If you do not have a licence file, please see your software provider.
installer.finishpanel.supportlink.url=http://www.example.com/support
installer.winservice.name=Real Reports
installer.winservice.description=This service starts the Real Reports Server

# installer actions
action.yellowfincontent=false
installer.warfilename=realreports.war
installer.applogfilename=realreports.log

# post-installation application behaviour
action.config.appname=Real Reports
action.config.supportemail=support@example.com
action.config.broadcastemail=noreply@example.com
action.config.broadcastname=Real Reports
action.adminuser.username=admin@example.com
action.adminuser.password=secret
action.adminuser.email=admin@example.com
action.customindexpage=resources/login.html
action.customimagespath=resources/customimages

# resources
resource.infopanel.html=resources/installsplash.html
resource.pack.core.img=resources/corepack.png
resource.pack.tutorial.img=resources/tutorialpack.png
resource.pack.geopack.us.img=resources/usgeopack.png
resource.pack.geopack.world.img=resources/worldgeopack.png

jarファイルは次のようになります:

Code Block
none
none
META-INF/MANIFEST.MF
custom.properties
com/
default.properties
resources/corepack.png
resources/tutorialpack.png
resources/usgeopack.png
resources/worldgeopack.png
resources/installsplash.html
resources/login.html
resources/customimages/header_logo.gif
resources/customimages/logo.png
resources/customimages/logoFooter.png
resources/customimages/loginimage1.png
resources/customimages/loginimage2.png
resources/customimages/loginimage3.png

最小限のユーザー操作

Styleclass
ClasstopLink

ページトップ

この例では、大半のユーザー操作がバイパスされるようにインストーラーを作成する方法について説明します。ユーザーはターゲットインストールディレクトリを選択するだけです。その他すべてのオプションはあらかじめ選択されていて、ユーザーには見えません。

カスタムプロパティファイルの内容:

Code Block
none
none
# Set default values for installation options
option.pack.tutorial=true
option.pack.geopack.us=false
option.pack.geopack.world=false
option.serverport=8181
option.winservice=false
option.db.dbtype=POSTGRESQL
option.db.hostname=localhost
option.db.dbname=yellowfin
option.db.createdb=true
option.db.username=yfuser
option.db.userpassword=yfpassword
option.db.createuser=true
option.db.dbausername=postgres
option.db.dbapassword=secret

# Tell the installer to hide various options from the user
action.hidedboptions=true
action.hidepacks=true
action.hideserverport=true
action.hidewinservice=true

# Embed a licence file in the installer
resource.licencefile=resources/licence.lic

この例で、インストーラーは「yellowfin」という名前のlocalhost(のデフォルトポート)上で稼働しているPostgreSQLサーバーに新しいYellowfin設定データベースを作成します。インストーラーはユーザー名「postgres」とパスワード「secret」を使用して接続し、データベースを作成します。さらに、ユーザー「yfuser」をパスワード「yfpassword」で作成します。

インストーラーアーカイブには、インストールで有効なライセンスファイルがresources/licence.licに含まれている必要もあります。

 

horizontalrule
Styleclass
ClasstopLink

ページトップ