Bevor Sie beginnen

In this tutorial, you learn how to install the Oracle Visual Builder Add-in for Excel, create a Microsoft Excel workbook that retrieves data from a REST service, and publish the workbook so business users can perform data entry tasks. Dieses Tutorial dauert etwa 10 Minuten.

Hintergrund

Mit Oracle Visual Builder Add-in for Excel können Sie Daten aus einem REST-Service in eine Tabelle in einer Excel-Arbeitsmappe herunterladen, in der Benutzer Daten ändern, erstellen oder löschen können, bevor sie diese Änderungen an den Service zurücksenden. Nach der Installation des Add-ins geben Sie den Endpunkt des Service ein, um Daten aus dem Service in die Excel-Arbeitsmappe herunterzuladen. Außerdem wird eine neue Oracle Visual Builder-Menübandregisterkarte mit Befehlen angezeigt, mit denen Sie die heruntergeladenen Daten verwalten können.

Voraussetzungen

• Ein Windows 10- oder 11-Betriebssystem mit einer Installation von Microsoft Excel 365 oder einer anderen unterstützten Version

  (Siehe Unterstützte Plattformen in Integrierte Kalkulationstabellen mit Oracle Visual Builder Add-in for Excel entwickeln.)

• Zugriff auf Ihre Oracle Visual Builder-Instanz

  Hinweis: Sie können das Tutorial möglicherweise mit einem REST-Service Ihrer Wahl abschließen. Stellen Sie sicher, dass Sie über die OpenAPI-Servicemetadaten für den Zielservice verfügen (einige Oracle-Services stellen eine solche Beschreibung bereit, indem Sie der URL /describe hinzufügen). Wenn Sie diese Route verwenden, können einige Schritte in diesem Tutorial für Ihren Service unterschiedlich sein.

  Beispiel: Sie können die Unterschritte 1 bis 6 von Schritt 1 überspringen, müssen jedoch die Unterschritte 7 und 8 abschließen, um das Add-in zu installieren. Laden Sie das Installationsprogramm von der Seite Downloads herunter, bevor Sie beginnen.

Oracle Visual Builder Add-in for Excel installieren

1. Klicken Sie mit der rechten Maustaste auf diese Datei, und laden Sie sie auf Ihren Rechner herunter.

   Die Datei Personnel_Manager.zip enthält eine visuelle Anwendung mit einem Geschäftsobjekt "Mitarbeiter" und Beispieldaten.

2. Melden Sie sich in Ihrem Webbrowser bei Oracle Visual Builder an.
3. Klicken Sie auf der Seite "Visuelle Anwendungen" auf Importieren, wählen Sie Anwendung aus Datei aus, und navigieren Sie zur Datei Personnel_Manager.zip . Klicken Sie auf Importieren.
4. Klicken Sie auf der Seite "Visuelle Anwendungen" in der Spalte "Name" auf Personalmanager.
5. Klicken Sie auf Geschäftsobjekte , Menü , und wählen Sie Datenmanager aus.

   

6. Klicken Sie auf der Seite "Datenmanager" auf Daten in Excel bearbeiten, um das Installationsprogramm herunterzuladen.

   Tipp: Suchen Sie auf der Seite Downloads nach einer neueren Version.

7. Beenden Sie Excel, bevor Sie das Installationsprogramm ausführen.
8. Doppelklicken Sie auf die heruntergeladene Installationsprogrammdatei, um die Installation zu beginnen, klicken Sie auf Weiter und dann auf Schließen, nachdem das Add-in installiert wurde. Siehe Oracle Visual Builder Add-in for Excel installieren in Integrierte Kalkulationstabellen mit Oracle Visual Builder Add-in for Excel entwickeln.

   Eine erfolgreiche Installation aktiviert das Add-in in Excel, und beim Starten von Excel wird eine neue Registerkarte Oracle Visual Builder angezeigt.

   

Excel-Arbeitsmappe zum Herunterladen von Daten aus einem REST-Service konfigurieren

In diesem Schritt erstellen Sie eine Tabelle in einer Excel-Arbeitsmappe, die Mitarbeiterdaten aus dem REST-Service herunterlädt, der mit der gerade importierten visuellen Anwendung verknüpft ist.

1. Klicken Sie in Oracle Visual Builder auf der Registerkarte Geschäftsobjekte auf Mitarbeiter, Endpunkte.
2. Blenden Sie Ressourcen-APIs ein, und klicken Sie auf das Zwischenablage-Symbol, um die gesamte URL für die Metadatenressourcen-API zu kopieren:

   

