Таблицы, структуры и поля SAP: смысл, ключ и допустимый доступ#

Техническое имя объекта само по себе не объясняет, что означает строка, можно ли её использовать в отчёте и будет ли объект стабилен при обновлении. Перед чтением или переносом данных установите тип объекта, его бизнес-смысл, уровень строки, полный ключ, происхождение полей и контракт доступа для конкретного продукта и версии.

Эта страница даёт метод проверки. Для подробностей о типах таблиц и ABAP Dictionary см. ABAP Dictionary: типы, таблицы и связи; о ключах и детализации финансовых выборок - CDS для финансовых данных и SAP Journal в EDWH.

Определите тип объекта#

Сначала выясните, что именно нашли:

Таблица базы данных хранит данные или техническую структуру хранения. Её поля, ключ и обновление принадлежат конкретной модели и версии.
Структура или тип данных описывает форму значений для программы или интерфейса; сам по себе такой тип не означает, что данные где-то хранятся.
Представление, включая CDS view формирует набор полей из источников, связей, выражений и фильтров. Его результат может иметь другой уровень строки, чем базовая таблица.
API или сервис публикует контракт чтения либо изменения данных. Его входные параметры, фильтры, пагинация, авторизация и статус выпуска определяют допустимое потребление.
Совместимое или устаревшее имя может перенаправляться на другую модель, иметь сокращённую семантику или сохраняться только ради обратной совместимости.

Не делайте вывод о физическом хранении, записи или разрешённом доступе только по похожему имени таблицы, view, структуры и API.

Зафиксируйте смысл поля и уровень строки#

Описывайте поле вместе с объектом, в котором оно опубликовано. Один термин вроде «дата», «сумма» или «позиция» может обозначать разные вещи в заголовке документа, бухгалтерской строке, валютном представлении, агрегате или справочном списке.

Для каждой выборки ответьте:

Что представляет одна строка результата: документ, бухгалтерскую строку, сумму по счёту и периоду, объект справочника или другое?
Какие поля вместе образуют ключ строки в выбранном объекте? Не заменяйте составной ключ одним удобным номером документа.
Какие условия фильтрации обязательны для области компании, ledger, финансового года, валюты, статуса и даты?
Как формируется поле: непосредственно из источника, через association/join, вычисление, агрегацию или пользовательское расширение?
Для суммы определены ли валюта, тип валюты, знак, единица измерения и дата оценки?
Какое приложение или процесс является владельцем бизнес-смысла поля?

Элемент контракта	Что записать
Объект	Техническое имя, тип, владелец, продукт и версия
Поле	Техническое имя и бизнес-определение из документации
Ключ	Полный набор ключевых полей именно этого объекта
Уровень строки	Значение одной записи и возможные агрегирования
Происхождение	Источник, связи, вычисление, фильтр и преобразование
Применение	Разрешённый сценарий, авторизации, статус выпуска и стабильности

Отметка Key в CDS view относится к контракту этого view. Она не доказывает, что поле само по себе уникально, и не устанавливает первичный ключ базовой таблицы. Уникальность проверяйте по всему заявленному ключу, нацеленной версии и реальным данным.

Проследите происхождение и ограничения#

Для важного финансового поля зафиксируйте источник и все преобразования до потребителя. При переходе из таблицы в CDS view может измениться название, тип, семантика, валюта, набор записей, вычисление или уровень агрегации. Association может добавить атрибут справочника, но связь также может увеличить число строк, если кардинальность источников не соответствует предположению.

При сверке задайте вопросы:

Включены ли те же организационные области и периоды?
Отбираются ли одинаковые типы документов, ledger, статусы и record types?
Суммируются ли строки только после совместимости валют и единиц?
Есть ли фильтры авторизации, даты действия, удаления или статуса?
Означает ли пустое значение отсутствие данных, неприменимость или результат вычисления?
Не меняют ли join, association или текстовое представление число строк?

Сверяйте не только итоговую сумму, но и выборку на уровне ключа и ожидаемой строки. Равенство агрегатов не доказывает совпадение состава данных.

Выбирайте доступ по статусу и назначению#

