Udostępnij przez


Project Online

Usługa Project Online to elastyczne rozwiązanie online do zarządzania portfolio projektów (PPM) i codziennego użytku firmy Microsoft. Usługa Project Online dostarczana za pośrednictwem usługi Office 365 umożliwia organizacjom szybkie rozpoczęcie pracy z zaawansowanymi funkcjami zarządzania projektami w celu planowania, określania priorytetów i zarządzania projektami oraz inwestycji w portfolio projektów z niemal dowolnego miejsca na niemal dowolnym urządzeniu.

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

Usługa Class Regions
Copilot Studio Standard Wszystkie regiony usługi Power Automate
Logic Apps Standard Wszystkie regiony usługi Logic Apps
Power Apps Standard Wszystkie regiony usługi Power Apps
Power Automate Standard Wszystkie regiony usługi Power Automate
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://products.office.com/project/project-management-software

Aby korzystać z tej integracji, musisz mieć dostęp do konta z dostępem do witryny usługi Project Online. Aby nawiązać połączenie, wybierz pozycję Zaloguj. Zostanie wyświetlony monit o podanie identyfikatora logowania firmy Microsoft, postępuj zgodnie z pozostałymi ekranami, aby utworzyć połączenie.

Każda z operacji wymaga adresu URL witryny głównej do witryny usługi Project Online. W większości przypadków ten adres URL można znaleźć na pasku adresu przeglądarki podczas przechodzenia do witryny usługi Project Online. Adres URL powinien należeć do domeny sharepoint.com i powinien mieć typ PWA (Project Web App). Jeśli używasz usługi Project Online za pośrednictwem https://project.microsoft.com/ witryny, odwiedź stronę Ustawienia Moja>witryna PWA, aby uzyskać prawidłowy adres URL programu PWA. Np. https://sampletenant.sharepoint.com/teams/sampleteam

Teraz możesz rozpocząć korzystanie z tej integracji.

Znane problemy i ograniczenia

  1. Właściwość "Nazwa zasobu" nie jest zwracana dla zadań usługi Project Online, ponieważ nie jest zwracana przez sam interfejs API REST usługi zaplecza.
  2. Wszystkie wyzwalacze mogą zwracać maksymalnie 10 elementów na pojedynczy przebieg. Jeśli dostępnych jest więcej danych i jest to wyzwalacz w wersji 2, wyzwalacz zostanie uruchomiony ponownie bez opóźnień.

Limity ograniczania

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

Akcje

Lista projektów

Wyświetla listę projektów w witrynie online projektu.

Pobieranie zadania sumarycznego projektu

Pobiera zadanie sumaryczne projektu dla danego projektu.

Sprawdzanie i publikowanie projektu

Zaewidencjonuj i opublikuj istniejący projekt w witrynie.

Tworzenie nowego zasobu

Tworzy zasób przedsiębiorstwa w witrynie usługi Project Online.

Tworzy nowe zadanie

Tworzy nowe zadanie w projekcie.

Tworzy nowy projekt

Tworzy nowy projekt w witrynie online projektu.

Wyewidencjonuj projekt

Wyewidencjonuj istniejący projekt w witrynie.

Wyświetla listę zadań

Wyświetla listę opublikowanych zadań w projekcie.

Wyświetlanie listy projektów

Wyświetla listę projektu według identyfikatora w witrynie online projektu.

Lista projektów

Wyświetla listę projektów w witrynie online projektu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Zwraca

Model odpowiedzi projektów listy online projektu

Pobieranie zadania sumarycznego projektu

Pobiera zadanie sumaryczne projektu dla danego projektu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Identyfikator projektu
project_id True string

Unikatowy identyfikator projektu do pobrania

Zwraca

Zadanie programu Project Online Server

Body
Task

Sprawdzanie i publikowanie projektu

Zaewidencjonuj i opublikuj istniejący projekt w witrynie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Identyfikator projektu
project_id True string

Unikatowy identyfikator projektu do zaewidencjonowania.

Zwraca

response
object

Tworzenie nowego zasobu

Tworzy zasób przedsiębiorstwa w witrynie usługi Project Online.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Nazwa zasobu
Name True string

