タグ: Integration

Empty Item Repository —空のアイテムレポジトリ—

投稿日: 投稿者: nogカテゴリー: ダイレクトスマイル、DirectSmile Integration Serverコメントをどうぞ

Time is money??

[EN]
Today, I’d like to post small tips regarding DirectSmile Integration Server.

When you see empty Item Repository in DSMI Frontend even though everything configured properly, then the reason of you problem could be “Time Setting” of your local computer.

Here is the possible case which cause empty Item Repository.

  1. There are more than 5 mins differences between Server’s time and your local PC’s time.

  2. Enabled “Automatically adjust clock for Daylight Saving Time” option at server, but not on your local machine and vice versa.

    Time Setting

It because DSMI validate the date and time of your local machine, and in the case it doesn’t match with server time, those behavior will appear as result of this mismatching time on both machines.

[JP]
今日はちょっとしたTipsを。

もしDSMIのItem Repositoryにどのアイテムも表示されない場合は、多くのケースではお使いのPCの時間設定が起因しています。

ケース１．サーバーの現在時刻とクライアントPCの現在時刻がが5分以上ずれている

ケース２．サーバー、またはクライアントPCの時間設定にて”夏時間に自動的に調整する”オプションが設定されており、片方では設定されていない。

どちらの場合にも、DSMIによる時間設定のチェックにて不適合が起こり、結果としてアイテム・レポジトリ内に何もアイテムが表示されないという現象が発生します。その場合は、時間設定をチェックすることで解決出来る事が多いです。

広告

Tips for GMC & DirectSmile

投稿日: 投稿者: nogカテゴリー: 3rd Party Software、ダイレクトスマイル、DirectSmile Integration Server、Supportコメントをどうぞ

A+B = C

<EN>
Since this blog have being shown quite frequently by “PrintNet T”, “GMC” as searching word. So I’d like to introduce some useful tips for Integration work of GMC PrintNet T Designer and DirectSmile Integration Server.

<JP>
ここ最近のレポートを見ていると、GMC PrintNet T関連のキーワードで訪問して頂いている方が多いようですので、今日は1つGMC PrintNet TとDirectSmile Integration Serverを使用する場合のTipsを投稿します。

How to add a parameter in the request stream image URL
—画像リクエスト・ストリームURLに対するパラメータ追加方法—

<EN>
It is possible to add any additional parameters to the request URL by using “Data Transformer”. This way you can specify the pixel width, or a watermark, etc…

<JP>
Data Transformerモジュールを使用すれば、どんなパラメータでも画像リクエストURLに対して追加する事が可能です。（例：画像のピクセル幅を指定、ウォーターマークを追加、透過PNG画像の取得など）

Use “Stack FCVs” for the Field Converter
—”Stack FCVs”をフィールドコンバーターに対して使用—

Stack FCVs

<EN>
The first step is to select “Stack FCVs” instead of “DirectSmile” in the Field Converter menu. If you select “Stack FCVs”, then you can set a chain of multiple data transformations for one column. Now, click on the 3-dots icon next to the Field Converter selection menu.

<JP>
始めに、”Stack FCVｓ”をフィールド・コンバーターメニューから選択します。Stack FCVsを適用する事で、データベースの1項目に対して、複数のデータ・トランスフォーメーション・チェーンを設定する事が可能になります。
次にフィールド・コンバーターの隣にある参照ボタンをクリックします。

Create Input
—Input(入力)を作成—

Create Input

Click “Add a converter” icon!
—”Add a converter”アイコンをクリック—
Add a converter

<EN>
We need to select “DirectSmile” as the first transformation.  After you have done so, you can select which DSM-set you would like to use as we mentioned in GMC & DSMI guide manual.

<JP>
先ずは”DirectSmile”を最初のトランスフォーメーションとして選択します。次にどのDSM-Setを使用するのかを定義します。(詳細な方法はGMC & DSMIガイドを御覧ください)

Add a converter

<EN>
Click on the “Add a converter” icon again, and select “String manipulation” as the second transformation.

<JP>
再度”Add a converter”をクリックします。そして、”String manipulation”を2番目のトランスフォーメーションとして選択・追加します。