Для CDS view в SAP S/4HANA используйте View Browser целевой версии и проверяйте статус выпуска, тип, назначение, ключи, поля, аннотации, поддерживаемые возможности и преемников. View Browser показывает не только Released views: он также может показывать unreleased, deprecated и пользовательские представления. SAP рекомендует для нового потребления Released views; unreleased или deprecated объект может измениться или исчезнуть.

Для разработки с ограниченной версией языка ABAP проверьте, что объект доступен как released API именно для этой версии разработки. Учитываются и release contract, и видимость объекта для соответствующего языка. Внешнее или side-by-side потребление требует контракта, подходящего для такого использования; внутренний статус или наличие объекта в системе не заменяет опубликованный API.

Для интеграции и аналитики предпочитайте документированный API или CDS view, соответствующий целевому сценарию. Не считайте прямое чтение внутренней таблицы поддерживаемым контрактом только потому, что таблица существует и содержит нужные столбцы. Отдельно проверьте row-level authorization, фильтры по компании и ledger, ограничения объёма, пагинацию и срок поддержки.

Пример по версиям: журнал бухгалтерских документов#

Документация SAP S/4HANA Cloud Public Edition 2608 описывает CDS view I_AccountingDocumentJournal как released view типа Cube для журнала документов. Среди опубликованных атрибутов перечислены компания, финансовый год, документ, G/L item, ledger и дата проводки; доступ также зависит от ограничений авторизации по организационным областям.

Этот список атрибутов не следует копировать как готовый ключ. В карточке view целевой версии проверьте, какие из них помечены ключом, какой уровень строки задаёт модель и нужны ли дополнительные поля, например источник ledger или тип валюты. В другом примере той же редакции I_JournalEntryVH явно предназначен для value help; документация направляет за полным бизнес-набором к отдельному view. Назначение похожих по названию представлений может различаться.

Отдельная документация I_JournalEntryItem для SAP S/4HANA On-Premise 2023 относится к той версии. Не переносите её имена полей, статус или поведение на On-Premise 2025, Cloud или другой CDS без проверки View Browser и документации целевого выпуска.

Подготовьте передачу в отчёт или DWH#

До выбора объекта согласуйте с владельцем потребления:

бизнес-вопрос и уровень детализации;
полный ключ и поля сортировки для возобновляемого чтения;
время изменения, дату действия и способ обнаружения поздних корректировок;
валюту, тип суммы, знак и правила агрегации;
фильтры и полномочия;
статус и контракт интерфейса в целевом релизе;
версию схемы и сверки, которые выявят изменение полей или семантики.

Сохраните исходные технические имена, но храните бизнес-определения, lineage и версии контракта отдельно. Перевод поля не является преобразованием значения, а одинаковое название в двух объектах не гарантирует одинаковую семантику.

Границы проверки#

Примеры CDS и их назначения выше привязаны к SAP S/4HANA Cloud Public Edition 2608 и On-Premise 2023, как указано рядом. View Browser проверен по документации SAP S/4HANA On-Premise 2025 FPS01. Ссылки подтверждают продуктовые сведения, но не доступность объекта, разрешения, выпуск API или качество данных в конкретной системе. SAP Dictionary, таблицы, CDS, API, роли и runtime клиента не проверялись.

SAP tables, structures, and fields: meaning, key, and permitted access#

A technical object name does not explain what a row means, whether it can be used in a report, or whether it will remain stable after an upgrade. Before reading or moving data, identify the object type, business meaning, row granularity, full key, field lineage, and access contract for the exact product and release.

This page provides a verification method. See ABAP Dictionary: types, tables, and relationships for table and type details, and CDS for financial data and SAP Journal to EDWH for keys and financial extraction.

Identify the object type#

First determine what you have found:

Database table stores data or a technical storage structure. Its fields, key, and update behavior belong to a specific model and release.
Structure or data type describes the shape of values for a program or interface; by itself it does not mean that the data is stored somewhere.
View, including a CDS view forms a result from sources, associations, expressions, and filters. Its row granularity may differ from that of the underlying table.
API or service publishes a read or change contract. Its parameters, filters, pagination, authorization, and release status define permitted use.
Compatibility or obsolete name may redirect to another model, have reduced semantics, or exist only for compatibility.

Do not infer storage, write behavior, or permitted access from a similar table, view, structure, or API name.

Record field meaning and row granularity#

Describe a field together with the object that publishes it. A label such as date, amount, or item can mean different things in a document header, accounting line, currency view, aggregate, or value-help list.