Nazwa nowego zasobu do utworzenia

Czy zasób jest w budżecie
IsBudget boolean

Czy zasób jest uwzględniany w budżecie

Czy zasób jest ogólny
IsGeneric boolean

Czy zasób jest ogólny

Czy zasób jest nieaktywny
IsInactive boolean

Czy zasób jest nieaktywny

Zwraca

Model zasobów usługi Project Online Enterprise

Tworzy nowe zadanie

Tworzy nowe zadanie w projekcie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Identyfikator projektu
project_id True string

Unikatowy identyfikator projektu do dodania zadania.

Nazwa zadania
Name True string

Nazwa nowego zadania do utworzenia

Uwagi dotyczące zadań
Notes string

Uwagi do umieszczenia w nowym zadaniu

Data rozpoczęcia zadania
Start date-time

Data rozpoczęcia zadania

Czas trwania zadania
Duration string

Czas trwania zadania. Na przykład (1h, 2d lub 3w)

Zwraca

Zadanie programu Project Online Server

Body
Task

Tworzy nowy projekt

Tworzy nowy projekt w witrynie online projektu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Nazwa projektu
Name True string

Nazwa nowego projektu do utworzenia

Opis projektu
Description string

Opis nowego projektu do utworzenia

Data rozpoczęcia projektu
Start date-time

Data rozpoczęcia nowego projektu

Zwraca

Project Online Project Model

Body
Project

Wyewidencjonuj projekt

Wyewidencjonuj istniejący projekt w witrynie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Identyfikator projektu
project_id True string

Unikatowy identyfikator projektu do wyewidencjonowania.

Zwraca

response
object

Wyświetla listę zadań

Wyświetla listę opublikowanych zadań w projekcie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Identyfikator projektu
project_id True string

Unikatowy identyfikator projektu do pobierania zadań.

Filtruj zapytanie
$filter string

Zapytanie filtru ODATA w celu ograniczenia zwracanych wpisów (np. Id eq "task-guid").

Wybieranie zapytania
$select string

OData wybierz zapytanie dotyczące kolumn, które mają zostać zwrócone. Przykład: Identyfikator, Nazwa

Zwraca

Model odpowiedzi zadań listy online w programie Project Online

Wyświetlanie listy projektów

Wyświetla listę projektu według identyfikatora w witrynie online projektu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Identyfikator projektu
project_id True string

Unikatowy identyfikator projektu do pobrania

Wybieranie zapytania
$select string

OData wybierz zapytanie dotyczące kolumn, które mają zostać zwrócone. Przykład: Identyfikator, Nazwa

Zwraca

Project Online Project Model

Body
Project

Wyzwalacze

Po opublikowaniu projektu

Wyzwala przepływ za każdym razem, gdy projekt zostanie opublikowany.

Po opublikowaniu projektu (wersja 2) (wersja zapoznawcza)

Wyzwala przepływ za każdym razem, gdy projekt zostanie opublikowany.

Po utworzeniu nowego projektu

Wyzwala przepływ za każdym razem, gdy zostanie utworzony nowy projekt.

Po utworzeniu nowego projektu (wersja 2) (wersja zapoznawcza)

Wyzwala przepływ za każdym razem, gdy zostanie utworzony nowy projekt.

Po utworzeniu nowego zadania

Wyzwala przepływ po utworzeniu nowego zadania.

Po utworzeniu nowego zadania (wersja 2) (wersja zapoznawcza)

Wyzwala przepływ po utworzeniu nowego zadania.

Po utworzeniu nowego zasobu

Wyzwala nowy przepływ po utworzeniu nowego zasobu.

Po utworzeniu nowego zasobu (wersja 2) (wersja zapoznawcza)

Wyzwala nowy przepływ po utworzeniu nowego zasobu.

Po opublikowaniu projektu

Wyzwala przepływ za każdym razem, gdy projekt zostanie opublikowany.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Zwraca

Usługa Project Online w nowym modelu odpowiedzi projektu.

Po opublikowaniu projektu (wersja 2) (wersja zapoznawcza)

