この記事では、以下のことを学びます:
- アプリが完了した際にすべてのデータを印刷する方法
- 印刷に適した形式でステップを設計する方法
- ステップ上でカスタムウィジェットを印刷する方法
貴社が現場での紙ベースのプロセスを自動化し、フォームのデジタル化を進め始めても、データを適切に共有するために、さまざまな作業の結果を印刷する必要がある場合があります。
アプリのステップを印刷する
Tulipアプリからデータをリアルタイムで印刷(またはローカルのPDFに保存)したい場合は、次の4つの手順が必要です:
- 希望する印刷サイズに合わせて、ステップ(または複数のステップ)を設定します。
- 印刷した際に整理されており、理解しやすいようにステップを設計します。
- 「印刷」トリガー付きのボタンを追加します。
- ステップのサイズがページをできるだけ埋め尽くすように、印刷設定をカスタマイズします。
「ステップを印刷」トリガーアクションを使用すると、単一のステップまたはステップグループ全体を一度に印刷できます。各ステップは別々のページに印刷されます。
ステップの解像度を設定する
まず、多くのユーザーは「レポート」というステップグループを作成し、一度に印刷したいすべてのステップをそのステップグループに追加することを好みます。
その構成は次のようになります:

次に、このグループ内のステップが希望の解像度で印刷されるよう、適切に設定することが重要です。アプリ内で、コンテキストペインの [ステップ] タブに移動し、[ステップの解像度] を選択します。

サイドペイン内で、希望する用紙サイズに合わせて適切な解像度を選択します。

PDFの場合、レターサイズ(縦向き)を使用するのが最適です。用紙サイズを合わせることで、アプリの表示が1ページに収まるように印刷されます。
ステップの設計
アプリで、多くの単色を使用した「ベースレイアウト」を利用しているかもしれません。これはオペレーターへの情報伝達には有効ですが、カラフルなステップでプリンターのインクを無駄にしたくないでしょう。
その代わりに、レポートステップからすべてのベースレイアウト要素を削除し、テキストに重点を置くことをお勧めします。
以下に、印刷用に最適化されたステップの例を示します:

このステップには、アプリからのデータ7件と、5件のテスト結果が含まれています。左上と右下の**「印刷**」ボタンおよび「メニュー」ボタンは、色インクを必要としないよう、背景が白になっています。
このステップでは、Tulipの以下の機能を活用しています:
- シンプルな視覚的レイアウトを作成するためのグリッドウィジェット
- ステップ上にさまざまな変数の値を埋め込むための「変数テキスト」
- カスタム配色のボタン
印刷ボタンの追加
印刷ボタンには、1つのトリガーアクションが必要です。多くの場合、アプリの完了と組み合わせて使用されますが、これらは同じトリガー内で行うことはできません。アプリの完了をトリガーするには、別のボタンを作成する必要があります。
そこで、オペレーターがステップを印刷し、「レポート」ステップグループの次のステップに移動してアプリを完了できるようにするトリガーの例を以下に示します:

- 「ステップを印刷」 「レポート」
- 「ステップへ移動」 「次へ」
また、通常のステップに「印刷」ボタンを配置し、オペレーターにステップを表示することなく、ステップグループ全体を印刷することも可能です。
これにより、コンピュータのデフォルトの印刷オプションが開きます。
印刷設定のカスタマイズ
印刷ダイアログ
オペレーターは、さまざまなサイズの画面で Tulip Player を使用します。そのため、Tulip Player を実行しており、ステップの印刷または保存が必要な各コンピュータで、以下の操作を行う必要があります。
- 印刷するステップの解像度に合わせてページレイアウトを変更します。例:レター(縦向き)。
- オペレーターが将来簡単に選択できるよう、これらの設定を「プリセット」としてローカルに保存してください:

アプリが正しく印刷されるか確認するには、印刷ダイアログの「プレビュー」オプションを使用して、印刷前にアプリの表示を確認してください。

