References

Barcode Types

GrapeCity Barcodeが表示と生成をサポートしているバーコードの種類は以下のとおりです。 GcBarcode、GcBarcodeVFおよびWeb APIの type 属性に記述することで使用できます。複数の名前を持っているバーコードは「別名」を使うこともできます。 すべてのバーコードの名前は、大文字と小文字を区別しないので、「QRCode」は「qrcode」、「qrCode」のように記述できます。

一次元バーコード

以下の「使用例」のバーコード画像は、クリックすると拡大表示できます。「GS1データバー」は後述の別の一覧となります。

バーコードの名前 別名 説明 使用例
Code39 数字、アルファベット、記号など合計43種類の文字に対応しています。読み取りの誤りが発生しにくく信頼性の高い規格です。
Code93 CODE39よりも高密度で、データチェックの信頼性も高い規格です。128種類のASCII文字すべてに対応しています。
Code128 128種類のASCII文字すべてに対応しています。ファンクションキャラクタ、コードセット選択キャラクタ、スタートコードの3つを組み合わせることで、省スペースとデータの多様性を両立しています。GS1-128やコンビニバーコードは、このCODE128規格がベースとなっています。
EAN128 GS1-128 UCC/EAN-128、コンビニバーコード。商取引に関する各種情報をCODE128シンボルを用いて表す規格です。このシンボルで使用する、商品管理や物流管理、業務管理のデータ項目は、アプリケーション識別子（AI）として標準化されています。
NW7 CodabarまたはCodeabarまたはCode2of7 4本のバーとその間のスペースで1つの文字を表します。図書館や宅配便、血液の管理などで利用されています。また、誤読防止の為、様々な種類のチェックデジットがサポートされているのも特長です。
IntelligentMail アメリカ合衆国郵便公社（USPS）で郵便物の自動化処理のために使用されるバーコードです。従来のPOSTNETとPLANETを置き換える新しい規格です。
ITF 商品の物流過程において、ダンボールに集合包装用商品コード（GTIN-14）を表示する際に利用されています。
JAN8 EAN8 JANコードを8桁で表す省略形です。現在日本で流通しているほとんどの商品につけられています。
JAN13 EAN13 JANコードを13桁で表す標準型です。現在日本で流通しているほとんどの商品につけられています。
JapanesePostal カスタマバーコード、郵便バーコード。日本の郵便業務で利用されている規格です。このバーコードを印字した葉書や封筒は、区分機で自動的に仕分けされます。あらかじめ差出人が郵便物にカスタマバーコード印刷しておくことで、料金の割引サービスを受けることができます。
PostNet アメリカで郵便番号の表示に利用されています。高さの異なるバーで11桁の数字を表現します。
UPC UPC/A、UPC/E、UPC/E アドオン。

二次元バーコード（二次元コード）

以下の「使用例」のバーコード画像は、クリックすると拡大表示できます。GrapeCity Barcodeでは別名を提供している二次元コードはありません。

»

Barcode Options

GrapeCity BarcodeではバーコードのオプションをJSON形式の文字列で指定します。ここでは、各バーコードのオプションと値を説明します。JSON形式とは、次のような文字列です。

{'キー文字列':'値','別のキー文字列':'別のキー文字列の値'}

Visualforceページの場合、バーコードのオプションは次の「options=」以下のように設定します。この例では、QRコードの色を紫色、エラー訂正レベルを「H」に変更しています。

<apex:page>
    <gcbc:GcBarcodeVF value="QRCodeValue" type="qrcode" imageWidth="200" imageHeight="200" outputFormat="PNG" options="{'BackColor':'white','ForeColor':'purple','ErrorLevel':'H'}">
    </gcbc:GcBarcodeVF>
</apex:page>

Lightningアプリの場合、次のような文字列を「Options」に設定ます。

{'BackColor':'white','ForeColor':'purple','ErrorLevel':'H'}

または次のような書式も使用できます。

{"BackColor":"white","ForeColor":"purple","ErrorLevel":"H"}

オプションは大文字と小文字を区別しません。

各バーコードで利用できるオプションは以下のとおりです。

共通の設定

  • EncodingCodePage: 既定のエンコーディングはShift-JIS（シフトJIS）です。Shift-JISの場合は「{“EncodingCodePage”:“932”}」と指定します。UTF-8の場合は「{“EncodingCodePage”:“65001”}」と指定します。他のコードページはエンコーディングのコードページを参照してください。
  • ForeColor: バーコードの前景色を指定します。背景色の値はHTML Color Formatで指定します。色名または16進数を値として設定できます。例えば、「Red」と「#FF0000」のどちらでも設定できます。関数記法「rgb(R,G,B)」や「hsl()」「rgba()」は使用できません。HTML Color Formatの詳細は、MDN Web DocsのcolorやW3CのCSS Color Module Level 3（英文）を参照してください。
  • BackColor: バーコードの背景色を指定します。色名を指定する形式はForeColorと同じです。
  • CheckDigit: いくつかの一次元バーコードに利用でき、チェックディジットを含むまたは除外するために使用されます。Boolean値。チェックディジットを含む場合はtrue、それ以外の場合はfalse。
  • ShowMessage: 人間が読める形式のメッセージ文字列を表示する場合はtrue、それ以外の場合はfalse。Boolean値。人間が読める形式のメッセージをサポートする一次元バーコードに使用されます。
  • MessageString: 人間が読める形式のカスタムなメッセージ文字列を指定します。人間が読める形式のメッセージをサポートする一次元バーコードのみで利用できます。