Concatenation

<EN>
Once you have created the 2nd transformer, you can click on the 3-dots icon.  Select “Concatenation” in the field “Type”, and by doing so be able to add any parameter in the “Suffix” field.

These values are automatically added to the request URL later. In this example, we added a pixel width specification and placed a watermark on the personalized image.

Now click “OK”, and close the data transformer module.

<JP>
2番目のトランスフォーメーションを作成すると、参照ボタンをクリック出来るようになります。参照ボタンをクリックし、String manipulationウィンドウが開いたら、”Concatenation”をフィールドタイプとして選択します。これでPreFixフィールド、SurFixフィールドに対して値を入力出来ます。

これらの値は自動的に画像リクエストURLに対して追加されます。このサンプルでは画像のピクセル幅の指定とウォーターマークの追加をしました。

”OK”ボタンをクリックし、Data Transformerモジュールを閉じます。

Proof
—プルーフ—
Proof

<EN>
As you can see above, this personalized image has a watermark.　Let’s see the URL that was sent to DSMI.

<JP>
上記のスクリーンショットに見えるように、パーソナライズド・イメージにウォーターマークが追加されました。
次にこの画像が生成された画像リクエストURLを見てみます。

<EN>
The sub-menu “Data”, located in the “Proof” menu (F6), contains the requested URL into which the additional parameter has been written.  You can also separately find the additional parameter in the requested URL as well.

So you are free to add any parameter! 🙂

<JP>
Proofメニュー(F6)内のサブメニュー”Data”を開くと、実際にリクエストされたURLを確認出来ます。実際の画像リクエストURLに対して、ピクセル幅指定のパラメータと、ウォーターマーク追加用のパラメータが追記されていることがわかります。

この方法でどんなパラメータでも追加可能です。　🙂

ダイレクトスマイル・インテグレーション・サーバーのインストール方法

投稿日: 投稿者: nogカテゴリー: ダイレクトスマイル、DirectSmile Integration Serverコメントをどうぞ

Connect DSMI

今日は結構長くなるかも。
DSMI（ダイレクトスマイル・インテグレーション・サーバー）のインストールにおけるテクニカルナレッジをご紹介します。

初めに

ダイレクトスマイル・インテグレーション・サーバーは、以下のシステムが必須です。また、システム要件・環境が満たされていない場合には、ダイレクトスマイルのサポートを受けることは出来ません。

必ず、ソフトウェアのインストールより前に条件を満たす環境をご用意ください。

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

特に注意！！

インストール作業は必ずパスワード保護がされた管理者アカウントにて行います。

管理者アカウントにおいても、パスワード保護のされていないアカウントでは問題が発生します。（例：Setのアップロードができない、不具合が起きるなど）

DSMIからは、事前に必ず固定IPアドレスの取得が必須です。

また、サーバー証明書の取得は絶対に欠かせない必須事項となります。

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

インストール準備

インストールは以下のソフトウェアを使用して行います。

DirectSmile関連のインストーラー

  • DSMGenInstaller_4.2.0.xxx.exe
  • dsmi-4.2.0.xxx.msi

その他の必須ソフトウェア

  • Microsoft SQL Server 2008 R2

既に顧客が所有している場合は、そのSQL Serverを使用することが可能

未購入の場合、Expressという無料版を使用することが可能。その場合は以下のVerのインストーラーを使用する

(Microsoft® SQL Server® 2008 R2 SP1 – Express Edition with Tools(x64))

  • Microsoft Silverlight 4 or 5(DSMIのバージョンによる)

インストール後のチェック用実行ファイル

  • DSMIPreCheck.exe

(正常インストールのチェック：実行後に自動的にインストール、および各フォルダへの設定に間違いがないかをチェックしてくれるコマンドラインベースの実行ファイル)

データベースの上書きなど修正用実行ファイル

  • dsmobcktool.zip

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

インストール方法

１．サーバーの役割を設定する

サーバーマネージャーから役割の追加を選択し、サーバーへ以下の役割を追加する

  • Webサーバー(IIS)
  • アプリケーションサーバー