PDF上のフィールドへの入力
また、PDFをステップに埋め込み、その上に適切な位置に変数テキストウィジェットを配置することで、「入力済みの」PDFを印刷することもできます。そのステップは、Tulip Playerに表示されているとおりに印刷されます。
その手順は以下の通りです:
- 適切な解像度にサイズ調整されたステップにPDFを埋め込みます。
- PDFの適切なフィールドの上に「可変テキスト」ウィジェットを追加します。これらは、Playerでアプリが使用された際に動的に入力されます。
- PDFが複数ページにわたる場合は、PDFの各ページごとにTulipで新しいステップを追加し、上記の手順を繰り返します。
アプリデータをローカルにPDFとして保存する
また、アプリデータをローカルコンピュータ上のPDFとして保存するには、印刷ダイアログを使用するのが最適です。システムダイアログで「印刷」を押すのではなく、**「PDFとして保存」**を選択して、ステップとライブデータをローカルファイルに保存してください。

技術的な注意事項
印刷時に正常に動作しないアプリコンテンツに関する注意事項。
- 変数テキストウィジェット内の「現在のステップ」への参照は、[印刷] ボタンが押された時点で開いているステップでのみ機能します。
- 「ステップ進入時」トリガーは、印刷されたステップでは発火しないため、「印刷」ボタンを押す前に、正しいデータがすでに追加されていることを確認してください。
- マシン属性ウィジェット:これらが正しく機能することはほとんどありません。最後に確認された出力を取得したいレポートの場合、より適切な方法は、マシン出力にトリガーを設定して出力をローカル変数に保存し、それをカスタムウィジェットで表示することです。
- 動画:YouTube 動画の場合、バナー画像は読み込まれません。
カスタムウィジェットの印刷
Player ステップを印刷すると、各カスタムウィジェットは、その現在のコンテンツの静的なスナップショットとして含まれます。スナップショットをキャプチャすると、ブラウザが埋め込まれたフレームを直接印刷できない場合でも、ウィジェットは確実に印刷されます。
ウィジェットのスナップショットの動作
- スナップショットには、印刷が開始された時点でのウィジェットの状態が反映されます。これには、画面上に表示されているテキスト、レイアウト、色、フォームの値、画像、および標準的な 2 次元キャンバスコンテンツが含まれます。
- 同じカスタムウィジェットがステップ上に複数回配置されている場合、各ウィジェットの配置ごとに独自のスナップショットが印刷されます。
- 印刷されるスナップショットは静的です。つまり、印刷中はウィジェットの JavaScript が再度実行されることはありません。「
beforeprint」ハンドラやその他の印刷時の JavaScript に依存する変更は反映されません。印刷開始前にウィジェットに加えられた変更は保持されます。 - 印刷ビューを静的な状態に保つため、スナップショットはクリーンアップされます。インラインスクリプト、インラインのイベントハンドラ属性(
onclick、onerror、onloadなど)、およびjavascript: URL は削除されます。これは、通常のテキスト、レイアウト、スタイル、画像、またはフォームの値には影響しません。 - ウィジェット独自のスタイルシートはキャプチャされ、再適用されるため、そのスタイルは維持されます。
@media printルールを含む直接的な CSS は印刷用スナップショットに影響を与えるため、印刷時に反映させたい表示の変更には CSS を使用してください。
印刷されたウィジェットは独立してレンダリングされます。画面上と同様に、印刷ページの他の部分のスタイルに影響を与えることもなければ、そこからスタイルを継承することもありません。また、印刷ビューはクリーンなスタイルのベースラインから開始されるため、ウィジェットが特定のフォントや色に依存している場合は、デフォルトを前提とせず、ウィジェット独自のCSSで明示的に設定してください。
期待される動作
印刷では、ウィジェットに表示されている内容を可能な限り忠実に再現することを目指しています。
最も予測可能な出力を得るには:* 印刷に必要なコンテンツはウィジェットのメインドキュメント内に収める* 印刷用スタイルには直接 CSS を使用する* 印刷が開始される前に、重要な画像やデータが表示されていることを確認する* 印刷に必要な情報が、印刷時の* JavaScript、インラインイベントハンドラ、動画や WebGL フレーム、ネストされた Web ページ、外部からインポートされたスタイルに依存しないようにする。
制限事項
印刷されたカスタムウィジェットは完全な再現ではなく、外部リソースやブラウザ固有のレンダリングに依存するコンテンツは異なる場合があります。
- ウィジェットのメインドキュメント内のコンテンツのみがキャプチャされます。Web コンポーネント、カスタム要素、またはシャドウ DOM(Lit など)を通じて表示 UI をレンダリングするウィジェットは、画面上では正しく表示されていてもキャプチャされず、印刷時には空白になります。 一般的なライブラリ(Chart.js、D3、jQuery など)を使用して構築されたウィジェットは、メインドキュメントにレンダリングされるため、影響を受けません。ネストされた iframe も同様にキャプチャされません。
@media printルールを含む、直接読み取れる CSS は保持されます。外部スタイルシートおよび CSS の@import ルールは「ベストエフォート」であり、読み込まれない場合があります。- ウィジェットのスナップショットは、プレーヤーの印刷ページによって読み込まれるため、そのセキュリティポリシーに準拠する必要があります:
- そのため、ウィジェット自身のフレーム内で読み込まれるリソース(画像、フォント、スタイル、背景画像、メディアファイルなど)は、印刷時にブロックされる可能性があります。
- ウィジェットのフレームに紐づく認証、混合コンテンツのルール、有効期限のあるURL、および相対URLも、リソースの読み込みを妨げる可能性があります。
- 外部リソースの読み込みが遅い場合、それらが欠落する可能性があります。印刷処理はアセットの読み込みを短時間待機しますが、すべてのリソースの読み込みが完了したことを保証するものではありません。
- 2次元キャンバスは、そのピクセルがキャプチャ可能な場合にのみ印刷されます。クロスオリジン(汚染された)キャンバスは空白になる可能性があり、WebGLキャンバスは一般的にキャプチャされません。
- 動画の現在のフレームはキャプチャされません。動画、音声、ネストされたウェブページ、アニメーション、テキストの選択範囲、フォーカス、ホバー状態、およびスクロール位置は、表示されるとは限りません。
- 現在のスナップショットをキャプチャできない場合、ウィジェットは現在の状態ではなく、初期設定の HTML および CSS を使用して印刷されます。
以下の表は、ウィジェットの出力結果における一般的な差異とその考えられる原因をまとめたものです:
| 出力されたウィジェットの結果 | 考えられる原因 |
|---|---|
| 外部スタイルまたはフォントが欠落している | リソースがプレーヤーのセキュリティポリシーによってブロックされているか、印刷ページからアクセスできないか、または印刷開始時にまだ読み込み中だった可能性があります。 |
| 印刷専用の JavaScript による変更が反映されていない | 静的な印刷ビューでは JavaScript は実行されません。表示の変更を行う場合は、代わりに直接印刷用 CSS を使用してください。 |
| インラインハンドラに関連付けられた動作が反映されていない | インラインスクリプトやイベントハンドラ(例:onerror時の画像フォールバック)は、静的な印刷ビューからは削除されます。代わりに、直接印刷用 CSS を使用してください。 |
| 画像が欠落しています | そのURLは、ウィジェット内でのみ利用可能な認証を必要としているか、有効期限が切れているか、ブロックされているか、または読み込みが完了していない可能性があります。 |
| キャンバスが空白です | 2次元キャンバスは、そのピクセルを安全にキャプチャできる場合にのみ印刷されます。クロスオリジンキャンバスのコンテンツはキャプチャできず、WebGLキャンバスは通常キャプチャされません。 |
| 動画、WebGL、または埋め込み Web ページのコンテンツが空白です | これらの動的または埋め込みの表示領域は、キャプチャされることが保証されていません。 |
| Web コンポーネント/シャドウ DOM ウィジェットが空白で印刷される | ウィジェットのメインドキュメント内のコンテンツのみがキャプチャされます。Webコンポーネント、カスタム要素、またはシャドウDOM(例:Lit)で構築されたウィジェットはキャプチャされません。一般的なライブラリ(Chart.js、D3、jQuery)はメインドキュメントにレンダリングされるため、影響を受けません。 |
| 印刷されたウィジェットは初期状態のように見える | 現在のスナップショットを取得できなかったため、出力されたウィジェットには初期設定時のHTMLおよびCSSが使用されました。 |
