---
# API: PRA Well Test
# File: CE_PRAWELLTEST_0001.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: OData V4
# Source URL: https://api.sap.com/api/CE_PRAWELLTEST_0001/overview
# Generated: 2026-07-23 14:17:02
---

# PRA Well Test / PRA 油井测试 API

> **API 版本:** 1.0.0 | **状态:** ACTIVE | **协议:** OData V4
> **技术名称:** `CE_PRAWELLTEST_0001`
> **服务根路径:** `/sap/opu/odata4/sap/CE_PRAWELLTEST_0001/srvd_a2x/sap/pra_welltest/0001`
> **SAP 通信场景:** `SAP_COM_0189`

## 概述 / Overview

该 OData V4 服务提供对 PRA 油井测试数据的读取访问。支持按测试文档、油井和测试日期查询测试结果数据，用于油井生产性能评估。

This OData V4 service provides read access to PRA well test data. It supports querying test results by test document, well, and test date for well production performance evaluation.

**API 业务加速器中心:** https://api.sap.com/api/CE_PRAWELLTEST_0001/overview

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_PRAWellTest` | PRA Well Test | PRA 油井测试 | `WellTestDocument` |

---

## 1. A_PRAWellTest — PRA 油井测试

**实体集合路径:** `A_PRAWellTest`
**主键 (Key):** `WellTestDocument` (RAW 16)
**ETag:** 不支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `WellTestDocument` | RAW | 16 | Key: Well Test Document UUID | 键：油井测试文档 UUID |
| `WellTestDocumentNo` | CHAR | 12 | Well Test Document Number | 油井测试文档编号 |
| `Well` | CHAR | 10 | Well Code | 油井代码 |
| `WellName` | CHAR | 40 | Well Description | 油井描述 |
| `TestDate` | DATS | 8 | Test Date | 测试日期 |
| `TestTime` | TIMS | 6 | Test Time | 测试时间 |
| `TestType` | CHAR | 4 | Test Type | 测试类型 |
| `TestTypeText` | CHAR | 60 | Test Type Description | 测试类型描述 |
| `TestResult` | CHAR | 1 | Test Result (Pass/Fail) | 测试结果（通过/失败） |
| `ResultText` | CHAR | 60 | Test Result Description | 测试结果描述 |
| `OilFlowRate` | DEC | 23(2) | Oil Flow Rate | 产油速率 |
| `GasFlowRate` | DEC | 23(2) | Gas Flow Rate | 产气速率 |
| `WaterFlowRate` | DEC | 23(2) | Water Flow Rate | 产水速率 |
| `FlowRateUnit` | UNIT | 3 | Flow Rate Unit of Measure | 流速计量单位 |
| `BottomHolePressure` | DEC | 23(2) | Bottom Hole Pressure | 井底压力 |
| `WellheadPressure` | DEC | 23(2) | Wellhead Pressure | 井口压力 |
| `PressureUnit` | UNIT | 3 | Pressure Unit | 压力单位 |
| `ChokeSize` | DEC | 23(2) | Choke Size Used | 使用油嘴尺寸 |
| `APIGravity` | DEC | 23(1) | API Gravity | API 重度 |
| `GasOilRatio` | DEC | 23(2) | Gas Oil Ratio | 气油比 |
| `WaterCut` | DEC | 23(2) | Water Cut Percentage | 含水率百分比 |
| `Remarks` | CHAR | 255 | Test Remarks | 测试备注 |
| `DataSource` | CHAR | 10 | Data Source | 数据来源 |
| `Status` | CHAR | 2 | Test Document Status | 测试文档状态 |
| `StatusText` | CHAR | 60 | Status Description | 状态描述 |
| `LastModifiedDateTime` | EDTM | - | Last Modified Date/Time | 最后修改日期/时间 |
| `CreationDate` | DATS | 8 | Record Creation Date | 记录创建日期 |
| `CreatedByUser` | CHAR | 12 | Created By User | 创建用户 |

### 示例请求 / Sample Request

```
GET /sap/opu/odata4/sap/CE_PRAWELLTEST_0001/srvd_a2x/sap/pra_welltest/0001/A_PRAWellTest?$filter=Well eq 'WELL001' and TestDate ge 2026-01-01&$top=10
Accept: application/json
```

### 示例响应 / Sample Response

```json
{
  "d": {
    "results": [
      {
        "WellTestDocument": "d4e5f6a7-b8c9-0123-defa-234567890123",
        "WellTestDocumentNo": "WTEST000123",
        "Well": "WELL001",
        "TestDate": "/Date(1893542400000)/",
        "TestType": "PT",
        "TestResult": "P",
        "OilFlowRate": "500.00",
        "GasFlowRate": "1200.00",
        "FlowRateUnit": "BPD"
      }
    ]
  }
}
```