一次元バーコード

Code39

  • FullAscii: Boolean値。FullAscii Code39を使用するかどうかを指定します。trueの場合使用します。falseの場合、使用しません。

JAN8（EAN8）

  • CompositeType: CCA、CCBおよびCCCです。
  • CompositeValue: 複合部分の文字列の値を指定します。

JAN13（EAN13）

  • CompositeType: CCA、CCBおよびCCCです。
  • CompositeValue: 複合部分の文字列の値を指定します。

EAN128（GS1-128）

»

Structured 2D code

GrapeCity Barcodeは、Aztec、Code49、DataMatrixおよびQRコードを使う場合に、１つのバーコードに収まらないデータや分割したいデータを複数のバーコードに分割し、読み取り時にデータを連結できる「連結機能」に対応しています。

Aztec

StructureAppened プロパティ、 StructureIndex プロパティ、および StructrueNumber プロパティは、構成連結機能をサポートするAztecバーコードを生成して、すべてのバーコードが読み込んだ後、それらを再構築します。既定値は順にfalse、0、1です。

文字列の長さが構造数の倍数である場合、元の文字列は平均的に分割されます。それ以外の場合は、残りの文字が最後の文字列に含まれます。例えば、元の文字列のバイナリ長は「password is 123456」の場合、平均的に3つの部分（構造数は3である）に文字列が分割されます。すべての部分をエンコードし、以下のように表示します。

上記3つのシンボル用の設定は以下の通りです。

Symbol #1:
Value = "password is 123456"
Options = '{"StructureAppend":"true","StructureNumber":"3","StructureIndex":"1"}'

Symbol #2:
Value = "password is 123456"
Options = '{"StructureAppend":"true","StructureNumber":"3","StructureIndex":"2"}'

Symbol #3:
Value = "password is 123456"
Options = '{"StructureAppend":"true","StructureNumber":"3","StructureIndex":"3"}'

AztecではStructureIndexが1から開始されることに注意してください。

Code49

Grouping プロパティをtrueに設定して、正しい GroupNo を指定することでCode49を複数のバーコードシェイプに分割できます。その結果、より高いデータ量が表示できます。

Grouping プロパティの既定値はfalseです。GroupNo の既定値は0です。値が指定されない場合は、81文字数以上の文字列を設定する場合、バーコード画像が生成できません。

例えば、以下の値のCode49バーコードを生成する場合、2つのCode49シンボルに分割します。 「123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890」

各シンボル用の設定は以下の通りです。

Symbol #1:
Value = "123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890"
Options='{"Grouping":"true","GroupNo":"0","ShowMessage":"false"}'

Symbol #2:
Value = "123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890"
Options='{"Grouping":"true","GroupNo":"1","ShowMessage":"false"}'

上記設定は2つのシンボルのみに適しています。無効な値（例：GroupNo = 2）を設定する場合、バーコード画像が生成できません。

»

Type of Scanned Barcode

The preservedScannedType or scannedType of the GrapeCity Barcode component stores the following values based on the read barcode or two-dimensional code.

  • AZTEC
  • CODABAR (Ames Code, NW-7, Code 2 of 7, ANSI/AIM BC3-1995 or USD-4)
  • CODE_39
  • CODE_93
  • CODE_128 (EAN128)
  • DATA_MATRIX
  • EAN_8 (JAN8)
  • EAN_13 (JAN13)
  • ITF
  • IMB
  • MAXICODE
  • MSI
  • PDF_417
  • QR_CODE
  • RSS_14
  • RSS_EXPANDED
  • UPC_A
  • UPC_E
  • UPC_EAN_EXTENSION
  • PLESSEY

Both AZTEC and PDF_417 support are Beta version.

»

Error messages

GrapeCity Barcodeでバーコードを生成するとき、指定したバーコードに無効な値が設定された場合、またはネットワーク通信によってエラーが発生する可能性があります。

GcBarcodeとGcBarcodeVFコンポーネントでは、以下のエラーが発生する場合があります。

Salesforceサーバーの通信エラー

JavaScriptコードがApexクラスと通信する場合、以下のエラーが発生します。括弧内は日本語の参照訳です。

  • Server Unavailable (サーバーが利用可能でない)
  • User session expired (ユーザーのセッションが期限切れ)
  • The lightning platform met a serious error and could not resume (Lightningプラットフォームが致命的なエラーに遭遇し回復可能でない)

上記エラーが発生する場合、GcBarcodeコンポーネントは以下のようにエラーを通知します。

Error:[Error Message from Server]

バーコード生成サービスの通信エラー

GrapeCity Barcode for Salesforceでは、Salesforceのデータを外部のサーバーに送信し、その外部のサーバーからバーコードの画像データを取得します。外部のサーバーとの通信に失敗すると、次のようなエラーが発生します。

エラーメッセージ 日本語の参照訳
Error:Unable to tunnel through proxy. Proxy returns “HTTP/1.0 404 Not Found” エラー：プロキシを経由して接続できません。「HTTP/1.0 404 Not Found」が返されます。
Error:Read timed out エラー：読み取りのタイムアウト。

バーコード設定エラー

バーコードの設定が正しくない場合は、以下のエラーが発生する場合があります。

»

Copyright © MESCIUS inc. All rights reserved.