📄 Documentation: PDF Watermark Extension for OutSystems (Latest Version)

This guide explains how to install, configure, and use the PDF Watermark Extension in your OutSystems applications. The extension allows you to add watermarks to PDF files with full support for Arabic and Right-to-Left (RTL) text, and now includes customizable settings for better control.

🚀 1. Installing the Extension

1. Go to OutSystems Forge and search for PDF Watermark Extension.
2. Click Download & Install.
3. Open Service Studioand add the extension to your OutSystems module by:
   • Logic → Manage Dependencies → Select PDF Watermark Extension → Apply.

🔧 2. Using the Extension in Your Application

The extension provides an action that allows you to process PDFs and add fully customized watermarks.

📌 Action: AddWatermarkToPDF

📥 Input Parameters:

📤 Output Parameter:

🛠 3. How to Use in OutSystems

Step 1: Add the Extension to Your Logic

1. In Service Studio, open the module where you want to add a watermark.
2. Navigate to Logic → Server Actions.
3. Drag the AddWatermarkToPDF action into your logic flow.

Step 2: Configure Watermark Parameters

• InputPDF: Provide the binary file of the original PDF.
• WatermarkText: Enter the desired watermark text (supports Arabic & RTL).
• FontSize: Choose a text size (e.g., 20 for larger text).
• Opacity: Set transparency (0.2 for faint watermark, 0.8 for stronger visibility).
• RotationAngle: Adjust the rotation (0 for straight, 45 for diagonal).
• StepX / StepY: Modify spacing to control the density of the watermark pattern.

Step 3: Process and Display the Watermarked PDF

• Save OutputPDF to a Database or File System.
• Use the Download Widget to allow users to download the watermarked PDF.

📌 4. Example: Adding a Custom Watermark

🎯 Scenario: A user uploads a PDF, and the system adds a semi-transparent, diagonal watermark before allowing them to download it.

📍 Steps:

1. Add an Upload Widget to accept a PDF file.
2. Use the AddWatermarkToPDF actionand set:
   • InputPDF → File uploaded by the user.
   • WatermarkText → "سري للغاية 000000133".
   • FontSize → 18 (larger text).
   • Opacity → 0.3 (subtle transparency).
   • RotationAngle → 45 (diagonal text).
   • StepX → 200 (wider horizontal spacing).
   • StepY → 200 (wider vertical spacing).
3. Store or display the processed PDF using a Download Widget.

🖥 Logic Flow Example in OutSystems

1️⃣ User uploads a PDF
2️⃣ AddWatermarkToPDF action is triggered with custom settings
3️⃣ The output is stored in a variable
4️⃣ User downloads the processed PDF

💡 5. Best Practices

✅ Ensure that the font used in the watermark supports Arabic characters.
✅ Test different opacity levels to balance visibility without obscuring content.
✅ Increase StepX/StepY to reduce watermark density.
✅ Keep Rotation Angle at 45 for diagonal positioning or 0 for horizontal text.

🔗 6. Need Help?

For support, visit the OutSystems Forums or reach out via the Forge Discussion Section.

📥 Upgrade now and take full control of your PDF watermarking in OutSystems! 🚀