Plumsail HelpDesk
Die API ermöglicht die Interaktion mit dem Plumsail HelpDesk-Ticketing-System. Besuchen Sie https://plumsail.com/docs/help-desk-o365/v1.x/API/ms-flow.html weitere Informationen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Norm | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Plumsail |
| URL | https://plumsail.com/sharepoint-helpdesk |
| support@plumsail.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Plumsail Inc. |
| Webseite | https://plumsail.com |
| Datenschutzrichtlinie | https://plumsail.com/privacy-policy/ |
| Kategorien | Zusammenarbeit; Unternehmensführung |
Dieser Connector hilft Ihnen, Daten in Ihrem HelpDesk mithilfe von Power Automate zu bearbeiten.
Besuchen Sie https://plumsail.com/helpdesk weitere Informationen.
Voraussetzungen
Um mit der Verwendung zu beginnen, müssen Sie die folgenden Voraussetzungen erfüllen:
Nachdem Sie einen API-Schlüssel erstellt haben, können Sie ihren ersten Flow erstellen.
Suchen Sie einfach in Flow nach "Plumsail HelpDesk", und fügen Sie eine entsprechende Aktion hinzu:
Wenn Sie eine Aktion zum ersten Mal hinzufügen, werden Sie nach und nach einer Aktion Access KeygefragtConnection Name. Sie können einen beliebigen Namen für die Verbindung eingeben. Beispiel: Plumsail HelpDesk.
Fügen Sie dann den API-Schlüssel ein, den Sie im ersten Schritt erstellt haben, um eingaben zu Access Key können.
-
Power Automate -Aktionen (Microsoft Flow)
- Tickets abrufen
- Erstellen eines Tickets
- Löschen eines Tickets
- Abrufen eines einzelnen Tickets
- Anlage herunterladen
- Aktualisieren eines Tickets
- Abrufen aller Kommentare für ein Ticket
- Erstellen eines Kommentars
- Abrufen eines einzelnen Kommentars
- Kontakte abrufen
- Erstellen eines Kontakts
- Abrufen eines einzelnen Kontakts per E-Mail
- Aktualisieren eines Kontakts per E-Mail
- Löschen eines Kontakts
- Abrufen eines einzelnen Kontakts nach ID
- Aktualisieren eines Kontakts anhand der ID
- Organisationen abrufen
- Eine Organisation erstellen
- Löschen einer Organisation
- Abrufen einer einzelnen Organisation
- Aktualisieren einer Organisation
- Löschen einer Organisation nach Titel
- Abrufen einer einzelnen Organisation nach Titel
- Aktualisieren einer Organisation nach Titel
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Freigabefähig |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der API-Schlüssel für diese API | Richtig |
| Rechenzentrumsregion | Schnur | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen aller Kommentare für ein Ticket |
Ruft alle Kommentare für ein Ticket mit der angegebenen ID ab. |
| Abrufen einer einzelnen Organisation |
Ruft die Organisation nach ID ab und gibt sie zurück. |
| Abrufen einer einzelnen Organisation nach Titel |
Ruft eine Organisation nach Titel ab und gibt sie zurück. |
| Abrufen eines einzelnen Kommentars |
Ruft einen Kommentar nach ID ab und gibt ihn zurück. |
| Abrufen eines einzelnen Kontakts nach ID |
Ruft einen Kontakt anhand der ID ab und gibt ihn zurück. |
| Abrufen eines einzelnen Kontakts per E-Mail |
Ruft einen Kontakt per E-Mail ab und gibt ihn zurück. |
| Abrufen eines einzelnen Tickets |
Ruft ein Ticket nach ID ab und gibt es zurück. |
| Aktualisieren einer Organisation |
Ruft eine Organisation nach ID ab und gibt sie zurück. |
| Aktualisieren einer Organisation nach Titel |
Ruft eine Organisation nach Titel ab und aktualisiert sie. Gibt aktualisierte Organisation zurück. |
| Aktualisieren eines Kontakts |
Sucht einen Kontakt anhand der ID und aktualisiert ihn. Gibt den aktualisierten Kontakt zurück. |
| Aktualisieren eines Kontakts per E-Mail |
Sucht einen Kontakt per E-Mail und aktualisiert ihn. Gibt den aktualisierten Kontakt zurück. |
| Aktualisieren eines Tickets |
Ruft ein Ticket nach ID ab und aktualisiert es. Gibt das aktualisierte Ticket zurück. |
| Anlage herunterladen |
Gibt die Anlagendatei für ein bestimmtes Ticket anhand des Namens zurück oder gibt Fehlercode zurück. |
| Einen Kontakt erstellen |
Erstellt neuen Kontakt und gibt ihn zurück. |
| Erstellen einer Organisation |
Erstellt ein neues Element in der Liste "Organisationen" und gibt es zurück. |
| Erstellen eines Kommentars |
Erstellt einen neuen Kommentar für ein Ticket mit der angegebenen ID und gibt ihn zurück. |
| Kontakte abrufen |
Kontaktliste abrufen |
| Löschen einer Organisation nach Titel |
Löscht Organisation nach Titel |
| Löschen eines Kontakts |
Löscht Kontakt nach ID |
| Löschen eines Tickets |
Löscht das Ticket nach ID. |
| Organisation löschen |
Löscht die Organisation nach ID. |
| Organisationen abrufen |
Organisationsliste abrufen |
| Ticket erstellen |
Erstellt ein neues Ticket und gibt ein erstelltes Ticket zurück. |
| Tickets abrufen |
Gibt eine Liste der TicketRead-Objekte zurück, jedes TicketRead -Objekt hat die folgenden Felder: Kategorie, Erstellt, TicketID, Status, Antragsteller usw. Überprüfen Sie die TicketRead -Objektdefinition, um weitere Details zu erhalten. |
Abrufen aller Kommentare für ein Ticket
Ruft alle Kommentare für ein Ticket mit der angegebenen ID ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
ticketId | True | integer |
Ticket-ID |
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
|
|
$filter
|
$filter | string |
Eine ODATA-$filter Abfrageoption zum Einschränken der zurückgegebenen Einträge |
|
|
$orderBy
|
$orderBy | string |
Eine ODATA-$orderBy Abfrageoption zum Angeben der Reihenfolge der Einträge. |
Gibt zurück
- response
- array of CommentRead
Abrufen einer einzelnen Organisation
Ruft die Organisation nach ID ab und gibt sie zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Organisations-ID
|
id | True | integer |
Organisations-ID |
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
Gibt zurück
- Body
- OrganizationRead
Abrufen einer einzelnen Organisation nach Titel
Ruft eine Organisation nach Titel ab und gibt sie zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Titel der Organisation
|
title | True | string |
Titel der Organisation |
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
Gibt zurück
- Body
- OrganizationRead
Abrufen eines einzelnen Kommentars
Ruft einen Kommentar nach ID ab und gibt ihn zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
ticketId | True | integer |
Ticket-ID |
|
Kommentar-ID
|
id | True | integer |
Kommentar-ID |
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
Gibt zurück
- Body
- CommentRead
Abrufen eines einzelnen Kontakts nach ID
Ruft einen Kontakt anhand der ID ab und gibt ihn zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kontakt-ID
|
id | True | integer |
Kontakt-ID |
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
Gibt zurück
- Body
- ContactRead
Abrufen eines einzelnen Kontakts per E-Mail
Ruft einen Kontakt per E-Mail ab und gibt ihn zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kontakt-E-Mail
|
True | string |
Kontakt-E-Mail |
|
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
Gibt zurück
- Body
- ContactRead
Abrufen eines einzelnen Tickets
Ruft ein Ticket nach ID ab und gibt es zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
id | True | integer |
Ticket-ID |
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
Gibt zurück
- Body
- TicketRead
Aktualisieren einer Organisation
Ruft eine Organisation nach ID ab und gibt sie zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Organisations-ID
|
id | True | integer |
Organisations-ID |
|
Benutzerdefinierte Organisationsfelder
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
|
Organisationstitel
|
title | True | string |
Gibt zurück
- Body
- OrganizationRead
Aktualisieren einer Organisation nach Titel
Ruft eine Organisation nach Titel ab und aktualisiert sie. Gibt aktualisierte Organisation zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Titel der Organisation
|
title | True | string |
Titel der Organisation |
|
Benutzerdefinierte Organisationsfelder
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
|
Organisationstitel
|
title | True | string |
Gibt zurück
- Body
- OrganizationRead
Aktualisieren eines Kontakts
Sucht einen Kontakt anhand der ID und aktualisiert ihn. Gibt den aktualisierten Kontakt zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kontakt-ID
|
id | True | integer |
Kontakt-ID |
|
Benutzerdefinierte Felder für Kontakt
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
|
Kontakt-E-Mail
|
True | string | ||
|
Alternative E-Mail-Adresse für Kontakt
|
emailAlternate | string | ||
|
Kontaktrolle
|
role | string | ||
|
SpUserId kontaktieren
|
spUserId | integer | ||
|
Kontaktname
|
title | True | string |
Gibt zurück
- Body
- ContactRead
Aktualisieren eines Kontakts per E-Mail
Sucht einen Kontakt per E-Mail und aktualisiert ihn. Gibt den aktualisierten Kontakt zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kontakt-E-Mail
|
True | string |
Kontakt-E-Mail |
|
|
Benutzerdefinierte Felder für Kontakt
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
|
Kontakt-E-Mail
|
True | string | ||
|
Alternative E-Mail-Adresse für Kontakt
|
emailAlternate | string | ||
|
Kontaktrolle
|
role | string | ||
|
SpUserId kontaktieren
|
spUserId | integer | ||
|
Kontaktname
|
title | True | string |
Gibt zurück
- Body
- ContactRead
Aktualisieren eines Tickets
Ruft ein Ticket nach ID ab und aktualisiert es. Gibt das aktualisierte Ticket zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
id | True | integer |
Ticket-ID |
|
Name der Ticketempfänger-E-Mail oder SharePoint-Gruppe
|
assignedToEmail | string | ||
|
AttachmentContent
|
AttachmentContent | True | binary |
Inhalt der Datei |
|
Dateiname der Anlage
|
Name | True | string | |
|
Tickettext
|
body | True | string | |
|
Ticketkategorie
|
category | string | ||
|
Ticket cc-E-Mails
|
ccEmails | array of string | ||
|
Benutzerdefinierte Ticketfelder
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
|
Ticket DueDate
|
dueDate | date-time | ||
|
Ticketpriorität
|
priority | string | ||
|
Ticketanforderungser-E-Mail
|
requesterEmail | True | string | |
|
Ticketstatus
|
status | string | ||
|
Ticketbetreff
|
subject | True | string | |
|
Ticket SupportChannel
|
supportChannel | string | ||
|
Titel von Tickettags
|
tagTitles | array of string |
Gibt zurück
- Body
- TicketRead
Anlage herunterladen
Gibt die Anlagendatei für ein bestimmtes Ticket anhand des Namens zurück oder gibt Fehlercode zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
id | True | integer |
Ticket-ID |
|
Dateiname der Anlage
|
filename | True | string |
Dateiname der Anlage |
Gibt zurück
- Ergebnisdatei
- binary
Einen Kontakt erstellen
Erstellt neuen Kontakt und gibt ihn zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerdefinierte Felder für Kontakt
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
|
Kontakt-E-Mail
|
True | string | ||
|
Alternative E-Mail-Adresse für Kontakt
|
emailAlternate | string | ||
|
Kontaktrolle
|
role | string | ||
|
SpUserId kontaktieren
|
spUserId | integer | ||
|
Kontaktname
|
title | True | string | |
|
Kontakt aktualisieren, falls vorhanden
|
updateIfExists | boolean |
Aktualisieren des Kontakts, wenn er bereits vorhanden ist |
Gibt zurück
- Body
- ContactRead
Erstellen einer Organisation
Erstellt ein neues Element in der Liste "Organisationen" und gibt es zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerdefinierte Organisationsfelder
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
|
Organisationstitel
|
title | True | string |
Gibt zurück
- Body
- OrganizationRead
Erstellen eines Kommentars
Erstellt einen neuen Kommentar für ein Ticket mit der angegebenen ID und gibt ihn zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
AttachmentContent
|
AttachmentContent | True | binary |
Inhalt der Datei |
|
Dateiname der Anlage
|
Name | True | string | |
|
Kommentartext
|
body | True | string | |
|
Benutzerdefinierte Kommentarfelder
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
|
E-Mail-Adresse des Kommentarautors
|
fromEmail | True | string | |
|
Comment MessageId
|
messageId | string | ||
|
Ticket-ID
|
ticketId | True | integer |
Ticket-ID |
Gibt zurück
- Body
- CommentRead
Kontakte abrufen
Kontaktliste abrufen
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. Verwenden Sie $select=PhoneNumber,Titel,E-Mail,ID, um Telefonnummer einzuschließen. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
|
|
$filter
|
$filter | string |
Verwenden Sie die ODATA-$filter Option, um den erforderlichen Kontakt zu finden. Verwenden Sie z. B. $filter=Title eq 'Bill Gates', um die Person nach vollständigem Namen zu finden. Verwenden Sie $filter=substringof('@DOMAIN', E-Mail), um personen mit E-Mail aus Domäne (DOMAIN) zu suchen. |
|
|
$orderBy
|
$orderBy | string |
Eine ODATA-$orderBy Abfrageoption zum Angeben der Reihenfolge der Einträge. |
|
|
$top
|
$top | integer |
Eine ODATA-$top Abfrageoption zum Auswählen der ersten n Elemente des Rückgabesatzes für die Rückgabe (Standard = 50, Maximum = 100). |
|
|
$skiptoken
|
$skiptoken | string |
Eine ODATA-$skiptoken Abfrageoption, um Elemente zu überspringen, bis das angegebene Element erreicht ist und den Rest zurückgibt. |
Gibt zurück
- response
- array of ContactRead
Löschen einer Organisation nach Titel
Löscht Organisation nach Titel
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Titel der Organisation
|
title | True | string |
Titel der Organisation |
Löschen eines Kontakts
Löscht Kontakt nach ID
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kontakt-ID
|
id | True | integer |
Kontakt-ID |
Löschen eines Tickets
Löscht das Ticket nach ID.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
id | True | integer |
Ticket-ID |
Organisation löschen
Löscht die Organisation nach ID.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Organisations-ID
|
id | True | integer |
Organisations-ID |
Organisationen abrufen
Organisationsliste abrufen
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
|
|
$filter
|
$filter | string |
Eine ODATA-$filter Abfrageoption zum Einschränken der zurückgegebenen Einträge |
|
|
$orderBy
|
$orderBy | string |
Eine ODATA-$orderBy Abfrageoption zum Angeben der Reihenfolge der Einträge. |
|
|
$top
|
$top | integer |
Eine ODATA-$top Abfrageoption zum Auswählen der ersten n Elemente des Rückgabesatzes für die Rückgabe (Standard = 50, Maximum = 100). |
|
|
$skiptoken
|
$skiptoken | string |
Eine ODATA-$skiptoken Abfrageoption, um Elemente zu überspringen, bis das angegebene Element erreicht ist und den Rest zurückgibt. |
Gibt zurück
- response
- array of OrganizationRead
Ticket erstellen
Erstellt ein neues Ticket und gibt ein erstelltes Ticket zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name der Ticketempfänger-E-Mail oder SharePoint-Gruppe
|
assignedToEmail | string | ||
|
AttachmentContent
|
AttachmentContent | True | binary |
Inhalt der Datei |
|
Dateiname der Anlage
|
Name | True | string | |
|
Tickettext
|
body | True | string | |
|
Ticketkategorie
|
category | string | ||
|
Ticket cc-E-Mails
|
ccEmails | array of string | ||
|
Benutzerdefinierte Ticketfelder
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
|
Ticket DueDate
|
dueDate | date-time | ||
|
Ticketpriorität
|
priority | string | ||
|
Ticketanforderungser-E-Mail
|
requesterEmail | True | string | |
|
Ticketstatus
|
status | string | ||
|
Ticketbetreff
|
subject | True | string | |
|
Ticket SupportChannel
|
supportChannel | string | ||
|
Titel von Tickettags
|
tagTitles | array of string |
Gibt zurück
- Body
- TicketRead
Tickets abrufen
Gibt eine Liste der TicketRead-Objekte zurück, jedes TicketRead -Objekt hat die folgenden Felder: Kategorie, Erstellt, TicketID, Status, Antragsteller usw. Überprüfen Sie die TicketRead -Objektdefinition, um weitere Details zu erhalten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
$select
|
$select | string |
Eine ODATA-$select Abfrageoption, um anzugeben, welche Felder für ein Listenelement zurückgegeben werden sollen. Sie können * verwenden, um alle verfügbaren Felder zurückzugeben. |
|
|
$expand
|
$expand | string |
Eine ODATA-$expand Abfrageoption, um anzugeben, dass die Anforderung die Werte von Nachschlagevorgängen zurückgibt. |
|
|
$filter
|
$filter | string |
Eine ODATA-$filter Abfrageoption. Verwenden Sie z. B. $filter=Status/Title eq STATUS oder $filter=Status/Title ne STATUS (STATUS kann "Ausstehend", "Neu", "In Bearbeitung", "Gelöst" usw.) verwenden, um Tickets mit einem bestimmten Status zu erhalten, oder $filter=Status/Title ne Gelöst, um aktive Tickets zu erhalten, oder $filter=Created gt '2023-08-18', um Tickets zu erhalten, die nach einem bestimmten Datum erstellt wurden. Verwenden Sie das Feld "Kategorie", um nach Kategorie zu filtern, "AssignedTo/Email", um nach E-Mail zu filtern, "AssignedTo/Title", um nach Namen des Zuweisenden zu filtern. Verwenden Sie $filter=substringof('@DOMAIN', Requester/Email), um personen mit E-Mail aus Domäne (DOMAIN) zu suchen. Überfällige Tickets sind nur aktive Tickets, bei denen DueDate weniger als heute ist. |
|
|
$orderBy
|
$orderBy | string |
Eine ODATA-$orderBy Abfrageoption zum Angeben der Reihenfolge der Einträge. |
|
|
$top
|
$top | integer |
Eine ODATA-$top Abfrageoption zum Auswählen der ersten n Elemente des Rückgabesatzes für die Rückgabe (Standard = 50, Maximum = 100). |
|
|
$skiptoken
|
$skiptoken | string |
Eine ODATA-$skiptoken Abfrageoption, um Elemente zu überspringen, bis das angegebene Element erreicht ist und den Rest zurückgibt. |
Gibt zurück
- response
- array of TicketRead
Definitionen
Zugewiesene Person
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Assignee CustomFields
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
Assignee Email
|
string | ||
|
Alternative E-Mail-Adresse des Zuweisens
|
emailAlternate | string | |
|
Assignee-ID
|
id | integer | |
|
Rolle "Assignee"
|
role | string | |
|
Assignee SPUserId
|
spUserId | integer | |
|
Zuweisen des vollständigen Namens
|
title | string |
Cc
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Cc CustomFields
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
Cc-E-Mail
|
string | ||
|
Alternative Cc-E-Mail
|
emailAlternate | string | |
|
Cc-ID
|
id | integer | |
|
Cc-Rolle
|
role | string | |
|
Cc SPUserId
|
spUserId | integer | |
|
Cc Vollständiger Name
|
title | string |
CommentRead
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Kommentartext
|
body | string | |
|
Erstellungsdatum des Kommentars
|
created | date-time | |
|
Benutzerdefinierte Kommentarfelder
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
E-Mail-Adresse des Kommentarautors
|
fromEmail | string | |
|
Name des Kommentarautors
|
fromName | string | |
|
Kommentar-ID
|
id | integer | |
|
Comment MessageId
|
messageId | string |
ContactRead
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzerdefinierte Felder für Kontakt
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
Kontakt-E-Mail
|
string | ||
|
Alternative E-Mail-Adresse für Kontakt
|
emailAlternate | string | |
|
Kontakt-ID
|
id | integer | |
|
Kontaktrolle
|
role | string | |
|
SpUserId kontaktieren
|
spUserId | integer | |
|
Vollständiger Name des Kontakts
|
title | string |
OrganizationRead
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzerdefinierte Organisationsfelder
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
Organisations-ID
|
id | integer | |
|
Organisationstitel
|
title | string |
Antragsteller
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Requester CustomFields
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
E-Mail-Adresse des Antragstellers
|
string | ||
|
Alternative E-Mail-Adresse des Antragstellers
|
emailAlternate | string | |
|
Anforderungs-ID
|
id | integer | |
|
Anforderungsrolle
|
role | string | |
|
Requester SPUserId
|
spUserId | integer | |
|
Vollständiger Name des Antragstellers
|
title | string |
TagRead
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzerdefinierte Felder markieren
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
Tag-ID
|
id | integer | |
|
Tagtitel
|
title | string |
TicketRead
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Ticket Assignee
|
assignedTo | Assignee | |
|
Ticketanlagen
|
attachments | array of string | |
|
Ticketkategorie
|
category | string | |
|
Ticket Cc
|
cc | array of Cc | |
|
Erstellungsdatum des Tickets
|
created | date-time | |
|
Benutzerdefinierte Ticketfelder
|
customFields | object |
JSON-Zeichenfolge mit benutzerdefinierten Feldwerten |
|
Fälligkeitsdatum des Tickets
|
dueDate | date-time | |
|
Ticket-ID
|
id | integer | |
|
Ticketpriorität
|
priority | string | |
|
Ticketantrager
|
requester | Requester | |
|
Ticketauflösungsdatum
|
resolutionDate | date-time | |
|
Ticketstatus
|
status | string | |
|
Ticketbetreff
|
subject | string | |
|
Tickettags
|
tags | array of TagRead | |
|
Benutzerdefinierte Ticket-ID
|
ticketID | string |
binär
Dies ist der grundlegende Datentyp "binary".