役割をサーバーへ追加したら、Windows Updateを実行しておきます。セキュリティの為、適用可能な全てのUpdateをインストールします。

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

２．SQL Serverをインストール

SQL Server 2008 をインストールします。

他のSQL Serverと接続する場合には、このステップは行う必要はありません。

SQL Server 2008 R2 Express Editionをインストールした場合、初期設定ままインストールを行うと、名前付きインスタンスが適用され、サーバーインスタンス名は以下の様になります。

サーバーインスタンス名：　サーバー名\SQLEXPRESS

Instance Name = SQLExpress

注意：

SQL Serverをインストールする際には、必ず初期設定のままインストールをしてください。SQL Serverのインスタンス名を変更してしまうと、後々修正するのが非常に面倒になります(データベースの上書きツールの使用、さらに複数の構成ファイルの編集が必要となります)

サービスアカウント設定

「サーバーの構成」設定では、すべてのSQL Serverサービスで同じアカウントを使用するというオプションを利用します。

NETWORK SERVICE

アカウントには「NT AUTHORITY\NETWORK SERVICE」を使用します

スタートアップの種類　自動

続いて「スタートアップの種類」の設定を両方とも「自動」に変更します。

これが手動などになっていると、サービスを起ち上げなければいけなくなります。

Windows認証モード

「データベースエンジンの構成」設定においては、認証モードに「Windows認証モード」を設定します。ただし、顧客が既にSQL Serverを所有している場合や、SQL Server認証を使用したい場合には「混合モード」を採用します。

SQLServerへアクセス

続いてインストールしたSQL Serverを確認します。サーバー名は初期設定のままで、

「.\SQLExpress」と入力します

 – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

３．Microsoft .Net Framework 4をインストール

DSMIは.Net Framework 4を使用しているので、それに対応するために事前に.
Net Framework 4をインストールしておきます。

これはWindows Updateからインストールすることが可能です。

ただし、このUpdateは自動ではなく、手動の選択式のものになります。
ご自身でWindows Updateから選択してインストールしてください。

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

４．DirectSmile Generatorをインストール

オフラインと同様にDSMをインストール

※1
WindowsのUAC(User Account Control)問題により、所定のフォルダにデータがすべて作成されていない場合があります。この場合一度アンインストール後、以下のフォルダからデータコピーし、正しいディレクトリ内にデータをペーストし、再インストールを管理者権限の元で行います。

C:\Users\アカウント名\AppData\Local\VirtualStore\Program Files (x86)

※2
インストール後、フライアウトメニューにGeneratorではなく、VDP Studioと表記されていることがありますが、特に問題ありません。

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

５．DSMIをインストール(DirectSmile Integration Server)

インストール実行前に以下のフォルダを手動で作成します。

  • DSMUsers(C:\DSMUsers)
  • DSMuploads(C:\DSMTemp\DSMUploads)

インストール中に複数の設定があるので初期設定で問題なければその通りに行います。

インストール･ウィザード

①     連携するSQL Serverの設定

ここでは、4つの入力欄と、1つのチェックボックスが表示されます。

SQLServer設定入力フィールド

SQL Server Instance name :

対応するSQL Serverのインスタンス名を入力します。
もし顧客が用意した別のSQL Serverに接続する場合には以下の例の様に入力します。

PC名\サーバーインスタンス名

(例：DIRECTSMILE\MSSQLSERVER)

Database name：

ダイレクトスマイル用のデータベース名を入力します。
ここは初期設定から変更はせず、かならず「dsmodb」とします。

Username / Password：

ここにユーザー名、パスワードを入力するのは、SQL認証を採用している場合に限ります。

②     SQL Serverにおけるデータベース同期設定

上記の設定の下部に表示されているチェックボックスは複数のDSMIを連携させる際にどちらのサーバーにインストールされたSQL Serverをメインのデータベースとして使用するのかという設定を行います。これは2つのDSMIを連携させる場合に必要なマスター、スレーブの設定となります。

この設定をしないと複数のDSMI間におけるデータベースの同期が出来ません。

Master or Slave?

③     サーバー証明書の登録

サーバー証明書のCN値入力ダイアログ

