Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Smartsheet-Integration
Verwenden Sie den Smartsheet-Aktionsconnector, um Blätter, Zeilen, Berichte und Suchen in Ihren Smartsheet-Arbeitsbereichen direkt in Amazon Quick in natürlicher Sprache zu verwalten. Diese Integration verwendet die Smartsheet-API. Weitere Informationen finden Sie unter Einführung in die Smartsheet-API
Die Einrichtung dieser Integration umfasst zwei Schritte. Zunächst konfigurieren Sie die Anmeldeinformationen in Smartsheet für die von Ihnen gewählte Authentifizierungsmethode. Anschließend erstellen Sie die Integration in Amazon Quick und verbinden sie mit Ihrem Smartsheet-Konto. Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unterAuthentifizierungsmethoden.
Voraussetzungen
Bevor Sie die Integration einrichten, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:
-
Ein Smartsheet-Konto mit einem Business- oder Enterprise-Plan. Kostenlose Konten können keine API-Zugriffstoken generieren oder OAuth-Apps registrieren. Weitere Informationen finden Sie unter Smartsheet-Preise auf der Smartsheet-Website
. -
Der Zugriff auf die Smartsheet Developer Tools ist für Ihr
Konto aktiviert. Um sich zu registrieren, gehen Sie zur Registrierungsseite für Entwicklertools . -
Informationen zu den Abonnementanforderungen finden Sie unterIntegrationen in der Konsole einrichten.
Konfigurieren Sie die Smartsheet-Entwicklertools
Bevor Sie Amazon Quick konfigurieren, richten Sie Anmeldeinformationen in Smartsheet ein. Die Schritte, die Sie ausführen, hängen davon ab, welche Authentifizierungsmethode Sie verwenden möchten. Amazon Quick unterstützt zwei Authentifizierungsmethoden für Smartsheet. Weitere Informationen zu diesen Methoden finden Sie unterAuthentifizierungsmethoden.
-
Benutzerauthentifizierung (OAuth) — Jeder Benutzer meldet sich mit seinem eigenen Smartsheet-Konto an. Aktionen werden mit den Berechtigungen dieses Benutzers ausgeführt. Diese Methode verwendetBenutzerdefinierte OAuth-App. Füllen Sie die folgenden Registrieren Sie die OAuth-Anwendung Abschnitte Registrieren Sie sich für Developer Tools und erstellen Sie ein Entwicklerprofil und aus.
-
Dienstauthentifizierung (API-Schlüssel) — Alle Aktionen werden mit einem einzigen API-Token ausgeführt. Diese Methode verwendetAPI-Schlüsselauthentifizierung. Füllen Sie den folgenden Generieren Sie ein API-Zugriffstoken (nur Dienstauthentifizierung) Abschnitt aus.
Weitere Informationen zu Smartsheet OAuth finden Sie unter OAuth
Registrieren Sie sich für Developer Tools und erstellen Sie ein Entwicklerprofil
-
Gehen Sie zur Registrierungsseite für Entwicklertools
und registrieren Sie das Smartsheet-Konto, das Sie mit Ihren Apps verwenden möchten. Weitere Informationen finden Sie unter Registrierung für Entwickler-Tools in der Smartsheet-API-Dokumentation. -
Nachdem Smartsheet die Entwicklertools aktiviert hat, melden Sie sich bei der Smartsheet-Anwendung an und wählen Sie Ihr Kontosymbol in der unteren linken Ecke und dann Entwicklertools.
-
Wählen Sie Entwicklerprofil erstellen und geben Sie einen Profilnamen ein. Weitere Informationen finden Sie unter Erstellen Sie Ihr Entwicklerprofil
in der Smartsheet-API-Dokumentation.
Tipp
Smartsheet empfiehlt die Verwendung eines speziellen Dienstkontos für OAuth-Apps anstelle eines persönlichen Kontos.
Registrieren Sie die OAuth-Anwendung
-
Wählen Sie in den Smartsheet Developer Tools die Option Neue App erstellen aus.
-
Füllen Sie das Formular aus:
-
App-Name — Ein Name, mit dem Ihre App für Benutzer identifiziert werden kann.
-
App-Beschreibung — Eine kurze Beschreibung der Integration.
-
App-URL — Die URL, mit der Ihre App oder eine Landingpage gestartet wird.
-
App contact/support — Kontaktinformationen für den Support.
-
URL zur App-Weiterleitung —
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback{region}Ersetze es durch deine AWS Region (z. B.us-east-1).
-
-
Wählen Sie Speichern. Smartsheet generiert die App-Client-ID und den App-Secret.
-
Kopieren Sie die Werte Client-ID und Client Secret. Sie benötigen diese, wenn Sie die Integration in Amazon Quick konfigurieren.
Weitere Informationen finden Sie unter Eine App registrieren
Generieren Sie ein API-Zugriffstoken (nur Dienstauthentifizierung)
Wenn Sie die Dienstauthentifizierung anstelle von OAuth verwenden möchten, generieren Sie ein API-Zugriffstoken. Sie benötigen einen Business- oder Enterprise-Plan, um Token generieren zu können. Weitere Informationen finden Sie im Smartsheet-Hilfecenter unter Generieren eines API-Zugriffstokens
-
Wählen Sie in der Smartsheet-Anwendung unten in der linken Navigationsleiste Ihr Konto (Profilbild) und dann Persönliche Einstellungen aus.
-
Wählen Sie die Registerkarte API-Zugriff und wählen Sie Neues Zugriffstoken generieren.
-
Benennen Sie das Token und wählen Sie OK. Kopieren Sie den Token-Wert sofort — dies ist das einzige Mal, dass er sichtbar ist.
Wichtig
Bewahren Sie Ihr Zugriffstoken sicher auf. Jeder, der das Token besitzt, kann auf alle Smartsheet-Daten zugreifen, auf die der Token-Besitzer Zugriff hat. Übergeben Sie Tokens nicht an Versionskontrollsysteme. Bewährte Methoden zum Speichern von Token finden Sie in der Smartsheet-API-Dokumentation unter Authentifizierung
OAuth-Zugriffsbereiche
Wenn Sie die Benutzerauthentifizierung (OAuth) konfigurieren, fordert die Integration die folgenden Zugriffsbereiche von Smartsheet an. Diese Bereiche bestimmen, was die Integration im Namen des authentifizierten Benutzers tun kann. Wenn Sie stattdessen die Dienstauthentifizierung (API-Schlüssel) verwenden, verwendet die Integration die vollen Berechtigungen des Token-Besitzers und Bereiche gelten nicht. Weitere Informationen finden Sie unter Zugriffsbereiche
| Scope | Description |
|---|---|
READ_SHEETS |
Lesen Sie alle Blattdaten, einschließlich Anlagen, Diskussionen und Zellendaten. |
WRITE_SHEETS |
Fügen Sie Blattdaten ein und ändern Sie sie, einschließlich Anlagen, Diskussionen und Zellendaten. |
Anmerkung
Durch Zugriffsbereiche werden bestehende Freigabeberechtigungen nicht außer Kraft gesetzt. Wenn der WRITE_SHEETS Geltungsbereich festgelegt ist, kann die Integration beispielsweise kein Blatt aktualisieren, auf das der Benutzer nur Zugriff auf Betrachterebene hat. Weitere Informationen finden Sie unter Zugriffsebenen für Ressourcen
Richten Sie die Integration in Amazon Quick ein
Nachdem Sie die Konfiguration der Smartsheet Developer Tools abgeschlossen haben, erstellen Sie die Integration in Amazon Quick.
-
Wählen Sie in der Amazon Quick-Konsole Connectors aus.
-
Wählen Sie den Tab „Für Ihr Team erstellen“.
-
Suchen Sie Smartsheet und wählen Sie es aus.
-
Geben Sie die Integrationsdetails ein:
-
Name — Beschreibender Name für Ihre Smartsheet-Integration.
-
Beschreibung (optional) — Zweck der Integration.
-
-
Wählen Sie Ihren Verbindungstyp und geben Sie die Verbindungseinstellungen ein. Weitere Informationen zu diesen Authentifizierungsmethoden finden Sie unterAuthentifizierungsmethoden.
-
Verwenden Sie für die Benutzerauthentifizierung (OAuth) die Client-ID und das Client-Geheimnis aus Ihrer Registrierung der Smartsheet Developer Tools-App. Konfigurieren Sie die folgenden Felder:
-
Basis-URL —
https://api.smartsheet.com/2.0 -
Client-ID — App-Client-ID aus Ihrer Registrierung der Smartsheet Developer Tools App.
-
Kundengeheimnis — Geheime App aus Ihrer Registrierung der Smartsheet Developer Tools-App.
-
Token-URL —
https://api.smartsheet.com/2.0/token -
Authentifizierungs-URL —
https://app.smartsheet.com/b/authorize -
URL umleiten —
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
-
-
Verwenden Sie für die Dienstauthentifizierung (API-Schlüssel) das API-Zugriffstoken aus Ihren persönlichen Smartsheet-Einstellungen. Konfigurieren Sie die folgenden Felder:
-
API-Schlüssel — Das Smartsheet-API-Zugriffstoken, das aus Ihren persönlichen Einstellungen generiert wurde.
-
Basis-URL —
https://api.smartsheet.com/2.0 -
E-Mail — E-Mail-Adresse, die dem Smartsheet-Konto zugeordnet ist, das das Token generiert hat.
-
-
-
Wählen Sie Erstellen und fortfahren.
-
Wählen Sie Benutzer aus, mit denen Sie die Integration teilen möchten.
-
Wählen Sie Weiter aus.
Gehen Sie zur Benutzerauthentifizierung zu Connectors > Ihren Smartsheet-Connectornamen und wählen Sie Anmelden aus, um den OAuth-Autorisierungsablauf abzuschließen. Wählen Sie im Smartsheet-Einwilligungsfenster die Option Zulassen, um Zugriff zu gewähren.
Wichtig
Bei der Dienstauthentifizierung werden alle Aktionen mit den Berechtigungen des Besitzers des API-Tokens ausgeführt. Jeder Amazon Quick-Benutzer mit Zugriff auf diese Integration kann Aktionen für alle Smartsheet-Ressourcen ausführen, auf die der Token-Besitzer zugreifen kann. Richten Sie den Umfang der Token-Berechtigungen entsprechend den Sicherheitsanforderungen Ihres Unternehmens ein.
Anmerkung
Wenn Sie Smartsheet Gov, Smartsheet Regions Europe oder Smartsheet Regions Australien verwenden, verwenden Sie die entsprechende Basis-URL für Ihre Umgebung:
| Umgebung | Basis-URL |
|---|---|
| Smartsheet | https://api.smartsheet.com/2.0 |
| Smartsheet Gov | https://api.smartsheetgov.com/2.0 |
| Smartsheet-Regionen Europa | https://api.smartsheet.eu/2.0 |
| Smartsheet-Regionen Australien | https://api.smartsheet.au/2.0 |
Weitere Informationen finden Sie unter Basis-URL
Verfügbare Aktionen
Nachdem Sie die Integration eingerichtet haben, sind die folgenden Aktionen verfügbar.
| Kategorie | Action | Description |
|---|---|---|
| Suchen | Suche auflisten | Durchsucht alle Blätter, auf die der Benutzer zugreifen kann, nach dem angegebenen Text. |
| Blätter | Listenblätter | Führt alle Blätter auf, auf die der authentifizierte Benutzer zugreifen kann. |
| Blätter | Blatt abrufen | Ruft ein Blatt und seine Daten basierend auf der Blatt-ID ab. |
| Berichte | Berichte auflisten | Listet alle Berichte auf, auf die der Benutzer zugreifen kann. |
| Berichte | Bericht ansehen | Ruft Berichtsdetails basierend auf der Berichts-ID ab. |
Verwaltung und Problembehebung
Informationen zum Bearbeiten, Teilen oder Löschen Ihrer Integration finden Sie unterVerwaltung vorhandener Integrationen.
Probleme bei der Authentifizierung
-
Die OAuth-Autorisierung schlägt fehl — Stellen Sie sicher, dass die Client-ID und der geheime Clientschlüssel mit den Werten in Ihrer Registrierung der Smartsheet Developer Tools-App übereinstimmen. Vergewissern Sie sich, dass die Weiterleitungs-URL in Smartsheet exakt mit der URL in Ihrer Amazon Quick-Konfiguration übereinstimmt. Eine Liste der OAuth-Fehlertypen finden Sie unter OAuth-Fehlertypen
in der Smartsheet-API-Dokumentation. -
Entwicklertools nicht verfügbar — Stellen Sie sicher, dass die Entwicklertools für Ihr Smartsheet-Konto aktiviert sind. Kostenlose Konten unterstützen keine Entwicklertools. Wenn Ihre Anfrage abgelehnt wurde, wenden Sie sich an Ihren Smartsheet Customer Success Manager.
-
API-Schlüsselauthentifizierung schlägt fehl — Stellen Sie sicher, dass das Zugriffstoken nicht gesperrt wurde. Sie können Token in der Smartsheet-Anwendung über Persönliche Einstellungen > API-Zugriff verwalten. Weitere Informationen finden Sie im Smartsheet-Hilfecenter unter Generieren eines API-Zugriffstokens
. -
Zugriffstoken abgelaufen — OAuth-Zugriffstoken laufen nach etwa 7 Tagen ab. Amazon Quick verarbeitet die Token-Aktualisierung automatisch. Wenn Sie auf anhaltende Token-Fehler stoßen, melden Sie sich über die Integrationseinstellungen ab und melden Sie sich erneut an. Weitere Informationen finden Sie unter API-Aufrufe tätigen
in der Smartsheet-API-Dokumentation.
Häufige Fehlermeldungen
-
Aktionen geben Berechtigungsfehler zurück — Stellen Sie sicher, dass der authentifizierte Benutzer über die erforderlichen Freigabeberechtigungen für die Zielblätter verfügt. OAuth-Bereiche setzen die Zugriffskontrollen auf Freigabeebene nicht außer Kraft. Weitere Informationen finden Sie unter Zugriffsebenen für Ressourcen
in der Smartsheet-API-Dokumentation. -
Blatt nicht gefunden — Stellen Sie sicher, dass die Blatt-ID korrekt ist und dass der authentifizierte Benutzer zumindest Viewer-Zugriff auf das Blatt hat.
-
Fehler bei der API-Ratenbegrenzung — Die Smartsheet-API setzt Ratenbegrenzungen durch. Weitere Informationen finden Sie in der Smartsheet-API-Dokumentation unter Einschränkungen
.