3. Erstellen Sie eine Excel-Arbeitsmappe mit dem Namen employees-source.xlsx in einem Verzeichnis auf Ihrem Computer, und öffnen Sie sie.
4. Klicken Sie auf die Zelle, in der Sie die Datentabelle suchen möchten.
5. Klicken Sie in der Excel-Arbeitsmappe auf der Registerkarte Oracle Visual Builder auf Designer, um den Assistenten "Neues Layoutsetup" zu starten.
6. Geben Sie im ersten Fenster des Assistenten die zuvor kopierte URL in das Feld "Webadresse" ein, und klicken Sie auf Weiter.

   

   Lassen Sie die Authentifizierungseinstellung auf "Standard" gesetzt.

   Hinweis: Wenn Sie einen anderen REST-Service verwenden, geben Sie die URL für diesen Service ein, und hängen Sie /describe an die URL an.

7. Geben Sie im Anmeldedialogfeld den Benutzernamen und das Kennwort für den Zugriff auf Oracle Visual Builder ein, und klicken Sie auf Anmelden.

   Das Add-in stellt eine Verbindung zur Oracle Visual Builder-Instanz her und ruft die Servicemetadaten ab. Die Ergebnisse des Vorgangs werden im Assistenten angezeigt.

8. Klicken Sie auf Weiter, um fortzufahren.
9. Wählen Sie im nächsten Fenster Mitarbeiter aus, und klicken Sie auf Weiter.

   

   Im nächsten Fenster werden Sie aufgefordert, den zu erstellenden Layouttyp auszuwählen: "Tabelle" oder "Form-over-Tabelle".

   

10. Wählen Sie Tabellenlayout aus, und klicken Sie auf Weiter.

    Im nächsten Fenster werden Sie aufgefordert, weitere Geschäftsobjekte für mindestens ein abhängiges Layout auszuwählen.

    

11. Lassen Sie diesen Bildschirm leer, und klicken Sie auf Weiter, um fortzufahren.
12. Bestätigen Sie im letzten Bildschirm die Details Ihres neuen Layouts, und klicken Sie auf Fertigstellen.

    In Ihrer Excel-Arbeitsmappe wird eine neue Tabelle angezeigt. Spaltenüberschriften werden angezeigt, wobei eine Platzhalterdatenzeile unterhalb der Header angezeigt wird. Sie sehen auch den Layout Designer auf der rechten Seite.

    

    Hinweis: Wenn sich die Ursprungszelle des Layouts in den ersten 10 Zeilen befindet, wird die Kopfzeile eingefroren, sodass die Spaltenüberschriften immer angezeigt werden, wenn Sie im Arbeitsblatt nach oben und unten scrollen.

13. Klicken Sie auf Daten herunterladen, um die Daten herunterzuladen, die das Mitarbeitergeschäftsobjekt referenziert.

    

Tabelle vor der Veröffentlichung in der Excel-Arbeitsmappe anpassen

Sie können die Tabelle, die das Add-in in der Excel-Arbeitsmappe erstellt, anpassen, bevor Sie sie veröffentlichen und zur Dateneingabe an Benutzer verteilen. Beispiel: Sie möchten die Reihenfolge der Spalten ändern, sodass die Spalte "E-Mail" vor dem Vornamen des Mitarbeiters angezeigt wird. Sie können auch eine Suchabfrage hinzufügen, um die vom Service heruntergeladenen Daten zu filtern. Beispiel: Sie können das Feld "Gehalt" aus dem Geschäftsobjekt "Mitarbeiter" als Suchfeld hinzufügen, damit Benutzer Suchkriterien eingeben können, mit denen sie nur die Datensätze von Mitarbeitern herunterladen können, die diesen Kriterien entsprechen.

1. Klicken Sie auf der Registerkarte Oracle Visual Builder gegebenenfalls auf Designer. Klicken Sie anschließend im Layout Designer auf die Registerkarte Spalten.
2. Ordnen Sie die Spalten neu an, indem Sie das Symbol, das links neben dem Eintrag E-Mail angezeigt wird, per Drag-and-Drop verschieben, wie hier gezeigt:

   Tipp: Klicken Sie mit der rechten Maustaste auf eine Spalte, um weitere Optionen für die Neuanordnung anzuzeigen.

   

   Hinweis: Die Spalten "Ändern", "Status" und "Schlüssel" werden automatisch generiert. Sie können diese Spalten nicht anpassen oder entfernen.

3. Klicken Sie auf die Registerkarte Herunterladen, um eine Suchabfrage hinzuzufügen.
4. Klicken Sie auf das Symbol "Bearbeiten" neben "Suchen".

   

