Integracja Folderit z Microsoft Power Automate

Użyj łącznika Folderit DMS dla Microsoft Power Automate, aby połączyć zarządzanie dokumentami z innymi aplikacjami biznesowymi. Twórz przepływy, które tworzą foldery, wyszukują dokumenty, przesyłają pliki, dodają wersje, aktualizują metadane lub uruchamiają skonfigurowane przepływy pracy Folderit.

Dostępność — aktualizacja 27 października 2026 r.: Firma Microsoft zakończyła certyfikację i publikację, a Partner Center wskazuje status łącznika Live. Dostępność może się różnić podczas wdrażania: nasza ostatnia kontrola w normalnym środowisku Power Automate nie wykazała jeszcze publicznego łącznika Folderit DMS. Poniższe kroki połączenia mają zastosowanie, gdy łącznik pojawi się w Twoim środowisku. Jeśli nie możesz go znaleźć, skontaktuj się z Folderit, aby dowiedzieć się o aktualnej dostępności, zamiast wybierać niepowiązany niestandardowy łącznik.

Wsparcie wdrożeniowe: Ten przewodnik dotyczy standardowej usługi Folderit w chmurze. Wdrożenia dedykowane, domeny niestandardowe Folderit i instalacje lokalne nie są obecnie obsługiwane przez ten opublikowany łącznik.

Ten przewodnik omawia wymagania wstępne, konfigurację samoobsługową, podłączenie konta, pierwszy przepływ, mapowanie zawartości pliku, praktyczne przykłady, Microsoft Copilot, oraz rozwiązywanie problemów.

Zanim zaczniesz

• Konto Folderit z dostępem API i pozwoleniem na korzystanie z zamierzonych dokumentów i folderów. Zobacz Dostęp do API Folderit lub zapytaj administratora konta.
• Konto służbowe lub szkolne Microsoft, dostęp do docelowego środowiska Power Automate oraz licencja obejmująca łączniki premium. Nie wszystkie subskrypcje Microsoft 365 obejmują te prawa. Sprawdź Aktualne wskazówki dotyczące licencjonowania usługi Power Automate firmy Microsoft.
• Łącznik Folderit DMS musi być dostępne w Twoim środowisku i dozwolone przez zasady Power Platform Twojej organizacji.
• W przypadku przepływu z udziałem Outlooka, SharePoint, Teams, systemu księgowego lub innej aplikacji potrzebne jest również odpowiednie konto i połączenie dla tej usługi.

Wybierz mały, dokument testowy bez poufnych danych i wyraźnie oznaczony folder testowy do pierwszego przepływu. Przesyłanie plików przez to złącze jest obecnie ograniczone do 10 MiB na plik.

Połącz swoje konto Folderit

1. Otwórz Microsoft Power Automate i wybierz środowisko, w którym będzie uruchamiany przepływ.
2. Otwórz Connections, wybierz New connection i wyszukaj Folderit DMS. Połączenia mogą być dostępne poprzez menu nawigacyjne More.
3. Wybierz opublikowany łącznik Folderit DMS i wybierz opcję utworzenia połączenia.
4. Zaloguj się do Folderit i udziel autoryzacji. Użyj konta użytkownika Folderit z dostępem do konta, folderów i dokumentów wymaganych przez przepływ.
5. Wróć do Power Automate i potwierdź, że połączenie zostało nawiązane. Wybierz to połączenie podczas dodawania akcji Folderit do swojego przepływu.

Połączenie Folderit wykorzystuje istniejące uprawnienia zalogowanego użytkownika. Logowanie do Microsoft i autoryzacja Folderit to osobne kroki. Trzymaj sekrety klienta OAuth poza polami przepływu, metadanymi dokumentów i wiadomościami pomocy technicznej.

Nie możesz znaleźć Folderit DMS? Sprawdź powyższą informację o dostępności i zasady dotyczące łączników obowiązujące w Twojej organizacji. Istniejące łączniki specyficzne dla dzierżawy o nazwach Folderit lub Folderit Development to osobne zasoby niestandardowe; ich obecność nie potwierdza, że złącze publiczne jest dostępne.

Co potrafi łącznik

Obecny łącznik udostępnia 19 akcji:

• Konta: List accounts; Get account.
• Foldery List root folders; List child folders; Get folder; Create folder.
• Wyszukiwanie i rekordy: Search records; Get record; Get file; List folder contents.
• Transfery i wersje plików: Upload file; Download file; Add file version; List file versions.
• Metadane List metadata fields; Get metadata; Update metadata.
• Przepływy pracy List startable workflows; Start workflow.

Łącznik udostępnia obecnie akcje, ale nie ma wyzwalacza zdarzeń Folderit. Rozpocznij przepływ za pomocą przycisku ręcznego, harmonogramu lub obsługiwanego zdarzenia z innej aplikacji. Zaplanowane sprawdzenie nowego pliku wymaga własnego zapisanego stanu, aby odróżnić nowe rekordy od rekordów już przetworzonych.

Identyfikatory UID kont, folderów, plików, rekordów, przepływów pracy i pól metadanych identyfikują różne zasoby. Użyj identyfikatora zwróconego przez odpowiednią akcję Folderit; nazwa dokumentu nie jest jego UID. Użyj dostępnych selektorów kont i folderów, jeśli są dostępne.

Skonfiguruj go we własnym środowisku

Możesz skonfigurować swoje przepływy, korzystając z własnych kont Microsoft i Folderit. Pracownicy Folderit nie potrzebują dostępu do Twojej dzierżawy ani dokumentów. Być może Twoja organizacja będzie musiała zapewnić odpowiednią licencję Microsoft, zezwolić na łącznik lub udzielić Ci pozwolenia na tworzenie przepływów.

1. Najpierw sprawdź dostępność. Wyszukaj publiczny łącznik Folderit DMS w New connection. Jeśli go nie ma, poczekaj na dostępność w swoim środowisku; importowanie prywatnego łącznika i konfigurowanie poświadczeń OAuth to inny proces administratora/programisty.
2. Połącz swoje własne konta. Użyj połączeń Microsoft dla usług źródłowych, które chcesz zautomatyzować, oraz własnego autoryzowanego połączenia Folderit. Pobrany przepływ nie zawiera Twoich danych uwierzytelniających i nie zapewnia dostępu do dokumentów.
3. Wybierz wąskie źródło i miejsce docelowe. Zacznij od dedykowanego folderu przyjmowania poczty e-mail lub folderu biblioteki dokumentów i oznaczonego folderu testowego w Folderit. Potwierdź konto i miejsce docelowe za pomocą selektorów łącznika lub akcji Get account / Get folder.
4. Uruchom poniższy przykład ręcznego wyszukiwania. Potwierdź znany wynik i pusty wynik przed dodaniem etapu zapisywania dokumentu.
5. Przetestuj obsługę plików i powtarzające się zdarzenia. Użyj małego, dokumentu bez poufnych danych, sprawdź faktycznie zapisane bajty i miejsce docelowe oraz potwierdź, że to samo zdarzenie źródłowe nie może utworzyć ponownego przesłania pliku. Zachowaj niepewne zapisy do kontroli, zamiast automatycznie je ponawiać.

Praktyczne przykłady w tym przewodniku opisują konfigurowane przepływy; nie są to linki do szablonów gotowych do importu. Podczas importowania pakietu przepływu klienci muszą wybrać własne połączenia i skonfigurować własne miejsca docelowe. Firma Microsoft wymaga roli Environment Maker w przypadku importowania pakietów innych niż rozwiązania; administrator może potwierdzić odpowiednie uprawnienia dla Twojego środowiska. Zobacz Wytyczne firmy Microsoft dotyczące eksportu/importu.

Unikaj duplikatów i odzyskaj nieudany transfer

Budując przepływ, który zapisuje dokumenty, prowadź zapis śledzenia dla każdego elementu źródłowego i miejsca docelowego. Zarezerwuj tę tożsamość przed przesłaniem, zweryfikuj zapisany plik na docelowym koncie i folderze Folderit i oznacz rekord Completed dopiero po weryfikacji. Powtórzone zdarzenie z tą samą pełną tożsamością i zweryfikowanym rekordem Completed powinno pominąć przesyłanie. Jeśli istnieje rekord Reserved lub NeedsReview, przetwarzanie powinno zostać zatrzymane w celu kontroli. Same nazwy plików nie stanowią niezawodnej ochrony przed duplikatami.

Jeśli przesyłanie się powiedzie, ale aktualizacja śledzenia nie powiedzie się, nie przesyłaj ponownie. Sprawdź nieudane działanie oraz dokładny identyfikator zapisanego pliku, miejsce docelowe i bajty. Po niezależnej weryfikacji zamierzonego pliku należy uzupełnić istniejący rekord śledzenia zgodnie z ustalonym wynikiem. Nie usuwaj rezerwacji tylko po to, aby powtórne uruchomienie było kontynuowane: dokument mógł zostać zapisany w wyniku nieudanego zapisu lub przekroczenia limitu czasu. W wiadomości e-mail zawierającej kilka załączników pomiń tylko załącznik, którego przetwarzanie zakończono, aby móc nadal przetwarzać pozostałe załączniki.

Konfiguracja listy SharePoint: wymuś unikatowe wartości klucza śledzenia. Jeśli importujesz listę śledzenia z pliku CSV, sprawdź, czy State jest polem pojedynczego wyboru zawierającym zamierzone wartości. Import CSV może nadawać kolumnom wewnętrzne nazwy, takie jak field_1, nawet jeśli ich wyświetlane nazwy to FullKey lub RunId. Użyj znaczników zawartości dynamicznej z etykietą projektanta lub sprawdź małe syntetyczne dane wyjściowe elementu Get/Create przed zapisaniem wyrażeń przyjmujących wewnętrzną nazwę kolumny.

Utrzymuj obsługę błędów powiązaną z własną rezerwacją. Aktualizuj dokładny wiersz śledzenia utworzony przez to uruchomienie dopiero po potwierdzeniu utworzenia. Jeśli rezerwacja źródła nie powiodła się, nie zmieniaj wiersza należącego do wcześniejszego uruchomienia. Przeczytaj ponownie wiersz przed oznaczeniem NeedsReview i zachowaj jego pełną tożsamość źródła, oryginalny identyfikator przebiegu i wszelki znany identyfikator zapisanego pliku. Rekord o stanie Completed powinien pozostać w stanie Completed.

Skonfiguruj gałęzie awarii, aby przepływ zachował rezerwację i raportował niekompletny transfer, zamiast po cichu raportować sukces. Zobacz wytyczne firmy Microsoft dotyczące Run after, Scopes i obsługi błędów. Są to instrukcje dotyczące konfigurowanych przez Ciebie przepływów; nie przekształcają przykładów w gotowe do zaimportowania szablony.

Załączniki Microsoft Forms: pytania dotyczące przesyłania plików są dostępne dla respondentów w Twojej organizacji. Pliki przesłane do formularzy indywidualnych są przechowywane w usłudze OneDrive właściciela formularza; pliki przesłane do formularzy grupowych trafiają do witryny SharePoint grupy. Pobranie tych plików wymaga odpowiedniego połączenia z magazynem. Zobacz Wymagania firmy Microsoft dotyczące przesyłania plików.

Zbuduj swój pierwszy przepływ: znajdź dokument

1. W Power Automate wybierz Create → Instant cloud flow i wybierz Manually trigger a flow.
2. Dodaj tekstowe pole wejściowe na wyszukiwaną frazę, na przykład odniesienie do projektu.
3. Dodaj akcję Folderit DMS Search records i wybierz swoje połączenie Folderit.
4. Wybierz konto. Zamapuj wprowadzany tekst na query, opcjonalnie ogranicz wyszukiwanie do folderu za pomocą parentUid i wybierz potrzebny typ rekordu. Zacznij od limit ustawionego na 5 i offset ustawionego na 0.
5. Zapisz przepływ i uruchom test ręczny z referencją, o której wiesz, że istnieje.
6. Otwórz historię przebiegów i sprawdź rzeczywiste wyniki. Potwierdź, że zwrócone nazwy i identyfikatory UID identyfikują zamierzone dokumenty. Przetestuj także frazę bez dopasowań.
7. W razie potrzeby dodaj kolejny krok, na przykład prezentację pasujących nazw dokumentów w aplikacji Teams. Skonfiguruj połączenie tej aplikacji oraz przetestuj odbiorcę i dane wyjściowe.

