Udostępnij za pośrednictwem


Wyświetlanie i aktualizowanie strony podsumowania projektu

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Każdy projekt zawiera podsumowanie lub stronę główną, aby udostępnić informacje i zaprezentować najnowsze działania projektu. Ta strona służy jako centralne centrum dla członków zespołu, aby być na bieżąco z postępem projektu. Użyj tej strony dla następujących zadań:

  • Udostępnianie ważnych aktualizacji i anonsów projektu
  • Wyróżnianie ostatnich działań i punktów kontrolnych
  • Zapewnianie szybkiego dostępu do kluczowych zasobów projektu i dokumentacji
  • Ułatwianie współpracy zespołowej i komunikacji

Użyj strony podsumowania projektu, aby również wykonywać bardziej szczegółowe zadania:

Zadania administratora projektu

Zadania członkowskie projektu

  • Dodawanie krótkiego opisu projektu
  • Wybierz plik README lub witrynę typu wiki, aby uzyskać informacje o projekcie
  • Zapraszanie osób do współtworzenia projektu
  • Ustawianie tagów projektu
  • Wyświetlanie informacji o projekcie
  • Wyświetlanie działania projektu
  • Dodawanie do ulubionych projektu
  • Wyślij wiadomość e-mail lub zainicjuj czat z członkiem zespołu
  • Inicjowanie wyszukiwania w projekcie
  • Wyświetlanie informacji o projekcie
  • Wyślij wiadomość e-mail lub zainicjuj czat z członkiem zespołu
  • Wyświetlanie działania projektu

Uwaga

Możesz wyznaczyć hostowane projekty jako prywatne lub publiczne. W przypadku projektów publicznych użytkownicy anonimowi mogą wyświetlać podsumowanie projektu, z wyjątkiem sekcji Członkowie. Ponadto ikony Polubienie i Ulubione nie są widoczne dla użytkowników anonimowych. Aby uzyskać więcej informacji, zobacz Co to jest projekt publiczny?

Zrzut ekranu przedstawiający stronę podsumowania.

Wymagania wstępne

  • Uprawnienia: być członkiem grupy Administratorzy projektu lub mieć uprawnienie Edytuj informacje na poziomie projektu ustawione na Wartość Zezwalaj , aby wykonać następujące zadania:
    • Edytowanie informacji na stronie projektu
    • Zmienianie repozytorium używanego do udostępniania informacji o projekcie
    • Zarządzanie członkostwem w projekcie
  • Określone zadania:
    • Aby edytować stronę projektu, być współautorem repozytorium lub gałęzi lub mieć uprawnienia Współtworzenie ustawione na Zezwalaj.
    • Aby wyświetlić podsumowanie projektu, być prawidłowym członkiem projektu. Aby uzyskać więcej informacji, zobacz Informacje o zabezpieczeniach, członkostwie i uprawnieniach; Prawidłowe grupy użytkowników.
    • Aby dodać lub edytować tagi projektu, ustaw uprawnienie Zarządzanie właściwościami na poziomie projektu na wartość Zezwalaj. To uprawnienie kontroluje interfejs API REST właściwości projektu.

Napiwek

Jeśli nie masz niezbędnych uprawnień do edytowania strony lub korzystania z funkcji, odpowiednie ikony i linki nie są widoczne dla Ciebie.

Otwieranie podsumowania projektu

W przeglądarce internetowej wybierz pozycję Podsumowanie przeglądu>. Jeśli nie masz jeszcze projektu, utwórz projekt.

Jeśli podsumowanie projektu nie zostało jeszcze skonfigurowane, zostanie wyświetlona strona powitalna:

Zrzut ekranu przedstawiający stronę powitalną projektu.

Wybierz jedno z następujących zadań, aby rozpocząć pracę:

Aktualizowanie strony podsumowania

