Workday と Barcodesoft Cloud Barcode の統合
Workday エコシステム内で高解像度バーコードを生成するための包括的なガイドです。
前提条件: ご注文処理後、
User_id、Secret、および Scope が電子メールで直ちに送信されます[cite: 3, 4]。
技術アーキテクチャ
1. 認証
Workday Integration Cloud は、固有の認証情報を使用して OAuth 2.0 ハンドシェイクを開始し、安全な Bearer トークンを取得します[cite: 3, 4]。
2. REST リクエスト
Workday Studio または EIB は、データパラメータ（例: 資産 ID または従業員 ID）を含む GET リクエストを Barcodesoft Cloud に送信します[cite: 3, 4]。
3. イメージ生成
Cloud API は、要求された形式（SVG/PNG）でバーコードをレンダリングし、その画像を直接 Workday に返します[cite: 3, 4]。
ステップ 1: アクセストークンを取得
OAuth 2.0 エンドポイントを使用して認証情報を Bearer トークンに交換します[cite: 3, 4]。
POST リクエスト設定
https://www.barcodesoft.com/api/auth/token
| ヘッダー / ボディキー | 値 / ソース |
|---|---|
Content-Type | application/x-www-form-urlencoded |
grant_type | client_credentials |
client_id | お客様の User_id[cite: 3, 4] |
client_secret | お客様の Secret[cite: 3, 4] |
scope | お客様の Scope[cite: 3, 4] |
ステップ 2: エンドポイントパラメータ
| パラメータ | 説明 | サポートされる値 |
|---|---|---|
data |
エンコードする情報（資産 ID、社会保障番号など） | 英数字、GS1 AI（01、10 など）[cite: 3, 4] |
imageformat |
出力ファイル形式 | SVG、PNG、JPeg、WebP[cite: 3, 4] |
orientation |
画像の回転 | Original、Rotate90、Rotate180、Rotate270[cite: 3, 4] |
dpi |
印刷品質用の解像度 | 96、300、600[cite: 3, 4] |
Workday Studio
HTTP Outbound Connector を使用して画像を取得します。バーコードを BIRT レポート で使用する場合は、以下の手順を実行してください。
Authorizationヘッダーに Bearer トークンを設定します[cite: 3, 4]。- 特定のエンドポイント（例:
/barcode/v1/qrcode/）に GET リクエストを送信します[cite: 3, 4]。 - Store Step を使用してバイナリコンテンツを保存します[cite: 3, 4]。
Workday EIB
シンプルな ID カード生成や資産ラベル出力に最適です。以下のようにトランスポートを設定してください。
- 変換: Workday XML 出力に基づいて URL 文字列を動的に生成する XSLT を作成します[cite: 3, 4]。
- REST トランスポート: 変換結果を REST エンドポイントの宛先にマッピングします[cite: 3, 4]。
Barcodesoft Cloud への即時アクセス
サブスクリプションにより、Workday 統合向けの GS1-128、QR Code、DataMatrix、および Code 128 の生成を無制限に利用できます。 認証情報は電子メールで直ちに送信されます[cite: 3, 4]。
即時セットアップ
OAuth 2.0 セキュリティ[cite: 3, 4]
600 DPI 対応[cite: 3, 4]
トラブルシューティング & ヒント
BIRT ベースの Workday レポートでは、SVG を強く推奨します。拡大縮小時でも鮮明なエッジを維持し、高密度コードでの読み取りエラーを防止します[cite: 3, 4]。
GS1-128 データを送信する際、
(01) のような括弧は %2801%29 として URL エンコードしてください。「Invalid Data」エラーを回避できます[cite: 3, 4]。実装のヒント
- PDF レポートで高品質な印刷を行うため、常に
imageformat=svgを使用してください[cite: 3, 4]。 - データ文字列が URL エンコードされていることを確認してください（特に GS1-128 の括弧）[cite: 3, 4]。