Ten przykład przedstawia przepływ, który konfigurujesz we własnym środowisku. Pusty wynik wyszukiwania oznacza, że w wybranym zakresie i dostępie podłączonego użytkownika nie zwrócono żadnego pasującego rekordu.

Zapisz dokument przychodzący w Folderit

Typowy przepływ przyjmowania dokumentów rozpoczyna się od zdarzenia w innej aplikacji, pobiera zawartość pliku, a następnie wywołuje Upload file. Na przykład przepływ załączników w programie Outlook wymaga odpowiedniego wyzwalacza programu Outlook i kroku pobierania zawartości załącznika przed akcją Folderit.

• accountUid: konto Folderit będące właścicielem miejsca docelowego.
• folderUid: UID konkretnego folderu docelowego.
• fileName: nazwa dokumentu wraz z jego rozszerzeniem.
• contentType: typ MIME, taki jak application/pdf.
• fileContent: bajty pliku zakodowane w formacie base64.

Użyj rzeczywistej zawartości pliku akcji źródłowej, a nie adresu URL podglądu internetowego. W projektancie Power Automate dane wejściowe zawartości pliku łącznika mają semantykę binarną/bajtową: wybierz źródłowy token binarny File Content. Jeśli masz już wartość tekstową base64, przekonwertuj ją za pomocą base64ToBinary(...) przed zamapowaniem na to wejście. Bezpośrednie przekazanie zwykłego łańcucha base64 może spowodować drugie kodowanie i zapisać tekst base64 zamiast oryginalnego dokumentu. Surowe żądanie łącznika przesyła dane w formacie base64; projektant obsługuje tę serializację. Sprawdź faktycznie zapisane bajty, a nie tylko status pomyślnego uruchomienia.

Mapowanie zawartości SharePoint: w Get file content using path, ustaw parametr zaawansowany Infer content type na No i zmapuj wyjście binarne akcji File Content. Jeśli wyodrębniasz tekst $content base64, przekonwertuj ten tekst z powrotem na dane binarne za pomocą base64ToBinary(...) przed przekazaniem go do pola przesyłania. Po włączeniu wnioskowania plik tekstowy może zostać zwrócony jako zwykły ciąg znaków; odczytanie $content z takiego ciągu zakończy się błędem. Przed włączeniem przepływu sprawdź zapisane bajty pliku za pomocą wybranej akcji źródłowej i typów plików.

W przypadku Upload file i Add file version ustaw zasadę automatycznego ponawiania akcji na None. Zachowaj stabilny identyfikator zdarzenia źródłowego lub dokumentu w magazynie śledzenia przepływu i sprawdź go przed zapisaniem, aby powtarzające się zdarzenia źródłowe nie powodowały tworzenia duplikatów plików ani wersji. Klucz korelacji audytu, jeśli jest używany, nie stanowi mechanizmu zapobiegania duplikatom.

Pobierz plik dla kolejnego etapu przepływu

Dodaj Download file, wybierz konto i podaj UID konkretnego pliku. Dane wyjściowe obejmują fileContent, contentType, byteLength i sha256.

Gdy następna akcja oczekuje zawartości pliku binarnego, użyj tego wyrażenia w kroku Compose:

base64ToBinary(body('Download_file')?['fileContent'])

Zastąp Download_file rzeczywistą nazwą wewnętrzną działania, jeśli jest inna. Zamapuj dane wyjściowe Compose na dane wejściowe zawartości pliku aplikacji odbierającej. Może to na przykład dostarczyć załącznik do wiadomości e-mail lub czynność tworzenia pliku w innej usłudze przechowywania.

