Udostępnij przez


Projekty pracy zespołowej (wersja zapoznawcza)

Zachowaj wszystkie zadania zespołu w jednym miejscu. Współpraca i praca w czasie rzeczywistym w celu uzyskania rzeczywistych wyników. Teamwork Projects to zaawansowany i prosty sposób współpracy z zespołem.

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)
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://www.teamwork.com/
Zasady ochrony prywatności https://www.teamwork.com/legal/privacy-policy/

Aby korzystać z wyzwalaczy w tej integracji, najpierw musisz mieć włączone elementy webhook dla konta projektów zespołowych. Aby włączyć elementy webhook, kliknij pozycję Ustawienia w prawym górnym rogu konta projektów pracy zespołowej, kliknij pozycję Ustawienia witryny i wybierz kartę Elementy webhook. Po włączeniu ustawienia na twoim koncie użycie wyzwalacza spowoduje automatyczne zarejestrowanie elementu webhook.

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
Nazwa użytkownika ciąg Nazwa użytkownika dla tego interfejsu API Prawda
Hasło securestring Hasło dla tego interfejsu API Prawda
Adres URL witryny ciąg Adres URL witryny głównej (przykład: https://my.teamwork.com ) Prawda

Limity ograniczania

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

Akcje

Aktualizowanie zadania

Ta operacja służy do aktualizowania właściwości określonego zadania.

Lista projektów

Ta operacja zwraca listę wszystkich projektów skojarzonych z kontem.

Pobieranie projektu

Ta operacja zwraca wszystkie właściwości asosciated z określonym projektem, biorąc pod uwagę jego identyfikator.

Pobieranie użytkownika

Ta operacja służy do pobierania wszystkich szczegółów użytkownika.

Pobieranie zadania

Ta operacja zwraca wszystkie właściwości asosciated z określonym zadaniem, biorąc pod uwagę jego identyfikator.

Tworzenie projektu

Ta operacja służy do tworzenia nowego projektu Teamwork.

Usuń zadanie

Ta operacja służy do usuwania zadania.

Utwórz użytkownika

Ta operacja służy do tworzenia nowego użytkownika.

Utwórz zadanie

Ta operacja służy do tworzenia nowego zadania.

Wyświetlanie listy użytkowników

Ta operacja zwraca listę wszystkich użytkowników asosciated z określonym projektem.

Wyświetlanie listy zadań

Ta operacja służy do zwracania listy zadań dla danego projektu.

Aktualizowanie zadania

Ta operacja służy do aktualizowania właściwości określonego zadania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zadania
taskId True string

Unikatowy identyfikator zadania.

Name
content string

Nazwa zadania.

Description
description string

Opis zadania.

Progress
progress string

Liczba całkowita z zakresu od 0 do 90.

Przypisz do
responsible-party-id string

Wybierz osobę.

Data rozpoczęcia
start-date string

yyyy-MM-dd

Data upływu
due-date string

yyyy-MM-dd

Szacowany czas
estimated-minutes string

Minuty ukończenia zadania.

Priority
priority string

Wybierz priorytet.

Powiadamianie osób
notify boolean

Wartość True, aby powiadomić osoby przydzielone do tego zadania pocztą e-mail.

Jest prywatny
private boolean

Wartość true, aby zadanie było prywatne.

Etykiety
tags string

Rozdzielona przecinkami lista tagów zadania.

Zwraca

Lista projektów

Ta operacja zwraca listę wszystkich projektów skojarzonych z kontem.

Zwraca

Pobieranie projektu

Ta operacja zwraca wszystkie właściwości asosciated z określonym projektem, biorąc pod uwagę jego identyfikator.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator projektu
projectId True string

Unikatowy identyfikator projektu.

Zwraca

Pobieranie użytkownika

Ta operacja służy do pobierania wszystkich szczegółów użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator osoby
personId True string

Unikatowy identyfikator osoby.

Zwraca

Pobieranie zadania

Ta operacja zwraca wszystkie właściwości asosciated z określonym zadaniem, biorąc pod uwagę jego identyfikator.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zadania
taskId True string

Unikatowy identyfikator zadania.

Zwraca

Szczegóły skojarzone z określonym zadaniem.

Tworzenie projektu

Ta operacja służy do tworzenia nowego projektu Teamwork.

Parametry

Nazwa Klucz Wymagane Typ Opis
Name
name True string

Nazwa projektu.

Description
description string

Więcej szczegółów na temat projektu.

Identyfikator kategorii
category-id string

Wybierz kategorię

Identyfikator firmy
companyId string

Wybierz istniejącą firmę.

Nowa firma
newCompany string

Wprowadź nazwę nowej firmy zewnętrznej.

Data rozpoczęcia
startDate string

yyyy-MM-dd

Data zakończenia
endDate string

yyyy-MM-dd

Etykiety
tags string

Rozdzielona przecinkami lista tagów dla projektu.

Zwraca

Usuń zadanie

Ta operacja służy do usuwania zadania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zadania
taskId True string

Unikatowy identyfikator zadania.

Zwraca

Utwórz użytkownika

Ta operacja służy do tworzenia nowego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres e-mail
email-address True string

Adres e-mail użytkownika.

Imię
first-name True string

Imię użytkownika.

Nazwisko
last-name True string

Nazwisko użytkownika.

Identyfikator firmy
company-id string

Firma użytkownika.

Stanowisko
title string

Tytuł użytkownika.

Narzędzia główne
phone-number-home string

Telefon domowy użytkownika.

Mobile
phone-number-mobile string

Telefon komórkowy użytkownika.

Office
phone-number-office string

Telefon biurowy użytkownika.

Rozszerzenie pakietu Office
phone-number-office-ext string

Rozszerzenie telefonu biurowego użytkownika.

Faks
phone-number-fax string

Numer faksu użytkownika.

Nazwa użytkownika
user-name True string

Nazwa wyświetlana użytkownika.

Zwraca

Utwórz zadanie

Ta operacja służy do tworzenia nowego zadania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator projektu
projectId True string

Wybierz projekt.

Identyfikator listy zadań
taskListId True string

Wybierz listę zadań.

Name
content True string

Tytuł zadania.

Description
description string

Szczegóły zadania.

Progress
progress string

Ustaw postęp z zakresu od 0 do 90.

Przypisz do
responsible-party-id string

Wybierz użytkownika.

Data rozpoczęcia
start-date string

yyyy-MM-dd

Data upływu
due-date string

yyyy-MM-dd

Szacowane minuty
estimated-minutes string

Aby wykonać zadanie.

Priority
priority string

Wybierz priorytet.

Powiadamianie osób
notify boolean

Wartość True, aby powiadomić osoby przydzielone do tego zadania pocztą e-mail.

Jest prywatny
private boolean

Wartość true, aby zadanie było prywatne.

Etykiety
tags string

Rozdzielona przecinkami lista tagów zadania.

Zwraca

Wyświetlanie listy użytkowników

Ta operacja zwraca listę wszystkich użytkowników asosciated z określonym projektem.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator projektu
projectId True string

Wybierz projekt.

Zwraca

Wyświetlanie listy zadań

Ta operacja służy do zwracania listy zadań dla danego projektu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator projektu
projectId True string

Wybierz projekt.

Identyfikator listy zadań
taskListId True string

Wybierz listę zadań.

Zwraca

Wyzwalacze

Kiedy zostanie utworzone zadanie

Ta operacja jest wyzwalana po utworzeniu nowego zadania.

Po utworzeniu projektu

Ta operacja jest wyzwalana po utworzeniu nowego projektu.

Po utworzeniu użytkownika

Ta operacja jest wyzwalana po utworzeniu nowego użytkownika.

Kiedy zostanie utworzone zadanie

Ta operacja jest wyzwalana po utworzeniu nowego zadania.

Zwraca

Po utworzeniu projektu

Ta operacja jest wyzwalana po utworzeniu nowego projektu.

Zwraca

Po utworzeniu użytkownika

Ta operacja jest wyzwalana po utworzeniu nowego użytkownika.

Zwraca

Definicje

ProjectResponse

Nazwa Ścieżka Typ Opis
Identyfikator projektu
objectId string

Unikatowy identyfikator projektu.

ZadanieResponse

Nazwa Ścieżka Typ Opis
Identyfikator zadania
objectId string

Unikatowy identyfikator zadania.

UserResponse

Nazwa Ścieżka Typ Opis
Identyfikator użytkownika
objectId string

Unikatowy identyfikator użytkownika.

CreateProject_Response

Nazwa Ścieżka Typ Opis
Identyfikator projektu
id string

Unikatowy identyfikator projektu.

ListProjects_Response

Nazwa Ścieżka Typ Opis
Lista projektów
projects array of Project_Response

Tablica wszystkich projektów asosciated z Twoim kontem.

GetProject_Response

Nazwa Ścieżka Typ Opis
projekt
project Project_Response

Project_Response

Nazwa Ścieżka Typ Opis
Id
category.id string

Unikatowy identyfikator kategorii projektu.

Name
category.name string

Nazwa kategorii projektu.

Id
company.id string

Unikatowy identyfikator firmy.

Name
company.name string

Nazwa firmy.

Utworzono Date-Time
created-on date-time

rrrr-MM-ddTHH:mm:ss.fffZ

Description
description string

Więcej szczegółów na temat projektu.

Zakończenie Date-Time
endDate string

yyyy-MM-dd

Włączony czasomierz
harvest-timers-enabled boolean

Wartość true, jeśli czasomierz harvest jest włączony.

Identyfikator projektu
id string

Unikatowy identyfikator projektu.

Zaktualizowano Date-Time
last-changed-on date-time

rrrr-MM-ddTHH:mm:ss.fffZ

Logo
logo string

Logo projektu.

Name
name string

Nazwa projektu.

Strona przeglądu
overview-start-page string

Adres URL strony przegląd-start-.

Włączono prywatność
privacyEnabled boolean

Wartość True, jeśli włączono prywatność.

Gwiazda
starred boolean

Wartość True, jeśli projekt jest zagrany.

Uruchamianie Date-Time
startDate string

yyyy-MM-dd

Strona początkowa
start-page string

Adres URL strony początkowej.

Status
status string

Stan projektu.

Stan podrzędny
subStatus string

Podstatu projektu.

Strona początkowa zadań
tasks-start-page string

Adres URL strony początkowej zadań.

Typ
type string

Typ projektu.

UpsertTask_Response

Nazwa Ścieżka Typ Opis
Identyfikator zadania
id string

Unikatowy identyfikator zadania.

ListTasks_Response

Nazwa Ścieżka Typ Opis
todo-items
todo-items array of Task_Response

Lista zadań wraz z ich właściwościami.

GetTask_Response

Szczegóły skojarzone z określonym zadaniem.

Nazwa Ścieżka Typ Opis
todo-item
todo-item Task_Response

Task_Response

Nazwa Ścieżka Typ Opis
Można ukończyć
canComplete boolean

Wartość True, jeśli zadanie można wykonać.

Może edytować
canEdit boolean

Prawda, jeśli zadanie można edytować.

Może rejestrować czas
canLogTime boolean

Wartość true, jeśli czas można zarejestrować w zadaniu.

Identyfikator firmy
company-id integer

Unikatowy identyfikator firmy.

Nazwa firmy
company-name string

Nazwa firmy.

Ukończono
completed boolean

True to zadanie zostało ukończone.

Name
content string

Tytuł zadania.

Utworzono Date-Time
created-on date-time

rrrr-MM-ddTHH:mm:ss.fffZ

Adres URL awatara twórcy
creator-avatar-url string

Adres URL awatara twórcy zadania.

Imię twórcy
creator-firstname string

Imię twórcy zadania.

Identyfikator twórcy
creator-id integer

Unikatowy identyfikator twórcy.

Nazwisko twórcy
creator-lastname string

Nazwisko twórcy zadania.

Description
description string

Opis zadania.

Data upływu
due-date string

yyyy-MM-dd

Szacowane minuty
estimated-minutes integer

Szacowanie czasu zadania.

Włączone zbiory.
harvest-enabled boolean

Wartość true, jeśli zbiór jest włączony.

Liczba zależności
has-dependencies integer

Liczba zależności, które ma zadanie.

Ma poprzedniki
has-predecessors integer

Liczba poprzedników, które ma zadanie.

Zawiera przypomnienia
has-reminders boolean

Prawda, jeśli istnieją przypomnienia.

Ma bilety
hasTickets boolean

Prawda, jeśli istnieją bilety.

has-unread-comments
has-unread-comments boolean

Prawda, jeśli istnieją nieprzeczytane komentarze.

Identyfikator zadania
id integer

Unikatowy identyfikator zadania.

Zaktualizowano Date-Time
last-changed-on date-time

rrrr-MM-ddTHH:mm:ss.fffZ

Identyfikator blokady
lockdownId string

Unikatowy identyfikator blokady.

Identyfikator zadania nadrzędnego
parentTaskId string

Unikatowy identyfikator zadania nadrzędnego.

Priority
priority string

Priorytet zadania.

Prywatne
private integer

1, jeśli zadanie jest prywatne.

Progress
progress integer

Liczba całkowita z zakresu od 0 do 90.

Identyfikator projektu
project-id integer

Unikatowy identyfikator projektu.

Nazwa projektu
project-name string

Nazwa projektu.

Data rozpoczęcia
start-date string

yyyy-MM-dd

Status
status string

Usunięte, ukończone, ponownie otwarte lub nowe.

Identyfikator listy zadań do wykonania
todo-list-id integer

Unikatowy identyfikator listy zadań do wykonania.

Nazwa listy zadań do wykonania
todo-list-name string

Nazwa listy zadań do wykonania.

Następujące zmiany
userFollowingChanges boolean

Wartość True, jeśli użytkownik obserwuje zmiany.

Następujące komentarze
userFollowingComments boolean

Prawda, jeśli użytkownik obserwuje komentarze.

DeleteTask_Response

Nazwa Ścieżka Typ Opis
Identyfikator zadania
affectedTaskIds string

Unikatowy identyfikator zadania.

CreateUser_Response

Nazwa Ścieżka Typ Opis
Identyfikator użytkownika
id string

Unikatowy identyfikator użytkownika.

ListUsers_Response

Nazwa Ścieżka Typ Opis
Użytkownicy
people array of User_Response

Lista użytkowników.

GetUser_Response

Nazwa Ścieżka Typ Opis
osoba
person User_Response

User_Response

Nazwa Ścieżka Typ Opis
Adres URL awatara
avatar-url string

Adres URL awatara użytkownika.

Identyfikator firmy
company-id string

Unikatowy identyfikator firmy.

Nazwa firmy
company-name string

Nazwa firmy.

Adres e-mail
email-address string

Adres e-mail użytkownika.

Alternatywny adres e-mail 1
email-alt-1 string

Alternatywny adres e-mail użytkownika.

Imię
first-name string

Imię użytkownika.

Identyfikator użytkownika
id string

Unikatowy identyfikator użytkownika.

Nazwisko
last-name string

Nazwisko użytkownika,

Notatki
notes string

Uwagi dotyczące użytkownika.

Identyfikator otwarcia
openId string

Identyfikator otwarcia użytkownika.

Numer faksu
phone-number-fax string

Numer faksu użytkownika.

Narzędzia główne
phone-number-home string

Telefon domowy użytkownika.

Mobile
phone-number-mobile string

Numer telefonu komórkowego użytkownika.

Kod kraju
phone-number-mobile-parts.countryCode string

Numer telefonu komórkowego użytkownika.

Telefon
phone-number-mobile-parts.phone string

Numer telefonu komórkowego użytkownika.

Prefiks
phone-number-mobile-parts.prefix string

Numer telefonu komórkowego użytkownika.

Office
phone-number-office string

Numer telefonu biurowego użytkownika.

Rozszerzenie pakietu Office
phone-number-office-ext string

Numer telefonu biurowego użytkownika.

Pid
pid string

Pid użytkownika.

Title
title string

Tytuł użytkownika.

Twitter
twitter string

Obsługa twittera użytkownika.

Nazwa użytkownika
user-name string

Nazwa wyświetlana użytkownika.

Typ
user-type string

Typ użytkownika.

UUID
userUUID string

Identyfikator UUID użytkownika.