Đọc XBRL bằng Python

Tài liệu XBRL và Inline XBRL (iXBRL) là các báo cáo kinh doanh điện tử có cấu trúc để đáp ứng các yêu cầu kinh doanh khác nhau. Tài liệu XBRL là một tập hợp các dữ kiện cùng nhau tạo nên một báo cáo kinh doanh. Trong khi đó, báo cáo iXBRL là một báo cáo mà con người có thể đọc được với dữ liệu được gắn thẻ được nhúng trong đó. Chúng ta có thể dễ dàng phân tích cú pháp tài liệu phiên bản XBRL hoặc iXBRL theo lập trình và đọc các đối tượng hoặc phần tử như tham chiếu lược đồ, ngữ cảnh, đơn vị, mục, v.v. Trong bài trước, chúng ta đã biết cách tạo tài liệu XBRL. Trong bài viết này, chúng ta sẽ học cách phân tích cú pháp một tài liệu XBRL bằng Python.

Các chủ đề sau sẽ được đề cập trong bài viết này:

  1. Thư viện tài chính Python để phân tích cú pháp XBRL
  2. Phân tích cú pháp tệp XBRL
  3. Phân tích cú pháp tệp iXBRL

Thư viện tài chính Python để phân tích cú pháp XBRL

Để phân tích cú pháp tệp XBRL hoặc tài liệu phiên bản, chúng tôi sẽ sử dụng API Aspose.Finance cho Python. Nó cho phép tạo các phiên bản XBRL, phân tích cú pháp và xác thực các tệp XBRL hoặc iXBRL.

Lớp XbrlDocument của API đại diện cho một tài liệu XBRL chứa một hoặc nhiều trường hợp XBRL. Một phiên bản XBRL là một phân đoạn XML, với phần tử gốc có thẻ XBRL. Lớp XbrlInstance cung cấp các phương thức và thuộc tính khác nhau để làm việc với các cá thể XBRL. Lớp InlineXbrlDocument của API đại diện cho một tài liệu XBRL nội tuyến.

Vui lòng tải xuống gói hoặc cài đặt API từ PyPI bằng lệnh pip sau trong bảng điều khiển:

pip install aspose-finance

Phân tích cú pháp tệp XBRL bằng Python

Chúng tôi có thể dễ dàng tải và phân tích cú pháp một tài liệu phiên bản XBRL bằng cách làm theo các bước dưới đây:

  1. Đầu tiên, tải tệp XBRL bằng lớp XbrlDocument.
  2. Tiếp theo, lấy tất cả các phiên bản bằng xbrlinstances.
  3. Sau đó, truy cập phiên bản XBRL mong muốn từ bộ sưu tập.
  4. Sau đó, phân tích cú pháp nội dung của phiên bản XBRL.
  5. Cuối cùng, hiển thị dữ liệu / thông tin cần thiết.

Mẫu mã sau đây cho thấy cách phân tích cú pháp một phiên bản XBRL trong Python.

# Ví dụ mã này trình bày cách phân tích cú pháp tài liệu XBRL.
from aspose.finance.xbrl import XbrlDocument

# Đường dẫn đến thư mục tài liệu.
inputFile = "C:\\Files\\Finance\\sample.xbrl"

# Khởi tạo XbrlDocument
document = XbrlDocument(inputFile)

# Nhận phiên bản
xbrlInstances = document.xbrl_instances

# Chọn trường hợp cụ thể
xbrlInstance = xbrlInstances[0]

# Phân tích cú pháp
facts = xbrlInstance.facts
schemaRefs = xbrlInstance.schema_refs
contexts = xbrlInstance.contexts
units = xbrlInstance.units

# Hiển thị dữ liệu
if contexts.length > 0:
   for x in contexts:
        print("id: " + x.id)
        print("Entity Identifier : " + x.entity.identifier)

Phân tích cú pháp tệp iXBRL bằng Python

Chúng tôi cũng có thể phân tích cú pháp tài liệu iXBRL bằng cách làm theo các bước được cung cấp bên dưới:

  1. Đầu tiên, tải tệp iXBRL bằng lớp InlineXbrlDocument.
  2. Phân tích cú pháp nội dung của tài liệu iXBRL.

Mẫu mã sau đây cho thấy cách phân tích cú pháp iXBRL trong Python.

# Ví dụ mã này trình bày cách phân tích cú pháp tài liệu iXBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument

# Đường dẫn đến thư mục tài liệu.
inputFile = "C:\\Files\\Finance\\Output.html"

# Tải tệp đầu vào
document = InlineXbrlDocument(inputFile)

# Phân tích cú pháp
inlineFacts = document.facts
contexts = document.contexts
units = document.units

Nhận giấy phép miễn phí

Bạn có thể nhận giấy phép tạm thời miễn phí để dùng thử thư viện mà không có giới hạn đánh giá.

Sự kết luận

Trong bài viết này, chúng ta đã học cách phân tích cú pháp tài liệu XBRL hoặc iBXRL bằng Python. Chúng ta cũng đã thấy cách trích xuất dữ liệu từ các đối tượng cá thể XBRL theo chương trình. Bên cạnh đó, bạn có thể tìm hiểu thêm về API Aspose.Finance cho Python bằng cách sử dụng tài liệu. Trong trường hợp có bất kỳ sự mơ hồ nào, vui lòng liên hệ với chúng tôi trên diễn đàn của chúng tôi.

Xem thêm