DSMIはMicrosoft SilverlightクライアントとWCFサービス（Webサービス）との通信をhttps通信にて行います。https通信を可能にするためにはDSMIサーバーはサーバー証明書をインストールしてある必要があります。

サーバー証明書自体はDSMIのインストール作業中に作成させる事が可能ではありますが、これはあくまでもテストインストールのためだけであり、実装にあたっては必ず正規のプロバイダーが発行した有効なサーバー証明書を用意しておく必要があります。

注意：自己署名証明書を採用した場合、ダイレクトスマイルのサポート対象外システムとなります。自己署名を採用している場合は、例えそれがイントラネットで使用されているシステムであったとしてもダイレクトスマイルは一切のサポートを行いません。必ず正規のサーバー証明書をインストール、ウェブサイトにバインドして下さい。 

Yes           ：インストール作業中にサーバー証明書を作成

No             ：用意したサーバー証明書を登録（推奨）

証明書用秘密キー作成ダイアログ

テストインストールの際に、サーバー証明書の作成を行った場合にはパスワードの作成を求められます。これは証明書におけるプライベートキー、パブリックキーの作成プロセスです。ただしテストインストール段階においては、このパスワードは設定なしで進めて問題ありません。また設定しても、使用するところは無いので大丈夫です(ただし、本インストールにおいては必ずサーバー証明書を取得して行うという事が前提です)


– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

６．必要な詳細設定(下位互換性保持目的の場合のみ)

以下の設定の一部はデザイナーやオペレーターなどのクライアントサイドPCで使用するDirectSmile GeneratorがVer4.2以下の場合に対する下位互換性を保持する目的の設定です。DirectSmile GeneratorのVer4.2以降ではDSMIへテンプレートをアップロードするにあたり、使用するプロトコルをFTPからHTTPへ変更しています。よって、新規インストールなどに関しては以下の設定は省略可能です。

自動インストールでは作成されないフォルダや、手動設定が必要なフォルダについて以下の操作を実行します

  1. フォルダの作成
    A) dsmuploads
    FTP機能を使用する際のローカルアップロード用フォルダ

    1. DSMUsers　(C:\DSMUsers)
    2. DSMtemp　(C:\DSMtemp)
    3. DirectSmile Generator　(C:\Program Files (x86)\DirectSmile Generator)
    4. DSMO　(C:\inetpub\wwwroot\DSMO)
    5. dsmuploads　(C:\DSMTemp\dsmuploads)
  2. フォルダのセキュリティ設定の変更
    以下の５つのフォルダに対して、フォルダのセキュリティ設定から、Network Serviceアカウントに対してすべてフルコントロールを与える。※ツリー階層になる場合は、上階層のフォルダに設定すれば下階層のフォルダに自動的にセキュリティ設定が継承される。
  3. IISの設定

A)        FTPサイト(下位互換性保持の為必要な場合のみ設定)

※Generator 4.1以降はファイルのアップロードにおいてHTTPを通信プロトコルとして使用し、FTPは使用しません。ですが、古いバージョンのGeneratorに対しての下位互換性を保持する必要がある場合はDSMIサーバーにおいて、FTPサーバの設定を行います。

①       FTPサイトの追加

IISにおいて、最上位階層に位置するサーバー自体のアイコンを右クリックして、「FTPサイトの追加」を選択する

FTPサイトを追加

②       FTPサイトの設定

  1. FTPサイト名は何でもOK
  2. コンテンツパスには「dsmuploads」を選択
  3. バインド設定ではIPアドレス、接続ポートを設定(初期値のまま)
  4. 仮想ホスト名は必要なし
  5. SSL設定では「許可(O)」
  6. SSL証明書は選択せず、「未選択」のままでOK
  7. 認証および承認の設定

A)        認証欄は匿名にチェック
B)        承認欄

i.     アクセスの許可：匿名ユーザー
ii.    アクセス許可：読み取り、書き込みの両方にチェック

注意：FTPサイトの設定では、セキュリティ上の理由から、匿名ユーザーのアクセスを全て許可することが許されない場合があります。その場合はサーバーにアカウントを作成し、そのアカウントからのアクセスを許可させるように設定を変更します。
詳細はhttp://technet.microsoft.com/ja-jp/library/dd939052.aspx

