IronSecureDoc を使って C# PDF のテキストを編集する方法
この記事では、IronSecureDoc を使用して PDF 上のテキストを編集する方法について説明します。 これにより、サービスまたはプロセスは、実行中の IronSecureDoc サーバーに PDF を含む簡単な POST 要求を送信することで、機密情報を迅速かつ簡単に編集できるようになります。 Swagger ドキュメントを使用してこれを視覚的に実証します。 POST リクエストは必須パラメータとオプションパラメータの両方を受け取り、高度にカスタマイズ可能です。 応答では、編集されたテキストを含む PDF が返されます。
IronSecureDocでPDFのテキストを編集する方法
- IronSecureDoc Dockerイメージをプルして起動する
- Swaggerを使用してAPIをテスト
- 編集するテキストを指定します
- 提供された詳細でAPI呼び出しを実行します
- 赤actされたPDF文書をエクスポートします
IronSecureDoc をプルして起動する
IronSecureDoc をまだ実行していない場合は、以下のリンクに従ってセットアップしてください。
| ローカルでホスト | クラウドへのデプロイ |
|---|---|
[POST] テキスト編集 API
[POST] Redact Text API エンドポイントを使用すると、編集機能を使用して PDF ドキュメント内の機密テキストを非表示にすることができます。 この機能は、法的契約、医療記録、財務報告書などの機密文書を扱うアプリケーションにとって不可欠です。 この API を使用すると、特定のテキストが完全に削除され、セキュリティが強化され、データ保護標準への準拠が保証されます。
[{i:(テキストが編集されると、その内容を回復することはできません。ブラケットを閉じる
威勢のいい
Swagger は、開発者がユーザーフレンドリーな Web インターフェースを通じて RESTful API と対話できるようにする強力なツールです。 Python、Java などの言語を使用している場合でも、Swagger を使用すると、この API をテストおよび実装する便利な方法が得られます。
威勢のいいでテキストを編集する手順
Swagger UI にアクセスします。
API サーバーがローカルで実行されている場合は、Web ブラウザーで
http://localhost:8080/swagger/index.htmlに移動して Swagger にアクセスできます。
[POST] Redact Text APIを見つけます。
Swagger UI内で、[POST]
/v1/document-services/pdfs/redact-textエンドポイントを探してください。

3.構成を指定します。
この例では、PDFファイルと編集する単語の両方をPOSTリクエストで提供しています。"we"という単語を編集し、その上に黒い枠線を重ねます。 このデモでは、次の構成の" sample.pdf "ファイルを使用します。
- <コード>draw_black_box</コード>: true
match_whole_word: truewords_to_redact:私たち
4.サンプルPDFをアップロードします。
リクエスト本文で、編集を適用するサンプル PDF ファイルをアップロードします。 Ensure that the file is added as <コード>pdf_ファイル</コード.
5.リクエストを実行します。
"実行"をクリックしてリクエストを実行します。レスポンスには編集されたPDFが含まれます。 この Swagger UI インタラクションにより、編集プロセスを簡単にテストし、即時のフィードバックを得ることができます。
コマンドプロンプトからCURLリクエストを使用する
あるいは、コマンド プロンプトで curl POST リクエストを使用して同じ結果を得ることもできます。
curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
-H 'accept: */*' \
-H 'Content-Type: multipart/form-data' \
-F 'pdf_file=@sample.pdf;type=アプリケーション/pdf' \
-F 'words_to_redact="we"' \
-F 'draw_black_box=true' \
-F 'match_whole_word=true'curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
-H 'accept: */*' \
-H 'Content-Type: multipart/form-data' \
-F 'pdf_file=@sample.pdf;type=アプリケーション/pdf' \
-F 'words_to_redact="we"' \
-F 'draw_black_box=true' \
-F 'match_whole_word=true'ブラケットオープン デフォルトでは、PowerShell はcurl 、組み込みの PowerShell コマンドレットであるInvoke-WebRequestのエイリアスとして解釈する場合があります。 curlの代わりにcurl.exeを使用してみてください。
curl.exe --versioncurl.exe --versionブラケットを閉じる
必須のリクエストボディパラメータ
| 名前 | データ型 | 翻訳内容 |
|---|---|---|
| <コード>pdf_ファイルコード> | アプリケーション/pdf | 操作する PDF ファイル。 |
| <コード>words_to_redactコード> | 配列[文字列] | このパラメータは単語のリストを受け取り、入力に一致するテキストを編集します。 |
オプションのリクエストボディパラメータ
| 名前 | データ型 | 翻訳内容 |
|---|---|---|
| <コード>ユーザーパスワードコード> | 文字列 | 入力PDFにユーザーパスワードが設定されている場合は必須です。パスワード保護されたPDFにパスワードが指定されていない場合、操作は失敗します。 |
| <コード>所有者パスワードコード> | 文字列 | 入力PDFに所有者パスワードが設定されている場合は必須です。パスワード保護されたPDFにパスワードが指定されていない場合、操作は失敗します。 |
| <コード>特定のページコード> | 配列[int] | どのページのテキストを編集するかを指定できます。デフォルトでは値はnullで、指定された単語がすべてのページで編集されることを意味します。 |
| <コード>draw_black_boxコード> | ブール値 | 編集されたテキストの上に黒いボックスを描画するかどうかを指定できます。デフォルトでは、この値はTrueに設定されています。 |
| <コード>match_whole_wordコード> | ブール値 | 単語内の部分一致も削除するかどうかを指定します。例えば、指定された単語が"are"の場合、"hare"など"are"を含む単語の"are"も削除されます。デフォルトでは、この設定は"True"です。 |
match_case | ブール値 | 指定された単語が大文字と小文字の区別なく完全一致するかどうかを指定します。デフォルトでは、この値はnullです。注: この値をTrueに設定すると、小文字と大文字の文字列は一致しません。例えば、指定された単語が"WE"の場合、小文字の"we"は編集されません。 |
| <コード>overlay_textコード> | 文字列 | 編集されたテキストの上に重ねるオーバーレイテキスト(単語や記号など)を指定します。デフォルトでは、この文字列は空です。 |
| <コード>save_as_pdfaコード> | ブール値 | 変更したPDFをPDF/A-3準拠で保存します。デフォルトではFalseに設定されています。 |
| <コード>save_as_pdfuaコード> | ブール値 | 変更したPDFをPDF/UA準拠で保存します。デフォルトではFalseに設定されています。 |
オプションのヘッダーパラメータ
| 名前 | データ型 | 翻訳内容 |
|---|---|---|
| <コード>著者コード> | 文字列 | PDF文書の作成者を識別するのに役立ちます。デフォルトでは、このフィールドは空です。 |
| <コード>タイトルコード> | 文字列 | PDFドキュメントのタイトルを表示します。デフォルトでは、このフィールドは空です。 |
| <コード>件名コード> | 文字列 | PDF文書の内容を一目で確認するのに役立ちます。デフォルトでは、このフィールドは空です。 |
よくある質問
POSTリクエストを使用してPDF内のテキストを編集するにはどうすればよいですか?
PDFファイルと編集したい単語をIronSecureDocサーバーにPOSTリクエストすることで、PDFのテキストを編集できます。サーバーはリクエストを処理し、編集されたテキストを含むPDFを返します。
IronSecureDoc APIを使ったPDF編集のステップは何ですか?
PDF編集のためにIronSecureDoc APIを使用するには、まずIronSecureDoc Dockerイメージを取得して開始し、Swaggerを使用してAPIをテストし、編集するテキストを指定し、API呼び出しを行い、最終的に編集されたPDFドキュメントをエクスポートする必要があります。
本番使用前にIronSecureDoc APIをテストするにはどうしたらよいですか?
Swagger UIにアクセスしてSwaggerを使ってIronSecureDoc APIをテストできます。提供されたエンドポイントを使って編集プロセスをシミュレートすることができます。
PDF編集リクエストではどのパラメータをカスタマイズできますか?
PDF編集リクエストでは、ユーザーパスワード、オーナーパスワード、特定のページ、ブラックボックスの描画、完全一致、ケースに一致、オーバーレイテキスト、PDF/AやPDF/UAとして保存などのパラメータをカスタマイズできます。
curlを使用してPDF編集リクエストを実行するにはどうすればよいですか?
curlを使用してPDF編集リクエストを実行するには、コマンドプロンプトで必要なパラメータとファイルパスを指定してcurl POSTリクエストコマンドを使用します。
編集中にPDFがパスワードで保護されている場合はどうすればよいですか?
PDFがパスワードで保護されている場合、オプションパラメータにユーザーパスワードまたはオーナーパスワードを含めて、編集プロセスがドキュメントにアクセスして変更できるようにする必要があります。
テキスト編集での'draw_black_box'パラメータの目的は何ですか?
'draw_black_box'パラメータは、編集されたテキストを黒いボックスで覆うかを指定。デフォルトで有効。
編集目的でIronSecureDocをローカルでホストするにはどうすればよいですか?
Windows、Mac、またはLinuxなどのさまざまなオペレーティングシステム向けに提供されているチュートリアルに従うことで、IronSecureDocをローカルでホストし、ローカルサーバーで編集プロセスを管理できます。
PDFの特定のページを編集することはできますか?
はい、特定の領域の編集をターゲットとするための'specific_pages'パラメータを使用して、編集するページを指定することができます。
PDFで編集された領域にテキストをオーバーレイすることはできますか?
はい、カスタムメッセージやプレースホルダーで編集されたテキストを置き換えるために'overlay_text'パラメータを使用して、編集された領域にテキストをオーバーレイすることができます。
IronSecureDoc は .NET 10 およびそのクライアント ライブラリと互換性がありますか?
はい、IronSecureDoc は NuGet パッケージ Iron Software.SecureDoc.Client を介して .NET クライアントを提供しており、.NET 6~9 などの以前のバージョンに加えて .NET 10 とも互換性があります。これにより、.NET 10 アプリケーションに墨消し機能や関連 API をシームレスに統合できます。





