画像の挿入 - 動的画像ガイド

PDF4me 生成されたドキュメント内に動的な画像挿入を可能にし、データソースからロゴ、写真、チャート、図表、その他の視覚コンテンツをテンプレートに挿入できます。画像は公開されている方法で提供できます。 URLs または Base64エンコードされた文字列。

画像構文要件

The image syntax must be placed inside a Text Box in Word for proper image population. Create a text box at the desired location in your template before adding image merge fields.

画像挿入方法

PDF4me テンプレートに画像データを提供する2つの方法をサポートしています。

方法1：パブリックイメージ URL

公開されている画像を使用する URLs ウェブソースから画像を挿入する。

構文：

<<image [imageUrl]>>

データ例：

{
  "imageUrl": "https://public-url/image.png"
}

ユースケース：

公開サーバーにホストされている企業ロゴ
ECプラットフォームからの商品画像
オンラインで生成およびホストされているチャートとグラフ
公共リソース画像

方法2： Base64 エンコードされた画像

画像を挿入するには Base64画像ファイルのエンコードされた文字列表現。

構文：

<<image [imageBase64]>>

データ例：

{
  "imageBase64": "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAYAAADL1t+KAAAACXBIWXMAABcSAAAXEgFnn9JSAACU6ElEQVR4nOz953tjR5bn+34jtoMn6D2ZSaaRL5lSmR5z5t5/+9xzZqZ7qktSeksmvfcG3mzsveO+2ACVUklKUspMksj1eZ7qqpZECCCZ+CEiVqyljDEGIYQQQlxr+rKfgBBCCCH+OAl0IYQQogtIoAshhBBdQAJdCCGE6AIS6EIIIUQXkEAXQggh..."
}

利点：

インターネット接続なしで動作します
安全 - 外部依存関係なし
画像データを完全に制御する
機密文書に適しています

画像フォーマットオプション

書式設定スイッチを使用して、テキストボックス内での画像の収まり方を制御します。これらのオプションは、画像のサイズと縦横比の動作を決定します。

アスペクト比を維持する

構文： <<image [imageUrl] -keepRatio>>

行動：

テキストボックスのサイズを維持します
テキストボックスの範囲内に収まるように画像のサイズを調整します。
元の画像の縦横比を維持します
比率が異なる場合、画像がテキストボックス全体に表示されないことがあります。

最適な用途: ロゴ、アイコン、画像など、歪みを避ける必要があるもの

フィットハイト

構文： <<image [imageUrl] -fitHeight>>

行動：

テキストボックスの幅を維持します
画像の縦横比に合わせてテキストボックスの高さを調整します。
画像がテキストボックスを完全に埋め尽くします
画像に合わせてテキストボックスのサイズが変更されます

最適な用途: 柔軟なレイアウトにおける可変高さ画像

フィット幅

構文： <<image [imageUrl] -fitWidth>>

行動：

テキストボックスの高さを維持します
画像の縦横比に合わせてテキストボックスの幅を調整します。
画像がテキストボックスを完全に埋め尽くします
画像に合わせてテキストボックスの幅が変わります

最適な用途: 横長のバナー、高さが固定されたヘッダー

フィットサイズ

構文： <<image [imageUrl] -fitSize>>

行動：

画像サイズに合わせてテキストボックスの寸法を変更します
元の画像サイズを使用します
画像は実寸大で表示されます
テキストボックスは画像のサイズに合わせてサイズ変更されます

最適な用途: 元の画像サイズを正確に保持する必要がある場合

フィットサイズ限定

構文： <<image [imageUrl] -fitSizeLim>>

行動：

テキストボックスを画像サイズに合わせて調整します
元のテキストボックスのサイズを超えて拡大することはありません
画像が小さい場合はテキストボックスを縮小できます
テキストボックスの拡大を防止します

最適な用途: 最大画像サイズを制限しつつ、より小さな画像も許可する

書式比較

フォーマットオプション	幅	身長	アスペクト比	テキストボックスのサイズ
`-keepRatio`	修理済み	修理済み	保存済み	変更なし
`-fitHeight`	修理済み	変数	保存済み	高さの変化
`-fitWidth`	変数	修理済み	保存済み	幅の変更
`-fitSize`	変数	変数	保存済み	両方とも変化する
`-fitSizeLim`	変数	変数	保存済み	制約付き

実例

例１：会社ロゴ

テンプレート：

[Create a text box in header]
<<image [companyLogo] -keepRatio>>

データ：

{
  "companyLogo": "https://company.com/images/logo.png"
}

例2：商品画像

テンプレート：

<<foreach [product in products]>>
Product: <<[product.name]>>
[Text box:] <<image [product.imageUrl] -fitHeight>>
Price: $<<[product.price]>>

<</foreach>>

データ：

{
  "products": [
    {
      "name": "Laptop Pro",
      "imageUrl": "https://example.com/laptop.jpg",
      "price": "1299.99"
    },
    {
      "name": "Wireless Mouse",
      "imageUrl": "https://example.com/mouse.jpg",
      "price": "29.99"
    }
  ]
}

例3：署名画像（Base64）

テンプレート：

Authorized Signature:
[Text box:] <<image [signatureBase64] -fitSizeLim>>

Name: <<[signatoryName]>>
Date: <<[signatureDate]:"dd.MM.yyyy">>

データ：

{
  "signatureBase64": "iVBORw0KGgoAAAANSUhEUgA...[truncated]",
  "signatoryName": "John Smith",
  "signatureDate": "2024/01/15"
}

表内の画像

画像挿入と表構造を組み合わせることで、整理された視覚的なプレゼンテーションを作成できます。

製品カタログ表

テンプレート：

Product | Image | Price
<<foreach [item in catalog]>>
<<[item.name]>> | [Text box: <<image [item.imageUrl] -keepRatio>>] | $<<[item.price]>>
<</foreach>>

条件付き画像挿入

画像データが利用可能な場合にのみ、画像を挿入してください。

オプションのロゴ例

テンプレート：

<<if [logoUrl != null]>>
[Text box:] <<image [logoUrl] -keepRatio>>
<</if>>

デフォルトイメージのフォールバック

テンプレート：

<<if [productImage != null]>>
[Text box:] <<image [productImage] -fitHeight>>
<<else>>
[Text box:] <<image [defaultProductImage] -fitHeight>>
<</if>>

文書内の複数の画像

単一のデータソースから、複数の動的画像を含むドキュメントを生成します。

例：グラフ付きレポート

テンプレート：

Sales Report - <<[reportMonth]:"MMMM yyyy">>

Revenue Chart:
[Text box:] <<image [revenueChartUrl] -fitWidth>>

Expense Chart:
[Text box:] <<image [expenseChartUrl] -fitWidth>>

Growth Chart:
[Text box:] <<image [growthChartUrl] -fitWidth>>

画質に関する考慮事項

画像に関するベストプラクティス URLs

使用 HTTPS - 安全な URLs セキュリティ警告を防ぐ
永続 URLs - 確保する URLs アクセス可能な状態を維持する
適切なサイズ 出力に適したサイズの画像を使用する
フォーマット互換性 - 一般的なフォーマット: PNG、 JPG、 GIF
CDNホスティング 信頼性の高いコンテンツ配信ネットワークを使用する

ベストプラクティス Base64 画像

ファイルサイズを最適化する - エンコード前に画像を圧縮する
適切な解像度を使用してください - 意図した出力解像度に合わせる
データサイズを考慮する - 大きい Base64 文字列はペイロードサイズを増加させる
フォーマットの選択 - PNG 透明性を確保するため、 JPG 写真用
エンコード品質 - 適切な Base64 エンコーディング

Wordでのテキストボックスの設定

画像プレースホルダーの作成

テキストボックスを挿入します:
- ワードリボン → 挿入 → テキストボックス
- テキストボックスを希望の位置に描画する
- 画像サイズを概算するテキストボックスのサイズ
テキストボックスの設定:
- 必要に応じてテキストボックスの枠線を削除します。
- テキストボックスの塗りつぶしを「塗りつぶしなし」に設定して透明度を調整します。
- 必要に応じてテキストの折り返しを設定してください。
画像を追加する構文:
- テキストボックス内をクリック
- 画像差し込みフィールドの構文を入力してください
- 適切な書式設定オプションを追加する

画像挿入のトラブルシューティング

よくある問題

問題： 生成されたドキュメントに画像が表示されません
解決： 画像構文が通常の段落ではなく、テキストボックス内に含まれていることを確認してください。

問題： 画像が歪んで見える
解決： 使用 -keepRatio アスペクト比を維持する