5. Wählen Sie im Editor für Felder für verfügbare Geschäftsobjekte die Option Gehalt aus, und klicken Sie auf OK.
6. Wählen Sie im Sucheditor in der Vergleichsliste größer als, und lassen Sie den Wert leer.
7. Deaktivieren Sie Editor beim Download aktiviert, um sicherzustellen, dass die Steuerelemente des Sucheditors in der Eingabeaufforderung beim Download deaktiviert sind.
8. Klicken Sie auf OK, um die Sucheinstellungen zu speichern und den Sucheditor zu schließen.
9. Klicken Sie auf Daten herunterladen.
10. Geben Sie im Dialogfeld "Suchen" 10000 ein, und klicken Sie auf OK.

    Das Add-in lädt nur die Datensätze von Mitarbeitern herunter, deren Gehalt 10.000 übersteigt.

    

Excel-Arbeitsmappe veröffentlichen und an Benutzer verteilen

Nachdem Sie die Excel-Arbeitsmappe erstellt und für den Download von Daten aus Ihrem REST-Service konfiguriert haben, können Sie sie veröffentlichen. Dieser optionale Schritt ist nützlich, wenn Sie eine Kopie Ihrer Arbeitsmappe erstellen möchten, die Sie für die Dateneingabe an andere Benutzer verteilen können. Außerdem können Sie die Design-Tools (Designer, Layout löschen und veröffentlichen) entfernen und den Arbeitsblattschutz aktivieren. Das heißt, Sie können die Excel-Quellarbeitsmappe verteilen, ohne sie zu veröffentlichen.

1. Klicken Sie auf der Registerkarte Oracle Visual Builder auf Veröffentlichen.

   

2. Übernehmen Sie im Fenster "Arbeitsmappe veröffentlichen" den Speicherort und Dateinamen der Arbeitsmappe. Wenn der Name der ursprünglichen Arbeitsmappe mit -source endet (wie in unserem Beispiel employees-source.xlsx), bietet das Add-in denselben Namen ohne -source.

   

3. Deaktivieren Sie das Kontrollkästchen Servicehost aus jedem Katalog entfernen, lassen Sie die anderen Veröffentlichungsoptionen jedoch unverändert.
4. Klicken Sie auf Veröffentlichen. Siehe Integrierte Excel-Arbeitsmappe veröffentlichen in Integrierte Kalkulationstabellen mit Oracle Visual Builder Add-in for Excel entwickeln.

   Im Statusbereich wird eine Bestätigung angezeigt.

   

5. Speichern und schließen Sie die Excel-Quellarbeitsmappe, mit der Sie die Excel-Arbeitsmappe veröffentlicht haben.

   Jetzt können Sie die veröffentlichte Arbeitsmappe für die Dateneingabe an andere Benutzer verteilen. Jeder Benutzer muss über einen Benutzernamen und ein Kennwort verfügen, die den Zugriff auf den REST-Service ermöglichen, den Sie beim Erstellen der Excel-Arbeitsmappe eingegeben haben.

   Der nächste Schritt in diesem Tutorial zeigt, wie Benutzer Dateneingabeaufgaben mit der gerade veröffentlichten Excel-Arbeitsmappe abschließen.

Daten in einer veröffentlichten Excel-Arbeitsmappe erstellen, lesen, aktualisieren und löschen

Geschäftsbenutzer, die eine Kopie der von Ihnen veröffentlichten Excel-Arbeitsmappe erhalten, müssen das Add-in installieren, um Daten aus dem REST-Service herunterzuladen. (Das Installationsprogramm kann direkt von der Seite Downloads heruntergeladen werden.) Sobald das Add-in installiert ist, können sie heruntergeladene Daten in der Arbeitsmappe erstellen, lesen, aktualisieren und löschen, bevor sie Änderungen in den Service hochladen.

1. Öffnen Sie die veröffentlichte Excel-Arbeitsmappe aus dem Verzeichnis, in dem Sie sie gespeichert haben.

   

   Der Abschnitt "Entwurf" wird nicht auf der Registerkarte Oracle Visual Builder angezeigt, da Sie die Designtools deaktiviert haben und verhindern, dass Benutzer einer veröffentlichten Arbeitsmappe auf die Befehle Designer, Layout löschen und Veröffentlichen zugreifen können, auf die Sie als Arbeitsmappenentwickler zugreifen können. Die Tabelle zeigt die Spaltenüberschriften, aber keine Daten an, da Sie beim Veröffentlichen der Excel-Arbeitsmappe alle Layouts löschen möchten.

