ตรวจสอบ XBRL ใน Python

XBRL ย่อมาจาก XML Based Business Reporting Language เป็นเพียงสคีมาที่ช่วยให้บริษัทจัดระเบียบข้อมูลเพื่อให้สามารถแบ่งปันข้อมูลระหว่างแผนกต่างๆ ภายในบริษัทได้ เอกสาร XBRL และ Inline XBRL (iXBRL) เป็นรายงานธุรกิจอิเล็กทรอนิกส์ที่มีโครงสร้างเพื่อตอบสนองความต้องการทางธุรกิจที่แตกต่างกัน เอกสารนี้ไม่ได้เป็นเพียงเอกสารทางธุรกิจที่น่าเบื่ออีกประเภทหนึ่งเท่านั้น เอกสาร XBRL มีโครงสร้าง รูปแบบ และลักษณะเฉพาะบางอย่างที่สามารถใช้ตรวจสอบความถูกต้องของเอกสารทางการเงินได้ เราสามารถตรวจสอบเอกสารอินสแตนซ์ XBRL หรือ iXBRL ทางโปรแกรมได้อย่างง่ายดาย ในบทความนี้ เราจะเรียนรู้วิธีการตรวจสอบความถูกต้องของเอกสาร XBRL ใน Python

หัวข้อต่อไปนี้จะครอบคลุมในบทความนี้:

  1. Python XBRL Validator API เพื่อตรวจสอบความถูกต้องของเอกสาร XBRL
  2. ตรวจสอบไฟล์ XBRL
  3. ตรวจสอบความถูกต้องของไฟล์ XBRL แบบอินไลน์

Python XBRL Validator API เพื่อตรวจสอบเอกสาร XBRL

ในการตรวจสอบไฟล์ XBRL หรือเอกสารอินสแตนซ์ เราจะใช้ API Aspose.Finance for Python อนุญาตให้สร้างอินสแตนซ์ XBRL แยกวิเคราะห์ และตรวจสอบความถูกต้องของไฟล์ XBRL หรือ iXBRL

API จัดเตรียมคลาส XbrlDocument ที่แสดงถึงเอกสาร XBRL ที่มีอินสแตนซ์ XBRL อย่างน้อยหนึ่งรายการ อินสแตนซ์ XBRL เป็นแฟรกเมนต์ XML โดยที่องค์ประกอบรูทมีแท็ก XBRL คลาส XbrlInstance มีเมธอดและคุณสมบัติต่างๆ เพื่อทำงานกับอินสแตนซ์ XBRL เมธอด validate() ของคลาสนี้จะตรวจสอบอินสแตนซ์ XBRL ที่เลือก เรามีคลาส InlineXbrlDocument ของ API ที่แสดงถึงเอกสาร XBRL แบบอินไลน์ นอกจากนี้ การแจงนับ ValidationErrorCode ของ API จะกำหนดรหัสข้อผิดพลาดในการตรวจสอบทั้งหมดและข้อความแสดงข้อผิดพลาดที่เกี่ยวข้อง

โปรด ดาวน์โหลดแพ็คเกจ หรือติดตั้ง API จาก PyPI โดยใช้คำสั่ง pip ต่อไปนี้ในคอนโซล:

pip install aspose-finance

ตรวจสอบเอกสาร XBRL ใน Python

เราสามารถโหลดและตรวจสอบเอกสารอินสแตนซ์ XBRL ได้อย่างง่ายดายโดยทำตามขั้นตอนด้านล่าง:

  1. ประการแรก โหลดไฟล์ XBRL โดยใช้คลาส XbrlDocument
  2. ต่อไป รับอินสแตนซ์ทั้งหมดโดยใช้ xbrlinstances
  3. จากนั้น เข้าถึงอินสแตนซ์ XBRL ที่ต้องการจากคอลเลกชัน
  4. หลังจากนั้น ให้เรียกใช้เมธอด validate() เพื่อตรวจสอบความถูกต้องของอินสแตนซ์ XBRL
  5. สุดท้าย แสดงข้อผิดพลาดถ้ามี

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการตรวจสอบอินสแตนซ์ XBRL ใน Python

# ตัวอย่างโค้ดนี้สาธิตวิธีการตรวจสอบเอกสารอินสแตนซ์ XBRL
from aspose.finance.xbrl import XbrlDocument

# เส้นทางไปยังเอกสารอินพุต
inputFile = "C:\Files\sample.xbrl"

# โหลดไฟล์ XBRL
document = XbrlDocument(inputFile)

# รับอินสแตนซ์
xbrlInstances = document.xbrl_instances

# เลือกอินสแตนซ์เฉพาะ
xbrlInstance = xbrlInstances[0]

# ตรวจสอบความถูกต้อง
xbrlInstance.validate()

# แสดงข้อผิดพลาดการตรวจสอบถ้ามี
if xbrlInstance.validation_errors.length > 0:
   for validationError in xbrlInstance.validation_errors:
        print(validationError.message)

ตรวจสอบเอกสาร Inline XBRL ใน Python

เรายังสามารถตรวจสอบความถูกต้องของเอกสาร iXBRL ได้โดยทำตามขั้นตอนด้านล่าง:

  1. ประการแรก โหลดไฟล์ iXBRL โดยใช้คลาส InlineXbrlDocument
  2. หลังจากนั้น ให้เรียกใช้เมธอด validate() เพื่อตรวจสอบความถูกต้องของอินสแตนซ์ XBRL
  3. สุดท้าย แสดงข้อผิดพลาดถ้ามี

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการตรวจสอบเอกสาร XBRL หรือ iXBRL แบบอินไลน์ใน Python

# ตัวอย่างโค้ดนี้สาธิตวิธีการตรวจสอบความถูกต้องของเอกสาร Inline XBRL
from aspose.finance.xbrl.inline import InlineXbrlDocument

# เส้นทางไปยังเอกสารอินพุต
inputFile = "C:\Files\sample.html"

# โหลดไฟล์ XBRL
document = InlineXbrlDocument(inputFile)

# ตรวจสอบความถูกต้อง
document.validate();

# แสดงข้อผิดพลาดการตรวจสอบถ้ามี
if document.validation_errors.length > 0:
   for validationError in document.validation_errors:
        print(validationError.message)

รับใบอนุญาตฟรี

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

บทสรุป

ในบทความนี้ เราได้เรียนรู้วิธีการตรวจสอบความถูกต้องของเอกสาร XBRL ใน Python เราได้เห็นวิธีการตรวจสอบความถูกต้องของเอกสาร XBRL แบบอินไลน์โดยทางโปรแกรม นอกจากนี้ คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับ Aspose.Finance for Python API โดยใช้ เอกสารประกอบ ในกรณีที่มีความคลุมเครือ โปรดติดต่อเราได้ที่ ฟอรัมสนับสนุนฟรี

ดูสิ่งนี้ด้วย