Repository Services Component (BC-FES-AIT)

175 Pages·2001·0.51 MB·English

Repository Services Component
(BC-FES-AIT)
H
E
D
S
E
F
C
B
.
P
L
E
H
Release 4.6C
Repository Services Component (BC-FES-AIT) SAP AG
Copyright
© Copyright 2001 SAP AG. Alle Rechte vorbehalten.
Weitergabe und Vervielfältigung dieser Publikation oder von Teilen daraus sind, zu welchem
Zweck und in welcher Form
auch immer, ohne die ausdrückliche schriftliche Genehmigung durch SAP AG nicht gestattet. In
dieser Publikation enthaltene Informationen können ohne vorherige Ankündigung geändert
werden.
Die von SAP AG oder deren Vertriebsfirmen angebotenen Software-Produkte können Software-
Komponenten auch anderer Software-Hersteller enthalten.
Microsoft®, WINDOWS®, NT®, EXCEL®, Word®, PowerPoint® und SQL Server® sind eingetragene
Marken der
Microsoft Corporation.
IBM®, DB2®, OS/2®, DB2/6000®, Parallel Sysplex®, MVS/ESA®, RS/6000®, AIX®, S/390®,
AS/400®, OS/390® und OS/400® sind eingetragene Marken der IBM Corporation.
ORACLE® ist eine eingetragene Marke der ORACLE Corporation.
INFORMIX®-OnLine for SAP und Informix® Dynamic ServerTM sind eingetragene Marken der
Informix Software Incorporated.
UNIX®, X/Open®, OSF/1® und Motif® sind eingetragene Marken der Open Group.
HTML, DHTML, XML, XHTML sind Marken oder eingetragene Marken des W3C®, World Wide
Web Consortium,
Massachusetts Institute of Technology.
JAVA® ist eine eingetragene Marke der Sun Microsystems, Inc.
JAVASCRIPT® ist eine eingetragene Marke der Sun Microsystems, Inc., verwendet unter der
Lizenz der von Netscape entwickelten und implementierten Technologie.
SAP, SAP Logo, R/2, RIVA, R/3, ABAP, SAP ArchiveLink, SAP Business Workflow, WebFlow,
SAP EarlyWatch, BAPI, SAPPHIRE, Management Cockpit, mySAP.com Logo und mySAP.com
sind Marken oder eingetragene Marken der SAP AG in Deutschland und vielen anderen Ländern
weltweit. Alle anderen Produkte sind Marken oder eingetragene Marken der jeweiligen Firmen.
2 April 2001
SAP AG Repository Services Component (BC-FES-AIT)
Symbole
Symbol Bedeutung
Achtung
Beispiel
Empfehlung
Hinweis
Syntax
Tip
April 2001 3
Repository Services Component (BC-FES-AIT) SAP AG
Inhalt
Repository Services Component (BC-FES-AIT)..........................................................8
What's New in Release 4.6A?...................................................................................................................10
What's New in Release 4.6B?...................................................................................................................11
System Requirements...............................................................................................................................12
Repository Services Object Hierarchy....................................................................................................13
Working Online..........................................................................................................................................15
The Local Repository: Working Offline...................................................................................................19
Reading from the Local Repository.........................................................................................................21
Copying Data from R/3 to the Local Repository.....................................................................................23
Deleting Objects from the Local Repository...........................................................................................27
Refreshing Local Repository Data...........................................................................................................28
Component Interface Reference..............................................................................................................29
How to Use this Documentation..............................................................................................................30
IRepositoryServices..................................................................................................................................31
Unique Properties...................................................................................................................................33
Connection (Get)...............................................................................................................................34
Connection (Set)...............................................................................................................................35
IsOffline.............................................................................................................................................36
IsOnline.............................................................................................................................................37
IsR3Connected..................................................................................................................................38
Unique Methods.....................................................................................................................................39
ApplicationHierarchies.......................................................................................................................40
BusinessObjects................................................................................................................................41
CompareSAPSystems......................................................................................................................42
CreateSAPSystem............................................................................................................................43
DeleteSAPSystem.............................................................................................................................44
FunctionGroups.................................................................................................................................45
Functions...........................................................................................................................................46
Offline................................................................................................................................................47
Online................................................................................................................................................48
SAPSystems.....................................................................................................................................49
SetSAPSystem..................................................................................................................................50
WriteAppHierarchies.........................................................................................................................51
WriteAppHierarchy............................................................................................................................52
WriteBO.............................................................................................................................................55
WriteBOTree.....................................................................................................................................56
WriteFunctionGroup..........................................................................................................................59
WriteFunctionGroups........................................................................................................................61
WriteRFC...........................................................................................................................................62
ISAPSystems..............................................................................................................................................64
ISAPSystem................................................................................................................................................65
Unique Properties...................................................................................................................................66
4 April 2001
SAP AG Repository Services Component (BC-FES-AIT)
ApplicationServer..............................................................................................................................67
HostName.........................................................................................................................................68
SAPRelease......................................................................................................................................69
System..............................................................................................................................................70
SystemNumber..................................................................................................................................71
IApplicationHierarchies.............................................................................................................................72
IApplicationHierarchy................................................................................................................................73
Unique Properties...................................................................................................................................74
ApplicationAreaDescription...............................................................................................................75
Unique Methods.....................................................................................................................................76
BusinessObjects................................................................................................................................77
IBusinessObjects.......................................................................................................................................78
IBusinessObject.........................................................................................................................................79
Unique Properties...................................................................................................................................80
DevelopmentClass............................................................................................................................81
LastChangeDate...............................................................................................................................82
LastChangeRelease..........................................................................................................................83
LastChangeTime...............................................................................................................................84
Unique Methods.....................................................................................................................................85
KeyFields...........................................................................................................................................86
Methods.............................................................................................................................................87
IMethods.....................................................................................................................................................88
IMethod.......................................................................................................................................................89
Unique Properties...................................................................................................................................90
IsClassMethod...................................................................................................................................91
IsFactoryMethod................................................................................................................................92
IsFrozen.............................................................................................................................................93
IsModelOnly.......................................................................................................................................94
IsSynchronousMethod.......................................................................................................................95
MethodType......................................................................................................................................96
IFunctionGroups........................................................................................................................................97
IFunctionGroup..........................................................................................................................................98
Unique Methods.....................................................................................................................................99
Functions.........................................................................................................................................100
IFunctions.................................................................................................................................................101
IFunction...................................................................................................................................................102
Unique Properties.................................................................................................................................103
GroupName.....................................................................................................................................104
IExceptions...............................................................................................................................................105
IException.................................................................................................................................................106
Unique Properties.................................................................................................................................107
ID.....................................................................................................................................................108
IParameters..............................................................................................................................................109
IParameter................................................................................................................................................110
Unique Properties.................................................................................................................................112
ABAPName.....................................................................................................................................113
April 2001 5
Repository Services Component (BC-FES-AIT) SAP AG
Default.............................................................................................................................................114
IsStructure.......................................................................................................................................115
IsExport...........................................................................................................................................116
IsField..............................................................................................................................................117
IsImport...........................................................................................................................................118
IsMandatory.....................................................................................................................................119
IsTable.............................................................................................................................................120
Unique Methods...................................................................................................................................121
Field.................................................................................................................................................122
Structure..........................................................................................................................................123
Table................................................................................................................................................124
IStructure..................................................................................................................................................125
ITable.........................................................................................................................................................126
IFields........................................................................................................................................................127
IField..........................................................................................................................................................128
Unique Properties.................................................................................................................................130
CheckTable.....................................................................................................................................131
DataElement....................................................................................................................................132
Decimals..........................................................................................................................................133
Domain............................................................................................................................................134
HasFixedValues..............................................................................................................................135
HelpValues......................................................................................................................................136
HelpValuesCount............................................................................................................................137
InternalLength.................................................................................................................................138
IsCaseSensitive...............................................................................................................................139
IsConversionExit.............................................................................................................................140
Length..............................................................................................................................................141
LongScreenText..............................................................................................................................142
MediumScreenText.........................................................................................................................143
Offset...............................................................................................................................................144
Position............................................................................................................................................145
ReferenceField................................................................................................................................146
ReferenceTable...............................................................................................................................147
ReportHeader..................................................................................................................................148
ShortScreenText.............................................................................................................................149
ValuesForField................................................................................................................................150
ValuesForFieldCount.......................................................................................................................151
Common Properties................................................................................................................................152
ABAPType................................................................................................................................................153
ApplicationArea.......................................................................................................................................154
Count.........................................................................................................................................................155
Description...............................................................................................................................................156
DictionaryType.........................................................................................................................................157
Documentation.........................................................................................................................................158
InternalName............................................................................................................................................159
6 April 2001
SAP AG Repository Services Component (BC-FES-AIT)
Item............................................................................................................................................................160
ItemByIndex.............................................................................................................................................161
ItemByName.............................................................................................................................................162
Name.........................................................................................................................................................163
Obsolete....................................................................................................................................................164
Parent........................................................................................................................................................165
ParentType...............................................................................................................................................166
Root...........................................................................................................................................................167
RowLength...............................................................................................................................................168
Common Methods...................................................................................................................................169
Exceptions................................................................................................................................................170
Fields.........................................................................................................................................................171
Parameters...............................................................................................................................................172
Common Returned Values......................................................................................................................173
BO_METHOD_TYPE................................................................................................................................174
OBJECT_TYPE.........................................................................................................................................175
April 2001 7
Repository Services Component (BC-FES-AIT) SAP AG
Repository Services Component (BC-FES-AIT)
Repository Services Component (BC-FES-AIT)
Purpose
The Repository Services Component provides read access to SAP R/3 business object and RFC
function module metadata to external programs and applications.
The Repository Services Component provides a standard access interface to R/3 objects and
encapsulates the mechanism required to physically access the underlying R/3 system and
database.
Implementation Considerations
You can use the Repository Services component in programs that follow the Microsoft
Component Object Model (COM).
Integration
The Repository Services component allows you to create a Repository Services object on a client
computer, which holds the metadata of an R/3 business object or a function module.
The following diagram illustrates, as an example, a Repository Services object representing a
SAP business object.
Repository Services
Component
RR//33
Business Respository Services
Object Object
The details of the metadata of the SAP business object or of the RFC function module are
contained in a hierarchy of objects under the Repository Services object [Seite 13].
Features
The Repository Services component allows you read SAP business object and SAP function
module metadata.
The Repository Services component allows you to access this metadata using a live connection
to an R/3 system. We refer to this as working online [Seite 15].
8 April 2001
SAP AG Repository Services Component (BC-FES-AIT)
Repository Services Component (BC-FES-AIT)
The Repository Services component also allows you to save metadata in a local repository
database [Seite 19]. This enables access to the metadata offline, that is, without a connection to
the R/3 system.
April 2001 9
Repository Services Component (BC-FES-AIT) SAP AG
What's New in Release 4.6A?
What's New in Release 4.6A?
Error handling has changed in Release 4.6A to use the COM error handling. As a result, the
various methods of the Repository Services component now return either True or False, instead
of Success or Failure. In addition, the LastError property of IRepositoryServices is no longer in
use.
10 April 2001