2. Klicken Sie auf Daten herunterladen, um die Daten herunterzuladen, die von der Arbeitsmappe abgerufen werden sollen.
3. Geben Sie im Dialogfeld "Anmelden" einen Benutzernamen und ein Kennwort ein, und klicken Sie auf OK.
4. Da Sie eine Suchabfrage einrichten, um Datendownloads basierend auf dem Mitarbeitergehalt einzuschränken, werden Sie aufgefordert, einen Wert für die Abfrage einzugeben. Lassen Sie den Wert leer, und klicken Sie auf OK.

   Das Add-in lädt alle Mitarbeiterdaten herunter.

   

5. Nehmen Sie die folgenden Änderungen vor:
   • Ändern Sie in Zeile 1 Sophia in Sophie.
   • Klicken Sie auf die Zelle G2, und wählen Sie in der Werteliste die Option Manager aus, um die Tätigkeit von Dave Brown zu ändern.
   • Wählen Sie die Zeile für John Sieve (Zeile 4) aus, indem Sie beispielsweise auf seine E-Mail-Adresse klicken. Klicken Sie auf der Registerkarte Oracle Visual Builder auf Tabellenzeilenänderungen und dann auf Zum Löschen markieren.
   • Wählen Sie die gesamte Zeile 5 aus, klicken Sie mit der rechten Maustaste, und wählen Sie Einfügen aus dem Kontextmenü. Geben Sie diese Daten für die neu eingefügte Zeile ein: E-Mail = jmcgahern@example.com, Vorname = John, Nachname = McGahern, Einstellungsdatum = 2018-01-30, Tätigkeit = Accountant, Gehalt = 19,000 und Abteilung = Accounting.

     Hinweis: Eine weitere Möglichkeit, neue Zeilen in der Tabelle hinzuzufügen, besteht darin, die Zeile direkt unter der zuletzt heruntergeladenen Zeile in der Tabelle auszuwählen, klicken Sie auf Tabellenzeilenänderungen und Zeilen einfügen. Das Add-in erstellt eine neue Zeile in der Tabelle, die Sie dann bearbeiten können.

   • Wählen Sie die Zeile für Ken Ster ganz am Ende der Tabelle (Zeile 102) aus, indem Sie beispielsweise seine E-Mail-Adresse auswählen. Klicken Sie auf der Registerkarte Oracle Visual Builder auf Tabellenzeilenänderungen und dann auf Zum Löschen markieren.

     Nachdem Sie diese Änderungen vorgenommen haben, ähnelt Ihre Tabelle der Tabelle in der folgenden Abbildung. Das heißt, die Meldung Update, Delete oder Create wird in der Spalte Geändert für jede Zeile angezeigt, in der Sie eine Änderung vorgenommen haben.

     

6. Klicken Sie auf der Registerkarte Oracle Visual Builder auf Änderungen hochladen.

   Wenn Sie aufgefordert werden, eine Meldung mit ausstehenden Löschvorgängen für die Tabelle zu erhalten, klicken Sie zur Bestätigung auf Ja. Nach Abschluss des Uploads aktualisiert die Tabelle die Spalte Status, um die Änderung für jede geänderte Zeile zu beschreiben, die hochgeladen wurde.

   Die neue Zeile, die Sie erstellt haben, führt dazu, dass ein neuer Datensatz für John McGahern in der Collection erstellt wird.

   Die zum Löschen markierten Zeilen, die Datensätze für John Sieve und Ken Ster, werden nicht mehr angezeigt, weil der REST-Service sie aus seiner Sammlung gelöscht hat.

   

   Hinweis: Alle Daten werden validiert, bevor sie in den REST-Service hochgeladen werden. Wenn Fehler auftreten, können Sie die Fehler jederzeit beheben und die Änderungen erneut hochladen. Wenn Sie beispielsweise Teilfehler haben, wenn das Aktualisieren und Löschen von Zeilen erfolgreich war, das Erstellen von Zeilen jedoch nicht erfolgreich war, müssen Sie nur die Daten für die nicht erfolgreiche Erstellung von Zeilen korrigieren.

   Um zu prüfen, ob die Änderungen an Ihrer Excel-Arbeitsmappe erfolgreich hochgeladen wurden, gehen Sie zur Registerkarte Daten der Seite "Geschäftsobjekte" in Ihrer visuellen Anwendung.

   

Sie möchten mehr erfahren?

• Einführung in Oracle Visual Builder Add-in for Excel in Integrierte Kalkulationstabellen mit Oracle Visual Builder Add-in for Excel entwickeln
• Suchoptionen für Download konfigurieren in Integrierte Kalkulationstabellen mit Oracle Visual Builder Add-in for Excel entwickeln
• Daten mit Oracle Visual Builder Add-in for Excel verwalten. Diese Dokumentation hilft Geschäftsbenutzern, mit Ihren integrierten Arbeitsmappen erfolgreich zu werden.