Utwórz szybką czynność Findera, która przyjmuje pliki, przechodzi po zaznaczeniu i otwiera każdy element w wybranej aplikacji. W tym przewodniku użyto tymczasowych plików tekstowych i aplikacji TextEdit. Uwzględniono też sprawdzanie, czy nie brakuje danych wejściowych, czy nazwy plików się nie powtarzają oraz czy zmienne są prawidłowo połączone.

Przygotuj pliki, które może otworzyć wybrana aplikacja

Zadanie polega na zaznaczeniu w Finderze kilku istniejących plików lokalnych i otwarciu każdego z nich w tej samej aplikacji. Zacznij od dwóch przykładowych dokumentów tekstowych: Blue note.txt z treścią Blue sample oraz Green note.txt z treścią Green sample. Zapisz je w nowym folderze na biurku o nazwie Finder Opening Test. Jeśli taki folder już istnieje, wybierz inną nazwę i odpowiednio zmień dalszy przykład.

Zanim utworzysz skrót, ręcznie otwórz każdy plik przykładowy: kliknij go w Finderze z wciśniętym klawiszem Control, wybierz Otwórz w i wskaż TextEdit. Dzięki temu sprawdzisz, czy wybrana aplikacja potrafi obsłużyć dane wejściowe. Apple opisuje tę metodę otwierania pliku w konkretnej aplikacji, a także przeciąganie pliku na ikonę aplikacji. Wybieranie aplikacji do otwierania pliku na Macu.

W innym zastosowaniu wybierz zainstalowaną aplikację i pliki tymczasowe w obsługiwanym przez nią formacie. Sam wybór aplikacji nie gwarantuje, że odczyta ona każdy zaznaczony format. Pierwszy test ogranicz do zwykłych dokumentów lokalnych; foldery i pakiety dokumentów wymagają innej obsługi.

Utwórz szybką czynność Findera

Skonfiguruj dane wejściowe plików i reakcję na brak zaznaczenia

Utwórz skrót w aplikacji Skróty i nazwij go Open Selected Text in TextEdit. W przewodniku Apple opisano dodawanie czynności z biblioteki i konfigurowanie ich parametrów. Tworzenie własnego skrótu na Macu.

Otwórz Szczegóły skrótu, włącz Używaj jako szybkiej czynności i wybierz Finder jako dostępne miejsce. Apple opisuje integrację z Finderem i zaznacza, że może być konieczne dodanie plików lub folderów do dozwolonych danych wejściowych skrótu. Uruchamianie skrótu podczas pracy na Macu.

U góry obiegu pracy kliknij akceptowane typy danych wejściowych. Usuń szeroki wybór i zaznacz Pliki. Apple definiuje ten typ jako obejmujący dokumenty, obrazy, pliki PDF i inne pliki; foldery mają osobny typ danych wejściowych. Ten obieg pracy celowo przyjmuje pliki. Informacje o typach danych wejściowych w aplikacji Skróty na Macu.

Ustaw zachowanie przy braku danych wejściowych na Zatrzymaj i odpowiedz, a jako komunikat wpisz Select sample files in Finder, then run this Quick Action. Dzięki temu będzie jasne, co oznacza uruchomienie bez zaznaczonych plików. Apple wyjaśnia, że niektóre miejsca uruchamiania, w tym Dock, nie przekazują początkowych danych wejściowych, i opisuje tę opcję odpowiedzi. Ograniczanie danych wejściowych skrótu uruchamianego z innej aplikacji na Macu.

Połącz każdy zaznaczony plik z czynnością otwierania

Dodaj Powtórz dla każdego i ustaw listę na Dane wejściowe skrótu. Wewnątrz pętli dodaj Otwórz plik. Jako plik ustaw Powtarzany element, a w parametrze aplikacji wybierz TextEdit zamiast pozostawiać Aplikacja domyślna. Poniższy schemat przedstawia obieg pracy, a nie kod wykonywalny:

Odbierz pliki z Findera
Jeśli brak danych wejściowych: Zatrzymaj i odpowiedz

Powtórz dla każdego elementu na liście Dane wejściowe skrótu
    Otwórz Powtarzany element w TextEdit
Koniec powtarzania

Kluczowe jest połączenie z Powtarzanym elementem. Apple wyjaśnia, że czynność Powtórz dla każdego przyjmuje listę i wykonuje zawarte w niej czynności raz dla każdego elementu; podczas każdej iteracji Powtarzany element zawiera bieżący element. Przekazanie całej listy Dane wejściowe skrótu do czynności otwierania wewnątrz pętli zniweczyłoby zamysł przetwarzania po jednym pliku na iterację. Korzystanie z czynności powtarzania w aplikacji Skróty na Macu.

Przed uruchomieniem sprawdź informacje o czynności otwierania na Macu: kliknij jej ikonę z wciśniętym klawiszem Control i wybierz Pokaż informacje. Apple opisuje tę metodę jako sposób sprawdzania opisu czynności, akceptowanych danych wejściowych i wynikowych. Potwierdź, że wybrano czynność otwierania pliku i że jej konfiguracja pozwala wskazać wybraną aplikację. Poruszanie się po liście czynności w aplikacji Skróty na Macu.

Podczas edytowania obiegu pracy zachowaj następujące powiązania:

Etap Używana tu wartość Co zachować
Dane wejściowe Findera Zaznaczone pliki Traktuj pliki jako elementy plikowe.
Dane wejściowe Powtórz dla każdego Lista Dane wejściowe skrótu Przetwarzaj przekazaną listę.
Powtarzany element Jeden zaznaczony plik Połącz tę zmienną z Otwórz plik.
Po otwarciu Brak dalszej czynności w tym obiegu pracy Nie zakładaj, że wynikiem jest zawartość edytowanych dokumentów.

Apple wyjaśnia, że pętla powtarzania zbiera wyniki zawartych w niej czynności i zwraca je jako całość. W związku z tym wynik pętli zależy od tego, co zwracają te czynności. Ten skrót służy tylko do otwierania plików i kończy się na Koniec powtarzania; nie wykorzystuje wyniku jako nowej listy plików. Przepływ danych w czynności powtarzania.

Wykonaj mały test przed użyciem większego zaznaczenia

W Finderze otwórz folder Finder Opening Test, zaznacz oba dokumenty przykładowe, a następnie kliknij jeden z zaznaczonych elementów z wciśniętym klawiszem Control. Wybierz Szybkie czynności, a potem Open Selected Text in TextEdit. Apple opisuje uruchamianie skrótów z tego menu kontekstowego oraz z panelu podglądu Findera. Jeśli skrótu nie ma na liście, sprawdź, czy jest dostępny w Finderze i czy włączono jego rozszerzenie Findera. Uruchamianie skrótu z menu Szybkie czynności.

Sprawdź zawartość, a nie tylko to, czy otworzył się TextEdit. Powinny być widoczne teksty Blue sample i Green sample. Obieg pracy zleca osobne otwarcie każdego zaznaczonego pliku; nie określa położenia okien, grupowania kart ani kolejności dokumentów.

Skorzystaj z poniższej niewielkiej macierzy testów, aby odróżnić problemy z zaznaczeniem od problemów z aplikacją. Są to proponowane kontrole, a nie zgłoszone wyniki testów:

Test Co sprawdzić
Zaznacz tylko Blue note.txt Otworzy się niebieski przykład.
Zaznacz oba dokumenty przykładowe Dostępne są obie różne treści.
Uruchom bez przekazanych danych wejściowych Pojawi się skonfigurowany komunikat o zaznaczeniu.
Zaznacz dwa pliki o tej samej nazwie z różnych folderów Obie różne treści pozostają rozróżnialne.

Do ostatniego sprawdzenia utwórz dwa podfoldery wewnątrz tymczasowego folderu testowego. W każdym zapisz dokument tekstowy o nazwie Sample.txt, z treścią odpowiednio First folder sample i Second folder sample. Zaznacz oba pliki jednocześnie w wyszukiwaniu Findera ograniczonym do folderu testowego, a następnie uruchom szybką czynność.

To przydatna kontrola diagnostyczna, ponieważ proponowany obieg pracy przekazuje zaznaczone elementy plikowe bezpośrednio. Nie zawiera czynności, która wyodrębniałaby nazwę pliku bez rozszerzenia i odtwarzała ścieżkę. Zachowaj te bezpośrednie połączenia przy dostosowywaniu obiegu: sama nazwa pliku nie pozwala odróżnić tych dwóch dokumentów.

Poznaj ograniczenia dotyczące istnienia plików i kolizji nazw

Pliki muszą już istnieć w chwili, gdy czynność otwierania ma z nich skorzystać. Ten skrót nie zawiera czynności tworzenia ani odzyskiwania plików. Jeśli przykład został przeniesiony lub usunięty, przed ponowną próbą zaznacz go w aktualnym położeniu. Nie dodawaj stałej ścieżki tylko po to, by zrekompensować nieaktualne zaznaczenie.