Odpowiedź pobierania za pomocą protokołu HTTP 202 oznacza, że plik jest nadal przygotowywany. Ponów próbę odczytu później i kontynuuj działanie zależne od zawartości dopiero wtedy, gdy zawartość pliku będzie już dostępna.

Wersje, metadane i przepływy pracy Folderit

Użyj Add file version, gdy poprawiony dokument powinien pozostać dołączony do tego samego UID pliku Folderit. Użyj List file versions, aby sprawdzić jego wersje. Przesyłanie osobnego pliku i dodanie wersji to różne operacje.

Użyj List metadata fields, aby zidentyfikować istniejące identyfikatory UID i typy pól, a następnie odczytaj lub zaktualizuj ich wartości. Akcja Update metadata przyjmuje tablicę fieldsJson zawierającą metaUid i value dla każdego pola. Bieżąca akcja obsługuje pola skalarne o pojedynczej wartości; pola wielowartościowe, tabele, odniesienia do użytkowników/jednostek i zapisy typu datetime wykraczają poza bieżącą obsługę zapisu. Nie tworzy definicji metadanych. Przed ponowną próbą sprawdź skutki nieudanej aktualizacji, ponieważ operacja zbiorcza w systemie mogła zmienić część wartości.

Aby uruchomić istniejący kwalifikujący się przepływ pracy, wywołaj List startable workflows dla rekordu docelowego. Przekaż zwrócony workflowUid i dokładny identyfikator ręcznego wyzwalacza triggerId do Start workflow. Pomyślny start umieszcza przepływ pracy w kolejce; nie potwierdza, że ​​zatwierdzenia lub inne dalsze etapy zostały zakończone. Ta akcja uruchamia istniejącą konfigurację zamiast tworzyć projekt przepływu pracy.

Praktyczne przykłady Power Automate

To są scenariusze, które możesz zbudować na podstawie działań łącznika. Każdy z nich wymaga własnego wyzwalacza źródłowego, mapowania pól, połączeń z innymi aplikacjami i testowania.

• E-mail przychodzący: przechowuj wybrane załączniki w odpowiednim folderze Folderit.
• Import z SharePoint: skopiuj nowo utworzony dokument do Folderit.
• Import z OneDrive: archiwizuj dokumenty pojawiające się w wybranym folderze źródłowym.
• Przesłanie formularza: przechowuj przesłane dokumenty i zapisz dostarczone wartości formularzy w zgodnych polach metadanych.
• Księgowość: archiwizuj wygenerowane pliki PDF z fakturami i zapisuj identyfikatory faktur.
• Podpisane umowy: zapisz podpisany plik PDF zwrócony przez połączoną usługę podpisu.
• Wdrażanie klienta: utwórz folder klienta po utworzeniu rekordu CRM.
• Konfiguracja projektu: utwórz folder projektu i standardowe foldery podrzędne.
• Comiesięczne archiwizowanie: twórz foldery rok/miesiąc zgodnie z harmonogramem.
• Generowanie dokumentu: zapisz plik PDF lub Word utworzony przez inną aplikację.
• Wersje dokumentu: dodaj poprawioną umowę lub raport jako nową wersję.
• Referencje klientów: zapisz identyfikatory CRM lub ERP w metadanych dokumentu.
• Wyszukiwanie dokumentu: wyszukiwanie w obrębie wybranego konta lub folderu projektu.
• Wyszukiwanie w Teams: wyświetla pasujące nazwy dokumentów w skonfigurowanym przepływie Teams.
• Dostarczanie kontrolowane: pobierz bieżący plik dla autoryzowanej wiadomości e-mail lub procesu innej aplikacji.
• Rejestr dokumentów: wyświetla zawartość folderu i wczytuje metadane do rejestru programu Excel.
• Powiadomienia o wersji: porównaj identyfikatory bieżącej wersji z zapisanym stanem i zgłoś zmiany.
• Codzienne podsumowanie: porównuje zaplanowane listy folderów z wcześniej przetworzonymi identyfikatorami rekordów.
• Inicjacja przepływu pracy: prześlij dokument i rozpocznij skonfigurowany przepływ pracy Folderit.
• Wzbogacanie AI: przetwarza wyodrębniony tekst dokumentu za pomocą zatwierdzonej usługi AI i zapisuje sprawdzone wyniki w zgodnych polach metadanych.