Wyzwala przepływ za każdym razem, gdy projekt zostanie opublikowany.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Wybieranie zapytania
$select True string

OData wybierz zapytanie dotyczące kolumn, które mają zostać zwrócone.

Zwraca

Usługa Project Online w nowym modelu odpowiedzi projektu.

Po utworzeniu nowego projektu

Wyzwala przepływ za każdym razem, gdy zostanie utworzony nowy projekt.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Zwraca

Usługa Project Online w nowym modelu odpowiedzi projektu.

Po utworzeniu nowego projektu (wersja 2) (wersja zapoznawcza)

Wyzwala przepływ za każdym razem, gdy zostanie utworzony nowy projekt.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Wybieranie zapytania
$select True string

OData wybierz zapytanie dotyczące kolumn, które mają zostać zwrócone.

Zwraca

Usługa Project Online w nowym modelu odpowiedzi projektu.

Po utworzeniu nowego zadania

Wyzwala przepływ po utworzeniu nowego zadania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Zwraca

Usługa Project Online w nowym modelu odpowiedzi na zadania

Po utworzeniu nowego zadania (wersja 2) (wersja zapoznawcza)

Wyzwala przepływ po utworzeniu nowego zadania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Wybieranie zapytania
$select True string

OData wybierz zapytanie dotyczące kolumn, które mają zostać zwrócone.

Zwraca

Usługa Project Online w nowym modelu odpowiedzi na zadania

Po utworzeniu nowego zasobu

Wyzwala nowy przepływ po utworzeniu nowego zasobu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Zwraca

Usługa Project Online w nowym modelu odpowiedzi na zasoby.

Po utworzeniu nowego zasobu (wersja 2) (wersja zapoznawcza)

Wyzwala nowy przepływ po utworzeniu nowego zasobu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres URL witryny głównej
siteUrl True uri

Adres URL witryny głównej witryny projektu (przykład: https://sampletenant.sharepoint.com/teams/sampleteam ).

Wybieranie zapytania
$select True string

OData wybierz zapytanie dotyczące kolumn, które mają zostać zwrócone.

Zwraca

Usługa Project Online w nowym modelu odpowiedzi na zasoby.

Definicje

TriggerProjectsWrapper

Usługa Project Online w nowym modelu odpowiedzi projektu.

Nazwa Ścieżka Typ Opis
Zwrócone projekty
value array of TriggerProject

Zwrócona lista projektów wyzwalacza.

TriggerProject

Project Online Project Model

Nazwa Ścieżka Typ Opis
Data rozpoczęcia projektu
ProjectStartDate date-time

Data/godzina rozpoczęcia zatwierdzonego projektu.

Data zakończenia projektu
ProjectFinishDate date-time

Data/godzina zakończenia zatwierdzonego projektu.

Data utworzenia
ProjectCreatedDate date-time

Data/godzina utworzenia projektu.

Identyfikator projektu
ProjectId string

Unikatowy identyfikator projektu.

Data ostatniej modyfikacji
ProjectModifiedDate date-time

Data/godzina ostatniego zapisania projektu.

Typ projektu
ProjectType integer

Typ projektu.

Nazwa projektu
ProjectName string

Nazwa projektu.

Data ostatniej publikacji
ProjectLastPublishedDate date-time

Data/godzina ostatniego opublikowania projektu.

Właściciel projektu
ProjectOwnerName string

Właściciel projektu.

Procent ukończonego projektu
ProjectPercentCompleted integer

Procent ukończenia projektu.

Ukończono pracę procentowa projektu
ProjectPercentWorkCompleted integer

Procent wykonanych prac nad projektem.

Koszt nadgodzin projektu
ProjectOvertimeCost string

Koszt nadgodzin w projekcie.

Praca w nadgodzinach projektu
ProjectOvertimeWork string

Praca nadgodzin w projekcie.

TriggerResourcesWrapper

Usługa Project Online w nowym modelu odpowiedzi na zasoby.

Nazwa Ścieżka Typ Opis
Zwrócone zasoby
value array of TriggerResource

Zwrócona lista zasobów wyzwalacza.

TriggerResource

Model zasobów usługi Resource Online.

Nazwa Ścieżka Typ Opis
Identyfikator zasobu
ResourceId string

Unikatowy identyfikator zasobu.

Kalendarz bazowy
ResourceBaseCalendar string

Podstawowy typ kalendarza zasobu.

Typ rezerwacji zasobów
ResourceBookingType integer

Typ rezerwacji zasobu

Może na poziomie zasobu
ResourceCanLevel boolean

Może na poziomie zasobu

Koszt zasobu na użycie
ResourceCostPerUse string

Koszt użycia zasobu

Data utworzenia zasobu
ResourceCreatedDate date-time

Data utworzenia zasobu

Zasób najwcześniejszy dostępny od
ResourceEarliestAvailableFrom date-time

Najwcześniejsza data dostępności zasobu

Adres e-mail zasobu
ResourceEmailAddress string

Adres e-mail zasobu

Inicjały zasobów
ResourceInitials string

Initals zasobu

Czy zasób jest aktywnyw
ResourceIsActive boolean

Czy nowy zasób jest aktywny

Czy zasób jest ogólny
ResourceIsGeneric boolean

Czy nowy zasób jest ogólny

Zasób jest najnowszy dostępny dla
ResourceLatestAvailableTo date-time

Data ostatniej, dla której zasób jest dostępny

Data ostatniej modyfikacji zasobu
ResourceModifiedDate date-time

Data ostatniej modyfikacji zasobu

Nazwa zasobu
ResourceName string

Nazwa zasobu

Nazwa stanu zasobu
ResourceStatsuName string

Nazwa stanu zasobu

Typ zasobu
ResourceType integer

Typ zasobu

Opis typu zasobu
TypeDescription string

Opis typu zasobu

Nazwa typu zasobu
TypeName string

Nazwa typu zasobu

TriggerTasksWrapper

Usługa Project Online w nowym modelu odpowiedzi na zadania

Nazwa Ścieżka Typ Opis
Zwrócone zadania
value array of TriggerTask

Lista zwróconych zadań wyzwalacza

TriggerTask

Model zadań w trybie online

Nazwa Ścieżka Typ Opis
Identyfikator projektu
ProjectId string

Identyfikator projektu, w którym zostało utworzone zadanie

Identyfikator zadania
TaskId string

Identyfikator nowego zadania

Nazwa projektu
ProjectName string

Nazwa projektu, w którym zostało utworzone zadanie

Nazwa zadania
TaskName string

Nazwa nowego zadania

Data utworzenia zadania
TaskCreatedDate date-time

Data utworzenia nowego zadania

Data ostatniej modyfikacji zadania
TaskModifieddate date-time

Data ostatniej modyfikacji nowego zadania

Data rozpoczęcia zadania
TaskStartDate date-time

Data rozpoczęcia nowego zadania

Data zakończenia zadania
TaskFinishDate date-time

Data zakończenia nowego zadania

Podsumowanie zadania
TaskPriority integer

Priorytet nowego zadania

Zadanie jest aktywne
TaskIsActive boolean

Czy zadanie jest nadal aktywne

Projekt

Project Online Project Model

Nazwa Ścieżka Typ Opis
Zatwierdzona data rozpoczęcia
ApprovedStart date-time

Zatwierdzony czas rozpoczęcia projektu

Zatwierdzona data zakończenia
ApprovedEnd date-time

Zatwierdzony czas zakończenia projektu

Data wyewidencjonowana
CheckedOutDate date-time

Czas wyewidencjonowany projekt

Opis wyewidencjonowania
CheckOutDescription string

Opis, z którym projekt jest wyewidencjonowany

Identyfikator wyewidencjonowania
CheckOutId string

Identyfikator wyewidencjonowania projektu

Data utworzenia
CreatedDate date-time

Data utworzenia projektu

Identyfikator projektu
Id string

Identyfikator projektu

Jest wyewidencjonowany
IsCheckedOut boolean

Prawda, jeśli projekt jest obecnie wyewidencjonowany

Data ostatniego opublikowania
ProjectLastPublishedDate date-time

Data ostatniej publikacji projektu

Data ostatniego opublikowania
LastPublishedDate date-time

Data ostatniej publikacji projektu

Data ostatniego zapisania
LastSavedDate date-time

Ostatnia data zapisania projektu

Decyzja optymalizatora
OptimizerDecision integer

Numer decyzji optymalizatora projektu

Decyzja planisty
PlannerDecision integer

Numer decyzji planisty projektu

Typ projektu
ProjectType integer

Typ projektu

Nazwa projektu
Name string

Nazwa projektu

Identyfikator projektu
ProjectIdentifier string

Identyfikator projektu

Wersja win proj
WinprojVersion string

Wersja projektu

ProjektyWrapper

Model odpowiedzi projektów listy online projektu

Nazwa Ścieżka Typ Opis
Zwrócone projekty
value array of Project

Lista zwróconych projektów

EnterpriseResource

Model zasobów usługi Project Online Enterprise

Nazwa Ścieżka Typ Opis
Może na poziomie zasobu
CanLevel boolean

Może na poziomie zasobu

Kod zasobu
Code string

Kod zasobu

Naliczanie kosztów zasobów
CostAccrual integer

Naliczanie kosztów zasobów

Centrum kosztów zasobów
CostCenter string

Centrum kosztów zasobów

Czas utworzenia zasobu
Created date-time

Czas utworzenia zasobu

Domyślny typ rezerwacji
DefaultBookingType integer

Domyślny typ rezerwacji zasobu

Email
Email string

Adres e-mail zasobu

Identyfikator zewnętrzny
ExternalId string

Identyfikator zewnętrzny zasobu

Grupa zasobów
Group string

Grupa, do której należy zasób

Data zatrudnienia
HireDate date-time

Data zatrudnienia zasobu

Identyfikator zasobu
Id string

Identyfikator zasobu

Inicjały resouce
Initials string

Inicjały zasobów

Czy zasób jest aktywny
IsActive boolean

Czy zasób jest aktywny

Jest budżetem
IsBudget boolean

Czy koszt zasobu jest budżetowany

Jest wyewidencjonowany
IsCheckedOut boolean

Czy zasób jest wyewidencjonowany

Jest ogólny
IsGeneric boolean

Czy zasób jest ogólny

Jest zespołem
IsTeam boolean

Jest częścią zespołu

Etykieta materiału
MaterialLabel string

Etykieta materiału zasobu

Ostatnia modyfikacja
Modified date-time

Czas ostatniej modyfikacji zasobu

Nazwa zasobu
Name string

Nazwa zasobu

Fonetyka zasobów
Phonetics string

Fonetyczna wymowa zasobu

Typ zasobu
ResourceType integer

Typ zasobu

Data zakończenia
TerminationDate date-time

Data zakończenia zasobu

ZadaniaWrapper

Model odpowiedzi zadań listy online w programie Project Online

Nazwa Ścieżka Typ Opis
Zwrócone zadania
value array of Task

Lista zwróconych zadań

Zadanie

Zadanie programu Project Online Server

Nazwa Ścieżka Typ Opis
Data utworzenia zadania
Created date-time

Data utworzenia zadania

Data ostatniej modyfikacji zadania
Modified date-time

Data ostatniej modyfikacji zadania

Data rozpoczęcia zadania
Start date-time

Data rozpoczęcia zadania

Data zakończenia zadania
Finish date-time

Data zakończenia zadania

Zaplanowana data rozpoczęcia zadania
ScheduledStart date-time

Zaplanowana data rozpoczęcia zadania

Data zakończenia zaplanowanego zadania
ScheduledFinish date-time

Zaplanowana data zakończenia zadania

Nazwa zadania
Name string

Nazwa zadania

Identyfikator zadania
Id string

Identyfikator zadania

Priorytet zadania
Priority integer

Poziom priorytetu zadania

Procent ukończenia zadania
PercentComplete integer

Procent wykonania zadania

Uwagi dotyczące zadań
Notes string

Uwagi o opisie zadania

Kontakt zadania
Contact string

Adres kontaktowy zadania

Jest zadaniem punktu kontrolnego
IsMilestone boolean

Wskazuje, czy zadanie jest kamieniem milowym

obiekt

Jest to typ 'obiekt'.