เพิ่มข้อความและรูปภาพลงในส่วนหัว PDF

เมื่อต้องสร้างเอกสาร PDF ที่ดูเป็นมืออาชีพและดึงดูดสายตา ความสามารถในการเพิ่มรูปภาพและข้อความลงในส่วนหัวถือเป็นฟีเจอร์ที่ต้องมี ส่วนหัวเป็นหนึ่งในส่วนที่สำคัญที่สุดของเอกสาร เนื่องจากให้ข้อมูลสำคัญแก่ผู้อ่าน เช่น ชื่อเรื่อง ผู้เขียน และวันที่ แม้ว่าการเพิ่มข้อความลงในส่วนหัวจะเป็นกระบวนการที่ค่อนข้างตรงไปตรงมา แต่การเพิ่มรูปภาพอาจเป็นเรื่องท้าทายกว่า โดยเฉพาะสำหรับนักพัฒนา Python ที่เพิ่งเริ่มต้นสร้างเอกสาร PDF ในบทความนี้ เราจะมาดูวิธีการเพิ่มรูปภาพและข้อความลงในส่วนหัวของเอกสาร PDF โดยใช้ Python Cloud SDK

คุณสามารถเพิ่มรูปภาพ โลโก้ วันและเวลาที่สร้างเอกสาร ชื่อเอกสาร หมายเลขเวอร์ชันหรือการแก้ไข ร่าง ชื่อผู้เขียน และชื่อบทในส่วนหัว PDF ได้

REST API สำหรับการประกอบเอกสาร PDF

Aspose.PDF Cloud SDK for Python มีฟังก์ชันและวิธีการต่างๆ มากมายที่ช่วยให้ผู้พัฒนาสามารถจัดการไฟล์ PDF ได้ด้วยโปรแกรม นอกจากนี้ยังมีชุดเครื่องมือที่มีประสิทธิภาพและยืดหยุ่นสำหรับการเพิ่มรูปภาพและข้อความลงในส่วนหัวของเอกสาร PDF และสามารถผสานรวมเข้ากับแอปพลิเคชัน Python เพื่อประมวลผลเอกสาร PDF โดยอัตโนมัติได้อย่างง่ายดาย ขณะนี้เกี่ยวกับกระบวนการเพิ่มรูปภาพลงในส่วนหัว จะต้องระบุตำแหน่งและขนาดของรูปภาพ รวมถึงหมายเลขหน้าที่รูปภาพควรปรากฏอยู่ ในทำนองเดียวกัน การเพิ่มข้อความลงในส่วนหัวต้องระบุเนื้อหาข้อความ ขนาดแบบอักษร และตัวเลือกการจัดรูปแบบอื่นๆ SDK ยังให้ตัวเลือกสำหรับการควบคุมการจัดตำแหน่งและการวางตำแหน่งของเนื้อหาส่วนหัว ตลอดจนการระบุสีพื้นหลังของส่วนหัวอีกด้วย

ขั้นแรกเราต้องติดตั้ง SDK ซึ่งสามารถดาวน์โหลดได้ฟรีจากที่เก็บ PIP และ GitHub เพียงรันคำสั่งต่อไปนี้เพื่อติดตั้ง SDK เวอร์ชันล่าสุด

pip install asposepdfcloud

หากต้องการเข้าถึง REST API คุณต้องลงทะเบียนและรับข้อมูลประจำตัวส่วนบุคคล โปรดดูข้อมูลที่เกี่ยวข้องใน คู่มือเริ่มต้นใช้งานฉบับย่อ

เพิ่มข้อความลงในส่วนหัว PDF โดยใช้ Python

SDK ช่วยให้คุณสามารถเพิ่มสตริงข้อความลงในส่วนหัวของเอกสารได้ และสามารถดำเนินการตามข้อกำหนดนี้ได้โดยทำตามขั้นตอนต่อไปนี้

  • ขั้นแรก ให้สร้างอินสแตนซ์ของคลาส ApiClient โดยระบุรหัสไคลเอนต์และรหัสลับไคลเอนต์เป็นอาร์กิวเมนต์
  • ประการที่สอง สร้างอ็อบเจ็กต์ของคลาส PdfApi ซึ่งรับอ็อบเจ็กต์ ApiClient เป็นอาร์กิวเมนต์อินพุต
  • ประการที่สาม สร้างอ็อบเจ็กต์ของ TextHeader ที่กำหนดคุณสมบัติของอินสแตนซ์ TextHeader
  • เพื่อกำหนดการจัดรูปแบบข้อความสำหรับ TextHeader ให้สร้างอ็อบเจ็กต์ของ TextState โดยที่เราจะได้กำหนดสีพื้นหน้า ขนาดแบบอักษร ชื่อแบบอักษร เป็นต้น
  • ในที่สุด เรียกใช้เมธอด postdocumenttextheader(..) เพื่อเพิ่ม Text Header ลงในเอกสาร PDF และบันทึกไฟล์ผลลัพธ์ไปยังที่เก็บข้อมูลบนคลาวด์
