ドキュメントが空白になる、または何も生成されない
空白の出力は、ほぼ常に Portant が実行されたものの、期待していたデータを読み取れなかったことを意味します。以下の手順を順番に確認してください。
1. 接続を確認する
Google または HubSpot の接続が期限切れになっていると、エラーではなく空のドキュメントが生成されます。これは、マージするデータがない状態でマージが実行されるためです。まずこの可能性を排除してください。
2. ドキュメント全体が空白なのか、テーブルだけが空白なのか
明細項目のテーブルのみが空白の場合
明細項目は Contacts（連絡先）ではなく、Deals（取引）に紐付いています。Contact レコードからオートメーションを実行した場合、HubSpot 上で明細項目が表示されていても、明細項目テーブルは空白でレンダリングされます。
ワークフローを Deal から実行するか、関連オブジェクトからワークフローを実行するを使用してください。単一のドキュメントに複数の明細項目を追加するも参照してください。
関連レコードのフィールドのみが空白の場合
関連レコードから取得するフィールドは、レコード自体にアソシエーションラベルが適用されている必要があります。HubSpot のワークフローがラベルを適用せずにレコードを登録した場合、Portant は読み取るデータがなく、該当するタグが空のまま出力されるため、ドキュメントが半分しか入力されていない状態になります。
HubSpot でレコードを確認し、アソシエーションラベルが実際に設定されていることを確認したうえで、Portant のソースで同じラベルが選択されていることを確認してください。HubSpot プロパティを管理および選択するを参照してください。
一部のレコードのみが空白のドキュメントを生成する場合は、この点を慎重に確認する価値があります。ワークフロー自体に問題はなく、差異はデータにあります。
ドキュメント全体が空白の場合
以下のチェック項目に進んでください。
3. タグがソースと実際に一致しているか確認する
ソースフィールドと一致しないタグは空白のまま残ります。テンプレートを開いてタグチェッカーを実行してください。これにより、Portant が解決できないタグにフラグが立てられます。また、無効なタグも参照してください。
4. 何も生成されない場合
空白のファイルではなく、出力ファイル自体が存在しない場合は以下を確認してください。
- Template ブロックの出力設定を確認してください。 PDF を期待しているのに出力されない場合は、Save output as PDF（PDF として出力を保存）がオンになっていることを確認してください。
- ソースフィルターを確認してください。 すべてのレコードをフィルターで除外するワークフローは、出力なしで正常に完了します。ワークフローフィルターを参照してください。
- テンプレートが参照している画像を確認してください。 公開された直接の画像 URL ではないリンクを指定した画像タグがあると、出力の作成が停止します。画像タグを参照してください。
- Outputs ページでエラーステータスを確認してください。 エラーのある項目には黄色のステータスアイコンとエラーの理由が表示されます。
5. Portant 側の問題かどうかを確認する
すべてのユーザーで一斉にドキュメントの生成が停止した場合は、設定を変更する前に status.portant.co を確認してください。
それでも空白の場合
影響を受けた項目からサポートコードをコピーし、サポートチケットを開いてください。すべてのレコードに影響があるのか、一部のみに影響があるのかをお伝えください。その違いが原因の特定に直結します。