Udostępnij przez


Żniwa

Harvest to proste narzędzie ułatwiające śledzenie czasu spędzonego przez zespół w każdym projekcie i zadaniu.

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 Microsoft
adres URL Obsługa usługi Microsoft LogicApps
Pomoc techniczna usługi Microsoft Power Automate
Obsługa usługi Microsoft Power Apps
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://www.getharvest.com/
Zasady ochrony prywatności https://www.getharvest.com/privacy-policy

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund
Częstotliwość sond wyzwalacza 1 60 sekund

Akcje

Aktualizowanie wpisu czasu

Zaktualizuj istniejący wpis czasu.

Dodawanie nowego klienta

Utwórz nowego klienta.

Dodawanie nowego kontaktu

Utwórz nowy kontakt.

Dodawanie nowego użytkownika

Utwórz nowego użytkownika.

Dodawanie użytkownika do projektu

Dodaj istniejącego użytkownika do projektu.

Lista projektów

Wyświetla listę wszystkich projektów dla bieżącego użytkownika.

Tworzenie wpisu czasu

Utwórz nowy wpis czasu.

Usuwanie wpisu czasu

Usuń istniejący wpis czasu.

Uzyskiwanie informacji o użytkowniku

Pobierz szczegóły użytkownika według identyfikatora użytkownika lub wiadomości e-mail.

Uzyskiwanie wpisu czasu według identyfikatora

Pobierz istniejący wpis czasu według identyfikatora.

Wyświetl listę wszystkich kontaktów

Pobiera listę wszystkich kontaktów dla uwierzytelnionego użytkownika.

Wyświetlanie listy wszystkich klientów

Pobiera listę wszystkich klientów dla uwierzytelnionego konta.

Wyświetlanie listy zadań

Pobiera listę wszystkich zadań.

Aktualizowanie wpisu czasu

Zaktualizuj istniejący wpis czasu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wpisu czasu
DAY_ENTRY_ID True string

Identyfikator wpisu czasu

Identyfikator projektu
project_id True string

Projekt

Identyfikator zadania
task_id True string

Zadanie

Notatki
notes string
Data rozpoczęcia
started_at string

RRRR-MM-DDThh:mm:ssZ (format UTC).

Data/godzina zakończenia
ended_at string

RRRR-MM-DDThh:mm:ssZ (format UTC).

Date
spent_at string

RRRR-MM-DDThh:mm:ssZ (format UTC).

Zwraca

Dodawanie nowego klienta

Utwórz nowego klienta.

Parametry

Nazwa Klucz Wymagane Typ Opis
Name
name True string

Nazwa klienta

Waluta
currency string

Waluta, której chcesz użyć dla klienta.

Symbol waluty
currency_symbol string

Symbol skorelowany z wybraną walutą.

Szczegóły
details string

Dodatkowe szczegóły, zwykle używane na potrzeby informacji o adresach.

Dodawanie nowego kontaktu

Utwórz nowy kontakt.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator klienta
client_id True integer

Unikatowy identyfikator klienta.

Imię
first_name True string

Imię kontaktu.

Nazwisko
last_name True string

Nazwisko kontaktu.

Email
email string

Adres e-mail osoby kontaktowej.

Telefon biurowy
phone_office string

Kontaktowy telefon biurowy.

Telefon komórkowy
phone_mobile string

Telefon komórkowy kontaktu.

Faks
fax string

Faks kontaktu.

Title
title string

Tytuł kontaktu.

Dodawanie nowego użytkownika

Utwórz nowego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Email
email True string
Jest administratorem
is_admin boolean
Imię
first_name True string
Nazwisko
last_name True string
Czy wykonawca
is_contractor boolean
Telefon
telephone string
Stawka godzinowa
default_hourly_rate float

Domyślna stawka godzinowa.

Dział
department string
Stawka kosztów
cost_rate float

Dodawanie użytkownika do projektu

Dodaj istniejącego użytkownika do projektu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator projektu
project_id True string

Identyfikator projektu

Identyfikator użytkownika
id True integer

User

Lista projektów

Wyświetla listę wszystkich projektów dla bieżącego użytkownika.

Zwraca

Tworzenie wpisu czasu

Utwórz nowy wpis czasu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Notatki
notes string
Godzin
hours integer
Identyfikator projektu
project_id True string

Projekt

Identyfikator zadania
task_id True string

Zadanie

Date
spent_at string

Spędzone w

Zwraca

Usuwanie wpisu czasu

Usuń istniejący wpis czasu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wpisu czasu
DAY_ENTRY_ID True string

Identyfikator wpisu czasu

Uzyskiwanie informacji o użytkowniku

Pobierz szczegóły użytkownika według identyfikatora użytkownika lub wiadomości e-mail.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator użytkownika lub adres e-mail
USERID True string

Identyfikator użytkownika lub adres e-mail

Zwraca

Uzyskiwanie wpisu czasu według identyfikatora

Pobierz istniejący wpis czasu według identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wpisu czasu
DAY_ENTRY_ID True string

Identyfikator wpisu czasu

Zwraca

Wyświetl listę wszystkich kontaktów

Pobiera listę wszystkich kontaktów dla uwierzytelnionego użytkownika.

Zwraca

Wyświetlanie listy wszystkich klientów

Pobiera listę wszystkich klientów dla uwierzytelnionego konta.

Zwraca

Wyświetlanie listy zadań

Pobiera listę wszystkich zadań.

Zwraca

Przedmioty
ListTasks_Response

Wyzwalacze

Po dodaniu klienta

Wyzwala po dodaniu nowego klienta.

Po dodaniu kontaktu

Wyzwala po dodaniu nowego kontaktu.

Po dodaniu użytkownika

Wyzwala po dodaniu nowego użytkownika.

Po utworzeniu projektu

Wyzwala po utworzeniu nowego projektu.

Po utworzeniu wpisu czasu dla bieżącego dnia

Wyzwala wyzwalane po utworzeniu nowego wpisu czasowego dla bieżącego dnia.

Po utworzeniu wpisu godziny dla daty

Wyzwala, gdy zostanie utworzony nowy wpis godziny dla określonej daty.

Po dodaniu klienta

Wyzwala po dodaniu nowego klienta.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator klienta
client.id integer

Unikatowy identyfikator klienta.

Name
client.name string

Nazwa klienta.

Waluta
client.currency string

Waluta do użycia na potrzeby rozliczeń klientów.

Zaktualizowano datę i godzinę
client.updated_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Utworzono datę i godzinę
client.created_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Address
client.address string

Adres klienta.

Symbol waluty
client.currency_symbol string

Symbol skorelowany z wybraną walutą.

Szczegóły
client.details string

Dodatkowe szczegóły, zwykle używane na potrzeby informacji o adresach.

Po dodaniu kontaktu

Wyzwala po dodaniu nowego kontaktu.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator kontaktu
contact.id integer

Unikatowy identyfikator kontaktu.

Identyfikator klienta
contact.client_id integer

Unikatowy identyfikator klienta.

Imię
contact.first_name string

Imię kontaktu.

Nazwisko
contact.last_name string

Nazwisko kontaktu.

Email
contact.email string

Adres e-mail osoby kontaktowej.

Telefon biurowy
contact.phone_office string

Kontaktowy telefon biurowy.

Telefon komórkowy
contact.phone_mobile string

Telefon komórkowy kontaktu.

Faks
contact.fax string

Faks kontaktu.

Title
contact.title string

Tytuł kontaktu.

Utworzono datę i godzinę
contact.created_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Zaktualizowano datę i godzinę
contact.updated_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Po dodaniu użytkownika

Wyzwala po dodaniu nowego użytkownika.

Zwraca

Po utworzeniu projektu

Wyzwala po utworzeniu nowego projektu.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator projektu
project.id integer

Unikatowy identyfikator projektu.

Identyfikator klienta
project.client_id integer

Identyfikator klienta dla projektu.

Name
project.name string

Nazwa projektu.

Code
project.code string

Kod projektu.

Jest aktywny
project.active boolean

Wartość True, jeśli projekt jest obecnie aktywny.

Jest rozliczany
project.billable boolean

Wartość true, jeśli projekt jest rozliczany.

Rachunek według
project.bill_by string

Metoda, za pomocą której projekt jest fakturowany.

Stawka godzinowa
project.hourly_rate float

Stawka rozliczeniowa według godziny.

Budżet
project.budget float

Wartość budżetu dla projektu.

Budżet według
project.budget_by string

Metoda budżetowania projektu.

Utworzono datę i godzinę
project.created_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Zaktualizowano datę i godzinę
project.updated_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Data rozpoczęcia
project.starts_on string

RRRR —MM-DD

Data zakończenia
project.ends_on string

RRRR —MM-DD

Szacowanie
project.estimate float

Szacowanie projektu.

Szacowane przez
project.estimate_by string

Metoda szacowania projektu.

Najwcześniejsza data rekordu
project.hint_earliest_record_at string

RRRR —MM-DD

Data ostatniego rekordu
project.hint_latest_record_at string

RRRR —MM-DD

Notatki
project.notes string

Uwagi dotyczące projektu.

Budżet kosztów
project.cost_budget float

Wartość budżetowa dla projektów Total Project Opłaty.

Budżet kosztów obejmuje wydatki
project.cost_budget_include_expenses boolean

Opcja budżetu projektów Total Project Fees w celu uwzględnienia śledzonych wydatków.

Po utworzeniu wpisu czasu dla bieżącego dnia

Wyzwala wyzwalane po utworzeniu nowego wpisu czasowego dla bieżącego dnia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Inny identyfikator użytkownika
of_user string

Identyfikator użytkownika do sprawdzania wpisów czasu. Domyślnie jest to identyfikator.

Zwraca

Po utworzeniu wpisu godziny dla daty

Wyzwala, gdy zostanie utworzony nowy wpis godziny dla określonej daty.

Parametry

Nazwa Klucz Wymagane Typ Opis
Date
date True string

RRRR —MM-DD lub format ISO data/godzina

Inny identyfikator użytkownika
of_user string

Identyfikator użytkownika do sprawdzania wpisów czasu.

Zwraca

Definicje

ListAllContacts_Response

Nazwa Ścieżka Typ Opis
Identyfikator kontaktu
contact.id integer

Unikatowy identyfikator kontaktu.

Identyfikator klienta
contact.client_id integer

Unikatowy identyfikator klienta.

Imię
contact.first_name string

Imię kontaktu.

Nazwisko
contact.last_name string

Nazwisko kontaktu.

Email
contact.email string

Adres e-mail osoby kontaktowej.

Telefon biurowy
contact.phone_office string

Kontaktowy telefon biurowy.

Telefon komórkowy
contact.phone_mobile string

Telefon komórkowy kontaktu.

Faks
contact.fax string

Faks kontaktu.

Title
contact.title string

Tytuł kontaktu.

Utworzono datę i godzinę
contact.created_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Zaktualizowano datę i godzinę
contact.updated_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

ListAllClients_Response

Nazwa Ścieżka Typ Opis
Identyfikator klienta
client.id integer

Unikatowy identyfikator klienta.

Name
client.name string

Nazwa klienta.

Waluta
client.currency string

Waluta do użycia na potrzeby rozliczeń klientów.

Zaktualizowano datę i godzinę
client.updated_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Utworzono datę i godzinę
client.created_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Address
client.address string

Adres klienta.

Symbol waluty
client.currency_symbol string

Symbol skorelowany z wybraną walutą.

Szczegóły
client.details string

Dodatkowe szczegóły, zwykle używane na potrzeby informacji o adresach.

UpdateTimeEntry_Response

Nazwa Ścieżka Typ Opis
Identyfikator wpisu czasu
id integer

Unikatowy identyfikator wpisu czasu.

Identyfikator użytkownika
user_id integer

Unikatowy identyfikator użytkownika, który utworzył wpis czasu.

Date
spent_at string

Data wpisu godziny.

Utworzono datę i godzinę
created_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Zaktualizowano datę i godzinę
updated_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Identyfikator projektu
project_id string

Identyfikator wpisu czasu projektu jest skojarzony.

Identyfikator zadania
task_id string

Identyfikator wpisu czasu zadania jest skojarzony.

Projekt
project string

Nazwa projektu, z który jest skojarzony wpis czasu.

Zadanie
task string

Nazwa zadania, z które jest skojarzony wpis czasu.

Client
client string

Nazwa klienta, z który jest skojarzony wpis czasu.

Notatki
notes string

Uwagi dotyczące wprowadzania czasu.

Godziny bez czasomierza
hours_without_timer float

Bieżący czas śledzenia, jeśli czasomierz nie jest uruchomiony.

Godziny
hours float

Liczba (czas dziesiętny) godzin śledzonych w tym wpisie czasu.

ListProjects_Response

Nazwa Ścieżka Typ Opis
Identyfikator projektu
project.id integer

Unikatowy identyfikator projektu.

Identyfikator klienta
project.client_id integer

Identyfikator klienta dla projektu.

Name
project.name string

Nazwa projektu.

Code
project.code string

Kod projektu.

Jest aktywny
project.active boolean

Wartość True, jeśli projekt jest obecnie aktywny.

Jest rozliczany
project.billable boolean

Wartość true, jeśli projekt jest rozliczany.

Rachunek według
project.bill_by string

Metoda, za pomocą której projekt jest fakturowany.

Stawka godzinowa
project.hourly_rate float

Stawka rozliczeniowa według godziny.

Budżet
project.budget float

Wartość budżetu dla projektu.

Budżet według
project.budget_by string

Metoda budżetowania projektu.

Utworzono datę i godzinę
project.created_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Zaktualizowano datę i godzinę
project.updated_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Data rozpoczęcia
project.starts_on string

RRRR —MM-DD

Data zakończenia
project.ends_on string

RRRR —MM-DD

Szacowanie
project.estimate float

Szacowanie projektu.

Szacowane przez
project.estimate_by string

Metoda szacowania projektu.

Najwcześniejsza data rekordu
project.hint_earliest_record_at string

RRRR —MM-DD

Data ostatniego rekordu
project.hint_latest_record_at string

RRRR —MM-DD

Notatki
project.notes string

Uwagi dotyczące projektu.

Budżet kosztów
project.cost_budget float

Wartość budżetowa dla projektów Total Project Opłaty.

Budżet kosztów obejmuje wydatki
project.cost_budget_include_expenses boolean

Opcja budżetu projektów Total Project Fees w celu uwzględnienia śledzonych wydatków.

ListTasks_Response

Nazwa Ścieżka Typ Opis
Identyfikator zadania
task.id integer

Unikatowy identyfikator zadania.

Name
task.name string

Nazwa zadania.

wewnętrzny
task.billable_by_default boolean
Utworzono datę i godzinę
task.created_at date-time

RRRR-MM-DDThh:mm:ssZ (UTC).

Zaktualizowano datę i godzinę
task.updated_at date-time

RRRR-MM-DDThh:mm:ssZ (UTC).

Domyślna stawka godzinowa
task.default_hourly_rate float

Domyślna stawka zadania.

GetUserByID_Response

Nazwa Ścieżka Typ Opis
Identyfikator użytkownika
user.id integer

Unikatowy identyfikator użytkownika.

Email
user.email string

Adres e-mail użytkownika.

Utworzono datę i godzinę
user.created_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Jest administratorem
user.is_admin boolean

Wartość True, jeśli użytkownik jest administratorem.

Imię
user.first_name string

Imię użytkownika.

Nazwisko
user.last_name string

Nazwisko użytkownika.

Czy wykonawca
user.is_contractor boolean

Prawda, jeśli użytkownik jest wykonawcą.

Telefon
user.telephone string

Telefon użytkownika.

Jest aktywny
user.is_active boolean

Wartość True, jeśli użytkownik jest obecnie aktywny.

Stawka godzinowa
user.default_hourly_rate float

Stawka godzinowa użytkownika

Dział
user.department string

Nazwa działu, w ramach których działa użytkownik.

Subskrypcja biuletynu
user.wants_newsletter boolean

Prawda, jeśli użytkownik chce subskrybować biuletyn.

Stawka kosztów
user.cost_rate float

Stawka kosztów użytkownika.

Pojemność tygodniowa
user.weekly_capacity integer

Pojemność tygodniowa użytkownika.

GetTimeEntriesForDay_Response

Nazwa Ścieżka Typ Opis
day_entries
day_entries array of object

day_entries

Identyfikator projektu
day_entries.project_id string

Unikatowy identyfikator porject.

Nazwa projektu
day_entries.project string

Nazwa projektu.

Identyfikator użytkownika
day_entries.user_id integer

Unikatowy identyfikator użytkownika.

Date
day_entries.spent_at string

RRRR —MM-DD

Identyfikator zadania
day_entries.task_id string

Identyfikator zadania, z który jest skojarzony wpis czasu.

Zadanie
day_entries.task string

Nazwa zadania, z które jest skojarzony wpis czasu.

Client
day_entries.client string

Nazwa klienta, z który jest skojarzony wpis czasu.

Identyfikator wpisu czasu
day_entries.id integer

Unikatowy identyfikator wpisu czasu.

Notatki
day_entries.notes string

Uwagi dotyczące wprowadzania czasu.

Data rozpoczęcia
day_entries.started_at string

RRRR-MM-DDThh:mm:ssZ (format UTC).

Data/godzina zakończenia
day_entries.ended_at string

RRRR-MM-DDThh:mm:ssZ (format UTC).

Utworzono datę i godzinę
day_entries.created_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Zaktualizowano datę i godzinę
day_entries.updated_at date-time

RRRR-MM-DDThh:mm:ssZ (format UTC).

Godziny bez czasomierza
day_entries.hours_without_timer float

Bieżący czas śledzenia, jeśli czasomierz nie jest uruchomiony.

Godziny
day_entries.hours float

Liczba (czas dziesiętny) godzin śledzonych w tym wpisie czasu.