Buat Tindakan Cepat Finder yang menerima file, mengulangi pilihan, dan membuka setiap item di app pilihan Anda. Panduan ini menggunakan file teks sementara dan TextEdit, serta memeriksa input yang tidak ada, nama file duplikat, dan koneksi variabel yang keliru.

Siapkan file yang dapat dibuka oleh app pilihan Anda

Tugas konkretnya adalah memilih beberapa file lokal yang sudah ada di Finder dan mengirim setiap file ke app yang sama. Mulailah dengan dua dokumen teks biasa buatan: Blue note.txt, berisi Blue sample, dan Green note.txt, berisi Green sample. Simpan keduanya di folder baru di Desktop bernama Finder Opening Test. Jika folder tersebut sudah ada, pilih nama lain dan sesuaikan contoh berikutnya.

Sebelum membuat pintasan, buka setiap contoh secara manual: klik file di Finder sambil menahan Control, pilih Open With, lalu pilih TextEdit. Ini memastikan app yang dimaksud dapat menangani input tersebut. Apple mendokumentasikan cara ini untuk membuka file dengan app tertentu, selain cara menyeret file ke ikon app. Memilih app untuk membuka file di Mac.

Untuk alur kerja lain, gunakan app yang terpasang dan file sementara dalam format yang didukungnya. Memilih app tidak memastikan bahwa app tersebut dapat membaca semua format yang dipilih. Batasi pengujian awal pada dokumen lokal biasa; folder dan paket dokumen memerlukan penanganan berbeda.

Buat Tindakan Cepat Finder

Konfigurasikan input file dan respons untuk pilihan kosong

Buat pintasan di Pintasan dan beri nama Open Selected Text in TextEdit. Panduan pembuatan Apple menjelaskan cara menambahkan tindakan dari pustaka tindakan dan mengonfigurasikan parameternya. Membuat pintasan khusus di Mac.

Buka Details pintasan, aktifkan Use as Quick Action, lalu pilih Finder sebagai lokasi yang tersedia. Apple mendokumentasikan integrasi Finder dan menyebutkan bahwa memilih Finder mungkin mengharuskan Anda menambahkan file atau folder ke input pintasan yang diizinkan. Menjalankan pintasan saat menggunakan Mac.

Di bagian atas alur kerja, klik jenis input yang diterima. Hapus pilihan umum, lalu aktifkan Files. Apple mendefinisikan jenis ini sebagai mencakup dokumen, gambar, PDF, dan file lainnya; folder memiliki jenis input tersendiri. Alur kerja ini memang dirancang untuk menerima file. Memahami jenis input di Pintasan pada Mac.

Atur perilaku tanpa input ke Stop and Respond, dengan pesan Select sample files in Finder, then run this Quick Action. Dengan begitu, pemanggilan tanpa input tetap mudah dipahami. Apple mendokumentasikan bahwa beberapa lokasi peluncuran, termasuk Dock, tidak menyediakan input awal, dan menyediakan opsi respons ini. Membatasi input pintasan saat dijalankan dari app lain di Mac.

Hubungkan setiap file yang dipilih ke tindakan pembuka

Tambahkan Repeat with Each dan atur daftarnya ke Shortcut Input. Di dalam perulangan, tambahkan Open File. Atur parameter filenya ke Repeat Item, lalu pilih TextEdit di parameter app, bukan membiarkan Default App tetap dipilih. Berikut ini diagram alur kerja, bukan kode yang dapat dijalankan:

Terima File dari Finder
Jika tidak ada input: Berhenti dan Beri Respons

Ulangi untuk setiap item dalam Shortcut Input
    Buka Repeat Item di TextEdit
Akhiri Pengulangan

Koneksi pentingnya adalah Repeat Item. Apple mendokumentasikan bahwa Repeat with Each menerima sebuah daftar dan menjalankan tindakan di dalamnya sekali untuk setiap item; Repeat Item berisi item saat ini pada setiap iterasi. Meneruskan seluruh daftar Shortcut Input ke tindakan pembuka di dalam perulangan akan menggagalkan rancangan satu file per iterasi tersebut. Menggunakan tindakan Repeat di Pintasan pada Mac.

Periksa informasi tindakan pembuka di Mac Anda sebelum menjalankannya: klik ikonnya sambil menahan Control, lalu pilih Show Info. Apple mendokumentasikan cara ini untuk memeriksa deskripsi tindakan, input yang diterima, dan output yang dihasilkan. Pastikan Anda memilih tindakan untuk membuka file dan konfigurasinya menyediakan app yang dipilih. Menavigasi daftar tindakan di Pintasan pada Mac.

Pertahankan batasan berikut saat mengedit alur kerja:

Tahap Nilai yang digunakan di sini Hal yang perlu dipertahankan
Input Finder Item file yang dipilih Pertahankan file sebagai item file.
Input Repeat with Each Daftar Shortcut Input Proses daftar yang diberikan.
Repeat Item Satu file yang dipilih Hubungkan variabel ini ke Open File.
Setelah dibuka Tidak ada tindakan lanjutan dalam alur kerja ini Jangan menganggap hasilnya berisi konten dokumen yang telah diedit.

Apple menjelaskan bahwa perulangan mengumpulkan output tindakan yang ada di dalamnya menjadi hasil keseluruhan. Karena itu, hasil perulangan bergantung pada kontrak output tindakan tersebut. Pintasan ini hanya memerlukan operasi pembukaan dan berakhir di End Repeat; pintasan ini tidak menggunakan hasil tersebut sebagai daftar file baru. Alur data tindakan Repeat.

Jalankan pengujian kecil sebelum menggunakan pilihan yang lebih banyak

Di Finder, buka Finder Opening Test, pilih kedua dokumen contoh, lalu klik salah satu item yang dipilih sambil menahan Control. Pilih Quick Actions, lalu Open Selected Text in TextEdit. Apple mendokumentasikan cara menjalankan pintasan dari menu kontekstual ini dan dari panel pratinjau Finder. Jika pintasan tidak muncul, periksa ketersediaannya di Finder dan apakah ekstensi Finder-nya diaktifkan. Menjalankan pintasan dari menu Quick Actions.

Periksa isinya, bukan hanya apakah TextEdit muncul. Anda seharusnya dapat menemukan Blue sample dan Green sample. Alur kerja ini meminta satu operasi pembukaan untuk setiap file yang dipilih; alur kerja ini tidak mengatur posisi jendela, pengelompokan tab, atau urutan dokumen.

Gunakan matriks pengujian kecil ini untuk membedakan masalah pemilihan file dari masalah app. Ini adalah pemeriksaan yang disarankan, bukan hasil pengujian yang dilaporkan:

Pengujian Hal yang perlu diperiksa
Pilih hanya Blue note.txt Contoh biru terbuka.
Pilih kedua dokumen contoh Kedua konten yang berbeda dapat diakses.
Jalankan tanpa input yang diberikan Pesan pilihan yang dikonfigurasikan muncul.
Pilih dua file dengan nama sama dari folder berbeda Kedua konten yang berbeda tetap dapat dikenali.

Untuk pemeriksaan terakhir, buat dua subfolder di dalam folder pengujian sementara. Simpan dokumen teks biasa bernama Sample.txt di masing-masing folder, dengan isi First folder sample dan Second folder sample. Pilih kedua file tersebut sekaligus dalam pencarian Finder yang dibatasi ke folder pengujian, lalu jalankan Tindakan Cepat.

Ini merupakan diagnostik yang berguna karena alur kerja yang diusulkan meneruskan langsung item file yang dipilih. Alur kerja ini tidak memiliki langkah untuk mengambil nama dasar file dan menyusun ulang jalur. Pertahankan koneksi langsung tersebut saat menyesuaikannya: nama file saja tidak dapat membedakan kedua dokumen ini.

Pahami batasan keberadaan file dan tabrakan nama