Użyj Folderit z Microsoft Copilot

Możesz skonfigurować agenta Copilot Studio, aby używał akcji łącznika Folderit jako narzędzi. Agent może zamienić żądanie takie jak „Znajdź umowę dla Acme” w wyszukiwanie ograniczone, odczytać metadane dokumentu, utworzyć folder lub rozpocząć kwalifikujący się skonfigurowany przepływ pracy. Zobacz przewodnik firmy Microsoft dotyczący używania łączników jako narzędzi agenta.

Praktycznym punktem wyjścia jest agent tylko do odczytu, który może wykonywać tylko niezbędne czynności związane z wyszukiwaniem i metadanymi. Skonfiguruj narzędzia Folderit tak, aby korzystały z poświadczeń użytkownika, aby użytkownicy mogli łączyć się z własnymi kontami Folderit. Przed udostępnieniem agenta przetestuj go na różnych użytkownikach i w folderach z ograniczeniami.

Aby udostępnić agenta w Teams lub Microsoft 365 Copilot należy go skonfigurować i opublikować w odpowiednim kanale oraz zakończyć proces dystrybucji w organizacji. Jest to wdrożenie odrębne od publikowania łącznika usługi Power Automate. Zobacz Opcje publikowania agenta Microsoftu. Publikacja łącznika Folderit nie indeksuje automatycznie całego repozytorium w standardowym Copilocie ani nie instaluje gotowego agenta Folderit.

W przypadku podsumowań, tłumaczeń, klasyfikacji lub wyodrębniania wartości faktur dodaj etap wyodrębniania zawartości dokumentu i przetwarzania AI. Pobrane bajty pliku nie są automatycznie czytelnym tekstem dokumentu. Usługa Power Automate obsługuje opcję akcję Run a prompt w AI Builder; dostępne formaty, regiony, licencje i dostępne zasoby AI zależą od wybranej usługi. Przejrzyj wygenerowane wartości przed użyciem ich do podjęcia decyzji lub aktualizacji rekordów. Dokumenty wysyłane do usługi AI są przetwarzane zgodnie z konfiguracją i warunkami tej usługi.

Te przykłady Copilot i AI wymagają konfiguracji i testowania. Nie są to gotowe publiczne szablony Folderit dla Copilot dostarczane przez to złącze.

Rozwiązywanie problemów

• Brak łącznika: sprawdź informacje o publikacji/wdrożeniu, wybrane środowisko i zasady łącznika obowiązujące w Twojej organizacji. Skontaktuj się z Folderit, jeśli złącze publiczne jest niedostępne.
• Wymagana licencja premium: poproś administratora firmy Microsoft o sprawdzenie uprawnień użytkownika lub przepływu. Bezpłatna licencja Power Automate jest ograniczona do standardowych złączy.
• Nie można połączyć się z rekordem ani uzyskać do niego dostępu: sprawdź dostęp do API Folderit, zalogowanego użytkownika, wybrane konto i uprawnienia rekordu.
• Wyszukiwanie nie zwraca żadnych wyników: sprawdź frazę, konto, zakres folderu, typ rekordu i dostęp podłączonego użytkownika. Sprawdź paginację podczas przetwarzania większych zestawów wyników.
• Plik nieczytelny po przesłaniu: sprawdź mapowanie treści źródłowej, typ MIME, nazwę pliku i konwersję base64. Zacznij od małego, znanego pliku testowego.
• Plik za duży: ten łącznik ogranicza obecnie transfer plików do 10 MiB. To jest limit złącza, a nie ogólny limit przesyłania plików w Folderit.
• Duplikat dokumentu lub wersji: sprawdź deduplikację zdarzeń źródłowych i wyłącz automatyczne ponowne próby przesyłania/zapisu wersji.
• Aktualizacja metadanych nie powiodła się: potwierdź UID pola, jego typ i obsługiwaną strukturę pojedynczej wartości, a następnie odczytaj rekord przed ponowną próbą.
• Przebieg pracy rozpoczął się, ale nie został ukończony: sprawdź przepływ pracy w Folderit. Start w kolejce nie jest ostatecznym wynikiem zatwierdzenia.

