Technische Referenzen

Dieser Abschnitt enthält nützliche Informationen, die Sie möglicherweise für die Arbeit mit SAP BAPI benötigen.

Erstellen von Array-Eingaben für Tabelleneingabetypen

In der Aktivität „Execute BAPI“ werden Tabelleneingabetypen für BAPIs als Array-Eingaben dargestellt. Dazu müssen Sie die Objekte manuell erstellen. Wir arbeiten aktiv an einer Lösung, um Array-Zuordnungen zu vereinfachen und das Gesamterlebnis zu verbessern.

In diesem Abschnitt wird erläutert, wie äquivalente Array-Eingaben für eine Native-Typ-Tabelle in SAP BAPI erstellt werden, mit Beispielen in Studio Desktop-Version 2023.10 und Studio Web.

Wir erklären dieses Thema am Beispiel eines BAPI_PO_CREATE -Objekts.

Studio Desktop (Sprache C#)

1. Wählen Sie in der Aktivität BAPI ausführen ( Execute BAPI ) das Objekt BAPI_PO_CREATE aus.
2. Nachdem Sie das Objekt ausgewählt haben, werden die restlichen Felder automatisch abgerufen.
3. Für eine Tabelle von PO_ITEMS möchten Sie z. B. ein äquivalentes Array von Objekten erstellen. Wählen Sie das Plus + -Schaltflächenmenü neben dem Feld PO_ITEMS aus, um den Ausdrucks-Editor zu öffnen.
4. Geben Sie im Ausdrucks-Editor -Fenster UiPath.IntegrationService.Activities.SWEntities ein. Dadurch wird eine Liste von Elementen geladen. Sie können IntelliSense verwenden, um das Durchlaufen zu unterstützen.
5. Wählen Sie in der Liste das Element aus, das Ihrem InArgument entspricht (in diesem Fall bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE). Dieses Element ist für eine Tabelle immer eindeutig.
   
   

   

   
   
6. Geben Sie als Nächstes einen Punkt (.) ein und wählen Sie dann Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create aus der verfügbaren Liste aus. Fügen Sie am Ende zwei Klammernpaare hinzu: []{}.
7. An diesem Punkt wird das Array instanziiert und Sie können das darin enthaltene Objekt erstellen.
   
   

   

   
   
   Hinweis: Die CEBA75DCD15- ID ist ein eindeutiger Bezeichner, der auf unserer Seite für jedes Objekt spezifisch für Ihre SAP BAPI-Verbindung generiert wird. Die ID ist für jedes Objekt eindeutig.
8. Kopieren Sie die Zeile aus dem vorherigen Schritt und fügen Sie am Ende Klammern () hinzu. Jetzt können Sie die Eigenschaften innerhalb des Objekts zuordnen.
   
   

   

   
   
9. Geben Sie einen Punkt (.) ein, um alle Eigenschaften innerhalb des Objekts zu suchen.
   
   

   

   
   
10. Ordnen Sie die Eigenschaften nach Bedarf zu und wählen Sie Speichern aus.
    
    

    

    
    

Beispiel:

new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create[] {
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00001,
        PUR_MAT = "TG12",
        PLANT = "1710"
    },
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00002,
        PUR_MAT = "TG12",
        PLANT = "1710"
    }
}

Studio Web (Sprach-VB)

Nehmen wir dasselbe Beispiel und sehen wir uns an, wie wir das Ergebnis in Studio Web erzielen können.

1. Wählen Sie in der Aktivität BAPI ausführen ( Execute BAPI ) das Objekt BAPI_PO_CREATE aus.
2. Nachdem Sie das Objekt ausgewählt haben, werden die restlichen Felder automatisch abgerufen.
3. Für eine Tabelle von PO_ITEMS möchten Sie z. B. ein äquivalentes Array von Objekten erstellen. Wählen Sie Mehr anzeigen aus Schaltflächenmenü, um den Ausdrucks-Editor zu öffnen.
   
   

   

   
   
4. Geben Sie New ein, gefolgt von einem Leerzeichen, und dann bapis. Dadurch wird IntelliSense ausgelöst, um eine Liste von Elementen anzuzeigen. Wählen Sie in der Liste das Element aus, das Ihrem InArgument entspricht, in diesem Fall bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE. Dieses Element ist für eine Tabelle immer eindeutig.
   
   

   

   
   
   
   

   

   
   
5. Fügen Sie als Nächstes ein Paar geschweifter Klammern {} hinzu. Geben Sie in den Klammern einen Punkt . ein. Sie können dann die verfügbaren Eigenschaften innerhalb des Objekts sehen.
   
   

   

   
   
6. Ordnen Sie die Eigenschaften nach Bedarf zu und wählen Sie Speichern aus.
   
   

   

   
   

Beispiel:

{ 
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00001,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    },
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00002,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    }
}

Häufig gestellte Fragen