Na stronie podsumowania zostanie wyświetlony plik README zdefiniowany w repozytorium projektu lub strona główna witryny typu wiki projektu. Aby użyć strony głównej witryny typu wiki projektu, utwórz witrynę typu wiki dla projektu, a następnie możesz zmienić stronę podsumowania projektu , aby wskazywała stronę typu wiki.

  1. Edytuj stronę:

    • Jeśli po raz pierwszy edytujesz stronę, wybierz pozycję Dodaj opis projektu.
      Zrzut ekranu przedstawiający stronę podsumowania po raz pierwszy edytując.

    • Jeśli nie po raz pierwszy edytujesz stronę, wybierz pozycję Edytuj informacje o projekcie. Ta ikona jest widoczna tylko dla członków z uprawnieniami do edytowania strony Podsumowanie projektu.

  2. Podaj krótki opis przeznaczenia projektu w polu Opis .

    Informacje o tym oknie dialogowym projektu.

  3. (Opcjonalnie) Dodaj co najmniej jeden tag dla projektu. Te tagi są podobne do tagów elementów roboczych. Jednocześnie można dodać kilka tagów przy użyciu ograniczników przecinka lub średnika. Tagi muszą być zgodne z następującymi regułami:

    • Tagi muszą zawierać co najmniej 40 znaków
    • Tagi nie mogą zawierać znaku ukośnika (/) lub znaku łącznika (-)
    • Do projektu można dodać nie więcej niż 15 tagów
    • Tagi są bez uwzględniania wielkości liter i nie są dozwolone żadne zduplikowane tagi ani puste tagi.

    Uwaga

    Funkcji wyszukiwania i filtrowania nie można używać do wyszukiwania ani filtrowania tagów projektu.

  4. Wybierz, czy chcesz odwołać się do pliku README , czy strony głównej strony typu wiki projektu dla pozostałej części zawartości strony Podsumowanie.

    Napiwek

    Domyślny plik README jest tworzony w repozytorium dodanym podczas tworzenia projektu. W tym celu możesz wybrać plik README lub utworzyć inne repozytorium i plik README.

    Jeśli wybierzesz plik Readme, wybierz repozytorium dla pliku README. Zostanie wyświetlony podgląd bieżącego tekstu dla pliku README.

    Informacje o tym oknie dialogowym projektu, wybierz i wybierz repozytorium README.

    Jeśli wybierzesz witrynę typu wiki, zostanie odwołana strona główna typu wiki i musi być pierwszym plikiem w spisie treści typu wiki. Nie można zmienić tego odwołania.

  5. Aby zaktualizować zawartość przywołynego pliku README lub witryny typu wiki, zmodyfikuj odpowiedni plik. Aby uzyskać więcej informacji, zobacz Create a README for your repo (Tworzenie pliku README dla repozytorium) lub Add and edit wiki pages (Dodawanie i edytowanie stron typu wiki).

    Rozważ uwzględnienie następujących typów informacji na stronie Podsumowanie :

    • Sposoby współtworzenia projektu przez użytkowników
    • Kto skontaktować się w celu podniesienia uprawnień lub dodania rozszerzeń
    • Informacje o harmonogramie działania
    • Linki do instrukcji dotyczących konfigurowania środowisk programistycznych i testowych
    • Linki do instrukcji dotyczących współpracy nad kodem, śledzenia pracy, tworzenia potoków, wdrażania wydań
    • Linki do szablonów w celu zgłoszenia usterki, problemu lub żądania
    • Linki do list dystrybucyjnych, aby wysłać wiadomość e-mail na pytanie lub opublikować pytanie w kanale usługi Slack lub Teams.

Zapraszanie współautorów do projektu

Wyślij wiadomość e-mail, aby zaprosić użytkowników do współtworzenia projektu, wybierając pozycję Zaproś. Aby uzyskać więcej informacji, zobacz Dodawanie użytkowników lub grup do zespołu lub projektu, Zapraszanie użytkowników ze strony Podsumowanie.

Zrzut ekranu przedstawiający stronę Podsumowanie, przycisk Zaproś.

Uwaga

W przypadku usługi Azure DevOps Server wszystkie akcje poczty e-mail wymagają skonfigurowania serwera SMTP.

Wyświetlanie działania projektu

W sekcji Statystyki projektu lub Działanie możesz wyświetlić aktualizacje wprowadzone w projekcie w ciągu ostatnich 1, 7 lub 30 dni. Wybierz opcję widoku, jak pokazano na poniższej ilustracji.

Zrzut ekranu przedstawiający stronę Podsumowanie, sekcję Statystyki.

Rozmowa z członkiem projektu lub wysyłanie wiadomości e-mail

W sekcji Członkowie możesz zobaczyć niektórych członków dodanych do projektu i połączyć się z nimi za pośrednictwem poczty e-mail lub czatu z członkiem.

Zrzut ekranu przedstawiający stronę Podsumowanie, sekcję Członkowie.

Uwaga

100+ wskazuje, że do projektu jest dodawanych co najmniej 100 członków.

Aby wysłać wiadomość e-mail lub zainicjować sesję czatu, wybierz pokazanego członka zespołu i wybierz opcję.