def addTextHeader():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # สร้างอินสแตนซ์ PdfApi ขณะส่ง PdfApiClient เป็นอาร์กิวเมนต์
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # สร้างวัตถุโดยกำหนดส่วนหัวข้อความ
        textHeader = asposepdfcloud.TextHeader()
        # ตั้งค่าให้แสดงส่วนหัวในพื้นหลัง
        textHeader.background = False
        # ตั้งค่าการจัดตำแหน่งแนวนอนสำหรับส่วนหัวข้อความให้อยู่กึ่งกลาง
        textHeader.horizontal_alignment = 'Center'
        # ตั้งค่าความทึบของส่วนหัวเป็น 0.5
        textHeader.opacity = 0.5
        # ไม่มีมุมหมุน
        textHeader.rotate = None
        textHeader.rotate_angle = 0
        # ตั้งค่าการเยื้อง X และ Y
        textHeader.x_indent = 100
        textHeader.y_indent = 100
        # ตั้งค่าปัจจัยการซูมเป็น 1.0
        textHeader.zoom = 1.0
        # ค่าข้อความที่จะแสดงภายในส่วนหัว
        textHeader.value = 'Aspose.PDF Cloud'

        # สร้างอินสแตนซ์ของ TextState ที่กำหนดการจัดรูปแบบของข้อความ
        textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
              {"A": 0,
              "R": 252,
              "G": 173,
              "B": 3},font_style=2)
        # ส่งวัตถุ TextState ไปที่ TextHeader
        textHeader.text_state = textState

        # เรียก API เพื่อเพิ่ม Text Header ลงในเอกสาร PDF
        response = pdf_api.post_document_text_header(name = input_file, text_header = textHeader)
        
        # พิมพ์รหัสการตอบสนองในคอนโซล
        print(response)
        # พิมพ์ข้อความในคอนโซล (ทางเลือก)
        print('Text Header successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
ส่วนหัวข้อความใน PDF

ภาพที่ 2:- ดูตัวอย่างส่วนหัวข้อความในเอกสาร PDF

ไฟล์ PDF อินพุตและผลลัพธ์สามารถดาวน์โหลดได้จาก awesomeTable.pdf และ awecomeTable-TextHeader.pdf

เพิ่มรูปภาพลงในส่วนหัว PDF โดยใช้ Python

โปรดปฏิบัติตามคำแนะนำด้านล่างเพื่อเพิ่มวัตถุรูปภาพลงในส่วนหัว PDF ไฟล์ที่ได้จะถูกอัปโหลดไปยังที่เก็บข้อมูลบนคลาวด์

  • ก่อนอื่น ให้สร้างอินสแตนซ์ของคลาส ApiClient โดยระบุรหัสไคลเอนต์และรหัสความลับไคลเอนต์เป็นอาร์กิวเมนต์
  • ประการที่สอง สร้างอ็อบเจ็กต์ของคลาส PdfApi ซึ่งรับอ็อบเจ็กต์ ApiClient เป็นอาร์กิวเมนต์อินพุต
  • ตอนนี้สร้างวัตถุของ ImageHeader โดยกำหนดคุณสมบัติของ ImageHeader
  • เพื่อควบคุมการแสดงผลของส่วนหัวในบางหน้า ค่าจะถูกกำหนดให้กับพารามิเตอร์เสริม startpagenumber และ endpagenumber
  • สุดท้าย ให้เรียกใช้เมธอด postdocumentimageheader(..) เพื่อเพิ่ม Image Header ลงในเอกสาร PDF และบันทึกไฟล์ผลลัพธ์ไปยังที่เก็บข้อมูลบนคลาวด์ โปรดทราบว่าส่วนหัวจะถูกเพิ่มเฉพาะในสองหน้าแรกของเอกสารเท่านั้น (ตามที่ระบุในโค้ด)
def addImageHeader():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # สร้างอินสแตนซ์ PdfApi ขณะส่ง PdfApiClient เป็นอาร์กิวเมนต์
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # สร้างอินสแตนซ์ ImageHeader
        imageHeader = asposepdfcloud.ImageHeader()
        # ตั้งค่าคุณสมบัติพื้นหลังเป็นจริง
        imageHeader.background = True
        # ตั้งค่าการจัดวางแนวนอนเป็นขวา
        imageHeader.horizontal_alignment = 'Right'
        imageHeader.opacity = 0.7
        imageHeader.rotate = None
        imageHeader.rotate_angle = 0
        imageHeader.x_indent = 10
        imageHeader.y_indent = 10
        imageHeader.zoom = .5
        # ชื่อไฟล์รูปภาพที่มีอยู่ในระบบจัดเก็บข้อมูลบนคลาวด์ที่จะเพิ่มในส่วนหัว
        imageHeader.file_name = 'Koala.jpg'
        # ความกว้างของภาพในส่วนหัว
        imageHeader.width = 120
        # ความสูงของภาพในส่วนหัว
        imageHeader.height = 120
        imageHeader.left_margin = 0
        imageHeader.top_margin = 10
        imageHeader.right_margin = 10
        
        # หน้าเริ่มต้นของเอกสารที่จะเพิ่มส่วนหัว
        startPage = 1
        # หน้าท้ายเอกสารที่จะเพิ่มส่วนหัว
        endPage = 2

        # เรียก API เพื่อเพิ่มส่วนหัวของรูปภาพในเอกสาร PDF และบันทึกไฟล์ผลลัพธ์ในระบบจัดเก็บข้อมูลบนคลาวด์
        response = pdf_api.post_document_image_header(name = input_file, image_header = imageHeader, start_page_number = startPage, end_page_number=endPage)
        
        # รหัสตอบสนองการพิมพ์ในคอนโซล
        print(response)
        
        # พิมพ์ข้อความในคอนโซล (ทางเลือก)
        print('Image Header successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
คำบรรยายภาพ

Image 3:- Preview of Image Header added in PDF.

ไฟล์ต้นฉบับและไฟล์ผลลัพธ์ที่สร้างขึ้นในตัวอย่างข้างต้นสามารถดาวน์โหลดได้จาก

การเพิ่มส่วนหัวข้อความลงใน PDF โดยใช้คำสั่ง cURL

คำสั่ง cURL มอบกลไกที่สะดวกสำหรับการเข้าถึง REST API ผ่านทางเทอร์มินัลบรรทัดคำสั่ง เนื่องจาก Aspose.PDF Cloud ได้รับการพัฒนาตามสถาปัตยกรรม REST เช่นกัน ดังนั้นเราจึงสามารถเข้าถึง API โดยใช้คำสั่ง cURL ได้เช่นกัน แนวทางนี้อาจมีประโยชน์สำหรับนักพัฒนาที่ต้องการทำงานกับเครื่องมือบรรทัดคำสั่งหรือผู้ที่ต้องการรวมการแก้ไขส่วนหัว PDF เข้ากับเวิร์กโฟลว์อัตโนมัติขนาดใหญ่

ขณะนี้เพื่อที่จะใช้ REST API เราจำเป็นต้องสร้าง JSON Web accessToken (JWT) ขึ้นอยู่กับข้อมูลประจำตัวไคลเอนต์ของคุณโดยดำเนินการคำสั่งต่อไปนี้

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=88d1cda8-b12c-4a80-b1ad-c85ac483c5c5&client_secret=406b404b2df649611e508bbcfcd2a77f" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

เมื่อเรามี JWT Token แล้ว โปรดลองใช้คำสั่งต่อไปนี้เพื่อเพิ่มข้อความในส่วนหัวของเอกสารในหน้าที่ 1 และหน้าที่ 2

curl -X POST "https://api.aspose.cloud/v3.0/pdf/awesomeTable.pdf/header/text?startPageNumber=1&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": false,  \"HorizontalAlignment\": \"Center\",  \"Opacity\": 0.5,  \"Rotate\": \"None\",  \"RotateAngle\": 0,  \"XIndent\": 100,  \"YIndent\": 10,  \"Zoom\": 1.0,  \"TextAlignment\": \"None\",  \"Value\": \"Aspose.PDF Cloud\",  \"TextState\": {    \"FontSize\": 15,    \"Font\": \"Arial\",    \"ForegroundColor\": {      \"A\": 0,      \"R\": 252,      \"G\": 173,      \"B\": 3    },    \"BackgroundColor\": {      \"A\": 10,      \"R\": 0,      \"G\": 0,      \"B\": 0    }  },  \"LeftMargin\": 0,  \"TopMargin\": 0,  \"RightMargin\": 0}"

การเพิ่มส่วนหัวของรูปภาพลงใน PDF โดยใช้คำสั่ง cURL

โปรดลองใช้คำสั่ง cURL ต่อไปนี้เพื่อเพิ่มส่วนหัวของรูปภาพลงในเอกสาร PDF และบันทึกไฟล์ผลลัพธ์ในที่เก็บข้อมูลบนคลาวด์ ในคำสั่งต่อไปนี้ ส่วนหัวของรูปภาพจะอยู่ที่หน้า 1 และหน้า 2 ของเอกสาร โดยกำหนดความทึบเป็น 0.7 ปัจจัยการซูมเป็น 0.5 และคุณสมบัติความสูงและความกว้างของรูปภาพเป็น 120 จุด

curl -X POST "https://api.aspose.cloud/v3.0/pdf/awesomeTable.pdf/header/image?startPageNumber=1&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": true,  \"HorizontalAlignment\": \"Right\",  \"Opacity\": 0.7,  \"Rotate\": \"None\",  \"RotateAngle\": 0,  \"XIndent\": 10,  \"YIndent\": 10,  \"Zoom\": .5,  \"FileName\": \"Koala.jpg\",  \"Width\": 120,  \"Height\": 120,  \"LeftMargin\": 0,  \"TopMargin\": 10,  \"RightMargin\": 10}"

บทสรุป

โดยสรุป การเพิ่มรูปภาพและข้อความลงในส่วนหัวของเอกสาร PDF เป็นฟีเจอร์ที่มีประโยชน์ที่สามารถเพิ่มความสวยงามและภาพลักษณ์ของเอกสารของคุณได้ ด้วย Aspose.PDF Cloud SDK สำหรับ Python คุณจะสามารถทำงานได้อย่างง่ายดายด้วยโค้ดเพียงไม่กี่บรรทัด ไม่ว่าคุณจะสร้างใบแจ้งหนี้ รายงาน หรือเอกสารอื่น ๆ ที่ต้องมีส่วนหัว ฟีเจอร์นี้จะช่วยประหยัดเวลาและความพยายามของคุณไปพร้อมกับปรับปรุงคุณภาพผลลัพธ์ของคุณ นอกจากการใช้ Aspose.PDF Cloud SDK สำหรับ Python แล้ว เรายังได้เรียนรู้ว่าคุณสามารถเพิ่มรูปภาพและข้อความลงในส่วนหัวของ PDF ได้โดยใช้คำสั่ง cURL

เราหวังว่าบทความนี้จะให้คำแนะนำและแรงบันดาลใจที่จำเป็นทั้งหมดแก่คุณในการเพิ่มฟังก์ชันนี้ให้กับแอปพลิเคชัน Python ของคุณ

ลิงค์ที่เป็นประโยชน์

บทความที่เกี่ยวข้อง

เราขอแนะนำให้อ่านบทความต่อไปนี้เพื่อเรียนรู้เกี่ยวกับ: