Kontakt

Ansicht
Dokumentation

R_ODL_TEST - OData-Testbericht

R_ODL_TEST - OData-Testbericht

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Verwendung

Sie können den Report R_ODL_TEST verwenden, um die OData-Schicht der ABAP-Social-Media-Integration (ABAP SMI) manuell zu testen. Die SMI-OData-Schicht verwendet ABAP SMI, um auf das OData-API von SAP Jam zuzugreifen.

Sie können auf jeden Entitätstyp zugreifen, der von der OData-API von SAP Jam bereitgestellt wird. Über die OData-Metadatendatei von SAP Jam (<Service-Root-URL>/$metadata) können Sie die verfügbaren Entitätstypen anzeigen. Bei der Verwendung des Testreports ist es empfehlenswert, die Metadatendatei geöffnet zu haben, da sie alle Informationen enthält, die Sie für das Zugreifen auf Entitäten, das Navigieren zwischen Entitäten und das Anzeigen der Entitätseigenschaften benötigen.

Integration

Voraussetzungen

  • Ihr Backend-System ist mit einer Instanz von SAP Jam verbunden.
  • Sie haben in dieser SAP-Jam-Instanz einen Benutzer, der mit Ihrem Backend-System verbunden ist.

Funktionsumfang

Selektion

Mit diesem Report können Sie über das ABAP SMI API auf OData-Services von SAP Jam zugreifen.

  • Parameter
Feld Beschreibung
Anwendungs-ID Definiert die Instanz des Service-Providers (zum Beispiel Jam produktiv)
Typ des Service-Providers Den Typ des Service-Providers (zum Beispiel Jam)
OData-Service Service-Wurzelknoten des OData-Services (zum Beispiel api/v1/OData)
Zugriffsoperation Die Operation für den Zugriff auf den OData-Service (CREATE, READ, UPDATE, DELETE – Anlegen, Lesen, Aktualisieren, Löschen)

  • Zugriffsoperationen
Zugriffsoperation Beschreibung
READ Liest eine vorhandene OData-Ressource
CREATE Legt eine neue OData-Ressource an
DELETE Löscht eine vorhandene OData-Ressource
UPDATE Aktualisiert eine vorhandene OData-Ressource

  • In der Funktionsleiste werden auswahlspezifische Funktionsdrucktasten für das Erstellen des OData-Ressourcenpfads angezeigt.
Funktion Beschreibung
Top-Level-Ressource Legt eine neue Top-Level-Ressource an
Nach Schlüssel navigieren Fügt einen Schlüssel an den gewählten Ressourcen-Knoten an
Navigieren zu Fügt eine Navigation an den gewählten Ressourcen-Knoten an
$count Fügt eine $count-Abfrageoption an den gewählten Ressourcen-Knoten an
Query-Option Fügt eine Abfrageoption an den ausgewählten Ressourcen-Knoten an (zum Beispiel $filter, $orderby, usw.)
Löschen Löscht alle ausgewählten Ressourcen-Knoten und alle Unterknoten

Standardvarianten

Keine

Ausgabe

Die Ausgabe des Reports wird im Bereich Ergebnis angezeigt. Je nach gesendetem OData-Request kann das Ergebnis als Tabelle, im XML-Format oder als Zeichenkette ausgegeben werden.

Aktivitäten

Gehen Sie wie folgt vor, um einen OData-Request zu erstellen und zu versenden:

  1. Füllen Sie folgende Felder aus, um eine Verbindung zum SAP-Jam-System herzustellen:
  • Anwendungs-ID

  • Typ des Service-Providers

  • OData-Service

  • Zugriffsoperation

  1. Wählen Sie die Top-Level-Ressource, zum Beispiel Gruppen oder Feeds in SAP Jam.