Zrzut ekranu przedstawiający stronę Podsumowanie, sekcję Członkowie, opcje dostępne do nawiązania połączenia z członkiem zespołu.

Uwaga

W przypadku lokalnej usługi Azure DevOps wszystkie akcje poczty e-mail wymagają skonfigurowania serwera SMTP.

Wyszukiwanie projektu

Na stronie Podsumowanie możesz zainicjować wyszukiwanie kodu, elementów roboczych i witryny typu wiki. Aby uzyskać więcej informacji, zobacz Wprowadzenie do wyszukiwania.

Zrzut ekranu przedstawiający stronę Podsumowanie, pole wyszukiwania.

Inicjowanie pliku README dla repozytorium Git

Możesz udostępnić swój projekt i cel oraz sposoby współtworzenia projektu przez członków zespołu za pośrednictwem pliku README projektu. W przypadku projektów Git plik README.md musi znajdować się w katalogu głównym każdego repozytorium w gałęzi domyślnej. W przypadku projektów opartych na usłudze Git okienko po lewej stronie obsługuje nawigację do innych repozytoriów. Dla każdego repozytorium można utworzyć oddzielną stronę powitalną/plik README.md.

  1. Otwórz pliki repozytoriów>. Ta strona przeprowadzi Cię szybko, dodając kod do repozytorium, wybierając jedną z opcji klonowania, wypychania, importowania lub inicjowania repozytorium.

  2. Po zaznaczeniu pola wyboru Dodaj plik README wybierz pozycję Inicjuj.

    Zrzut ekranu przedstawiający inicjowanie pliku README, najnowsze wersje

    Domyślny plik README jest dodawany do repozytorium projektu, w tym przypadku repozytorium Fabrikam Test .

  3. Wróć do pozycji Podsumowanie przeglądu>i wybierz plik README dla strony projektu. Zaznacz Edytuj.

    Zrzut ekranu przedstawiający wybieranie pliku README.

  4. Wybierz repozytorium projektu, w którym zainicjowano plik README.

    Zrzut ekranu przedstawiający wybieranie repozytorium, w którym istnieje plik README.

  5. Aby edytować plik README, wybierz link plik README.

    Zrzut ekranu przedstawiający edytowanie pliku README.

    Zostanie przekierowana do strony Pliki repozytoriów> dla pliku README. Plik Markdown README można edytować i modyfikować tak, jak każdy inny plik w repozytorium Git. Możesz użyć języka Markdown do formatowania pliku README i dodawania obrazów. Aby uzyskać więcej informacji, zobacz Create a README for your repo and Markdown guidance (Tworzenie pliku README dla repozytorium i wskazówek dotyczących języka Markdown).

Inicjowanie pliku README dla repozytorium TFVC

W przypadku projektów wybranych kontroli wersji kontroli wersji plik README.md musi znajdować się w folderze głównym projektu zespołowego, na przykład $/TeamProject/README.md.

  1. Otwórz pliki repozytoriów>.

  2. Wybierz pozycję Dodaj opis projektu.

    Zrzut ekranu przedstawiający stronę powitalną, nowy projekt TFVC, utwórz plik readme.

  3. Wybierz repozytorium TFVC i wybierz pozycję Zapisz. Jeśli żaden plik README nie znajduje się w repozytorium, zostanie wyświetlony następujący komunikat.

    Zrzut ekranu przedstawiający okno dialogowe Informacje o tym projekcie.

  4. Aby utworzyć plik README, wybierz pozycję Pliki repozytoriów>i wybierz nowy plik, aby dodać plik do repozytorium projektu.

  5. Nadaj plikowi nazwę README.md.

    Zrzut ekranu przedstawiający okno dialogowe Dodawanie nowego pliku.

  6. Dodaj zawartość pliku README w formacie Markdown, a następnie wybierz pozycję Zaewidencjonuj....

    Zrzut ekranu przedstawiający zawartość pliku README Enter.

  7. Wybierz pozycję Zaewidencjonuj, aby ukończyć proces ewidencjonowania pliku README.

    Zrzut ekranu przedstawiający okno dialogowe Ewidencjonuj plik README.

  8. Wybierz pozycję Podsumowanie przeglądu>, aby przejrzeć stronę podsumowania projektu z wyświetlonym plikiem README.

    Zrzut ekranu przedstawiający stronę podsumowania projektu z wyświetlonym plikiem README.

Interfejsy API REST