Obieg pracy nie zawiera też czynności kopiowania, zmiany nazwy, przenoszenia ani zapisywania. Nie określa więc zasad nazewnictwa plików docelowych. Dwa istniejące pliki o nazwie Sample.txt w różnych folderach nie wymagają nowej nazwy wynikowej w tym obiegu pracy. Jeśli później dodasz zapisywanie lub eksportowanie, osobno określ lokalizację docelową i sposób obsługi istniejącej nazwy pliku.

Samo otwarcie dokumentu nie potwierdza też, że późniejsza edycja lub eksport się powiodły. Ogranicz pierwszą wersję do otwierania tymczasowych przykładów, a następnie oceniaj każdą dodatkową czynność pod kątem jej własnych danych wejściowych, wynikowych i sposobu obsługi istniejących plików.

Użyj Terminala, aby wyodrębnić problemy z danymi wejściowymi

Jeśli sposób uruchamiania z Findera jest niejasny, przetestuj ten sam skrót, przekazując jawnie pliki jako dane wejściowe. Apple opisuje polecenie shortcuts run i opcję -i, która pozwala przekazać ścieżki plików. Wyraźnie odróżnia tę metodę od przekazywania tekstu ze ścieżką za pomocą potoku, co dostarcza tekst, a nie dane wejściowe w postaci ścieżki do pliku. Uruchamianie skrótów z wiersza poleceń.

Po utworzeniu skrótu i dwóch przykładów na biurku opisanych powyżej uruchom w Terminalu poniższy kompletny przykład powłoki. Przed wywołaniem Skrótów sprawdza obie ścieżki i ujmuje każdą w cudzysłowy, aby zachować spacje. Składnię powłoki sprawdzono; polecenie macOS i graficzny obieg pracy nie były uruchamiane w tym środowisku badawczym.

/bin/bash <<'SCRIPT'
set -eu

sample_dir="$HOME/Desktop/Finder Opening Test"
first="$sample_dir/Blue note.txt"
second="$sample_dir/Green note.txt"

for file in "$first" "$second"; do
  if [ ! -f "$file" ]; then
    printf 'Missing sample file: %s\n' "$file" >&2
    exit 1
  fi
done

/usr/bin/shortcuts run "Open Selected Text in TextEdit" \
  -i "$first" "$second"
SCRIPT

Przykład używa tylko dwóch jawnie podanych ścieżek do plików przykładowych. Nie wykrywa aktualnego zaznaczenia w Finderze. Apple podaje, że kodem wyjścia oznaczającym pomyślne uruchomienie skrótu jest 0, a błędu — 1; mimo to sprawdź dokumenty przykładowe, aby potwierdzić oczekiwany widoczny rezultat. Działanie poleceń Skrótów.

Zdiagnozuj pierwszy punkt, w którym wynik odbiega od oczekiwań

Jeśli skrót pojawia się na liście, ale niczego nie otrzymuje, sprawdź akceptowany typ Pliki i uruchom go ponownie po zaznaczeniu plików przykładowych w Finderze. Jeśli otworzy się tylko jeden dokument, sprawdź połączenie listy w pętli oraz połączenie Powtarzanego elementu z czynnością otwierania.

Aby sprawdzić, co trafia do obiegu pracy, tymczasowo umieść Szybki podgląd przed pętlą powtarzania i jawnie połącz go z Dane wejściowe skrótu. Pętlę powtarzania również pozostaw jawnie połączoną z Dane wejściowe skrótu. Apple zaleca wstawienie Szybkiego podglądu między czynnościami, by sprawdzić przekazywaną zawartość. Po sprawdzeniu przykładów usuń czynność diagnostyczną. Testowanie czynności w aplikacji Skróty na Macu.

Jeśli otworzy się inna aplikacja, ponownie sprawdź parametr aplikacji w Otwórz plik. Jeśli TextEdit nie może ręcznie otworzyć przykładowego pliku, najpierw rozwiąż problem z tym dokumentem. Apple zaznacza, że aplikacja może nie otworzyć pliku, jeśli nie rozpoznaje jego formatu. Wybieranie aplikacji do otwierania pliku na Macu.

Gdy oba tymczasowe przykłady otworzą się z Findera, skrót będzie gotowy do tego samego zadania z kompatybilnymi plikami lokalnymi: zaznacz dokumenty, uruchom szybką czynność i sprawdź je w wybranej aplikacji. Podczas dostosowywania zachowaj elementy plikowe i połączenie pętli przetwarzającej po jednym elemencie.

Źródła