Khắc phục sự cố & câu hỏi thường gặp
Nguyên nhân và cách xử lý nhanh các lỗi phổ biến nhất trong AgentFlow.
Lỗi đăng nhập SSO
Triệu chứng: Nhấn "Đăng nhập" bị chuyển về trang lỗi hoặc thông báo "Tài khoản này đã bị vô hiệu hóa."
Nguyên nhân & cách xử lý:
| Thông báo lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| Tài khoản bị vô hiệu hóa | Quản trị viên đã vô hiệu hóa tài khoản | Liên hệ quản trị viên để kích hoạt lại |
| Đăng nhập sai quá nhiều lần | Tài khoản bị khóa tạm thời | Chờ vài phút hoặc đặt lại mật khẩu |
| Vui lòng xác nhận email | Email chưa được xác minh | Kiểm tra hộp thư và nhấn liên kết xác minh |
| Lỗi phiên IdP / OIDC | Phiên IdP hết hạn hoặc cookie bị xóa | Đóng trình duyệt, mở lại và thử đăng nhập |
Nếu tổ chức dùng SSO và bạn không có quyền đặt lại mật khẩu, hãy liên hệ bộ phận IT nội bộ — AgentFlow không quản lý thông tin xác thực của nhà cung cấp danh tính.
Cửa sổ popup OAuth bị chặn
Triệu chứng: Nhấn "Kết nối" trong mục Tích hợp nhưng không có cửa sổ nào xuất hiện.
Nguyên nhân: Trình duyệt chặn popup tự động.
Cách xử lý:
- Tìm biểu tượng chặn popup trên thanh địa chỉ trình duyệt.
- Chọn "Luôn cho phép popup từ trang này" rồi nhấn Kết nối lại.
- Nếu dùng trình chặn quảng cáo (uBlock Origin, AdGuard…), tạm tắt cho domain AgentFlow.
Không thể xuất bản quy trình (lỗi xác thực)
Triệu chứng: Nút Xuất bản mờ đi — di chuột lên thấy Sửa các lỗi kiểm tra trước khi xuất bản — và dải Không thể xuất bản hiện ở cuối canvas; một số bước có dòng Có vấn đề cần kiểm tra. Đôi khi nút vẫn bấm được, nhưng bấm xong lại nhận thông báo Không thể xuất bản — N vấn đề: ….
Nguyên nhân: Quy trình còn thiếu thông tin bắt buộc hoặc có cấu hình không hợp lệ. Hầu hết lỗi được phát hiện ngay trong lúc thiết kế, nên nút bị chặn từ trước; một vài kiểm tra chỉ chạy khi bạn bấm Xuất bản — xem Bảng kiểm tra.
Cách xử lý:
- Mở dải ở cuối canvas và nhấn vào từng mục để tới đúng bước có lỗi.
- Các lỗi thường gặp:
| Lỗi | Cách sửa |
|---|---|
| Bước chưa được nối | Kiểm tra mọi bước (trừ End) đều có ít nhất một cạnh đầu ra |
| Biểu mẫu chưa được chọn | Mở bước Công việc người dùng (Human) và chọn Biểu mẫu |
| Thiếu điều kiện nhánh | Mở bước Quyết định (Decision) và điền đầy đủ điều kiện cho mỗi nhánh |
| Tham chiếu biến không hợp lệ | Dùng bộ chọn biến thay vì nhập tay đường dẫn |
| Loop structure not supported (thông báo tiếng Anh) | Các nhánh song song nối sai vào bước Hợp nhất — thường là một bước Quyết định hay Công việc người dùng nối thẳng vào Hợp nhất. Đọc dòng chi tiết, rồi xem Nối các nhánh vào Hợp nhất |
Trong ví dụ "Đề xuất mua sắm", nếu bước Quyết định thiếu nhánh "Từ chối", quy trình sẽ không qua được kiểm tra và không thể Xuất bản.
Lượt chạy dừng ở bước Hợp nhất
Triệu chứng: Một lượt chạy đứng mãi ở trạng thái Đang chạy trước một bước Hợp nhất mà không còn công việc nào đang chờ ai, hoặc chuyển sang Thất bại với lỗi Join '…' can never receive arrival(s) on edge(s) […]; exclusive branches must merge at a plain step before the Join.
Nguyên nhân: Phiên bản quy trình ấy được xuất bản trước khi trình thiết kế kiểm tra cách nối nhánh, và có một cạnh đi vào bước Hợp nhất không phải lượt nào cũng chạy — thường là cạnh hành động của một bước phê duyệt. Bước Hợp nhất chờ mọi cạnh đi vào nó, nên nó chờ mãi cạnh không được chọn.
Cách xử lý: Mở quy trình trong trình thiết kế — dải kiểm tra sẽ chỉ ra bước Hợp nhất sai với thông báo Loop structure not supported. Sửa theo Nối các nhánh vào Hợp nhất, rồi xuất bản lại. Lượt chạy cũ không tự đi tiếp được; hãy khởi chạy lại trên phiên bản mới.
Không khởi chạy được với thư mục theo dõi
Triệu chứng: Chọn Dùng thư mục theo dõi rồi khởi chạy, nhưng bị từ chối với thông báo <trường>, or the folders it was grouped into, is also read by …, and those readers cannot see a file set — hoặc một thông báo cùng loại như is iterated by … and …, is grouped by … and …, is grouped into folders, but nothing iterates them.
Nguyên nhân: Sơ đồ không có hình dạng mà thư mục theo dõi đòi hỏi: chỉ đúng một vòng lặp — hoặc một bước Gộp tệp rồi một vòng lặp — được đọc trường tệp. Thường gặp nhất là một bước khác ngoài vòng lặp, như Mã lệnh hay Gửi email, cũng đọc trường đó.
Cách xử lý: Người thiết kế quy trình chuyển bước được nêu tên vào bên trong vòng lặp, theo Lặp trên một thư mục theo dõi, rồi xuất bản lại. Trình thiết kế hiện đã báo trước điều này bằng cảnh báo This field cannot come from a watched folder ở dải kiểm tra, vì vậy hãy đọc dải ấy trước khi xuất bản.
Không nhận được công việc
Triệu chứng: Phiên chạy đang ở bước Công việc người dùng (Human) nhưng bạn không thấy công việc trong danh sách.
Nguyên nhân & cách xử lý:
| Nguyên nhân | Cách xử lý |
|---|---|
| Bạn không nằm trong danh sách người được giao | Liên hệ người thiết kế quy trình để kiểm tra cấu hình Phân công |
| Bạn không phải thành viên của Nhóm được giao | Quản trị viên thêm bạn vào Nhóm đó |
| Bộ lọc Hộp thư đang ẩn công việc | Xóa bộ lọc hoặc chuyển sang tab "Tất cả" |
| Phiên chạy đang chờ bước trước | Kiểm tra xem bước trước đó đã hoàn thành chưa |
Đồng nghiệp gửi liên kết bản ghi, tôi mở ra "không tìm thấy"
Triệu chứng: Bạn mở liên kết tới một bản ghi mà đồng nghiệp đang xem được, nhưng trang báo không tìm thấy.
Nguyên nhân: Với một bản ghi nằm ngoài phạm vi của bạn, hệ thống trả lời giống hệt như với một bản ghi không tồn tại. Đây là chủ ý, không phải lỗi: nếu hai câu trả lời khác nhau, người ngoài phạm vi vẫn đoán ra được bản ghi nào đang tồn tại và của ai. Vì vậy "không tìm thấy" không có nghĩa là bản ghi đã bị xóa.
Cách xử lý: Thử lại không giúp được gì — hãy hỏi quản trị viên, và nêu đủ bốn điều để họ xử lý ngay.
| Nêu rõ | Ví dụ |
|---|---|
| Thực thể nào | Đúng tên hiển thị trên thanh điều hướng, ví dụ "Hợp đồng" |
| Bạn cần làm gì | Chỉ xem, hay còn cần liệt kê, tạo, sửa, xóa |
| Cần tới đâu | Bản ghi của mình, đơn vị của mình, đơn vị và cấp dưới, hay toàn tổ chức |
| Một ví dụ cụ thể | Liên kết bản ghi kèm tên đồng nghiệp đang thấy được nó |
Quản trị viên có sẵn công cụ giải thích vì sao một chủ thể được phép hay bị từ chối, trên từng bản ghi và từng thao tác, nên một ví dụ cụ thể thường đủ để chỉ ra ngay chỗ thiếu. Xem Quyền truy cập.
Xem được bản ghi nhưng không sửa được (và ngược lại)
Triệu chứng: Bạn mở được một bản ghi nhưng không lưu được thay đổi; hoặc bạn sửa được một bản ghi nhưng nó không hiện ra khi duyệt danh sách; hoặc bạn duyệt được cả danh sách nhưng không có nút Bản ghi mới.
Nguyên nhân: Năm thao tác trên bản ghi mang phạm vi riêng từng cái, được phân giải độc lập với nhau. Quyền Sửa không kéo theo quyền Xem, và ngược lại. Những tình huống trên đều bình thường.
| Bạn gặp | Thao tác đang thiếu phạm vi |
|---|---|
| Mở được, không sửa được | Sửa |
| Sửa được, nhưng không thấy trong danh sách | Liệt kê — bạn chỉ tới được bản ghi qua liên kết, công việc, hoặc khối liên quan trên bản ghi khác |
| Duyệt được danh sách, không có nút Bản ghi mới | Tạo |
| Mở và sửa được nhưng không xóa được | Xóa |
Cách xử lý: Hỏi quản trị viên mở rộng đúng thao tác đang bị chặn, thay vì xin "quyền vào thực thể này". Xem Quyền truy cập; phía cấu hình ở Quyền truy cập Thực thể & Bản ghi.
Nếu bạn nhận được một thông báo cụ thể khi nhấn Lưu — chứ không phải nút mờ đi hay bản ghi biến mất khỏi danh sách — đây thường không phải chuyện quyền hạn, mà là một quy tắc của thực thể từ chối đúng nội dung bạn vừa gõ. Xem Khi lưu bị từ chối.
Nút Tạo bản ghi không bật lên
Triệu chứng: Biểu mẫu tạo bản ghi mở ra bình thường, bạn điền hết các trường, nhưng nút Tạo bản ghi vẫn mờ và bấm không được.
Nguyên nhân: Trên thực thể có bật phân loại theo đơn vị, biểu mẫu còn một ô nữa phải hợp lệ trước khi lưu được: ô chọn Đơn vị (Unit) — nơi bản ghi sẽ được lưu vào. Nhãn của ô mang dấu sao bắt buộc và ngay dưới ô có một dòng nói rõ đang vướng gì, nên cái nút mờ thường kèm theo một lý do đọc được chứ không còn là một nút chết câm lặng. Bốn tình huống khác nhau cùng dẫn tới nó, và cách gỡ không giống nhau. (Ngoại lệ duy nhất là vài giây đầu, trong lúc danh sách đơn vị còn đang tải: nút mờ mà chưa có dòng nào — chờ một nhịp rồi đọc lại.)
| Bạn thấy gì ở ô Đơn vị | Nghĩa là gì và làm gì |
|---|---|
| Dòng Chọn đơn vị trước khi tạo bản ghi. ngay dưới ô chọn | Chưa chọn đơn vị nào. Thường gặp khi quyền tạo của bạn bao phủ nhiều đơn vị — hoặc cả tổ chức — mà bản thân bạn lại không có đơn vị chính để hệ thống chọn sẵn giúp. Tự chọn một đơn vị là xong, không phải chờ ai |
| Không có ô chọn, thay vào đó là dòng Quyền tạo của bạn không bao phủ đơn vị nào ở đây. | Không có đơn vị nào bạn được lưu vào, nên nút sẽ không bao giờ bật lên. Đây thường là chuyện vị trí của bạn trong sơ đồ tổ chức chứ không phải quyền trên thực thể: bạn chưa được đặt đơn vị chính, hoặc đơn vị chính đã bị lưu trữ. Việc này phải nhờ quản trị viên |
| Ô chọn viền đỏ, bên dưới ghi Ngoài quyền tạo của bạn dù bạn đã chọn xong | Một lần tải lại đã thu hẹp phạm vi tạo của bạn, và đơn vị bạn đang chọn không còn được phép nữa. Lựa chọn đó cố ý được giữ nguyên và bị đánh dấu chứ không bị lặng lẽ đổi về đơn vị chính của bạn — đổi ngầm nghĩa là bản ghi rơi vào một chỗ khác mà không ai báo. Chọn đơn vị khác, hoặc xin lại phạm vi cũ |
| Dòng Không tải được danh sách đơn vị bạn có thể lưu vào. kèm nút Thử lại (Retry) | Việc đọc danh sách đơn vị đã hỏng. Nhấn Thử lại — chỉ có đúng một nút này cho cả hai lượt đọc. Nếu chưa thấy dòng nào cả thì việc đọc vẫn đang chạy: nút khóa cho tới khi nó xong |
Trên thực thể không phân loại theo đơn vị thì không có ô Đơn vị quyết định nơi lưu — một trường tham chiếu tới thực thể Đơn vị do người soạn biểu mẫu thêm vào vẫn hiện bộ chọn, nhưng đó chỉ là một trường dữ liệu bình thường. Lúc đó nút mờ chỉ có thể do chính biểu mẫu: còn một trường bắt buộc bỏ trống hoặc một giá trị không hợp lệ — cuộn lên tìm dòng báo lỗi đỏ ở từng trường.
Xem Tạo bản ghi thủ công.
Đã cấp quyền mà người dùng vẫn không thấy gì
Triệu chứng: Bạn thêm quyền hệ thống (ví dụ entity.read) vào vai trò của một người, nhưng họ vẫn không thấy bản ghi nào.
Nguyên nhân: Quyền của vai trò là mức trần, không phải một lượt cấp quyền. Quy tắc thông thường là: được phép = người gọi có quyền vai trò và (thực thể ở chế độ Mọi người hoặc có một lượt cấp quyền áp dụng) — cách duy nhất vượt qua vế thứ hai mà không cần lượt cấp quyền là quyền riêng Vượt phạm vi bản ghi (có kiểm toán), vốn không được gán sẵn cho vai trò nào. Trên một thực thể ở chế độ Hạn chế, thiếu vế thứ hai thì vế thứ nhất không đem lại gì cả.
Cách xử lý:
- Mở thực thể, sang tab Quyền truy cập và xem chế độ đang là gì.
- Ở chế độ Hạn chế, thêm một lượt cấp quyền gọi tên người đó — hoặc một nhóm chứa họ — và đặt phạm vi cho đúng thao tác đang bị chặn.
- Dùng Giải thích quyền truy cập ngay trên tab đó để xác nhận, thay vì đoán.
| Bẫy thường gặp | Điều thực sự xảy ra |
|---|---|
| Liệt kê rộng nhưng Xem hẹp | Màn hình duyệt áp dụng cả hai: Liệt kê · Toàn tổ chức đi kèm Xem · Của mình chỉ liệt kê bản ghi của chính người đó |
| Chọn Đơn vị trong khi bản ghi nằm ở đơn vị cấp dưới | Đơn vị chỉ gồm đúng đơn vị neo; muốn cả nhánh thì chọn Cây con |
| Neo Đơn vị hoặc Cây con vào một đơn vị khác nhánh với chỗ đứng của chủ thể | Bẫy này không đến tay bạn dưới dạng "không thấy gì": phạm vi có neo trỏ tới đúng đơn vị được nêu, nên Xem/Liệt kê đưa ra bản ghi của phòng ban khác thay vì của họ, còn với Tạo thì bộ chọn đơn vị chỉ mời đúng nhánh đã neo và mọi bản ghi họ lập rơi vào đó, không lỗi nào cả. Bước Phạm vi (Scopes) nay có một dòng tư vấn ngay lúc soạn, nhưng nó không bao giờ từ chối lưu và không để lại dấu vết nào: lượt cấp quyền soạn từ trước khi có dòng đó không mang chip gì trong bảng cấp quyền. Dòng ấy cũng không hiện với lượt cấp quyền cho một Nhóm — nhóm không đứng ở đâu trong sơ đồ tổ chức, thành viên của nó mới đứng — nên đây vẫn là chỗ duy nhất mô tả triệu chứng |
| Cấp trên mức trần vai trò | Lượt cấp quyền vẫn lưu được và mang chip trên mức trần, nhưng không đem lại gì cho tới khi vai trò được mở rộng |
| Phạm vi Của mình cho một chủ thể dịch vụ không được phép sở hữu | Lượt cấp quyền được lưu nhưng lặng lẽ không khớp bản ghi nào |
Xem Quyền truy cập Thực thể & Bản ghi và Vai trò & quyền.
Bật trigger nhưng không lưu được, không rõ vì sao
Triệu chứng: Bạn bật công tắc Đang hoạt động cho một trigger — lịch, trigger bản ghi hoặc trigger ứng dụng kết nối — nhưng chân trình soạn chỉ báo Không thể lưu và trigger không bật lên.
Nguyên nhân: Một lượt chạy do trigger khởi động thì không có ai là người khởi chạy. Nếu chính sách Chạy với tư cách của quy trình đang là Người khởi chạy, hoặc còn ở trạng thái Cần quyết định của bản di trú, máy chủ từ chối bật trigger. Trình soạn trigger không dịch lời từ chối đó, nên bạn chỉ thấy thông báo tự động lưu chung chung.
Cách xử lý:
- Trong trình thiết kế quy trình, mở Cài đặt → Chạy với tư cách.
- Chọn Một service principal — hoặc Hệ thống nâng quyền, nếu bạn có quyền tương ứng — rồi Lưu.
- Quay lại trình soạn trigger và bật lại công tắc.
Quy tắc này chặn cả chiều ngược lại: đổi chính sách về Người khởi chạy trong khi quy trình đã có trigger đang bật cũng bị từ chối — nhưng ở chiều đó hộp thoại có giải thích rõ ràng. Xem Chạy với tư cách (Run as).
Quy trình tự động dừng lại mà không có gì báo lỗi
Triệu chứng: Một lượt chạy không nhích thêm bước nào. Không công việc nào đang chờ ai, không thông báo nào được gửi cho ai, không mục nào trong hàng đợi lỗi, và bộ lọc Thất bại không tìm ra nó. Nó chỉ lộ ra khi có người mở một màn hình có hiển thị lượt chạy.
Nguyên nhân: Chủ thể mà lượt chạy hành động với tư cách không đủ quyền cho thao tác kế tiếp — bị vô hiệu hóa, mất vai trò, mất một lượt cấp quyền, gặp một bản ghi ngoài phạm vi, hoặc phải tạo bản ghi vào một đơn vị nó không với tới. Quyền có thể mất giữa chừng, mà cũng có thể chưa bao giờ có. Lượt chạy dừng lại và chờ chứ không thất bại: nó mang chip hồng Bị chặn do phân quyền, còn trạng thái bên dưới vẫn là Tạm dừng.
Cách xử lý:
- Mở trang chi tiết lượt chạy. Khối cảnh báo nêu Thao tác, Thực thể, Lý do và Chạy với tư cách.
- Khắc phục theo lý do đó: bật lại chủ thể, trả lại quyền vai trò, thêm lượt cấp quyền, mở rộng phạm vi, hoặc gán chủ thể vào đúng đơn vị. Cách cuối giúp được lý do không có đơn vị đích — và giúp được cả lệch phạm vi, nhưng chỉ khi lượt cấp quyền của chủ thể dùng phạm vi theo lượt gán (Đơn vị của họ / Đơn vị của họ và mọi cấp bên dưới), vì đó là hai phạm vi duy nhất đọc tới lượt gán; với phạm vi có neo, chỗ đứng của chủ thể không được đọc tới.
- Nhấn Tiếp tục. Chủ thể đã lưu được kiểm tra lại với đúng thao tác đã bị chặn; nếu vẫn bị từ chối thì không có gì thay đổi.
| Nếu | Thì |
|---|---|
| Lượt chạy hiện khối hổ phách Lượt chạy này không có chủ thể thực thi | Đây là lượt chạy cũ, có từ trước khi có chính sách. Dùng Đặt chủ thể thực thi… — một lần và không đảo ngược — rồi lượt chạy tự tiếp tục |
| Bạn đã đổi cài đặt Chạy với tư cách của quy trình mà lượt chạy vẫn kẹt | Đúng như vậy: chủ thể được chốt lúc lượt chạy bắt đầu. Chỉ quyền cấp trên thực thể, vai trò, vị trí đơn vị, hoặc việc bật lại chính chủ thể mới có tác dụng |
| Lý do là không có đơn vị đích nào lượt chạy được phép tạo vào | Đích có thể do chính bước Bản ghi thực thể nêu tên chứ không phải là đơn vị của chủ thể — khối cảnh báo không phân biệt hai trường hợp đó, và cũng không nêu tên đơn vị. Mở bước rồi xem ô Đơn vị đích (Destination unit): nếu đang là Một đơn vị (A unit), cách gỡ là mở phạm vi Tạo của chủ thể tới đúng đơn vị đó, hoặc bỏ lưu trữ nó — Tiếp tục kiểm tra lại đúng đơn vị ấy. Sửa ô này trong trình thiết kế không gỡ được lượt chạy đang kẹt: lượt chạy chạy trên đồ thị đã chốt lúc nó bắt đầu. Sửa là để lượt chạy sau không kẹt lại y hệt |
| Bạn nhìn thấy nó từ khối Quy trình trên một trang bản ghi, hoặc từ hộp thoại kết quả sau khi bấm một nút hành động | Cả hai chỗ đó đều nêu đúng tình trạng Bị chặn do phân quyền, nhưng cố ý không nêu thực thể lẫn đơn vị. Mở trang lượt chạy — bằng liên kết Mở lượt chạy → trong hộp thoại, hoặc bằng tên quy trình trong khối Quy trình — đó là chỗ duy nhất có đủ thông tin và có nút Tiếp tục |
| Bạn cần nhìn toàn bộ hiện trạng | Quản trị → Đơn vị tổ chức → Tình trạng phân quyền gom mọi lượt chạy bị chặn, mọi quy trình còn Cần quyết định và mọi lượt chạy chưa có chủ thể |
Cả Tiếp tục lẫn Đặt chủ thể thực thi… đều cần quyền instance.admin. Bản ghi bị từ chối cố ý không được ghi lại và không hiển thị ở đâu cả — để màn hình quản trị không trở thành cách dò ra những bản ghi nằm ngoài phạm vi của lượt chạy.
Xem Chạy với tư cách (Run as), Bản ghi thực thể và Đơn vị tổ chức.
Quy trình vốn chạy êm, nay dừng ở bước tra khóa
Triệu chứng: Một quy trình chạy tốt nhiều tháng nay bắt đầu dừng ở một bước Bản ghi thực thể dùng Get one theo Key. Lượt chạy mang chip Bị chặn do phân quyền với lý do "bản ghi nằm ngoài phạm vi của lượt chạy" (scope_mismatch). Không có gì trong quy trình bị sửa cả.
Nguyên nhân: Đúng như vậy — quy trình không đổi, mà câu trả lời đổi. Trước đây, một khóa khớp bản ghi mà chủ thể của lượt chạy không được xem sẽ trả về found: false, y hệt một khóa chưa ai dùng. Nay hai trường hợp đó được tách ra, và trường hợp thứ nhất làm lượt chạy dừng lại. Việc từ chối vốn đã có từ trước; nó chỉ chưa từng hiện ra. Quy tắc đầy đủ của cả hai thao tác đi theo khóa nằm ở Bản ghi thực thể.
Cách xử lý:
- Mở trang chi tiết lượt chạy và đọc khối cảnh báo: nó nêu Thao tác (đọc), Thực thể, Lý do, Từ lúc và Chạy với tư cách. Nó không nêu bản ghi — cố ý — và cũng không nêu đơn vị của bản ghi.
- Quyết định xem chủ thể ấy có nên đọc được bản ghi đang giữ khóa đó không. Nếu có, mở rộng phạm vi Xem của lượt cấp quyền cho tới đơn vị chứa bản ghi — Đơn vị/Cây con neo tại chính đơn vị đó hoặc một đơn vị cấp trên nó, hay Toàn tổ chức — rồi nhấn Tiếp tục. Đặt chủ thể đứng vào đơn vị đó chỉ có tác dụng khi lượt cấp quyền dùng phạm vi theo lượt gán — khi ấy một lượt gán vào đơn vị của bản ghi đúng là cách gỡ; với phạm vi có neo thì không: phạm vi có neo trỏ tới đơn vị được nêu chứ không phải chỗ đứng của chủ thể. Tiếp tục kiểm tra lại đúng câu hỏi ấy — đơn vị của bản ghi đã nằm trong phạm vi Xem chưa — nên trên Thực thể có phân loại theo đơn vị, một phạm vi chỉ Của mình không bao giờ qua được; ở đó nếu cách gỡ là đổi chủ sở hữu bản ghi thì phải hủy lượt chạy rồi khởi chạy lại.
- Nếu không nên, thì bản thân bước mới là chỗ sai: "khóa này đã có ai giữ chưa" là câu hỏi về toàn bộ dữ liệu của thực thể, nên chỉ một chủ thể có phạm vi Xem · Toàn tổ chức mới nhận được câu trả lời. Chuyển quy trình sang một chủ thể như vậy ở Cài đặt → Chạy với tư cách, hoặc bỏ hẳn nhánh tra khóa, rồi hủy và khởi chạy lại — sửa trình thiết kế không gỡ được lượt chạy đang kẹt. Đổi sang đọc theo Id thì không giúp được gì: một id trỏ vào bản ghi ngoài phạm vi cũng chặn lượt chạy y hệt.
Kiểm tra luôn thiệt hại đã có từ trước
Đáng lo hơn cái dừng này là những gì đã xảy ra trước đó. Nhánh "chưa tìm thấy" của một quy trình hầu như luôn là nhánh tạo mới, nên mỗi lần câu trả lời cũ nói nhầm là mỗi lần lượt chạy đi tạo lại một bản ghi vốn đã tồn tại. Có hai dấu vết cần soát, tương ứng hai kết cục:
- Một bước tạo mới thất bại vì trùng khóa định danh. Đây là trường hợp bước tạo có ánh xạ đủ mọi trường của khóa, và ràng buộc duy nhất trên khóa chặn lại. Lỗi thì đúng, nhưng nó nổ ở sai bước — bước ngay trước vừa báo khóa còn trống — nên rất dễ bị đọc thành lỗi dữ liệu vặt và cho chạy lại.
- Bản ghi trùng thật sự, không lỗi nào cả. Nếu bước tạo mới không ánh xạ đủ các trường của khóa, bản ghi mới không vào chỉ mục khóa, không đụng ràng buộc nào, và lượt chạy xanh từ đầu đến cuối. Không có lượt chạy hỏng nào để đi tìm.
Trường hợp thứ hai phải tìm ở phía dữ liệu: mở trình duyệt bản ghi của thực thể ấy bằng một tài khoản có cả Liệt kê lẫn Xem ở mức Toàn tổ chức — màn hình duyệt áp dụng đồng thời hai phạm vi — sắp xếp theo các trường tạo thành khóa định danh rồi soát giá trị lặp. Đừng đi tìm bằng cách bắt hệ thống lập chỉ mục lại khóa (thêm lại khóa, đổi các trường của nó, hoặc bấm Lập lại chỉ mục): gặp dữ liệu trùng, việc lập chỉ mục dừng lại và khóa bị đánh dấu thất bại — mà một khóa thất bại làm ngừng mọi thao tác đi theo khóa ấy, cả Upsert lẫn chính bước Get one theo Key đang nói ở đây, đồng thời thôi luôn việc ngăn bản trùng mới, cho tới khi dữ liệu được dọn và khóa lập lại chỉ mục xong. Con số nó hiện ra lúc đó cũng chỉ là một mẫu có giới hạn, kèm dòng Có thể còn nhiều hơn thế. Xem Trường dữ liệu.
Quy trình chạy xong nhưng bản ghi mới không thuộc đơn vị nào
Triệu chứng: Một quy trình có bước Bản ghi thực thể đang chỉ định Đơn vị đích (Destination unit) chạy trót lọt — không lỗi, không bị chặn — nhưng những bản ghi nó vừa tạo lại không nằm trong đơn vị nào, và cột Đơn vị cũng đã biến mất khỏi trình duyệt bản ghi.
Nguyên nhân: Có người đã tắt phân loại theo đơn vị trên thực thể đó. Từ lúc ấy, một bước còn nêu đơn vị đích không chặn lượt chạy nữa và cũng không đóng dấu đơn vị nào: thiết lập bị bỏ qua, bản ghi được lưu mà không thuộc đơn vị nào, và lượt chạy đi tiếp. Đây là chủ ý — dừng hẳn một lượt chạy vì một chiều đơn vị đã không còn tồn tại thì tệ hơn — nhưng nó im lặng: việc bỏ qua chỉ được ghi vào nhật ký máy chủ kèm tên bước, tab Hoạt động của lượt chạy không có dòng nào nói ra. Lời gọi tạo bản ghi qua API còn kèm theo một đơn vị cũng bị bỏ qua y như vậy.
Cách xử lý:
- Mở thực thể, sang tab Quyền truy cập và xem phân loại theo đơn vị còn bật không. Nhật ký thay đổi chính sách ngay trên tab đó có dòng Đã tắt phân loại theo đơn vị, kèm thời điểm và người thực hiện.
- Nếu việc tắt là ngoài ý muốn, bật lại. Đơn vị cũ của từng bản ghi chưa bao giờ bị xóa nên chúng tự xếp lại đúng chỗ, và thiết lập Đơn vị đích trên các phiên bản quy trình đã xuất bản cũng sống lại — nó chưa từng rời khỏi đồ thị, chỉ bị bỏ qua trong thời gian thực thể ngừng phân loại.
- Nhưng những bản ghi sinh ra trong lúc phân loại tắt thì đang trống đơn vị, mà cổng chặn khi bật lại đòi mọi bản ghi phải có đơn vị. Dùng Gán đơn vị… để gán nốt chúng trước, rồi mới bật được.
Nếu việc tắt là cố ý, hãy dọn luôn phía quy trình: mở bảng cài đặt của bước một lần. Trên thực thể đã ngừng phân loại, ô Đơn vị đích không còn xuất hiện trong bảng — nó chỉ tồn tại với thực thể có phân loại — và chính lần mở đó xóa thiết lập cũ khỏi bản nháp, còn các phiên bản đã xuất bản vẫn giữ nguyên thiết lập của mình. Sự vắng mặt của ô đó là dấu hiệu nhìn thấy được duy nhất của việc bỏ qua nói trên. Danh sách đầy đủ những gì mất đi khi tắt nằm ở mục Tắt phân loại trong Phân loại theo đơn vị.
Khóa bí mật đang được sử dụng
Triệu chứng: Thông báo lỗi khi cố xóa hoặc thay thế một Khóa bí mật.
Nguyên nhân: Khóa đang được tham chiếu bởi ít nhất một Tích hợp hoặc kết nối đang hoạt động.
Cách xử lý: Vào danh sách Tích hợp, tìm kết nối đang dùng khóa đó, ngắt kết nối hoặc cập nhật sang khóa mới, rồi thử xóa lại.
Kết nối tích hợp "Cần kết nối lại"
Triệu chứng: Trạng thái kết nối hiển thị "Cần kết nối lại" (needs reconnect).
Nguyên nhân: Token truy cập của nhà cung cấp bên ngoài đã hết hạn hoặc bị thu hồi (ví dụ: người dùng đổi mật khẩu HubSpot, hoặc quản trị viên thu hồi quyền của ứng dụng).
Cách xử lý:
- Vào Cài đặt → Tích hợp.
- Nhấn Kết nối lại trên kết nối bị ảnh hưởng.
- Hoàn thành luồng OAuth trong cửa sổ popup.
Các phiên chạy đang tạm dừng do lỗi kết nối sẽ tự tiếp tục sau khi kết nối được khôi phục thành công.
Lỗi xung đột phiên bản (409 Stale version)
Triệu chứng: Khi lưu bản nháp, nhận thông báo lỗi xung đột hoặc "phiên bản cũ".
Nguyên nhân: Hai người đang chỉnh sửa cùng một quy trình, hoặc tab trình duyệt của bạn bị mở quá lâu mà không tải lại.
Cách xử lý:
- Tải lại trang để lấy phiên bản mới nhất.
- Áp dụng lại các thay đổi của bạn.
- Lưu ngay để tránh xung đột tiếp theo.
Nếu đội nhóm cùng chỉnh sửa quy trình quan trọng, hãy thống nhất chỉ một người chỉnh sửa tại một thời điểm để tránh mất dữ liệu.
Cần thêm trợ giúp?
Nếu vấn đề của bạn không có trong danh sách trên, hãy liên hệ quản trị viên hệ thống hoặc xem thêm tại Thuật ngữ.