Es wird im Bereich Ressourcen-Baum ein Knoten für die angegebene Top-Level-Ressource erstellt.

  1. Geben Sie im Bereich Request-Eingabe in das Feld Ressourcen-Name den Namen der Top-Level-Ressource ein (beispielsweise Groups).
  2. [Optional]: Erweitern Sie den Request wie folgt:
  • Wählen Sie den Knoten des Ressourcen-Baums aus, dem Sie einen weiteren Knoten anfügen möchten

  • Wählen Sie in der Funktionsleiste die entsprechende Funktion aus, um den Ressourcen-Pfad Ihrem Request zu erweitern.

  • Geben Sie im Bereich Request-Eingabe die funktionsspezifischen Daten ein (beispielsweise den Namen der Navigation oder den Namen und Wert eines Schlüssels).

  • [Optional]: Wiederholen Sie diese Schritte, bis Ihr Request vollständig ist.

  1. [Optional]: Geben Sie im Bereich Request-Eingabe in der Tabelle Header-Felder die Werte der Name/Wert-Paare ein. Fügen Sie je nach Anforderung neue Zeilen hinzu oder Löschen Sie vorhandene Zeilen.
  2. Wenn Sie die Zugriffsoperation CREATE oder UPDATE gewählt haben, geben Sie den Request-Body entweder als Tabellenbasierte Eingabe oder als Roheingabe ein:
  • Tabellenbasierte Eingabe:
  • Wählen Sie Tabellenbasierte Eingabe.

  • Geben Sie in das Feld Eingabeobjekt: Name den Namen der Entität ein, die mit Ihrem Request in SAP Jam angelegt werden soll (zum Beispiel Group).

  • Geben Sie in die Tabelle Eingabeobjekt: Eigenschaften die Namen und Werte der Entitätseigenschaften ein, die Sie anlegen möchten.

  • Roheingabe:
  • Wählen Sie Roheingabe.

  • Geben Sie in den Editor die hexadezimale Darstellung des Request-Bodys ein.

  1. Wählen Sie den Knoten des Ressourcen-Baums aus und wählen Sie Ausführen (F8).

Dadurch wird der Endpunkt erstellt und der OData-Request an SAP Jam gesendet.

  • Im Bereich Ergebnis sehen Sie die Ergebnisse des Requests.

  • Im Feld Endpunkt sehen Sie den erstellten OData-Endpunkt.

Hinweis:

Wiederholen Sie diese Schritte, um weitere Requests an SAP Jam zu senden.

Beispiel

Machen Sie sich mit den Funktionen des Reports vertraut, indem Sie Ihre eigenen OData-Aufrufe anlegen. Rufen Sie die verschiedenen Entitäten hierzu auf unterschiedliche Weise auf.

Im folgenden Beispiel wird beschrieben, wie sie den Report mit den wichtigsten Zugriffsoperationen verwenden.

Beispiel 1: Eine Jam-Gruppe lesen

  1. Rufen Sie in Ihrem Backend-System die Transaktion SE38 auf und führen Sie den Report R_ODL_TEST aus.
  2. Füllen Sie die Felder folgendermaßen:
Feld Wert
Anwendungs-ID DEFAULT
Typ des Service-Providers Jam
OData-Service DEFAULT
Zugriffsoperation READ

  1. Wählen Sie Top-Level-Ressource, geben Sie im Feld Ressourcen-Name den Wert Groups ein und wählen Sie anschließend die Eingabetaste.
  2. Wählen Sie Nach Schlüssel navigieren und wählen Sie im Bereich Request-Eingabe die Drucktaste Zeile anhängen für die Tabelle Navigationsschlüssel.
  3. Füllen Sie in der Tabelle Navigationsschlüssel die Felder wie folgt aus:
  • Name: Geben Sie Id ein.

  • Wert: Geben Sie die <Gruppen-ID> einer Ihrer SAP-Jam-Gruppen ein.

  1. Wählen Sie die Eingabetaste. Sie können im Ressourcen-Baum die angegebene Gruppen-ID sehen.
  2. Wählen Sie Ausführen (F8).

Ergebnis

Im Ergebnis-Bereich werden die Eigenschaften der ausgewählten Jam-Gruppe angezeigt.

Beispiel 2: Eine Jam-Gruppe anlegen

  1. Rufen Sie in Ihrem Backend-System die Transaktion SE38 auf und führen Sie den Report R_ODL_TEST aus.
  2. Füllen Sie die Felder folgendermaßen:
Feld Wert
Anwendungs-ID DEFAULT
Typ des Service-Providers Jam
OData-Service DEFAULT
Zugriffsoperation CREATE

  1. Wählen Sie Top-Level-Ressource, geben Sie im Feld Ressourcen-Name den Wert Groups ein und wählen Sie anschließend die Eingabetaste.
  2. Wählen Sie Nach Schlüssel navigieren und wählen Sie im Bereich Request-Eingabe die Drucktaste Zeile anhängen für die Tabelle Navigationsschlüssel. Im Ressourcen-Baum wird der Name Groups neben dem Ressourcen-Knoten angezeigt.
  3. Geben Sie im Bereich Request-Eingabe im Feld Eingabeobjekt: Name den Wert Group ein.
  4. Füllen Sie in der Tabelle Eingabeobjekt: Eigenschaften die Felder wie folgt aus:
  • Name: Geben Sie Name ein.

  • Wert: Geben Sie einen noch nicht in SAP Jam vorhandenen Gruppennamen ein.

  1. Wählen Sie Ausführen (F8).

Ergebnis

Im Bereich Ergebnis wird die neu in SAP Jam angelegte Gruppe zusammen mit ihren Eigenschaften angezeigt.

Beispiel 3: Dateien in eine Jam-Gruppe hochladen

  1. Melden Sie sich an Ihrem SAP-Jam-System an und wählen Sie eine Gruppe aus.
  2. Rufen Sie in Ihrem Backend-System die Transaktion SE38 auf und führen Sie den Report R_ODL_TEST aus.
  3. Füllen Sie die Felder folgendermaßen:
Feld Wert
Anwendungs-ID DEFAULT
Typ des Service-Providers Jam
OData-Service DEFAULT
Zugriffsoperation CREATE

  1. Wählen Sie Top-Level-Ressource, geben Sie im Feld Ressourcen-Name den Wert Groups ein und wählen Sie anschließend die Eingabetaste.
  2. Im Ressourcen-Baum wird der Name Groups neben dem Ressourcen-Knoten angezeigt.
  • Im Ressourcen-Baum wird die Entität ContentItems angezeigt.

  1. Wählen Sie Nach Schlüssel navigieren und wählen Sie im Bereich Request-Eingabe die Drucktaste Zeile anhängen für die Tabelle Navigationsschlüssel.
  2. Füllen Sie in der Tabelle Navigationsschlüssel die Felder wie folgt aus:
  • Name: Geben Sie Id ein.

  • Wert: Geben Sie die <Gruppen-ID> einer Ihrer SAP-Jam-Gruppen ein.

  1. Wählen Sie die Eingabetaste. Sie können im Ressourcen-Baum die angegebene Gruppen-ID sehen.
  2. Wählen Sie Navigieren zu und geben Sie im Bereich Request-Eingabe in das Feld Ressourcen-Name den Wert ContentItems ein.
  3. Im Ressourcen-Baum wird der Name ContentItems neben dem Ressourcen-Knoten angezeigt.
  4. Hängen Sie im Bereich Request-Eingabe Zeilen an und vervollständigen Sie die Tabelle Header-Felder wie folgt:
  • Name: Geben Sie Content-Type ein. / Wert: Geben Sie text/plain ein.

  • Name: Geben Sie Slug ein. / Wert: Geben Sie <Dateiname>.txt ein.

  1. Wählen Sie im Bereich Request-Eingabe die Roheingabe und geben Sie im Editor die hexadezimale Repräsentation des Dateiinhalts ein.
  2. Wählen Sie Ausführen (F8).

Ergebnis

  • Im Ergebnis-Bereich werden die Eigenschaften der nach SAP Jam hochgeladenen Datei angezeigt.
  • Wenn Sie sich bei SAP Jam anmelden, können Sie die hochgeladene Datei in Ihrer Gruppe sehen.






ABAP Short Reference   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 19270 Date: 20240520 Time: 073340     sap01-206 ( 150 ms )