Wymagania dotyczące importu

Istniejące dane dotyczące wymagań można szybko i łatwo przesłać do portalu wymagań za pomocą strony Import Wizard dostępnej w module wymagań.

Dostęp do strony Import Wizard można uzyskać z górnego paska portalu wymagań, klikając przycisk w prawym górnym rogu. Alternatywnie, gdy aktualnie przeglądana jest specyfikacja bez wymagań, dostęp do strony Import Wizard można uzyskać, klikając przycisk .

Dostęp do Import Wizard
Dostęp do Import Wizard

Aby zaimportować specyfikację, kreator prowadzi użytkownika przez trzy główne etapy: Specification, Upload, i Review. Po zakończeniu importu specyfikacji wyświetlane jest podsumowanie, a także możliwość wykonania dodatkowych czynności, takich jak walidacja lub import innych plików. Te etapy i działania zostały opisane w poniższych sekcjach.

Etap 1 - Specyfikacja

Na tym etapie Import Wizard można zdefiniować docelową specyfikację importu:

  • Użyj regionu Select a specification po lewej stronie okna Import Requirements, aby wybrać istniejącą specyfikację i opcjonalnie jej sekcję.

  • Użyj regionu Create a specification po prawej stronie okna Import Requirements, aby utworzyć nową specyfikację (a także zdefiniować skrót i blok, do którego ma zostać przypisany) bez opuszczania kreatora importu.

Kliknij wymagany region, aby użyć preferowanej metody.

  • Jeśli strona Import Wizard zostanie uruchomiona w kontekście specyfikacji lub sekcji, pojawi się ona jako wstępny wybór miejsca docelowego importu.

  • Jeśli nie ma istniejących specyfikacji, należy je utworzyć.

  • W definicji nazwy nowej specyfikacji muszą być spełnione zasady definicji nazwy - dozwolone są tylko znaki alfanumeryczne i znaki specjalne _ (podkreślenie).

Etap 2 - Przesyłanie

Na tym etapie Import Wizard można przesłać plik obsługiwanego typu. Aby to zrobić, przeciągnij i upuść plik po prawej stronie okna Import Requirements lub kliknij kontrolkę Drop file, aby przejrzeć i wybrać plik z dysku twardego. Po pomyślnym przesłaniu pliku w oknie zostanie wyświetlone powiadomienie.

  • Obsługiwane są tylko pliki Excel (.xls, .xlsx) i pliki z wartościami oddzielonymi przecinkami (.csv). Pliki makr programu Excel (.xlsm) nie są obsługiwane.

  • W przypadku przesłania nieobsługiwanego pliku zostanie wyświetlony komunikat o błędzie.

  • Po przesłaniu pliku można kontynuować proces importowania lub przesłać nowy plik (zastępując poprzedni).

Etap 3 - Przegląd

Na tym etapie na stronie Import Wizard można przejrzeć wyniki importu danych z przesłanego pliku, skonfigurować opcje pliku i zmapować dane z pliku do pól wymagań.

Region Destination okna Import Requirements zapewnia wizualne wskazanie miejsca, w którym dane zostaną zaimportowane (pod względem specyfikacji lub sekcji).

Region File options udostępnia następujące opcje:

  • Update requirements - po włączeniu, wszelkie istniejące wymagania w specyfikacji docelowej zostaną zastąpione przez zastąpienie danych (dane pliku zastępują dane w specyfikacji).

    • Jeśli opcja jest wyłączona i importowane są wymagania, których identyfikator już istnieje w specyfikacji wybranej jako miejsce docelowe, portal Requirements Portal doda przyrostek _import do identyfikatorów importowanych wymagań, aby je rozróżnić.

    • Jeśli opcja jest wyłączona i importujesz wymagania, których Identyfikatory już istnieją w bieżącym projekcie, ale nie w specyfikacji wybranej jako miejsce docelowe, Portal wymagań doda ikonę ostrzeżenia do identyfikatorów, które ostrzegają o zduplikowanym identyfikatorze w tym samym projekcie.

    • Jeśli opcja jest włączona, puste wartości w importowanym pliku są obsługiwane, tzn. jeśli wartość w pliku jest pusta, wartość ta jest usuwana z wymagania. Dotyczy to również pól wielokrotnego wyboru, takich jak Tags.

  • Use header row - Możesz zdecydować się na użycie wiersza nagłówka przesłanego pliku lub użyć ogólnego referencyjnego wiersza nagłówka dostarczonego przez portal wymagań (tj. nagłówki kolumn jako A, B, C itp.).

    Portal wymagań traktuje wiersz nagłówka jako pierwszy wiersz każdego przesłanego pliku.

  • Sheet - W przypadku pliku z wieloma arkuszami można wybrać arkusz, z którego ma zostać zaimportowany.

  • Starting row - Można wybrać, od którego wiersza zaimportowanego pliku ma rozpocząć się zbieranie danych w celu wstawienia ich do portalu wymagań.

W tabeli w dolnej części okna Import Requirements wyświetlany jest podgląd przesłanego pliku i mapowane są jego kolumny na pola w portalu wymagań. Pozwala to określić, w jaki sposób dane z pliku będą odpowiadać określonym polom w portalu wymagań, wybierając odpowiednie pole z listy rozwijanej Map To dla każdej kolumny. Jeśli plik zawiera nagłówki identyczne z domyślnymi polami w portalu wymagań, pola te zostaną automatycznie zmapowane. W razie potrzeby można jednak zastąpić lub dostosować to automatyczne mapowanie.

  • Do mapowania można wybrać następujące pola:

    • Identyfikator

    • Tekst

    • Tytuł

    • Uzasadnienie

    • Rodzice

    • Dzieci

    • Ścieżka do sekcji

    • Typ

    • Stan

    • Tagi

    • Zgodność

    • Komentarz dotyczący zgodności

    • Metody weryfikacji

    • Stosowalność

    • Obowiązujące bloki

    • Właściciel

    • Tagi

    • Kolumny niestandardowe

  • Metody weryfikacji, zastosowanie i tagi mogą być importowane z więcej niż jedną wartością dla każdego wymagania. W tym celu każdą wartość należy oddzielić przecinkiem.

  • W przypadku zastosowania, do złożonych typów bloków można odwoływać się za pomocą /, na przykład block_A/block_B.

Musi być wybrana przynajmniej kolumna Identyfikator. W przeciwnym razie do momentu spełnienia tego warunku wyświetlany będzie komunikat ostrzegawczy ().

Raport z wykonania

Po zakończeniu procesu importowania i pomyślnym zakończeniu importowania wyświetlany jest komunikat o powodzeniu i wprowadzonych zmianach. Jeśli import nie powiedzie się, zostanie wyświetlony komunikat o niepowodzeniu. Poniżej przedstawiono przykład udanego importu.

Jeśli wystąpią błędy miękkie, zostaną one również wyświetlone (). Możliwe błędy miękkie to:

  • Nie można ustanowić relacji → Identyfikator rodzica lub dziecka nie istnieje w projekcie

  • Nie można ustanowić relacji → Identyfikator rodzica lub dziecka jest zduplikowany w projekcie

  • Oświadczenie o zgodności z wymaganiami nie istnieje w projekcie

  • Typ wymagania nie istnieje w projekcie

  • Stan wymagania nie istnieje w projekcie

  • Tag nie istnieje w projekcie

  • Możliwość zastosowania Warunek nie istnieje

Niezależnie od tego, czy import się powiódł, czy nie, można ponownie zaimportować lub wykonać nowy import, klikając Import new file (sukces) lub Try again (niepowodzenie), co spowoduje powrót do etapu 1 (Specification).

Po pomyślnym zaimportowaniu można również rozpocząć proces weryfikacji, klikając przycisk Sprawdź teraz w górnej części okna. Proces ten przeskanuje zaimportowany tekst wymagań pod kątem możliwych parametrów kwantyfikowalnych, które zostaną przekonwertowane na Valis wewnątrz wymagania.

Więcej informacji można znaleźć na stronie Walidacja wymagań.

AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Content