For each data set, answer:

What does one result row represent: a document, accounting line, balance by account and period, master-data record, or something else?
Which fields together form the row key in this object? Do not replace a composite key with a convenient document number.
Which filters are required for company, ledger, fiscal year, currency, status, and date scope?
How is a field produced: direct source, association/join, expression, aggregation, or custom extension?
For an amount, are currency, currency type, sign, unit, and valuation date defined?
Which application or process owns the field's business meaning?

Contract element	Record
Object	Technical name, type, owner, product, and release
Field	Technical name and documented business definition
Key	Full set of key fields for this object
Row granularity	Meaning of one record and possible aggregation
Lineage	Source, associations, expressions, filters, and transformations
Use	Permitted scenario, authorizations, release status, and stability

A Key marker on a CDS view belongs to that view's contract. It does not prove that a field is unique by itself or establish the database table's primary key. Verify uniqueness using the complete declared key, target release, and real data.

Trace lineage and constraints#

For important financial fields, record their source and every transformation before they reach a consumer. A table-to-CDS transition can change the name, type, meaning, currency, population, calculation, or row granularity. An association can add a master-data attribute, but it can also multiply rows when source cardinality does not match the assumption.

When reconciling data, ask:

Are the same organizational scopes and periods included?
Are document types, ledgers, statuses, and record types filtered consistently?
Are amounts aggregated only after currencies and units are compatible?
Are there authorization, effective-date, deletion, or status filters?
Does an empty value mean missing data, not applicable, or a calculated result?
Do joins, associations, or text lookups change the number of rows?

Reconcile the key-level population as well as totals. Equal aggregates do not prove equal source populations.

Choose access by status and purpose#

Use the View Browser for the target SAP S/4HANA release and inspect release status, type, purpose, keys, fields, annotations, supported capabilities, and successors. The View Browser can show more than Released views: it can also list unreleased, deprecated, and custom views. SAP recommends Released views for new consumption; unreleased or deprecated objects may change or disappear.

For development with a restricted ABAP language version, check that the object is a released API for that language version. Both release contract and object visibility for the development language matter. An internal object or one that happens to exist in the system is not a substitute for a published API contract appropriate to the use case.

For integrations and analytics, prefer a documented API or CDS view whose contract matches the target scenario. Do not assume that direct reads from an internal table are a supported contract just because the table exists and contains the needed columns. Separately verify row-level authorization, company and ledger restrictions, volume limits, pagination, and support lifecycle.

Versioned example: accounting document journal#

SAP S/4HANA Cloud Public Edition 2608 documents I_AccountingDocumentJournal as a released CDS view of type Cube for the document journal. Listed attributes include company code, fiscal year, journal entry, G/L line item, ledger, and posting date; access is also subject to authorization restrictions for organizational areas.

Do not copy that attribute list as a ready-made key. In the target release, check which fields are marked as keys, what row granularity the model defines, and whether additional fields such as source ledger or currency type are needed. In the same edition, I_JournalEntryVH is explicitly intended for value help; the documentation points consumers to a different view for the full business data set. Similar names can describe different purposes.

Separate I_JournalEntryItem documentation for SAP S/4HANA On-Premise 2023 is scoped to that release. Do not transfer its fields, status, or behavior to On-Premise 2025, Cloud, or another CDS view without checking the target release in the View Browser and its documentation.

Prepare use in a report or DWH#

Before selecting an object, agree with the consumer on:

business question and row granularity;
full key and sort fields for resumable extraction;
change time, effective date, and detection of late corrections;
currency, amount type, sign, and aggregation rules;
filters and authorization;
contract and release status in the target release;
schema version and reconciliations that detect field or semantic changes.

Preserve original technical names, but store business definitions, lineage, and contract versions separately. A translated field name is not a value transformation, and matching names in two objects do not guarantee matching semantics.

Verification limits#

The CDS examples and their purposes are tied to SAP S/4HANA Cloud Public Edition 2608 and On-Premise 2023 as stated. The View Browser source refers to SAP S/4HANA On-Premise 2025 FPS01. SAP Help links support product information but do not establish object availability, authorization, API release status, or data quality in a particular system. No customer Dictionary, table, CDS view, API, role, or runtime was inspected.