Sprawdź wspólną konfigurację przed pierwszym transferem

1. Potwierdź pełne identyfikatory Folderit. Identyfikatory UID kont i folderów zawierają dokładnie 10 liter, cyfr, podkreśleń i łączników. Nie skracaj wklejonej wartości ani nie używaj adresu URL przeglądarki jako UID. Przeczytaj wybrane konto i folder za pośrednictwem własnego połączenia i potwierdź ich nazwy i uprawnienia przed zapisaniem.
2. Użyj adresu witryny SharePoint. Site Address to adres URL witryny, na przykład https://example.sharepoint.com/sites/Automation, a nie łącze do widoku listy, biblioteki lub udostępnionego pliku. Identyfikator GUID listy śledzenia to osobne ustawienie. Skorzystaj z witryny i listy własnej organizacji.
3. Zakończ ustawienia listy śledzenia. Importowanie pliku CSV nie ustanawia ochrony przed duplikatami. Sprawdź, czy Title wymusza unikatowe wartości, a State jest polem pojedynczego wyboru zawierającym zamierzone wartości. Użyj oznaczonych tokenów projektanta lub zweryfikuj rzeczywiste nazwy pól wewnętrznych; wyświetlana nazwa kolumny nie zawsze jest nazwą właściwości wyrażenia.

Te samoobsługowe kroki stanowią wskazówki dotyczące konfiguracji, a nie gotowy do zaimportowania pakiet przepływu. Zacznij od dokumentu syntetycznego i miejsca docelowego testu. Sprawdź konto zapisanego pliku, folder, UID, rozmiar i pobrane bajty, a następnie przetestuj powtórkę przed włączeniem wyzwalacza źródłowego.

Zweryfikuj zapisany dokument przed włączeniem przepływu

Zielony przebieg i zgodna nazwa pliku nie potwierdzają, że dokument został poprawnie zapisany. Przetestuj na małym, pliku bez poufnych danych i sprawdź faktycznie zapisaną kopię:

1. Pobierz odpowiednie kopie. Zachowaj oryginalną wersję źródłową używaną przez przepływ, a następnie pobierz zapisany plik z docelowego konta Folderit i folderu. Potwierdź jego UID pliku i rozmiar. Porównanie ze źródłem, które uległo zmianie od tego czasu, może dać mylący wynik.
2. Porównaj ich zawartość lokalnie. Umieść kopie w lokalnym folderze, nadając im różne nazwy. Poniższe opcjonalne polecenia obliczają skróty SHA-256; czytają pliki na twoim komputerze. Zastąp przykładowe ścieżki dwiema rzeczywistymi ścieżkami plików.
3. Sprawdź wynik i zapis śledzenia. Obydwa pliki muszą zostać pomyślnie odczytane, a pełne wartości SHA-256 muszą się zgadzać. Błąd odczytu pliku lub inny hash oznacza, że ​​transfer nie został zweryfikowany. Samo dopasowanie zawartości nie sprawdza UID pliku zdalnego, miejsca docelowego ani zachowania podczas odtwarzania ani nie upoważnia do zwolnienia rekordu Reserved / NeedsReview.

Windows PowerShell

Uruchom je w folderze zawierającym dwie kopie. Porównaj pełne wartości w kolumnie Hash. Zobacz Dokumentację Get-FileHash firmy Microsoft.

Get-FileHash -Algorithm SHA256 -LiteralPath '.\source-file.pdf'
Get-FileHash -Algorithm SHA256 -LiteralPath '.\folderit-copy.pdf'

Terminal macOS

Uruchom to w folderze zawierającym dwie kopie. Porównaj pełny skrót na początku każdej linii wyjściowej:

