Smart Report Meisterでバーコードを表示する

RayBarcodeのWeb APIと、日本コンピュータ・ダイナミクス株式会社のSmart Report Meisterを使用して、Salesforce上で帳票へのバーコード印刷を実現できます。RayBarcodeにはSmart Report Meisterのライセンスは含まれません。

Smart Report Meisterのデモ画面

前提

連携を試すためには、SalesforceおよびRayBarcodeとSmart Report Meisterの環境を準備します。ライセンスがまだない場合、トライアル版を使用できます。

概要

ここでは、「取引先レコードのIDをバーコード化し、帳票上にバーコードをレイアウトしPDFに出力する」というシナリオを実現します。レコードIDのバーコード化はRayBarcodeが担当します。帳票上のレイアウトとPDFへの出力はSmart Report Meisterが担当します。この2つのパッケージを連携させることで目的を実現します。

1. 取引先にカスタム項目を設定する

取引先にIDのバーコード画像を表すカスタム項目を設定します。IMAGE関数にIDをバーコード化した画像を取得するRayBarcodeのWeb APIを設定します。Web APIに設定するパラメータについての詳細はオンラインヘルプを参照してください。

指定する値

  • バーコードの種類: QRコード
  • 幅: 300
  • 高さ: 300
  • 値: 取引先レコードのID
  • トークン: Web APIの認証トークン

IMAGE関数

IMAGE("https://gcbarcode.azurewebsites.net/api/Png/qrcode?Width=300&Height=300&value="+Id+"&token="+ $Setup.gcbc__GcBarcodeSetting__c.gcbc__AccessToken__c,"QRCode",300,300)

パラメータにWeb APIの認証トークンを指定しています。これはRayBarcodeがインストールされている組織、かつ、ライセンスが割り当てられているユーザのみが使用できるカスタム設定の項目になります。このトークンには有効期限があり、Web API実行前に必ず値を更新する必要があります(後述)。

2. Smart Report Meisterで帳票を作成する

Smart Report Meisterで帳票を作成します。今回は簡単のために、バーコード画像のみを表示する帳票を作成します。

  1. 「帳票新規作成」ボタンを押下する。
  2. 任意の帳票名や用紙の向きを設定し、「次へ」ボタンを押下する。
  3. 基本オブジェクトを「取引先」に設定し、「次へ」ボタンを押下します。
  4. デフォルトのまま「保存」ボタンを押下する。
  5. Smart Report Meisterの帳票ができました。
  6. 出来上がった帳票にレイアウトを追加します。「新規レイアウト追加」リンクをクリックする。
  7. デザイナが表示されるので、さきほど作成したバーコード画像のカスタム項目を配置し[保存]ボタンを押下します。

以上で、Smart Report Meisterの設定は完了です。

3. 帳票出力を実行するカスタムボタンの作成

帳票出力を実行するカスタムボタンを作成します。Smart Report Meisterには帳票出力を実行するスクリプトを自動生成する機能があります。このスクリプトに対して、Web APIの認証に使うトークンを更新するコードを加える必要があります。

  1. Smart Report Meisterの[ボタンスクリプト]ボタンを押下してスクリプトを表示する。
  2. 表示されたスクリプトをクリップボードへコピーする。
  3. 新規カスタムボタンを作成する。動作に「JavaScriptを実行」を選択し、先ほどのスクリプトをクリップボードから貼り付ける。
  4. Smart Report Meisterの帳票出力するコードの前にアクセストークンを更新するためのAPEXクラスの実行を追加する。

追加するコード:

sforce.apex.execute("gcbc.GcBarcodeGlobalAccessTokenGenerator", "UpdateAccessToken", {}, {onSuccess: function(){;},onFailure: function(error) {alert(error);}});

最後に、ページレイアウトに作成したカスタムボタンを追加します。

以上ですべての設定が完了しました。

4. 実行結果の確認

  1. 取引先の詳細画面に移動し、先ほど作成したカスタムボタン「バーコード連携」を押下する。
  2. バーコード画像がPDF出力されることを確認する。
Copyright © 2018 GrapeCity inc. All rights reserved.