File harus sudah ada saat operasi pembukaan menggunakannya. Pintasan ini tidak memiliki langkah pembuatan atau pemulihan. Jika contoh file telah dipindahkan atau dihapus, pilih kembali file tersebut dari lokasinya saat ini sebelum mencoba lagi. Hindari menambahkan jalur tetap hanya untuk mengatasi pilihan yang sudah tidak berlaku.

Alur kerja ini juga tidak memiliki tindakan menyalin, mengganti nama, memindahkan, atau menyimpan. Karena itu, alur kerja ini tidak menetapkan kebijakan penamaan tujuan. Dua file yang sudah ada bernama Sample.txt di folder berbeda tidak memerlukan nama output baru untuk alur kerja ini. Jika nanti Anda menambahkan langkah penyimpanan atau ekspor, tentukan secara terpisah tujuannya dan cara menangani nama file yang sudah ada.

Membuka dokumen juga tidak memastikan bahwa operasi pengeditan atau ekspor berikutnya berhasil. Batasi versi pertama pada pembukaan contoh sementara, lalu evaluasi operasi tambahan apa pun berdasarkan input, output, dan perilakunya terhadap file yang sudah ada.

Gunakan Terminal untuk mengisolasi masalah input

Jika pemanggilan dari Finder tidak jelas, uji pintasan yang sama dengan input file eksplisit. Apple mendokumentasikan shortcuts run dan opsi -i untuk memberikan jalur file. Apple secara khusus membedakannya dari mengirim teks jalur melalui pipa, yang memberikan teks alih-alih input jalur file. Menjalankan pintasan dari baris perintah.

Setelah membuat pintasan dan dua file contoh di Desktop seperti yang dijelaskan di atas, jalankan contoh shell lengkap ini di Terminal. Perintah ini memeriksa kedua jalur sebelum memanggil Pintasan dan mengapit setiap jalur dengan tanda kutip agar spasi tetap terjaga. Sintaks shell-nya telah diperiksa; perintah macOS dan alur kerja grafisnya tidak dijalankan di lingkungan riset ini.

/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

Contoh ini hanya menggunakan dua jalur contoh yang ditentukan secara eksplisit. Contoh ini tidak menemukan pilihan Finder saat ini. Apple mendokumentasikan status keluar 0 untuk pemanggilan pintasan yang berhasil dan 1 untuk kesalahan; tetap periksa dokumen contoh untuk memastikan hasil yang terlihat sesuai harapan. Perilaku perintah Pintasan.

Diagnosis titik pertama saat hasilnya berbeda

Jika pintasan muncul tetapi tidak menerima apa pun, periksa jenis Files yang diterima dan panggil lagi dengan file contoh yang dipilih di Finder. Jika hanya satu dokumen yang terbuka, periksa koneksi daftar pada perulangan dan koneksi Repeat Item pada tindakan pembuka.

Untuk memeriksa apa yang masuk ke alur kerja, tempatkan Quick Look sementara sebelum perulangan dan hubungkan secara eksplisit ke Shortcut Input. Pastikan perulangan juga tetap terhubung secara eksplisit ke Shortcut Input. Apple menyarankan menyisipkan Quick Look di antara tindakan untuk memeriksa konten yang diteruskan. Hapus tindakan diagnostik setelah memeriksa contoh file. Menguji tindakan Anda di Pintasan pada Mac.

Jika app lain yang terbuka, periksa kembali parameter app di Open File. Jika TextEdit tidak dapat membuka contoh file secara manual, atasi masalah dokumen tersebut terlebih dahulu. Apple menyebutkan bahwa app mungkin gagal membuka file karena tidak mengenali formatnya. Memilih app untuk membuka file di Mac.

Setelah kedua contoh sementara terbuka melalui Finder, pintasan siap digunakan untuk tugas yang sama dengan file lokal yang kompatibel: pilih dokumen, jalankan Tindakan Cepat, dan periksa dokumen tersebut di app pilihan. Pertahankan item file dan koneksi perulangan satu item saat menyesuaikannya.

Sumber