shasum -a 256 -b -- './source-file.pdf' './folderit-copy.pdf'

Jeśli kopie się różnią, zachowaj transfer do sprawdzenia. Sprawdź wersję źródłową i natywne mapowanie zawartości pliku przed kolejnym testem. Nie przesyłaj ponownie ani nie usuwaj rezerwacji tylko dlatego, że sprawdzenie zawartości nie powiodło się. Usuń przyczynę i uzgodnij stan istniejącego transferu zgodnie z procedurę odzyskiwania.

Opis nieudanego lub niekompletnego transferu

• Przebieg jest zielony, ale zapisany plik jest nieczytelny. Pomyślna akcja nie jest dowodem na to, że bajty pliku są prawidłowe. Zamapuj token binarny zawartości pliku źródłowego na natywne pole zawartości pliku Folderit. Jeśli pracujesz z istniejącym ciągiem Base64, użyj raz base64ToBinary(...) dla tego wejścia przyjmującego bajty; nie stosuj ponownie base64(). Porównaj pobraną treść ze źródłem przed zgłoszeniem zakończenia.
• SharePoint zgłasza, że ciąg znaków nie ma właściwości $content. Ustaw Infer content type na No w przypadku odczytu zawartości pliku i sprawdź syntetyczne dane wyjściowe przed wybraniem $content. Potwierdź faktyczne mapowanie zawartości binarnej zamiast dodawać wariant awaryjny do wyrażenia, które już się nie powiodło.
• Odrzucono duplikat Title lub rekord śledzenia ma stan Reserved / NeedsReview. Sprawdź istniejący wiersz i historię wykonań. Celowe zatrzymanie duplikatu może pozostawić wykonanie w stanie Failed z pominiętymi wszystkimi akcjami zapisu Folderit. Ponowne wykonanie dla zakończonej operacji powinno przejść do gałęzi pomijania na podstawie pełnej zgodności identyfikatorów. Nieudana rezerwacja lub niepewny zapis nie mogą nigdy zezwalać na ponowne przesyłanie. Zachowaj wiersz i postępuj zgodnie z uzupełnianiem i odzyskiwaniem; nie wyłączaj wymogu unikatowości, nie usuwaj rezerwacji i nie ponawiaj wysyłania bez sprawdzenia.
• Outlook nie może odczytać załącznika. Upewnij się, że to samo połączone konto służbowe ma dostępną skrzynkę pocztową Exchange i wszelkie wymagane uprawnienia do udostępnionej skrzynki pocztowej. Samo pomyślne logowanie nie oznacza dostępu do skrzynki pocztowej. Wskazówki dotyczące łącznika programu Outlook firmy Microsoft zalecają pobieranie załączników za pomocą funkcji Get Attachment (V2), gdy upłynie limit czasu pobierania wyzwalacza, a także opisują zduplikowane zdarzenia i ograniczenia dotyczące chronionych wiadomości.
• Pobieranie zwraca odpowiedź 202 lub istnieje folder Forms bez pliku odpowiedzi. Trwające przygotowanie pliku do pobrania nie oznacza zakończonej weryfikacji: ponawiaj wyłącznie odczyt, w ramach ograniczonej liczby prób. W przypadku formularzy utworzenie folderu, tekst odpowiedzi i każdy załącznik wymagają osobnego śledzenia. Zakończone tworzenie folderu nie oznacza zakończenia niedokończonego kroku dotyczącego pliku. Blokuj niepewne zapisy podczas sprawdzania dokładnego zapisanego miejsca docelowego.

Aby uzyskać pomoc, skontaktuj się z Folderit, podając nazwę akcji, tekst błędu, godzinę i opis bez poufnych danych zamierzonego procesu. Trzymaj hasła, sekrety klientów, tokeny i poufną treść dokumentów poza wiadomościami pomocy technicznej.

Powiązane przewodniki: Integracje Folderit, Połącz Folderit z Zapier i Dokumentacja API Folderit. Aby zapoznać się z katalogiem publicznym firmy Microsoft, zobacz informacje o złączu.