問題： 画像が大きすぎるか小さすぎる
解決： テキストボックスのサイズを調整するか、適切なフィットオプションを使用してください

問題： Base64 画像の読み込みに失敗しました
解決： 確認する Base64 エンコードは完了し、有効です。

問題： URL 画像が読み込まれません
解決： チェック URL アクセシビリティを確保し、 HTTPS画像フォーマットを確認する

問題： 画像の位置が間違っています
解決： Wordテンプレート内のテキストボックスの位置を変更する

高度な画像処理技術

レスポンシブな画像サイズ調整

異なるサイズで表示される可能性のあるドキュメントの場合：

[Large text box:] <<image [headerImage] -fitSizeLim>>

これにより、必要に応じて画像を縮小できますが、テキストボックスの範囲を超えて拡大することはありません。

キャプション付き画像

テンプレート：

[Text box:] <<image [chartUrl] -fitWidth>>

Figure <<[$index + 1]>>: <<[chartTitle]>>
Source: <<[chartSource]>>

条件付き画像フォーマット

データプロパティに基づいて書式を選択する：

<<if [imageOrientation == "landscape"]>>
[Wide text box:] <<image [imageUrl] -fitWidth>>
<<else>>
[Tall text box:] <<image [imageUrl] -fitHeight>>
<</if>>

完全な例：製品シート

テンプレート：

<<[productName]:caps>>

Product Image:
[Text box 300x300:] <<image [productImageUrl] -keepRatio>>

Specifications:
• Model: <<[modelNumber]>>
• Category: <<[category]>>
• Price: $<<[price]:"F2">>

Additional Images:
<<foreach [img in additionalImages]>>
[Text box 150x150:] <<image [img.url] -keepRatio>>
<<[img.caption]>>
<</foreach>>

Company Logo:
[Text box 200x60:] <<image [companyLogoBase64] -fitHeight>>

:::ヒント：画像最適化最適な結果を得るには、データをソースに含める前に画像を最適化してください。画像を適切なサイズにリサイズし、圧縮することで、画質を維持しながらファイルサイズを削減できます。 :::

:::警告：テキストボックスの使用が必須 Wordテンプレートでは、画像は必ずテキストボックス内に挿入してください。通常の段落内で画像構文を使用すると、画像が正しく表示されません。動的な画像を挿入する場所には、必ずテキストボックスのプレースホルダーを作成してください。 :::

画像構文要件​

画像挿入方法​

方法1：パブリックイメージ URL​

方法2： Base64 エンコードされた画像​

画像フォーマットオプション​

アスペクト比を維持する​

フィットハイト​

フィット幅​

フィットサイズ​

フィットサイズ限定​

書式比較​

実例​

例１：会社ロゴ​

例2：商品画像​

例3：署名画像（Base64）​

表内の画像​

製品カタログ表​

条件付き画像挿入​

オプションのロゴ例​

デフォルトイメージのフォールバック​

文書内の複数の画像​

例：グラフ付きレポート​

画質に関する考慮事項​

画像に関するベストプラクティス URLs​

ベストプラクティス Base64 画像​

Wordでのテキストボックスの設定​

画像プレースホルダーの作成​

画像挿入のトラブルシューティング​

よくある問題​

高度な画像処理技術​

レスポンシブな画像サイズ調整​

キャプション付き画像​

条件付き画像フォーマット​

完全な例：製品シート​

画像構文要件

画像挿入方法

方法1：パブリックイメージ URL

方法2： Base64 エンコードされた画像

画像フォーマットオプション

アスペクト比を維持する

フィットハイト

フィット幅

フィットサイズ

フィットサイズ限定

書式比較

実例

例１：会社ロゴ

例2：商品画像

例3：署名画像（Base64）

表内の画像

製品カタログ表

条件付き画像挿入

オプションのロゴ例

デフォルトイメージのフォールバック

文書内の複数の画像

例：グラフ付きレポート

画質に関する考慮事項

画像に関するベストプラクティス URLs

ベストプラクティス Base64 画像

Wordでのテキストボックスの設定

画像プレースホルダーの作成

画像挿入のトラブルシューティング

よくある問題

高度な画像処理技術

レスポンシブな画像サイズ調整

キャプション付き画像

条件付き画像フォーマット

完全な例：製品シート