Ist das SAP BAPI-Aktivitätspaket mit Windows- und plattformübergreifenden Projekten kompatibel?

Ja, das SAP BAPI-Aktivitätspaket ist sowohl mit Windows- als auch mit plattformübergreifenden Projekttypen in Studio Desktop kompatibel.

Warum werden nicht alle erforderlichen Eigenschaften einer BAPI auf der Aktivitäts-Canvas angezeigt?

Wenn eine Eigenschaft einer bestimmten BAPI vom Typ Struktur ist, wird die Eingabe (Struktur) selbst nicht auf der Canvas für die Aktivität BAPI ausführen angezeigt, aber die zugrunde liegenden Eigenschaften werden angezeigt. Auch wenn bestimmte Eigenschaften innerhalb der Struktur von der BAPI gefordert werden, werden sie auf dem primären Canvas dennoch als optional angezeigt, was oft zu einer unübersichtlichen Aktivitätsoberfläche führt. SAP gibt nicht an, welche Felder innerhalb der Struktur erforderlich sind, und stellt nur Informationen über die obligatorische Struktur bereit. Daher müssen Sie die erforderlichen Felder manuell identifizieren und entsprechend zuordnen. Mehr über diese Einschränkung erfahren Sie in diesem SAP-Community-Thread: BAPI-Pflichtfelder.

Warum werden für die BAPIs keine Tabelleneingabetypen angezeigt?

In der Aktivität „Execute BAPI“ werden Tabelleneingabetypen für BAPIs als Array-Eingaben dargestellt. Dazu müssen Sie die Objekte manuell erstellen. Siehe die Beispiele unter Erstellen von Array-Eingaben für Tabelleneingabetypen.

Wir arbeiten aktiv an einer Lösung, um Array-Zuordnungen zu vereinfachen.

Warum kann ich nicht alle meine Eingaben auf der Canvas sehen?

Standardmäßig werden nur die erforderlichen Felder auf der Hauptaktivitäts-Canvas angezeigt. Sie können auf optionale Felder im Bereich Eigenschaften verwalten zugreifen und sie konfigurieren. Wählen Sie die zusätzlich benötigten Eingaben aus und verwenden Sie die Option Felder aktualisieren, um sie auf die primäre Canvas zu bringen.

Wird das Aufrufen von RFC unterstützt?

Das Aufrufen von RFC wird derzeit im SAP BAPI-Aktivitätspaket nicht unterstützt.

Gibt es Installationsvoraussetzungen für die Verwendung der SAP BAPI-Aktivitäten?

Um die neuen SAP BAPI-Aktivitäten aus dem Integration Service zu verwenden, sind keine Installationen erforderlich. Sie benötigen UiPath Studio Version 2023.10 oder höher. Alternativ können Sie direkt in Studio Web mit der Erstellung Ihrer Automatisierungen beginnen.

Wie kann ich ermitteln, ob die Aktivität „Execute BAPI“ erfolgreich war?

Alle BAPIs enthalten ein _RETURN -Array innerhalb des Abschnitts „Ausgabetabellen“. Dies liefert Ausgaben wie LOG_NO, CODE, MESSAGE usw. Überprüfen Sie diese Werte, um den Erfolg oder Fehlschlag der BAPI-Ausführung zu beurteilen.

Kann ich für den Hostnamen eine IP-Adresse anstelle eines DNS-Namens verwenden?

Die Verwendung einer IP-Adresse bietet einen erheblichen Vorteil: Eindeutigkeit. Wenn Sie einen DNS-Namen wie mycompany.com/sap/bapi verwenden, sind Sie von DNS-Übersetzung, Routing und anderen Netzwerkkomponenten abhängig. Dies kann zu potenziellen Problemen und Netzwerkproblemen führen. Daher empfehlen wir Ihnen, IP-Adressen zu verwenden, um eine zuverlässigere Verbindungserstellung zu gewährleisten.

Kann ich die Aktivität SAP BAPI aus dem Integration Service verwenden, wenn meine SAP-Anwendung lokal oder in einer dedizierten Cloud gehostet wird?

Ja. Wenn Ihr SAP S/4HANA-System auf einer Cloud-Plattform wie Azure gehostet wird, sollten Sie eine öffentliche IP-Adresse haben, die für den Zugriff ausreicht. Wenn Ihr SAP-System lokal installiert ist, müssen Sie den Zugriff von bestimmten externen IP-Adressen zulassen, was das Konfigurieren Ihrer Firewall-Einstellungen erfordert.

Verarbeitet das System Commits für BAPIs automatisch?

Ja. Da wir den SAP Java Connector verwenden, erkennt das System automatisch, ob eine BAPI einen Commit erfordert und löst BAPI_TRANSACTION_COMMIT aus, um sicherzustellen, dass die Transaktion gespeichert wird. Dadurch entfällt die Notwendigkeit eines manuellen Eingriffs.