ドキュメントの編集を制限する
場合によっては、ドキュメントの編集機能を制限し、ドキュメントに対する特定のアクションのみを許可する必要がある場合があります。これは、他の人が文書内の機密情報を編集できないようにするのに役立ちます。
Aspose.Words では、制限タイプを設定することでドキュメントの編集を制限できます。さらに、Aspose.Words を使用すると、ドキュメントの書き込み保護設定を指定することもできます。
この記事では、Aspose.Words を使用して制限タイプを選択する方法、保護を追加または削除する方法、および制限のない編集可能領域を作成する方法について説明します。
編集制限タイプの選択
Aspose.Words では、ProtectionType 列挙パラメータを使用してコンテンツを制限する方法を制御できます。これにより、次のような保護の正確な種類を選択できるようになります。
すべてのタイプはパスワードで保護されており、このパスワードが正しく入力されないと、ユーザーは文書の内容を合法的に変更できなくなります。したがって、必要なパスワードの入力を求められずに文書が返送された場合は、何か問題があることを示しています。
セキュリティの種類を選択するときにパスワードを設定しなかった場合、他のユーザーはドキュメントの保護を無視できます。
ドキュメント保護の追加
このセクションで説明する保護方法の 1 つを適用するだけなので、ドキュメントに保護を追加するのは簡単なプロセスです。
Aspose.Words を使用すると、Document.protect メソッドを使用してドキュメントを変更から保護できます。この方法はセキュリティ機能ではないため、ドキュメントは暗号化されません。
Microsoft Word では、次の両方を使用して同様の方法で編集を制限できます。
- 編集を制限する (ファイル → 情報 → 文書の保護) ※代替機能「編集制限」(レビュー→保護→編集制限)
次のコード例は、ドキュメントにパスワード保護を追加する方法を示しています。
import aspose.words as aw
doc = aw.Document()
# Apply document protection.
doc.protect(aw.ProtectionType.NO_PROTECTION, "password")
doc.save(docs_base.artifacts_dir + "DocumentProtection.PasswordProtection.docx");
次のコード例は、フォーム フィールドでのみ編集できるようにドキュメントでの編集を制限する方法を示しています。
import aspose.words as aw
# Insert two sections with some text.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.writeln("Text added to a document.")
# A document protection only works when document protection is turned and only editing in form fields is allowed.
doc.protect(aw.ProtectionType.ALLOW_ONLY_FORM_FIELDS, "password")
# Save the protected document.
doc.save(docs_base.artifacts_dir + "DocumentProtection.AllowOnlyFormFieldsProtect.docx");
ドキュメント保護を削除する
Aspose.Words を使用すると、ドキュメントを簡単かつ直接変更して、ドキュメントから保護を削除できます。実際のパスワードを知らなくてもドキュメントの保護を解除することも、unprotect メソッドを使用して正しいパスワードを入力してドキュメントのロックを解除することもできます。どちらの削除方法にも違いはありません。
次のコード例は、ドキュメントから保護を削除する方法を示しています。
import aspose.words as aw
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.writeln("Text added to a document.")
# Documents can have protection removed either with no password, or with the correct password.
doc.unprotect()
doc.protect(aw.ProtectionType.READ_ONLY, "newPassword")
doc.unprotect("newPassword")
doc.save(docs_base.artifacts_dir + "DocumentProtection.RemoveDocumentProtection.docx");
無制限の編集可能領域を指定する
ドキュメントの編集を制限すると同時に、ドキュメントの選択した部分への変更を許可することができます。したがって、ドキュメントを開いた人は誰でも、これらの制限されていない部分にアクセスして、コンテンツを変更できるようになります。
Aspose.Words では、start_editable_range メソッドと end_editable_range メソッドを使用して、ドキュメント内で変更できる部分をマークできます。
次のコード例は、ドキュメント全体を読み取り専用としてマークし、その中で編集可能な領域を指定する方法を示しています。
import aspose.words as aw
# Upload a document and make it as read-only.
doc = aw.Document(docs_base.my_dir + "Document.docx")
builder = aw.DocumentBuilder(doc)
doc.protect(aw.ProtectionType.READ_ONLY, "MyPassword")
builder.writeln("Hello world! Since we have set the document's protection level to read-only, we cannot edit this paragraph without the password.")
# Start an editable range.
edRangeStart = builder.start_editable_range()
# An EditableRange object is created for the EditableRangeStart that we just made.
editableRange = edRangeStart.editable_range
# Put something inside the editable range.
builder.writeln("Paragraph inside first editable range")
# An editable range is well-formed if it has a start and an end.
edRangeEnd = builder.end_editable_range()
builder.writeln("This paragraph is outside any editable ranges, and cannot be edited.");
doc.save(docs_base.artifacts_dir + "DocumentProtection.UnrestrictedEditableRegions.docx");
セクションごとに異なるドキュメント編集制限を選択することもできます。
次のコード例は、ドキュメント全体に制限を追加し、いずれかのセクションの制限を削除する方法を示しています。
import aspose.words as aw
# Insert two sections with some text.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.writeln("Section 1. Unprotected.")
builder.insert_break(aw.BreakType.SECTION_BREAK_CONTINUOUS)
builder.writeln("Section 2. Protected.")
# Section protection only works when document protection is turned and only editing in form fields is allowed.
doc.protect(aw.ProtectionType.ALLOW_ONLY_FORM_FIELDS, "password")
# By default, all sections are protected, but we can selectively turn protection off.
doc.sections[0].protected_for_forms = False
doc.save(docs_base.artifacts_dir + "DocumentProtection.UnrestrictedSection.docx");
doc = aw.Document(docs_base.artifacts_dir + "DocumentProtection.UnrestrictedSection.docx");
self.assertFalse(doc.sections[0].protected_for_forms)
self.assertTrue(doc.sections[1].protected_for_forms);