Freigeben über


iAuditor (Vorschau)

iAuditor ist die beliebteste Prüflisten-App der Welt. SafetyCulture ist das cloudbasierte Backup- und Management-System von iAuditor. Verwalten Sie alle Ihre Inspektionsteams, und analysieren Sie die aus dem Feld gesammelten Daten. iAuditor und SafetyCulture bieten Ihnen Echtzeitsicht über ihren gesamten Betrieb hinweg.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - 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 Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name iAuditor-Support
URL https://www.safetyculture.com/contact-us
Email support@safetyculture.com
Connectormetadaten
Herausgeber SafetyCulture Pty Ltd
Webseite https://safetyculture.com/
Datenschutzrichtlinie https://safetyculture.com/legal/privacy-policy/
Kategorien Daten; Produktivität

Der iAuditor Connector stellt eine API für die Arbeit mit iAuditor-Inspektionsdaten bereit.

Voraussetzungen

Um diesen Connector zu verwenden, müssen Sie folgendes haben:

So erhalten Sie Anmeldeinformationen

Bekannte Probleme und Einschränkungen

  • Aktionen zum Exportieren von Antworten aus Mehrfachauswahlfragen mit aktivierter Mehrfachauswahl werden nicht unterstützt.
  • Aktionen zum Exportieren von Antworten in Wiederholten Abschnitten werden nicht unterstützt.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
API-Token securestring Eingabeformat: 'Bearer-Token <> Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen einer bestimmten Inspektion

Rufen Sie die vollständigen Daten einer Inspektion ab.

Abrufen eines Inspektionsmediums

Abrufen einer Mediendatei aus einer Inspektion

Abrufen eines Webberichtslinks für Inspektionen

Wenn für diese Inspektion zuvor ein Link generiert wurde, wird er zurückgegeben. Andernfalls wird ein neuer Link generiert.

Aktualisieren einer Aktion

Aktualisieren einer vorhandenen Aktion

Deaktivieren eines Überprüfungswebberichtslinks

Deaktivieren Sie den Webberichtslink zu einer Inspektion.

Erstellen von Aktionen

Erstellen einer neuen Aktion

Exportieren eines Inspektionsberichts

Senden Sie eine Exportanforderung für einen Inspektionsbericht im ausgewählten Format.

Exportieren eines Überwachungsberichts (Legacy)

Senden Sie eine Exportanforderung für eine Überwachung an das als Abfrageparameter übergebene Format.

Festlegen des archivierten Zustands einer Inspektion

Wählen Sie "Ja" aus, um die Inspektion und "Nein" zu archivieren, um die archivierte Inspektion wiederherzustellen.

Generieren eines Links zu einer Inspektion [VERALTET]

Generieren Sie einen Link zu einer bestimmten Inspektion, die in iAuditor/SafetyCulture geöffnet wird.

Geänderte Überprüfungen durchsuchen

Rufen Sie die Liste der Inspektionen ab, die nach Datumsangaben, Vorlage, Abschlussstatus und mehr gefiltert wurden.

Herunterladen eines Überwachungsberichts (Legacy)

Laden Sie den zuvor übermittelten Überwachungsbericht herunter.

Löschen einer Aktion

Löschen einer vorhandenen Aktion

Suchaktionen

Suchen Sie Aktionen im Zusammenhang mit ihrem Status, ihrer Priorität, den Zugewiesenen, dem Element, der Inspektion und mehr.

Überprüfen des Exportstatus der Inspektion

Überprüfen Sie den Exportstatus der Inspektion.

Überprüfen des Status der zuvor übermittelten Exportanforderung (Legacy)

Überprüfen Sie, ob der zuvor übermittelte Downloadbericht zum Download bereit ist.

Abrufen einer bestimmten Inspektion

Rufen Sie die vollständigen Daten einer Inspektion ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Gibt zurück

Abrufen eines Inspektionsmediums

Abrufen einer Mediendatei aus einer Inspektion

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Medien-ID
mediaId True string

Der eindeutige Bezeichner einer bestimmten Mediendatei.

Gibt zurück

Die Mediendatei aus einer Inspektion

Mediendatei
binary

Wenn für diese Inspektion zuvor ein Link generiert wurde, wird er zurückgegeben. Andernfalls wird ein neuer Link generiert.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Gibt zurück

Aktualisieren einer Aktion

Aktualisieren einer vorhandenen Aktion

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aktions-ID
actionId True string

Der eindeutige Bezeichner einer bestimmten Aktion.

Title
title string

Der Text, der für den Aktionstitel verwendet werden soll.

Description
description string

Der Text, der für die Aktionsbeschreibung verwendet werden soll.

Priority
priority string

Die Priorität, die für die Aktion zugewiesen werden soll: 0=Keine, 10=Niedrig, 20=Mittel, 30=Hoch.

Der Status
status string

Der status, der für die Aktion festgelegt werden soll: 0=Aufgaben, 10=In Bearbeitung, 50=Fertig, 60=Nicht möglich.

Fällig bei
due_at date-time

Das Fälligkeitsdatum und die für die Aktion festzulegende Uhrzeit.

Assignee-ID
id string

Die Benutzer-ID oder E-Mail des Verwalters (extern).

Typ
type string

Der Typ des Zugewiesenen. Entweder "Benutzer" oder "E-Mail (extern)".

Gibt zurück

Body
action

Deaktivieren Sie den Webberichtslink zu einer Inspektion.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Erstellen von Aktionen

Erstellen einer neuen Aktion

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
audit_id string

Der eindeutige Identifer der Inspektion.

Artikel-ID
item_id string

Der eindeutige Bezeichner der Frage/des Elements.

Title
title string

Der Text, der für den Aktionstitel verwendet werden soll.

Description
description string

Der Text, der für die Aktionsbeschreibung verwendet werden soll.

Priority
priority string

Die Priorität, die für die Aktion zugewiesen werden soll: 0=Keine, 10=Niedrig, 20=Mittel, 30=Hoch.

Der Status
status string

Der status, der für die Aktion festgelegt werden soll: 0=Aufgaben, 10=In Bearbeitung, 50=Fertig, 60=Nicht möglich.

Fällig bei
due_at date-time

Das Fälligkeitsdatum und die für die Aktion festzulegende Uhrzeit.

Assignee-ID
id string

Die Benutzer-ID oder E-Mail des Verwalters (extern).

Typ
type string

Der Typ des Zugewiesenen. Entweder "Benutzer" oder "E-Mail (extern)".

Gibt zurück

Body
action

Exportieren eines Inspektionsberichts

Senden Sie eine Exportanforderung für einen Inspektionsbericht im ausgewählten Format.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Exportformat
format string

Das Format, in das ein Inspektionsbericht exportiert werden soll.

Einstellungs-ID
preference_id string

Die Berichtseinstellung, die auf den Berichtsexport angewendet werden soll.

Gibt zurück

Exportieren eines Überwachungsberichts (Legacy)

Senden Sie eine Exportanforderung für eine Überwachung an das als Abfrageparameter übergebene Format.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Format
format True string

Das Format, in das ein Export generiert werden soll.

Timezone
timezone string

Die Zeitzone, die beim Generieren eines Exports verwendet werden soll.

Exportprofil
export_profile string

Der eindeutige Bezeichner des Exportprofils, mit dem ein Export generiert werden soll.

Gibt zurück

Festlegen des archivierten Zustands einer Inspektion

Wählen Sie "Ja" aus, um die Inspektion und "Nein" zu archivieren, um die archivierte Inspektion wiederherzustellen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Archived
archived boolean

Ja/Nein

Gibt zurück

Generieren Sie einen Link zu einer bestimmten Inspektion, die in iAuditor/SafetyCulture geöffnet wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Gibt zurück

Geänderte Überprüfungen durchsuchen

Rufen Sie die Liste der Inspektionen ab, die nach Datumsangaben, Vorlage, Abschlussstatus und mehr gefiltert wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Sortierreihenfolge
order string

Die Datums- und Uhrzeitreihenfolge, in der die Ergebnisse angegeben werden.

Geändert nach
modified_after date-time

Filtern, um Ergebnisse einzuschließen, die nach diesem Datum und dieser Uhrzeit zuletzt geändert wurden.

Geändert vor
modified_before date-time

Filtern, um Ergebnisse einzuschließen, die zuletzt vor diesem Datum und dieser Uhrzeit geändert wurden.

Nach Vorlage filtern
template string

Filtern, um Ergebnisse aus einer bestimmten Vorlage einzuschließen.

Archived
archived string

Filter, um nur archiviert (true), nicht archiviert (false) oder beides einzuschließen.

Abgeschlossen
completed string

Filtern Sie Ergebnisse, um nur vollständig, unvollständig oder beides einzuschließen.

Besitz
owner string

Rufen Sie Ergebnisse im Besitz von mir ab, die von anderen Benutzern für mich freigegeben wurden, oder alle, auf die ich Zugriff habe.

Limit (Max. 1000)
limit integer

Maximale Anzahl der zurückzugebenden Ergebnisse. Kürzen Sie Ihre Serie und erhalten Sie vergangene Zeitintervalle, um weitere Ergebnisse abzurufen.

Gibt zurück

Herunterladen eines Überwachungsberichts (Legacy)

Laden Sie den zuvor übermittelten Überwachungsbericht herunter.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Vorgangs-ID exportieren
exportId True string

Der eindeutige Bezeichner einer Exportaufgabe.

Dateiname des Inspektionsberichts
filename True string

Der von einer Exportanforderung generierte Dateiname.

Gibt zurück

Überwachungsbericht als PDF- oder Docx-Datei.

Prüfbericht
binary

Löschen einer Aktion

Löschen einer vorhandenen Aktion

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aktions-ID
actionId True string

Der eindeutige Bezeichner einer bestimmten Aktion.

Gibt zurück

Name Pfad Typ Beschreibung
Okay
ok boolean

Okay

Suchaktionen

Suchen Sie Aktionen im Zusammenhang mit ihrem Status, ihrer Priorität, den Zugewiesenen, dem Element, der Inspektion und mehr.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID(n)
audit_id array of string

Mindestens eine Überwachungs-IDs, die nach Aktionen gesucht werden sollen.

Assignee-ID
id string

Die Benutzer-ID oder E-Mail des Verwalters (extern).

Typ
type string

Der Typ des Zugewiesenen. Entweder "Benutzer" oder "E-Mail (extern)".

Nach Datum
from date-time

Suchen Sie nach Ergebnissen, die nach diesem Datum und dieser Uhrzeit erstellt wurden.

Vor Dem Datum
to date-time

Suchen Sie nach Ergebnissen, die vor diesem Datum und dieser Uhrzeit erstellt wurden.

Nach Datum
from date-time

Suchen Sie nach Ergebnissen, die nach diesem Datum und dieser Uhrzeit geändert wurden.

Vor Dem Datum
to date-time

Suchen Sie nach Ergebnissen, die vor diesem Datum und dieser Uhrzeit geändert wurden.

Nach Datum
from date-time

Suchen Sie nach Ergebnissen, die nach diesem Datum und dieser Uhrzeit fällig sind.

Vor Dem Datum
to date-time

Suchen Sie nach Ergebnissen, die vor diesem Datum und dieser Uhrzeit fällig sind.

Gibt zurück

Überprüfen des Exportstatus der Inspektion

Überprüfen Sie den Exportstatus der Inspektion.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Vorgangs-ID exportieren
exportId True string

Der eindeutige Bezeichner einer Exportaufgabe.

Gibt zurück

Überprüfen des Status der zuvor übermittelten Exportanforderung (Legacy)

Überprüfen Sie, ob der zuvor übermittelte Downloadbericht zum Download bereit ist.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Überwachungs-ID
auditId True string

Der eindeutige Bezeichner einer bestimmten Inspektion.

Vorgangs-ID exportieren
exportId True string

Der eindeutige Bezeichner einer Exportaufgabe.

Gibt zurück

Definitionen

action_id

Der eindeutige Bezeichner der Aktion.

Der eindeutige Bezeichner der Aktion.

Aktions-ID
string

count

Die Anzahl der zurückgegebenen Aktionen.

Die Anzahl der zurückgegebenen Aktionen.

Anzahl
number

gesamt

Die Gesamtanzahl der In den Suchparametern gefundenen Aktionen.

Die Gesamtanzahl der In den Suchparametern gefundenen Aktionen.

Total
number

offset

Der Offset/die Seite der aktuellen Ergebnismenge.

Der Offset/die Seite der aktuellen Ergebnismenge.

Offset
number

AuditSearchResponse

Name Pfad Typ Beschreibung
Anzahl
count count

Die Anzahl der zurückgegebenen Aktionen.

Total
total total

Die Gesamtanzahl der In den Suchparametern gefundenen Aktionen.

Inspektion
audits array of object
Überwachungs-ID
audits.audit_id string

Der eindeutige Bezeichner der Inspektion.

Änderungsdatum
audits.modified_at date-time

Datum und Uhrzeit der letzten Änderung der Inspektion im Format: jjjj-MM-ddTHH:mm:ss.fffZ (UTC-Zeit).

Vorlagen-ID
audits.template_id string

Der eindeutige Bezeichner der Vorlage.

GetAuditLinkResponse

Name Pfad Typ Beschreibung
Inspektionslink
url string

Der Link "Inspektionsbericht", der über einen Webbrowser angezeigt werden kann.

InitExportResponse

Name Pfad Typ Beschreibung
Vorgangs-ID exportieren
id string

Der eindeutige Bezeichner der Exportaufgabe.

InitInspectionExportResponse

Name Pfad Typ Beschreibung
Vorgangs-ID exportieren
messageId string

Der eindeutige Bezeichner der Exportaufgabe.

ExportStatusResponse

Name Pfad Typ Beschreibung
Exportstatus
status string

Der aktuelle Status der Exportanforderung.

Export-URL
href string

Die Web-URL zur exportierten Prüfberichtsdatei.

Dateiname
filename string

Der Dateiname des exportierten Inspektionsberichts.

InspectionExportStatusResponse

Name Pfad Typ Beschreibung
Export-URL
url string

Die Web-URL zur exportierten Prüfberichtsdatei.

Exportstatus
status string

Der aktuelle Status der Exportanforderung.

GetAuditByIdResponse

Name Pfad Typ Beschreibung
Vorlagen-ID
template_id string

Der eindeutige Bezeichner der Vorlage.

Überwachungs-ID
audit_id string

Der eindeutige Bezeichner der Inspektion.

Score
audit_data.score number

Die in der Inspektion erzielte Bewertung.

Gesamtergebnis
audit_data.total_score number

Die Gesamtbewertung der Inspektion.

Bewertungsprozentsatz
audit_data.score_percentage float

Die Bewertung der Prüfung in Prozent.

Inspektionstitel
audit_data.name string

Der Name/Titel der Inspektion.

Dauer
audit_data.duration number

Die Dauer der Inspektion in Sekunden.

Inspektionsbesitzer
audit_data.authorship.owner string

Der Benutzer, der die Inspektion besitzt.

Id des Inspektionsbesitzers
audit_data.authorship.owner_id string

Die Benutzer-ID des Inspektionsbesitzers.

Prüfautor
audit_data.authorship.author string

Der Benutzer, der die Inspektion erstellt hat.

Id des Prüfautors
audit_data.authorship.author_id string

Die Benutzer-ID des Prüfautors.

Datum der Fertigstellung
audit_data.date_completed date-time

Datum und Uhrzeit der Inspektion im Format: yyyy-MM-ddTHH:mm:ss.fffZ (UTC-Zeit).

Änderungsdatum
audit_data.date_modified date-time

Datum und Uhrzeit der letzten Änderung der Inspektion im Format: jjjj-MM-ddTHH:mm:ss.ffZ (UTC-Zeit).

Startdatum
audit_data.date_started date-time

Datum und Uhrzeit des Inspektionsbeginns im Format: jjjj-MM-ddTHH:mm:ss.fffZ (UTC-Zeit).

Vorlagenbesitzer
template_data.authorship.owner string

Der Benutzer, der die Vorlage besitzt.

Vorlagenbesitzer-ID
template_data.authorship.owner_id string

Die Benutzer-ID des Vorlagenbesitzers.

Vorlagenautor
template_data.authorship.author string

Der Benutzer, der die Vorlage erstellt hat.

Vorlagenautor-ID
template_data.authorship.author_id string

Die Benutzer-ID des Vorlagenautors.

Vorlagenbeschreibung
template_data.metadata.description string

Die Beschreibung der Vorlage.

Vorlagenname
template_data.metadata.name string

Der Name der Vorlage.

ActionsSearchResponse

Name Pfad Typ Beschreibung
Anzahl
count count

Die Anzahl der zurückgegebenen Aktionen.

Total
total total

Die Gesamtanzahl der In den Suchparametern gefundenen Aktionen.

Offset
offset offset

Der Offset/die Seite der aktuellen Ergebnismenge.

Aktionen
actions array of action

Aktionen

Handlung

Name Pfad Typ Beschreibung
Aktions-ID
action_id action_id

Der eindeutige Bezeichner der Aktion.

Überwachungs-ID
audit.audit_id string

Der eindeutige Bezeichner der Inspektion.

Inspektionstitel
audit.name string

Der Name/Titel der Inspektion.

Artikel-ID
item.item_id string

Der eindeutige Bezeichner der Frage/des Elements.

Elementbezeichnung
item.label string

Die Bezeichnung des Frage-/Elements.

Description
description string

Die Beschreibung der Aktion.

Title
title string

Der Titel der Aktion.

Site
site string

Die ausgewählte Website der Aktion.

Priority
priority integer

Die Priorität der Aktion: 0=Keine, 10=Niedrig, 20=Mittel, 30=Hoch.

Der Status
status integer

Der Status der Aktion: 0=Aufgaben, 10=In Bearbeitung, 50=Fertig, 60=Nicht möglich.

Bearbeiter
assignees array of object

Die Zuweisungen der Aktion.

Assignee-ID
assignees.id string

Die Benutzer-ID oder E-Mail des Verwalters (extern).

Assignee Name
assignees.name string

Der Name oder die E-Mail des Aktionsempfängers (extern).

Typ
assignees.type string

Der Typ des Zugewiesenen. Entweder "Benutzer" oder "E-Mail (extern)".

Creator-ID
created_by.user_id string

Der eindeutige Bezeichner des Benutzers, der die Aktion erstellt hat.

Erstellername
created_by.name string

Der Name des Benutzers, der die Aktion erstellt hat.

Erstellungsdatum
created_at date-time

Das Datum und die Uhrzeit der Erstellung der Aktion.

Änderungsdatum
modified_at date-time

Datum und Uhrzeit der letzten Änderung der Aktion.

Fälligkeitsdatum
due_at date-time

Das Datum und die Uhrzeit, zu dem die Aktion fällig war.

Abschlussdatum
completed_at date-time

Das Datum und die Uhrzeit, zu dem die Aktion abgeschlossen wurde.

binär

Dies ist der grundlegende Datentyp "binary".