B)        Default Web Site

①   サーバー証明書の確認

必要なサーバー証明書以外について削除する

(ア) 既に用意している場合は購入済みのサーバー証明書を採用する

(イ) テストインストールの場合(サーバー証明書がインストール時に自動作成されている場合)、発行者がDirectSmile Support Certification Authorityとなっているサーバー証明書を採用する

② バインドの設定(https接続時に使用するサーバー証明書の設定)

③ アプリケーションプールの確認＝DefaultAppPool

※但し、仮想ディレクトリDSMImagesがDefaultWebSite直下に指定されている場合は、AppPoolが.NetFramework 4を使用している必要があります。

C)        DSMO

①   仮想ディレクトリの追加

DSMimagsという名前の仮想ディレクトリを作成します。これはDSMOで作成した画像をURLコールによって返す場合に画像へのパスとなる仮想ディレクトリになります。

実際に指定するフォルダはdsmtempを指定します。

D)       アプリケーションプールの確認＝DSMO_Pool

 

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

７．設定のチェック

インストール・詳細設定が終了したら「DSMIPreCheck.exe」を使い未設定や間違いがないかをチェックします。

コマンドラインベースの実行ファイルが、特定フォルダが作成されているかどうか、またそのセキュリティ設定が正しいかどうかを自動的にチェックしてくれます。

※Ghost Scriptの実行ファイルの既定が「Ver8.64」にてチェックされるため、DSM GeneratorがVer4.2.0.675インストール環境下ではエラーを返します。このバージョンのGeneratorはGhost Script 9.02を使用します。エラーが出る場合は、DSMOの設定欄からGhost Scriptの指定バージョンを変更します。

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

８．DSMOの動作チェック

インストール作業が終了したら、DSMOにログインして正常に動作するかのチェックを行います。チェックする項目の簡易版を以下に記載しますが、必ずFinalcheckを行なって下さい。全てのチェックをパスしたらインストール完了です！

  1. Setting：設定
    (ア)DSMOのURLを変更初期設定では”http://localhost/dsmo”となっているので、これを登録済みのドメイン名に変更します(イ)Image Repository URLを変更画像の表示用URLになるImage Repository URLに関しても初期設定では”http://localhost/dsmimages”となっているので、これを登録済みのドメイン名に変更します

    注意：この設定はウェブサイトのどのディレクトリに対して仮想ディレクトリを作成したかによります。
    ウェブサイトのサブディレクトリとして作成した場合が初期設定です。
    DSMOディレクトリ下に作成した場合には、”dsmo/dsmimages”と変更します
  2. Item：アイテム次にアイテムからSetのアップロードとDocumentのアップロードを確認します。

    ※１．Setのアップロードはサーバー自身のDSM Generatorを使って、Set Editorから直接アップロードすることは出来ません。DSMOをインターネットブラウザで開き、ItemページからSet、Documentをアップロードしてください。
    ※２．Documentの作成には必ず２台以上のプロダクションサーバーが稼働している必要があります。

  3. User：ユーザーUserメニューでは実際に新規アカウントの作成が出来るかどうかをチェックします。また、削除も同様に可能かチェックします。 
  4. Workflow：ワークフロー以下の流れでWorkflowの最終チェックを行います。まずはフロントエンドからWorkflowページを開きます。ここでエラーが発生する場合には、https://ドメイン名/workflow.svcと ブラウザにURLを直接入力し、Workflowサービスにアクセスしてみます。このページにてエラーが出る場合は、HTTPS接続による Workflowサービスが確立できていません。エラーが発生した場合に一番多いのは、サーバー証明書が複数存在することによる証明書の混在が原因となっ たhttpsアクセスができないという旨のエラーです。その場合には、不要なサーバー証明書を削除することで解決できます。また、何らかの原因でDSMO Backendが正常に動作していない為に発生している事がありますので、その場合はServiceからDSMO Backendを再起動させます。必要に応じてコマンドプロンプトからIISの再起動を行なってください。