Question 1

Documensoでプレースホルダーを使用して動的署名フィールドを追加する方法

Accepted Answer

DocumensoはPDFプレースホルダーをサポートしました。署名が必要な箇所に{{signature_1}}のようなプレースホルダーをPDFに追加すると、Documensoが自動的に検出してフィールド配置を行います。公式ドキュメント: https://docs.documenso.com/docs/users/documents/advanced/pdf-placeholders

Question 2

Documenso の完了済みドキュメントのメール添付ファイルで重複する '.pdf.pdf' 拡張子を修正する方法

Accepted Answer

これは、`packages/lib/jobs/definitions/emails/send-document-completed-emails.handler.ts` にある Documenso のメール添付ファイル名生成ロジックにおける既知のバグです。内部バージョン 2 のエンベロープでは、ドキュメントタイトルがすでに `.pdf` で終わっている場合でも `.pdf` が無条件に追加され、`Contract.pdf.pdf` のような名前の添付ファイルが生成されます。Web UI からの直接ダウンロードは影響を受けません。

**公式の修正方法:** PR #3374（https://github.com/documenso/documenso/pull/3374）を含むリリースに Documenso のインストールを更新してください。

**セルフホスト環境での回避策:** コードはその後で拡張子を再チェックしているため、無条件に拡張子を追加する処理を削除してハンドラーにパッチを適用してください：

```ts
const fileNameToUse = envelope.internalVersion === 1
  ? envelope.title
  : envelopeItem.title; // 無条件の + '.pdf' を削除

return {
  filename: fileNameToUse.endsWith('.pdf') ? fileNameToUse : fileNameToUse + '.pdf',
  content: Buffer.from(file),
  contentType: 'application/pdf',
};
```

その後、アプリケーションを再ビルドして再起動してください。このバグが影響するのは添付ファイルのファイル名のみであり、PDF の内容自体には影響しません。

Question 3

ドキュメントの言語がフランス語に設定されているのに、メールの件名「Waiting for others to complete signing」が英語で表示されるのはなぜですか？また、それを修正するにはどうすればよいですか？

Accepted Answer

フランス語の翻訳文字列が `packages/lib/translations/fr/web.po` に存在しない（`msgstr` が空）ため、Documenso は `send-document-pending-email.handler.ts` から送信される document-pending メールの件名について、英語の原文テキストにフォールバックします。修正方法: `fr/web.po` に翻訳を追加します:

msgid "Waiting for others to complete signing"
msgstr "En attente que les autres terminent de signer"

セルフホスト環境の場合は、`.po` ファイルを編集し、`lingui compile` で翻訳を再コンパイルしてからアプリを再起動します。上流プロジェクトの場合は、プロジェクトの翻訳プラットフォーム（Crowdin）を通じて翻訳を提出すれば、将来のリリースに含まれます。影響を受けるのはこの1つの文字列のみで、"Waiting for others to sign" のような関連文字列はすでに翻訳済みです。

Question 4

並列APIリクエストがfree-tierの月5通のメール制限をバイパスしてしまうrace conditionは、どのように修正すればよいですか？

Accepted Answer

動的レート制限を含むDocumensoリリースにアップグレードしてください。メンテナーによると、これにより並列リクエストのバイパスが間接的に解決されます。完全な修正のためには、データベーストランザクション内でアトミックなチェック・アンド・インクリメントを用いてクォータをサーバーサイドで強制してください。たとえば、`SELECT ... FOR UPDATE`でユーザーの月次使用量の行をロックし、`count >= 5`の場合はリクエストを拒否し、それ以外の場合はインクリメントしてコミットします。レート制限と冪等性キーを追加し、読み取りと書き込みが分離したチェックやクライアントサイドのバリデーションに決して依存しないでください。

Question 5

署名者が署名した後もドキュメントが保留中のままになるのはなぜですか?

Accepted Answer

これはバージョン `v1.8.0-rc.0` での既知の問題でした。最新の安定版リリースにアップグレードしてください。Docker の場合は、永続データボリュームを保持したまま、イメージを更新してコンテナを再作成してください。例: `docker compose pull && docker compose up -d`。アップグレード後、ドキュメントのステータスを再度確認してください。completed/abgeschlossen に変わっているはずです。

Documenso

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト