Udostępnij przez


iAuditor (wersja zapoznawcza)

iAuditor to najpopularniejsza na świecie aplikacja do sprawdzania inspekcji. SafetyCulture to system tworzenia kopii zapasowych i zarządzania oparty na chmurze firmy iAuditor. Zarządzaj wszystkimi zespołami inspekcji i analizuj dane zebrane z pola. IAuditor i SafetyCulture zapewniają widoczność w czasie rzeczywistym w całej operacji.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Obsługa interfejsu iAuditor
adres URL https://www.safetyculture.com/contact-us
Email support@safetyculture.com
Metadane łącznika
Publisher SafetyCulture Pty Ltd
Witryna internetowa https://safetyculture.com/
Zasady ochrony prywatności https://safetyculture.com/legal/privacy-policy/
Kategorie Dane; Produktywność

Łącznik iAuditor udostępnia interfejs API do pracy z danymi inspekcji iAuditor.

Wymagania wstępne

Aby użyć tego łącznika, musisz mieć następujące elementy:

Jak uzyskać poświadczenia

Znane problemy i ograniczenia

  • Akcje eksportowania odpowiedzi z pytań wielokrotnego wyboru z włączonym wieloma opcjami nie są obsługiwane.
  • Akcje eksportowania odpowiedzi w sekcjach powtórzeń nie są obsługiwane.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: Wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Token interfejsu API securestring Format danych wejściowych: "Token elementu nośnego <> Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Akcje wyszukiwania

Znajdź powiązane akcje na podstawie ich stanu, priorytetu, przypisań, elementu, inspekcji i nie tylko.

Aktualizowanie akcji

Aktualizowanie istniejącej akcji

Eksportowanie raportu inspekcji

Prześlij żądanie eksportu dla raportu inspekcji w wybranym formacie.

Eksportowanie raportu inspekcji (starsza wersja)

Prześlij żądanie eksportu dla inspekcji do formatu przekazanego jako parametr zapytania.

Generowanie linku do inspekcji [PRZESTARZAŁE]

Wygeneruj link do określonej inspekcji, która zostanie otwarta w pliku iAuditor/SafetyCulture.

Pobieranie linku do raportu internetowego inspekcji

Jeśli link został wcześniej wygenerowany dla tej inspekcji, zostanie zwrócony. W przeciwnym razie zostanie wygenerowany nowy link.

Pobieranie raportu inspekcji (starsza wersja)

Pobierz przesłany wcześniej raport inspekcji.

Przeszukaj zmodyfikowane inspekcje

Pobierz listę inspekcji filtrowanych według dat, szablonu, stanu ukończenia i nie tylko.

Sprawdzanie stanu eksportu inspekcji

Sprawdź stan eksportu inspekcji.

Sprawdź stan przesłanego wcześniej żądania eksportu (starsza wersja)

Sprawdź, czy przesłany wcześniej raport pobierania jest gotowy do pobrania.

Tworzenie akcji

Tworzenie nowej akcji

Ustawianie zarchiwizowanego stanu inspekcji

Wybierz pozycję "Tak", aby zarchiwizować inspekcję i "Nie", aby przywrócić zarchiwizowana inspekcję.

Usuwanie akcji

Usuwanie istniejącej akcji

Uzyskiwanie nośnika inspekcji

Pobieranie pliku multimedialnego z inspekcji

Uzyskiwanie określonej inspekcji

Pobieranie pełnych danych inspekcji.

Wyłączanie linku do raportu internetowego inspekcji

Wyłącz link do raportu internetowego do inspekcji.

Akcje wyszukiwania

Znajdź powiązane akcje na podstawie ich stanu, priorytetu, przypisań, elementu, inspekcji i nie tylko.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikatory inspekcji
audit_id array of string

Co najmniej jeden identyfikator inspekcji do wyszukiwania akcji w ramach.

Identyfikator przypisywania
id string

Identyfikator użytkownika lub adres e-mail (zewnętrzny) użytkownika i osoba przypisana.

Typ
type string

Typ przypisania. "użytkownik" lub "e-mail (zewnętrzny)".

Po dacie
from date-time

Wyszukaj wyniki utworzone po tej dacie i godzinie.

Przed datą
to date-time

Wyszukaj wyniki utworzone przed tą datą i godziną.

Po dacie
from date-time

Wyszukaj wyniki zmodyfikowane po tej dacie i godzinie.

Przed datą
to date-time

Wyszukaj wyniki zmodyfikowane przed tą datą i godziną.

Po dacie
from date-time

Wyszukaj wyniki po tej dacie i godzinie.

Przed datą
to date-time

Wyszukaj wyniki przed tą datą i godziną.

Zwraca

Aktualizowanie akcji

Aktualizowanie istniejącej akcji

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator akcji
actionId True string

Unikatowy identyfikator konkretnej akcji.

Title
title string

Tekst do użycia dla tytułu akcji.

Description
description string

Tekst do użycia w opisie akcji.

Priority
priority string

Priorytet przypisywania akcji: 0=Brak, 10=Niski, 20=Średni, 30=Wysoki.

Status
status string

Stan ustawiany dla akcji: 0=Do wykonania, 10=W toku, 50=Done, 60=Can't Do.

Termin ukończenia o
due_at date-time

Data i godzina ukończenia dla akcji.

Identyfikator przypisywania
id string

Identyfikator użytkownika lub adres e-mail (zewnętrzny) użytkownika i osoba przypisana.

Typ
type string

Typ przypisania. "użytkownik" lub "e-mail (zewnętrzny)".

Zwraca

Body
action

Eksportowanie raportu inspekcji

Prześlij żądanie eksportu dla raportu inspekcji w wybranym formacie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Format eksportu
format string

Format eksportowania raportu inspekcji do.

Identyfikator preferencji
preference_id string

Preferencja raportu, która ma być stosowana do eksportu raportu.

Zwraca

Eksportowanie raportu inspekcji (starsza wersja)

Prześlij żądanie eksportu dla inspekcji do formatu przekazanego jako parametr zapytania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Format
format True string

Format do wygenerowania eksportu.

Timezone
timezone string

Strefa czasowa używana podczas generowania eksportu.

Profil eksportowania
export_profile string

Unikatowy identyfikator profilu eksportu do wygenerowania eksportu za pomocą polecenia .

Zwraca

Generowanie linku do inspekcji [PRZESTARZAŁE]

Wygeneruj link do określonej inspekcji, która zostanie otwarta w pliku iAuditor/SafetyCulture.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Zwraca

Pobieranie linku do raportu internetowego inspekcji

Jeśli link został wcześniej wygenerowany dla tej inspekcji, zostanie zwrócony. W przeciwnym razie zostanie wygenerowany nowy link.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Zwraca

Pobieranie raportu inspekcji (starsza wersja)

Pobierz przesłany wcześniej raport inspekcji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Identyfikator zadania eksportu
exportId True string

Unikatowy identyfikator zadania eksportu.

Nazwa pliku raportu inspekcji
filename True string

Nazwa pliku wygenerowana przez żądanie eksportu.

Zwraca

Raport inspekcji jako plik PDF lub Docx.

Raport inspekcji
binary

Przeszukaj zmodyfikowane inspekcje

Pobierz listę inspekcji filtrowanych według dat, szablonu, stanu ukończenia i nie tylko.

Parametry

Nazwa Klucz Wymagane Typ Opis
Kolejność sortowania
order string

Kolejność daty i godziny, w której zostaną podane wyniki.

Zmodyfikowane po
modified_after date-time

Filtruj, aby uwzględnić wyniki ostatnio zmodyfikowane po tej dacie i godzinie.

Zmodyfikowano przed
modified_before date-time

Filtruj, aby uwzględnić wyniki ostatnio zmodyfikowane przed tą datą i godziną.

Filtruj według szablonu
template string

Filtruj, aby uwzględnić wyniki z określonego szablonu.

Archiwizowane
archived string

Filtruj, aby uwzględnić tylko zarchiwizowane (prawda), niezarchiwizowane (fałsz) lub oba te elementy.

Zakończone
completed string

Filtruj wyniki, aby uwzględnić tylko ukończone, niekompletne lub oba.

Własność
owner string

Pobierz wyniki należące do mnie, udostępnione mi przez innych użytkowników lub wszystkie, do których mam dostęp.

Limit (maksymalnie 1000)
limit integer

Maksymalna liczba wyników do zwrócenia. Skróć cykl i uzyskaj interwały czasu w przeszłości, aby pobrać więcej wyników

Zwraca

Sprawdzanie stanu eksportu inspekcji

Sprawdź stan eksportu inspekcji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Identyfikator zadania eksportu
exportId True string

Unikatowy identyfikator zadania eksportu.

Zwraca

Sprawdź stan przesłanego wcześniej żądania eksportu (starsza wersja)

Sprawdź, czy przesłany wcześniej raport pobierania jest gotowy do pobrania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Identyfikator zadania eksportu
exportId True string

Unikatowy identyfikator zadania eksportu.

Zwraca

Tworzenie akcji

Tworzenie nowej akcji

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
audit_id string

Unikalny identyfer inspekcji.

Identyfikator elementu
item_id string

Unikatowy identyfikator pytania/elementu.

Title
title string

Tekst do użycia dla tytułu akcji.

Description
description string

Tekst do użycia w opisie akcji.

Priority
priority string

Priorytet przypisywania akcji: 0=Brak, 10=Niski, 20=Średni, 30=Wysoki.

Status
status string

Stan ustawiany dla akcji: 0=Do wykonania, 10=W toku, 50=Done, 60=Can't Do.

Termin ukończenia o
due_at date-time

Data i godzina ukończenia dla akcji.

Identyfikator przypisywania
id string

Identyfikator użytkownika lub adres e-mail (zewnętrzny) użytkownika i osoba przypisana.

Typ
type string

Typ przypisania. "użytkownik" lub "e-mail (zewnętrzny)".

Zwraca

Body
action

Ustawianie zarchiwizowanego stanu inspekcji

Wybierz pozycję "Tak", aby zarchiwizować inspekcję i "Nie", aby przywrócić zarchiwizowana inspekcję.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Archiwizowane
archived boolean

Yes/No

Zwraca

Usuwanie akcji

Usuwanie istniejącej akcji

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator akcji
actionId True string

Unikatowy identyfikator konkretnej akcji.

Zwraca

Nazwa Ścieżka Typ Opis
Ok
ok boolean

Ok

Uzyskiwanie nośnika inspekcji

Pobieranie pliku multimedialnego z inspekcji

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

identyfikator nośnika
mediaId True string

Unikatowy identyfikator określonego pliku multimedialnego.

Zwraca

Plik multimedialny z inspekcji

Plik multimedialny
binary

Uzyskiwanie określonej inspekcji

Pobieranie pełnych danych inspekcji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Zwraca

Wyłączanie linku do raportu internetowego inspekcji

Wyłącz link do raportu internetowego do inspekcji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator inspekcji
auditId True string

Unikatowy identyfikator określonej inspekcji.

Definicje

action_id

Unikatowy identyfikator akcji.

Unikatowy identyfikator akcji.

Identyfikator akcji
string

count

Liczba zwróconych akcji.

Liczba zwróconych akcji.

Liczba
number

łączny

Łączna liczba akcji znalezionych w parametrach wyszukiwania.

Łączna liczba akcji znalezionych w parametrach wyszukiwania.

Total
number

przesunąć

Przesunięcie/strona bieżącego zestawu wyników.

Przesunięcie/strona bieżącego zestawu wyników.

Przesunięcie
number

AuditSearchResponse

Nazwa Ścieżka Typ Opis
Liczba
count count

Liczba zwróconych akcji.

Total
total total

Łączna liczba akcji znalezionych w parametrach wyszukiwania.

Inspekcja
audits array of object
Identyfikator inspekcji
audits.audit_id string

Unikatowy identyfikator inspekcji.

Data modyfikacji
audits.modified_at date-time

Data i godzina ostatniej modyfikacji inspekcji w formacie: rrrr-MM-ddTHH:mm:ss.fffZ (czas UTC).

Identyfikator szablonu
audits.template_id string

Unikatowy identyfikator szablonu.

GetAuditLinkResponse

Nazwa Ścieżka Typ Opis
Link inspekcji
url string

Link raportu inspekcji, który można wyświetlić w przeglądarce internetowej.

InitExportResponse

Nazwa Ścieżka Typ Opis
Identyfikator zadania eksportu
id string

Unikatowy identyfikator zadania eksportu.

InitInspectionExportResponse

Nazwa Ścieżka Typ Opis
Identyfikator zadania eksportu
messageId string

Unikatowy identyfikator zadania eksportu.

ExportStatusResponse

Nazwa Ścieżka Typ Opis
Stan eksportu
status string

Bieżący stan żądania eksportu.

Eksportowanie adresu URL
href string

Internetowy adres URL wyeksportowanego pliku raportu inspekcji.

Filename
filename string

Nazwa pliku wyeksportowanego raportu inspekcji.

InspectionExportStatusResponse

Nazwa Ścieżka Typ Opis
Eksportowanie adresu URL
url string

Internetowy adres URL wyeksportowanego pliku raportu inspekcji.

Stan eksportu
status string

Bieżący stan żądania eksportu.

GetAuditByIdResponse

Nazwa Ścieżka Typ Opis
Identyfikator szablonu
template_id string

Unikatowy identyfikator szablonu.

Identyfikator inspekcji
audit_id string

Unikatowy identyfikator inspekcji.

Score
audit_data.score number

Wynik uzyskany w inspekcji.

Łączny wynik
audit_data.total_score number

Łączna ocena inspekcji.

Procent wyników
audit_data.score_percentage float

Wynik inspekcji w procentach.

Tytuł inspekcji
audit_data.name string

Nazwa/tytuł inspekcji.

Czas trwania
audit_data.duration number

Czas trwania inspekcji w sekundach.

Właściciel inspekcji
audit_data.authorship.owner string

Użytkownik, który jest właścicielem inspekcji.

Identyfikator właściciela inspekcji
audit_data.authorship.owner_id string

Identyfikator użytkownika właściciela inspekcji.

Autor inspekcji
audit_data.authorship.author string

Użytkownik, który utworzył inspekcję.

Identyfikator autora inspekcji
audit_data.authorship.author_id string

Identyfikator użytkownika autora inspekcji.

Data ukończenia
audit_data.date_completed date-time

Data i godzina zakończenia inspekcji w formacie: rrrr-MM-ddTHH:mm:ss.fffZ (czas UTC).

Data modyfikacji
audit_data.date_modified date-time

Data i godzina ostatniej modyfikacji inspekcji w formacie: rrrr-MM-ddTHH:mm:ss.ffZ (czas UTC).

Data rozpoczęcia
audit_data.date_started date-time

Data i godzina rozpoczęcia inspekcji w formacie: rrrr-MM-ddTHH:mm:ss.fffZ (czas UTC).

Właściciel szablonu
template_data.authorship.owner string

Użytkownik, który jest właścicielem szablonu.

Identyfikator właściciela szablonu
template_data.authorship.owner_id string

Identyfikator użytkownika właściciela szablonu.

Autor szablonu
template_data.authorship.author string

Użytkownik, który utworzył szablon.

Identyfikator autora szablonu
template_data.authorship.author_id string

Identyfikator użytkownika autora szablonu.

Opis szablonu
template_data.metadata.description string

Opis szablonu.

Nazwa szablonu
template_data.metadata.name string

Nazwa szablonu.

ActionsSearchResponse

Nazwa Ścieżka Typ Opis
Liczba
count count

Liczba zwróconych akcji.

Total
total total

Łączna liczba akcji znalezionych w parametrach wyszukiwania.

Przesunięcie
offset offset

Przesunięcie/strona bieżącego zestawu wyników.

Czynności
actions array of action

Czynności

akcja

Nazwa Ścieżka Typ Opis
Identyfikator akcji
action_id action_id

Unikatowy identyfikator akcji.

Identyfikator inspekcji
audit.audit_id string

Unikatowy identyfikator inspekcji.

Tytuł inspekcji
audit.name string

Nazwa/tytuł inspekcji.

Identyfikator elementu
item.item_id string

Unikatowy identyfikator pytania/elementu.

Etykieta elementu
item.label string

Etykieta pytania/elementu.

Description
description string

Opis akcji.

Title
title string

Tytuł akcji.

Site
site string

Wybrana witryna akcji.

Priority
priority integer

Priorytet akcji: 0=Brak, 10=Niski, 20=Średni, 30=Wysoki.

Status
status integer

Stan akcji: 0 =Do wykonania, 10=W toku, 50=Gotowe, 60=Nie można wykonać.

Cesjonariuszy
assignees array of object

Przypisanie akcji.

Identyfikator przypisywania
assignees.id string

Identyfikator użytkownika lub adres e-mail (zewnętrzny) użytkownika i osoba przypisana.

Nazwa osoby przypisanej
assignees.name string

Nazwa lub adres e-mail przypisywania akcji (zewnętrzny).

Typ
assignees.type string

Typ przypisania. "użytkownik" lub "e-mail (zewnętrzny)".

Identyfikator twórcy
created_by.user_id string

Unikatowy identyfikator użytkownika, który utworzył akcję.

Nazwa twórcy
created_by.name string

Nazwa użytkownika, który utworzył akcję.

Data utworzenia
created_at date-time

Data i godzina utworzenia akcji.

Data modyfikacji
modified_at date-time

Data i godzina ostatniej modyfikacji akcji.

Data upływu
due_at date-time

Data i godzina ukończenia akcji.

Data ukończenia
completed_at date-time

Data i godzina zakończenia akcji.

binarny

Jest to podstawowy typ danych "binary".