C TWO (wersja zapoznawcza)

C TWO to platforma zarządzania agentem, która organizuje przepływy pracy automatyzacji, zarządza interakcjami między ludźmi i robotami oraz przetwarza elementy robocze za pośrednictwem kolejek uniwersalnych. Ten łącznik umożliwia wyzwalanie przepływów z dwóch sesji języka C, zarządzanie cyklem życia sesji, tworzenie i przetwarzanie elementów kolejki oraz włączanie interakcji między człowiekiem a procesami cyfrowymi.

Ten łącznik jest dostępny w następujących produktach i regionach:

Service Class Regions
Copilot Studio Premium Wszystkie regiony Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     - Azure Government regionów
     - Azure regionach Chin
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate - narzędzie do automatyzacji procesów Premium Wszystkie regiony Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt biznesowy
Nazwa Obsługa języka C TWO
adres URL https://ctwo.com/
Email customersuccess@ctwo.com
Metadane łącznika
Publisher C DWA
Witryna internetowa https://ctwo.com/
Zasady ochrony prywatności https://ctwo.com/privacy-policy/
Kategorie Analiza biznesowa; AI

C DWA

C TWO to platforma zarządzania agentem, która organizuje przepływy pracy automatyzacji, zarządza interakcjami między ludźmi i robotami oraz przetwarza elementy robocze za pośrednictwem kolejek uniwersalnych. Ten łącznik umożliwia Power Automate, Power Apps, Azure Logic Apps i wyzwalacz Copilot Studio oraz wyzwalanie ich przez sesje języka C TWO, zarządzanie cyklem życia sesji, tworzenie i przetwarzanie elementów kolejki uniwersalnej oraz interakcję między ludźmi a pracownikami cyfrowymi.

C TWO znajduje się nad infrastrukturą automatyzacji jako pojedynczą aranżacją, zarządzaniem i warstwą monitorowania: cokolwiek tworzy lub wykonuje pracę, C TWO dodaje śledzenie umowy SLA, ponawianie prób i samonaprawianie, telemetria sesji na żywo i pełny dziennik inspekcji.

Wymagania wstępne

Przed utworzeniem połączenia potrzebne są następujące elementy:

  1. Aktywna dzierżawa C TWO — chmura C TWO (hostowana) lub lokalny serwer C TWO osiągalny za pośrednictwem protokołu HTTPS.
  2. Token konta usługi lub osobisty token dostępu wystawiony przez administratora języka C TWO (zobacz Uzyskiwanie poświadczeń).
  3. Jeśli język C TWO jest hostowany lokalnie, serwer musi być dostępny z poziomu usługi Power Platform za pośrednictwem protokołu HTTPS (zapora zezwalająca na Microsoft zakresy adresów IP Power Automate wychodzących — Azure tagi AzureConnectors.<region> usług i PowerPlatformPlex obszar geograficzny platformy Power Platform).
  4. Środowisko platformy Power Platform z uprawnieniami łącznika niestandardowego i warstwą licencji, która obsługuje łączniki niestandardowe (Power Automate Premium lub równoważne).

Tworzenie połączenia

Podczas tworzenia połączenia podajesz trzy wartości, wszystkie z własnego środowiska C TWO:

  1. C DWA host — tylko nazwa hosta serwera C DWA (bez schematu, bez ukośnika końcowego), np. connect24.ctwo.cloudlub hosta lokalnego z opcjonalnym portem, takim jak ctwo.contoso.com:8443.
  2. C DWA podstawowy adres URL — ścieżka podstawowa interfejsu API C TWO, w tym podział, zaczynając od ukośnika i bez ukośnika końcowego, np. /DEFAULT/CTWO.Server/api.
  3. Klucz interfejsu API — token wprowadzony jako Bearer <your-token>. Zalecany jest token konta usługi ; Działa również osobisty token dostępu .

Razem host i podstawowy adres URL kierują łącznik do własnego serwera C TWO (https://{Host}{Base URL}/…), więc każdy klient łączy się z własnym środowiskiem — C TWO Cloud lub on-premises.

Uzyskiwanie poświadczeń

Uwierzytelnianie używa klucza interfejsu API wysyłanego jako token elementu nośnego w nagłówku Authorization .

Token konta usługi (zalecany dla środowiska produkcyjnego)

  1. Zaloguj się do swojego wystąpienia C TWO.
  2. Przejdź do pozycji Aplikacje i połączenia → Microsoft Power Automate → Utwórz konto usługi.
  3. Skopiuj wygenerowany token natychmiast — jest wyświetlany tylko raz.

Osobisty token dostępu (programowanie/testowanie)

  1. Otwórz profil użytkownika w języku C TWO.
  2. Przejdź do karty Tokeny interfejsu API i wygeneruj nowy token.
  3. Skopiuj go natychmiast — jest wyświetlany tylko raz i jest unieważniany, jeśli konto użytkownika jest wyłączone.

Traktuj oba typy tokenów jako wpisy tajne — przechowuj je tylko w poświadczeniach połączenia platformy Power Platform, nigdy w zmiennych przepływu lub kodzie po stronie klienta.

Obsługiwane operacje

  • Wyzwalacze — uruchom przepływ, gdy dwa języki C wysyłają sesję z wymuszonym limitem czasu lub bez tego limitu czasu.
  • Zarządzanie sesjami — uzupełnianie/niepowodzenie raportu, dzienniki sesji typu zapisu, dostosowywanie limitu czasu sesji i sprawdzanie, czy żądanie zatrzymania jest bezproblemowe.
  • Kolejka uniwersalna — tworzenie, wyświetlanie listy, blokowanie, odblokowywanie, ponawianie i odroczenie elementów kolejki; aktualizowanie danych elementu i dodawanie dzienników na poziomie elementu; dodawanie/usuwanie tagów; pobieranie załączników; tworzenie stanów elementów niestandardowych; kolejki list.
  • Human-in-the-loop — tworzenie, przypisywanie, anulowanie przypisania i uzupełnianie ustrukturyzowanych formularzy pomocy człowieka oraz pobieranie/wykonywanie zapytań.

Wewnętrzne operacje pomocnika wypełniają dynamiczne listy rozwijane (selektory zadań i użytkowników) i nie są wywoływane bezpośrednio.

Znane problemy i ograniczenia

  • Wymagany jest poprawny adres URL hosta i podstawowy. Oba te elementy są wprowadzane w czasie połączenia i kierują łącznik do serwera C TWO. Nieprawidłowe lub niedostępne wartości powodują błędy połączenia lub żądania.
  • Format klucza interfejsu API. Pole Klucz interfejsu API oczekuje ciągu Bearer <token> literału — pominięcie prefiksu Bearer powoduje zwrócenie wartości 401 Unauthorized.
  • Dostarczanie danych elementu JSON. Pola danych elementu (Create Queue Item, Set Queue Item Data) to obiekty JSON. W przepływie podaj literał JSON z json('…') wyrażeniem, aby był wysyłany jako obiekt, a nie ciąg.
  • Opóźnienie wyzwalacza sondowania. Wyzwala sondowanie, a nie wypychanie, dlatego występuje małe opóźnienie (ograniczone przez cykl wyzwalacza) między sesją wysyłaną w języku C DWA a uruchomieniem przepływu.
  • Typy pól formularza. Niektóre pola identyfikatorów zwracane przez operacje formularza mogą być liczbą całkowitą, ciągiem lub wartością null w zależności od stanu formularza.

Typowe błędy i środki zaradcze

Błąd Prawdopodobna przyczyna Rozwiązanie
401 Unauthorized Klucz interfejsu API nie ma prefiksu Bearer , wygasł lub odwołano Wprowadź ponownie poświadczenia jako Bearer <token>; wygeneruj nowy token konta usługi w przypadku odwołania
400 Bad request w obszarze Create Queue Item (Tworzenie elementu kolejki) Brak wymaganego pola (reference, queueItemState, itemKey) Wypełnij wszystkie trzy wymagane pola
Wyzwalacz nigdy nie jest wyzwalany Wybrane nieprawidłowe zadanie lub zadanie C TWO nie jest widoczne dla Power Automate Upewnij się, że zadanie jest wyświetlane na liście rozwijanej Identyfikator zadania i jest skonfigurowane jako uwidoczniony przepływ w języku C TWO
Dane elementu przechowywane jako ciąg ucieczki Kod JSON podany jako tekst zamiast obiektu Użyj wyrażenia (przepływów) lub nieprzetworzonej json('…') treści (testu łącznika), aby była wysyłana jako obiekt

Często zadawane pytania

Czy mogę użyć tego łącznika z Power Apps, Azure Logic Apps i Copilot Studio, a nie tylko Power Automate? Yes. Wyzwalacze są Power Automate specyficzne, ale każda akcja może być wywoływana z dowolnej z tych platform po utworzeniu połączenia.

Czy ten łącznik zarządza licencjonowaniem? No. C DWA orkiestruje i zarządza wykonywaniem; klienci są odpowiedzialni za własne licencjonowanie Microsoft.

Gdzie mogę uzyskać pomoc? Skontaktuj się z C TWO Customer Success pod adresem customersuccess@ctwo.com.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Nazwa Typ Description Wymagane
C DWA hosty ciąg Nazwa hosta serwera C TWO tylko â € " brak schematu, bez końcowego ukośnika. Na przykład connect24.ctwo.cloud lub hosta lokalnego z opcjonalnym portem, takim jak ctwo.contoso.com:8443. True
C DWA podstawowy adres URL ciąg Ścieżka podstawowa interfejsu API języka C TWO wraz z podziałem. Zacznij od ukośnika, bez końcowego ukośnika. Na przykład /DEFAULT/CTWO. Serwer/interfejs API. True
Klucz API securestring Twój token interfejsu API języka C dwa wprowadzony jako: Bearer <your-token>. Zalecany jest token konta usługi; Działa również osobisty token dostępu. True

Akcje

Blokowanie elementu kolejki

Blokuje element kolejki, aby uniemożliwić innym procesom roboczym przetwarzanie go współbieżnie. Użyj tej akcji przed przetworzeniem elementu roboczego, aby zapewnić wyłączny dostęp.
Czy sesja powinna zostać zatrzymana

Sprawdza, czy C TWO zażądało bezpiecznego (miękkiego) zatrzymania dla danej sesji. Użyj tej akcji wewnątrz pętli, aby okresowo sprawdzać, czy sesja powinna zakończyć się wcześnie, umożliwiając przepływowi czyszczenie zasobów przed zatrzymaniem.
Dodawanie dziennika do elementu kolejki

Dodaje komunikat dziennika do elementu kolejki na potrzeby dziennika inspekcji i możliwości śledzenia. Ta akcja służy do rejestrowania kroków przetwarzania, ostrzeżeń lub błędów względem określonego elementu roboczego.
Dodawanie dziennika do sesji

Zapisuje wpis dziennika w sesji C TWO. Ta akcja służy do śledzenia postępu, rejestrowania decyzji lub rejestrowania informacji diagnostycznych podczas wykonywania przepływu. Dzienniki są widoczne na platformie C TWO na potrzeby inspekcji i rozwiązywania problemów.
Dodawanie tagów do elementu kolejki

Dodaje co najmniej jeden tag do elementu kolejki na potrzeby kategoryzacji i filtrowania. Tagi ułatwiają organizowanie i wyszukiwanie elementów roboczych w kolejkach.
Formularz kompletny

Oznacza formularz interakcji robota zgodnie z ukończeniem, sygnalizując, że użytkownik dostarczył żądane dane wejściowe, a cyfrowy proces roboczy może wznowić przetwarzanie.
Nieprzypisane formularz

Usuwa bieżące przypisanie użytkownika z formularza interakcji z robotem, udostępniając go innym użytkownikom do oświadczeń.
Odblokowywanie elementu kolejki

Odblokuje wcześniej zablokowany element kolejki i zwraca go do jego dostępnego stanu. Użyj tej akcji, gdy przetwarzanie zostanie przerwane, a element powinien zostać zwolniony dla innych procesów roboczych.
Odroczenie elementu kolejki

Odchyli element kolejki, aby nie był przetwarzany do określonej daty/godziny. Użyj tej akcji, gdy nie można teraz przetworzyć elementu, ale należy go ponowić później.
Pobieranie elementów kolejki

Pobiera elementy kolejki na podstawie określonych kryteriów filtrowania, takich jak stan, tagi, daty i nazwy kolejek. Użyj tej akcji, aby wyszukać i monitorować elementy robocze w kolejkach uniwersalnych.
Pobieranie formularza według identyfikatora

Pobiera określony formularz interakcji robota według jego unikatowego identyfikatora. Użyj tej akcji, aby pobrać szczegóły, pola i bieżący stan formularza pętli human-in-the-loop, który został utworzony przez cyfrowy proces roboczy.
Pobieranie formularzy

Pobiera listę formularzy interakcji robotów z opcjonalnym filtrowaniem. Użyj tej akcji, aby wysyłać zapytania dotyczące oczekujących żądań pętli human-in-the-loop, sprawdzić ich stan lub znaleźć formularze przypisane do określonych użytkowników.
Pobieranie kolejek

Pobiera kolejki uniwersalne na podstawie kryteriów filtrowania. Użyj tej akcji, aby wyświetlić listę dostępnych kolejek, sprawdzić ich konfigurację lub wyszukać szczegóły kolejki. Ta operacja obsługuje również dynamiczne listy rozwijane w innych akcjach.
Pobieranie załącznika elementu kolejki

Pobiera określony załącznik pliku z elementu kolejki jako dane zakodowane w formacie base64. Ta akcja służy do pobierania plików dołączonych do elementów roboczych podczas tworzenia lub przetwarzania.
Ponów próbę elementu kolejki

Ponów próbę określonego elementu kolejki, ustawiając jego dane z powrotem na oryginalną wartość i tworząc nową próbę.
Przypisywanie formularza

Przypisuje formularz interakcji robota do określonego użytkownika, dzięki czemu jest odpowiedzialny za przeglądanie i kończenie żądania pętli człowieka.
Tworzenie elementu kolejki

Tworzy nowy element roboczy w określonej uniwersalnej kolejce. Ta akcja służy do dodawania elementów do przetwarzania przez pracowników cyfrowych, w tym ładunków danych, tagów i opcjonalnych załączników plików.
Tworzenie formularza

Tworzy nowy formularz interakcji robota, który umożliwia cyfrowemu pracownikowi żądanie pomocy ludzkiej. Formularz jest przedstawiany przypisanym użytkownikom na platformie C TWO, umożliwiając scenariusze pętli człowieka w pętli, w których potrzebna jest wiedza specjalistyczna w zakresie obsługi wyjątków lub złożonych decyzji.
Tworzenie stanu elementu kolejki

Tworzy nowy stan niestandardowy w określonej kolejce. Stany niestandardowe umożliwiają definiowanie etapów przepływu pracy poza stanami domyślnymi (Oczekujące, Ukończone, Odwołane), dostosowanie kolejki do procesu biznesowego.
Ustaw stan wykonania przepływu na niepowodzenie

Oznacza sesję C TWO jako nieudaną, sygnalizując, że wystąpił błąd podczas wykonywania przepływu. Użyj tej akcji w zakresach obsługi błędów, aby zgłosić błędy z powrotem do C TWO ze szczegółowymi informacjami na temat tego, co poszło nie tak.
Ustaw stan wykonania przepływu na Ukończono

Oznacza sesję C TWO ukończoną, sygnalizując, że przepływ zakończył pracę pomyślnie. Umieść tę akcję na końcu przepływu, aby zgłosić z powrotem do C DWA, że automatyzacja została ukończona bez błędów.
Ustawianie danych elementu kolejki

Aktualizuje zawartość danych elementu kolejki. Użyj tej akcji, aby zmodyfikować ładunek elementu roboczego podczas przetwarzania, na przykład w celu przechowywania wyników pośrednich.
Ustawianie limitu czasu sesji

Aktualizuje wartość limitu czasu dla aktywnej sesji C TWO. Użyj tej akcji, aby przedłużyć lub skrócić dozwolony czas wykonywania dla uruchomionej sesji, gdy oryginalny limit czasu wymaga dostosowania.
Ustawianie stanu elementu kolejki

Zmienia stan elementu kolejki (np. z Oczekujące na Ukończono lub do stanu niestandardowego). Użyj tej akcji, aby przejść do elementów za pośrednictwem potoku przepływu pracy.
Usuwanie tagów z elementu kolejki

Usuwa jeden lub więcej tagów z elementu kolejki. Ta akcja służy do aktualizowania kategoryzacji elementów roboczych podczas przetwarzania.

Blokowanie elementu kolejki

Identyfikator operacji:
LockItem

Blokuje element kolejki, aby uniemożliwić innym procesom roboczym przetwarzanie go współbieżnie. Użyj tej akcji przed przetworzeniem elementu roboczego, aby zapewnić wyłączny dostęp.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId string

Identyfikator elementu kolejki do zablokowania. W przypadku pominięcia następny dostępny element pasujący do filtru zostanie zablokowany.
Nazwa kolejki
 reference string

Odwołanie do kolejki w celu zablokowania elementu.
Identyfikator stanu
 stateId string

Identyfikator stanu do filtrowania elementów.
Nazwa stanu
 stateName string

Nazwa stanu do filtrowania elementów według.
Identyfikator sesji
 sessionId string

Identyfikator sesji dla tej blokady.

Zwraca

Nazwa Ścieżka Typ Opis
id
 id integer

Unikatowy identyfikator zablokowanego elementu.
itemKey
 itemKey string

Unikatowy klucz zablokowanego elementu.
Prób
 attempts integer

Liczba prób przetwarzania.
queueId
 queueId integer

Identyfikator kolejki nadrzędnej.
id
 state.id integer

Identyfikator stanu.
nazwa
 state.name string

Nazwa stanu.
stan
 state.state string

Wartość stanu.
tags
 tags array of string

Tagi skojarzone z elementem kolejki.
utworzone
 created string

Znacznik czasu tworzenia.
createdByVendorSessionId
 createdByVendorSessionId integer

Identyfikator sesji, który utworzył ten element.
Zawartych
 concluded string

Sygnatura czasowa zakończenia.
Odroczonego
 deferred string

Odroczony znacznik czasu.
test
 test boolean

Czy jest to element testowy.
zablokowany
 locked boolean

Czy element jest zablokowany.

Czy sesja powinna zostać zatrzymana

Identyfikator operacji:
IsStopRequested

Sprawdza, czy C TWO zażądało bezpiecznego (miękkiego) zatrzymania dla danej sesji. Użyj tej akcji wewnątrz pętli, aby okresowo sprawdzać, czy sesja powinna zakończyć się wcześnie, umożliwiając przepływowi czyszczenie zasobów przed zatrzymaniem.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator sesji
 sessionId True string

Identyfikator sesji C TWO, aby sprawdzić żądanie zatrzymania. Domyślnie identyfikator sesji z danych wyjściowych wyzwalacza.

Zwraca

Nazwa Ścieżka Typ Opis
isStopRequested
 isStopRequested boolean

isStopRequested

Dodawanie dziennika do elementu kolejki

Identyfikator operacji:
AddItemLog

Dodaje komunikat dziennika do elementu kolejki na potrzeby dziennika inspekcji i możliwości śledzenia. Ta akcja służy do rejestrowania kroków przetwarzania, ostrzeżeń lub błędów względem określonego elementu roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId True string

Identyfikator elementu kolejki do zalogowania.
Poziom logowania
 level string

Poziom ważności wpisu dziennika.
Message
 message string

Zawartość komunikatu dziennika.

Dodawanie dziennika do sesji

Identyfikator operacji:
AddLogToSession

Zapisuje wpis dziennika w sesji C TWO. Ta akcja służy do śledzenia postępu, rejestrowania decyzji lub rejestrowania informacji diagnostycznych podczas wykonywania przepływu. Dzienniki są widoczne na platformie C TWO na potrzeby inspekcji i rozwiązywania problemów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator sesji
 sessionId True string

Identyfikator sesji C TWO, w której zostanie zarejestrowany wpis dziennika. Domyślnie identyfikator sesji z danych wyjściowych wyzwalacza.
poziom
 level True string

Poziom ważności wpisu dziennika.
komunikat
 message True string

Zawartość komunikatu dziennika do zarejestrowania.

Dodawanie tagów do elementu kolejki

Identyfikator operacji:
AddItemTag

Dodaje co najmniej jeden tag do elementu kolejki na potrzeby kategoryzacji i filtrowania. Tagi ułatwiają organizowanie i wyszukiwanie elementów roboczych w kolejkach.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId True string

Identyfikator elementu kolejki do dodawania tagów.
Tags
 tags string

Rozdzielona przecinkami lista tagów do dodania.

Formularz kompletny

Identyfikator operacji:
CompleteForm

Oznacza formularz interakcji robota zgodnie z ukończeniem, sygnalizując, że użytkownik dostarczył żądane dane wejściowe, a cyfrowy proces roboczy może wznowić przetwarzanie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator formularza
 formId True string

Użytkownik w identyfikatorze formularza pętli oznaczany jako ukończony.
completedAt
 completedAt date-time

Sygnatura czasowa po zakończeniu formularza (format ISO 8601).

Nieprzypisane formularz

Identyfikator operacji:
UnassignForm

Usuwa bieżące przypisanie użytkownika z formularza interakcji z robotem, udostępniając go innym użytkownikom do oświadczeń.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator formularza
 formId True string

Człowiek w identyfikatorze formularza pętli, aby cofnąć przypisanie.

Odblokowywanie elementu kolejki

Identyfikator operacji:
UnlockItem

Odblokuje wcześniej zablokowany element kolejki i zwraca go do jego dostępnego stanu. Użyj tej akcji, gdy przetwarzanie zostanie przerwane, a element powinien zostać zwolniony dla innych procesów roboczych.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId True string

Identyfikator elementu kolejki do odblokowania.

Odroczenie elementu kolejki

Identyfikator operacji:
DeferItem

Odchyli element kolejki, aby nie był przetwarzany do określonej daty/godziny. Użyj tej akcji, gdy nie można teraz przetworzyć elementu, ale należy go ponowić później.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId True string

Identyfikator elementu kolejki do odroczenia.
Odroczone do czasu
 deferredUntil date-time

Data/godzina odroczenia do (format ISO 8601).

Zwraca

response
string

Pobieranie elementów kolejki

Identyfikator operacji:
GetItems

Pobiera elementy kolejki na podstawie określonych kryteriów filtrowania, takich jak stan, tagi, daty i nazwy kolejek. Użyj tej akcji, aby wyszukać i monitorować elementy robocze w kolejkach uniwersalnych.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz elementu
 itemKey string

Filtruj według klucza elementu.
Attempts
 attempts integer

Filtruj według liczby prób.
Odroczone przed
 deferredBefore date-time

Filtruj elementy odroczone przed tą datą.
Odroczone po
 deferredAfter date-time

Odroczone po tej dacie odfiltruj elementy.
Utworzone przed
 createdBefore date-time

Filtruj elementy utworzone przed tą datą.
Utworzone po
 createdAfter date-time

Odfiltruj elementy utworzone po tej dacie.
Zakończone przed
 concludedBefore date-time

Odfiltruj elementy zakończone przed tą datą.
Zakończone po
 concludedAfter date-time

Odfiltruj elementy zakończone po tej dacie.
Stan wprowadzony przed
 stateEnteredTimeBefore date-time

Filtruj elementy, które wprowadziły stan przed tym czasem.
Stan wprowadzony po
 stateEnteredTimeAfter date-time

Odfiltruj elementy, które zostały wprowadzone po tym czasie.
States
 states string

Filtruj według stanu elementu kolejki.
Identyfikatory stanu elementu kolejki
 queueItemStateIds integer

Filtruj według identyfikatorów stanu elementu kolejki.
Nazwy stanów elementu kolejki
 queueItemStateNames string

Filtruj według nazw stanów elementów kolejki.
Tags
 tags string

Filtruj według tagów (rozdzielane przecinkami).
Identyfikatory kolejek
 queueIds integer

Filtruj według identyfikatorów kolejek.
Nazwy kolejek
 queueNames True string

Filtruj według nazw kolejek (wymagane).
References
 references string

Filtruj według odwołań do kolejki.
Uwzględnij dane elementu
 includeItemData boolean

Określa, czy dane elementów mają być uwzględniane w odpowiedzi.
Pomiń
 skip integer

Liczba rekordów do pominięcia na potrzeby stronicowania.
Weź
 take integer

Liczba rekordów do zwrócenia.

Zwraca

Nazwa Ścieżka Typ Opis
array of object
id
 id integer

Unikatowy identyfikator elementu kolejki.
itemKey
 itemKey string

Unikatowy klucz elementu kolejki.
Prób
 attempts integer

Liczba prób przetwarzania.
queueId
 queueId integer

Identyfikator kolejki nadrzędnej.
id
 state.id integer

Identyfikator stanu.
nazwa
 state.name string

Nazwa stanu.
stan
 state.state string

Wartość stanu.
tags
 tags array of string

Tagi skojarzone z elementem kolejki.
utworzone
 created string

Znacznik czasu tworzenia.
createdByVendorSessionId
 createdByVendorSessionId integer

Identyfikator sesji, który utworzył ten element.
zakończone
 concluded string

Sygnatura czasowa zakończenia.
Odroczonego
 deferred string

Odroczony znacznik czasu.
test
 test boolean

Czy jest to element testowy.
zablokowany
 locked boolean

Czy element jest zablokowany.

Pobieranie formularza według identyfikatora

Identyfikator operacji:
GetFormById

Pobiera określony formularz interakcji robota według jego unikatowego identyfikatora. Użyj tej akcji, aby pobrać szczegóły, pola i bieżący stan formularza pętli human-in-the-loop, który został utworzony przez cyfrowy proces roboczy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator formularza
 formId True string

Człowiek w identyfikatorze formularza pętli, aby uzyskać szczegółowe informacje.

Zwraca

Nazwa Ścieżka Typ Opis
id
 id integer

id
divisionId
 divisionId

divisionId
identyfikator sesji
 sessionId

identyfikator sesji
queueItemId
 queueItemId

queueItemId
claimedByUserId
 claimedByUserId

claimedByUserId
claimedOn
 claimedOn string

claimedOn
createdByWorkflowTaskId
 createdByWorkflowTaskId

createdByWorkflowTaskId
createdByUserId
 createdByUserId

createdByUserId
createdOn (Utworzony On)
 createdOn string

createdOn (Utworzony On)
termin
 deadline string

termin
zakończono
 completed string

zakończono
tytuł
 title string

tytuł
wprowadzenie
 intro string

Intro
pola
 fields string

pola

Pobieranie formularzy

Identyfikator operacji:
GetForms

Pobiera listę formularzy interakcji robotów z opcjonalnym filtrowaniem. Użyj tej akcji, aby wysyłać zapytania dotyczące oczekujących żądań pętli human-in-the-loop, sprawdzić ich stan lub znaleźć formularze przypisane do określonych użytkowników.

Parametry

Nazwa Klucz Wymagane Typ Opis
Pomiń
 skip integer

Liczba rekordów do pominięcia na potrzeby stronicowania.
Weź
 take integer

Liczba rekordów do zwrócenia.
Termin przed
 deadlineBefore date-time

Filtruj formularze z terminem przed tą datą/godziną (ISO 8601).
Termin po
 deadlineAfter date-time

Filtruj formularze z terminem upływanym po tej dacie/godzinie (ISO 8601).
Uwzględnij ukończone
 includeCompleted boolean

Określa, czy w wynikach mają być uwzględniane wypełnione formularze.
Oświadczenia według identyfikatora użytkownika
 claimedByUserId integer

Filtruj formularze zgłoszone przez określony identyfikator użytkownika.
Utworzony przez identyfikator zadania przepływu pracy
 createdByWorkflowTaskId integer

Filtruj formularze utworzone według określonego identyfikatora zadania przepływu pracy.

Zwraca

Nazwa Ścieżka Typ Opis
array of object
id
 id integer

id
divisionId
 divisionId

divisionId
identyfikator sesji
 sessionId

identyfikator sesji
queueItemId
 queueItemId

queueItemId
claimedByUserId
 claimedByUserId

claimedByUserId
claimedOn
 claimedOn string

claimedOn
createdByWorkflowTaskId
 createdByWorkflowTaskId

createdByWorkflowTaskId
createdByUserId
 createdByUserId

createdByUserId
createdOn (Utworzony On)
 createdOn string

createdOn (Utworzony On)
termin
 deadline string

termin
zakończono
 completed string

zakończono
niezdefiniowane
 undeferred boolean

niezdefiniowane

Pobieranie kolejek

Identyfikator operacji:
GetQueues

Pobiera kolejki uniwersalne na podstawie kryteriów filtrowania. Użyj tej akcji, aby wyświetlić listę dostępnych kolejek, sprawdzić ich konfigurację lub wyszukać szczegóły kolejki. Ta operacja obsługuje również dynamiczne listy rozwijane w innych akcjach.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kolejki
 id string

Filtruj według identyfikatora kolejki.
Odwołanie do kolejki
 reference string

Filtruj według odwołania do kolejki.
Nazwa kolejki
 name string

Filtruj według nazwy kolejki.
Nazwa stanu
 stateName string

Filtruj według nazwy stanu.
Deleted
 deleted boolean

Filtruj według usuniętego stanu.
Pomiń
 skip integer

Liczba rekordów do pominięcia na potrzeby stronicowania.
Weź
 take integer

Liczba rekordów do zwrócenia.

Zwraca

Nazwa Ścieżka Typ Opis
array of object
id
 id integer

Unikalny identyfikator kolejki.
usunięta
 deleted boolean

Czy kolejka jest usuwana.
nazwa
 name string

Nazwa kolejki.
description
 description string

Opis kolejki.
widoczny
 visible boolean

Czy kolejka jest widoczna.
includeInReports
 includeInReports boolean

Czy należy uwzględnić w raportach.
utworzone
 created string

Znacznik czasu tworzenia.
aktualizowano
 updated string

Znacznik czasu ostatniej aktualizacji.
deletedTime
 deletedTime string

Sygnatura czasowa usuwania.
divisionId
 divisionId integer

Identyfikator dzielenia.
typ
 type integer

Typ kolejki.
odwołanie
 reference string

Odwołanie do kolejki.
Państw
 states array of object

Stany dostępne w tej kolejce.
id
 states.id integer

Identyfikator stanu.
nazwa
 states.name string

Nazwa stanu.
description
 states.description string

Opis stanu.
filtr tagów
 states.tagfilter string

Filtr tagu dla tego stanu.
stan
 states.state integer

Typ stanu.
timeSavedPerItem
 states.timeSavedPerItem integer

Czas zapisany na element.
includeInReports
 states.includeInReports boolean

Czy należy uwzględnić w raportach.
responseTimeCalculationBasis
 states.responseTimeCalculationBasis integer

Podstawa obliczania czasu odpowiedzi.

Pobieranie załącznika elementu kolejki

Identyfikator operacji:
GetItemAttachment

Pobiera określony załącznik pliku z elementu kolejki jako dane zakodowane w formacie base64. Ta akcja służy do pobierania plików dołączonych do elementów roboczych podczas tworzenia lub przetwarzania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId True string

Identyfikator elementu kolejki zawierającego załącznik.
Identyfikator załącznika
 attachmentId True string

Identyfikator załącznika do pobrania.
Filename
 filename string

Nazwa pliku załącznika.

Zwraca

response
string

Ponów próbę elementu kolejki

Identyfikator operacji:
RetryItem

Ponów próbę określonego elementu kolejki, ustawiając jego dane z powrotem na oryginalną wartość i tworząc nową próbę.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId True integer

Określony identyfikator elementu kolejki, aby ponowić próbę.
Identyfikator stanu
 stateId integer

Określony identyfikator stanu oczekującego elementu kolejki do ustawienia; przyjmuje priorytet nad parametrem stanu.
State
 state string

Określona nazwa stanu oczekującego elementu kolejki, która ma zostać ustawiona.
Identyfikator zadania przepływu pracy
 workflowTaskId integer

Identyfikator workflowTask.
identyfikator aplikacji
 appId integer

Identyfikator aplikacji.

Przypisywanie formularza

Identyfikator operacji:
AssignForm

Przypisuje formularz interakcji robota do określonego użytkownika, dzięki czemu jest odpowiedzialny za przeglądanie i kończenie żądania pętli człowieka.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator formularza
 formId True string

Człowiek w identyfikatorze formularza pętli do przypisania.
userId
 userId integer

Identyfikator użytkownika do przypisania formularza.

Tworzenie elementu kolejki

Identyfikator operacji:
CreateItem

Tworzy nowy element roboczy w określonej uniwersalnej kolejce. Ta akcja służy do dodawania elementów do przetwarzania przez pracowników cyfrowych, w tym ładunków danych, tagów i opcjonalnych załączników plików.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz elementu
 itemKey True string

Unikatowy klucz biznesowy umożliwiający zidentyfikowanie tego elementu kolejki (np. numer faktury, identyfikator sprawy).
Stan elementu kolejki
 queueItemState True string

Początkowy stan elementu kolejki (np. Oczekiwanie).
Odwołanie do kolejki
 reference True string

Odwołanie do kolejki, w której zostanie utworzony element.
Odroczone do czasu
 deferredUntil date-time

Odroczenie przetwarzania do tej daty/godziny (format ISO 8601).
Dane elementu
 itemData object

Ładunek danych dla elementu kolejki w formacie JSON.
Tags
 tags string

Tagi elementu kolejki (rozdzielane przecinkami).
fileName
 fileName string

Nazwa pliku załącznika.
fileData
 fileData string

Dane pliku zakodowane w formacie base64.
Identyfikator sesji
 sessionId string

Identyfikator sesji skojarzony z tym elementem.
Urządzenie
 device string

Urządzenie, które utworzyło ten element.
User
 user string

Użytkownik, który utworzył ten element.
Dostawca usługi Automation
 automationProvider string

Dostawca automatyzacji dla tego elementu.

Zwraca

Nazwa Ścieżka Typ Opis
id
 id integer

id
itemKey
 itemKey string

itemKey
Prób
 attempts integer

Prób
queueId
 queueId integer

queueId
id
 state.id integer

id
nazwa
 state.name string

nazwa
stan
 state.state string

stan
tags
 tags array of string

tags
utworzone
 created string

utworzone
createdByVendorSessionId
 createdByVendorSessionId integer

createdByVendorSessionId
Zawartych
 concluded string

zakończone
Odroczonego
 deferred string

Odroczonego
test
 test boolean

test
zablokowany
 locked boolean

zablokowany

Tworzenie formularza

Identyfikator operacji:
CreateForm

Tworzy nowy formularz interakcji robota, który umożliwia cyfrowemu pracownikowi żądanie pomocy ludzkiej. Formularz jest przedstawiany przypisanym użytkownikom na platformie C TWO, umożliwiając scenariusze pętli człowieka w pętli, w których potrzebna jest wiedza specjalistyczna w zakresie obsługi wyjątków lub złożonych decyzji.

Parametry

Nazwa Klucz Wymagane Typ Opis
pola
 fields string

Ciąg sformatowany w formacie JSON definiujący pola formularza, które użytkownik musi wypełnić.
tytuł
 title string

Tytuł wyświetlany użytkownikowi po otwarciu formularza.
termin
 deadline date-time

Termin, w którym człowiek musi odpowiedzieć na formularz (format ISO 8601).
Intro
 intro string

Tekst wprowadzający pokazany użytkownikowi wyjaśniające, jakie działania są potrzebne.
itemId
 itemId integer

Identyfikator elementu kolejki skojarzony z tym formularzem, łącząc interakcję człowieka z określonym elementem roboczym.
workflowTaskId
 workflowTaskId integer

Zadanie C TWO, które utworzyło ten formularz.

Zwraca

Nazwa Ścieżka Typ Opis
id
 id integer

id

Tworzenie stanu elementu kolejki

Identyfikator operacji:
CreateItemState

Tworzy nowy stan niestandardowy w określonej kolejce. Stany niestandardowe umożliwiają definiowanie etapów przepływu pracy poza stanami domyślnymi (Oczekujące, Ukończone, Odwołane), dostosowanie kolejki do procesu biznesowego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa
 name string

Nazwa nowego stanu.
Obliczanie czasu odpowiedzi
 responseTimeCalculationBasis True string

Określa sposób obliczania umów SLA czasu odpowiedzi dla elementów wchodzących w ten stan.
Typ stanu
 state True string

Typ stanu (Oczekiwanie, Ukończono lub Odwoływanych).
Identyfikator kolejki
 queueId True integer

Identyfikator kolejki, w której zostanie utworzony ten stan.
Description
 description string

Opis tego, co ten stan reprezentuje w przepływie pracy.
Czas zaoszczędzony na element
 timeSavedPerItem integer

Czas zapisany na element w tym stanie (w sekundach), używany do raportowania zwrotu z inwestycji.
Wartość wygenerowana na element
 valueGeneratedPerItem integer

Wartość wygenerowana dla każdego elementu w tym stanie, używana do raportowania zwrotu z inwestycji.
Uwzględnij w raportach
 includeInReports boolean

Czy należy uwzględnić ten stan w analizie i raportach.

Ustaw stan wykonania przepływu na niepowodzenie

Identyfikator operacji:
SetSessionFailed

Oznacza sesję C TWO jako nieudaną, sygnalizując, że wystąpił błąd podczas wykonywania przepływu. Użyj tej akcji w zakresach obsługi błędów, aby zgłosić błędy z powrotem do C TWO ze szczegółowymi informacjami na temat tego, co poszło nie tak.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator sesji
 sessionId True string

Identyfikator sesji C TWO oznaczany jako niepowodzenie. Domyślnie identyfikator sesji z danych wyjściowych wyzwalacza.
details
 details True string

Opis błędu lub wyjątku, który spowodował niepowodzenie sesji.

Ustaw stan wykonania przepływu na Ukończono

Identyfikator operacji:
SetSessionCompleted

Oznacza sesję C TWO ukończoną, sygnalizując, że przepływ zakończył pracę pomyślnie. Umieść tę akcję na końcu przepływu, aby zgłosić z powrotem do C DWA, że automatyzacja została ukończona bez błędów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator sesji
 sessionId True string

Identyfikator sesji dwóch języka C do oznaczania jako ukończony pomyślnie. Domyślnie identyfikator sesji z danych wyjściowych wyzwalacza.

Zwraca

response
object

Ustawianie danych elementu kolejki

Identyfikator operacji:
SetItemData

Aktualizuje zawartość danych elementu kolejki. Użyj tej akcji, aby zmodyfikować ładunek elementu roboczego podczas przetwarzania, na przykład w celu przechowywania wyników pośrednich.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId True string

Identyfikator elementu kolejki do zaktualizowania.
Data
 data object

Nowy ładunek danych dla elementu kolejki jako obiekt JSON.
Created
 created date-time

Sygnatura czasowa tworzenia dla tych danych.

Ustawianie limitu czasu sesji

Identyfikator operacji:
SetTimeout

Aktualizuje wartość limitu czasu dla aktywnej sesji C TWO. Użyj tej akcji, aby przedłużyć lub skrócić dozwolony czas wykonywania dla uruchomionej sesji, gdy oryginalny limit czasu wymaga dostosowania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator sesji
 sessionId True string

Identyfikator sesji C TWO w celu zaktualizowania limitu czasu dla. Domyślnie identyfikator sesji z danych wyjściowych wyzwalacza.
Przerwa czasowa
 timeout True integer

Nowa wartość limitu czasu w sekundach, która ma być stosowana do sesji.

Zwraca

response
string

Ustawianie stanu elementu kolejki

Identyfikator operacji:
SetItemState

Zmienia stan elementu kolejki (np. z Oczekujące na Ukończono lub do stanu niestandardowego). Użyj tej akcji, aby przejść do elementów za pośrednictwem potoku przepływu pracy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId True string

Identyfikator elementu kolejki do zaktualizowania.
State
 state string

Nowy stan elementu kolejki.

Usuwanie tagów z elementu kolejki

Identyfikator operacji:
RemoveItemTag

Usuwa jeden lub więcej tagów z elementu kolejki. Ta akcja służy do aktualizowania kategoryzacji elementów roboczych podczas przetwarzania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu kolejki
 queueItemId True string

Identyfikator elementu kolejki do usunięcia tagów.
Tags
 tags string

Rozdzielona przecinkami lista tagów do usunięcia.

Wyzwalacze

Uruchamianie przepływu z żądania sesji bez przekroczenia limitu czasu

Sonduje nowe sesje języka C TWO i wyzwala przepływ po utworzeniu sesji dla wybranego zadania. Użyj tego wyzwalacza, gdy automatyzacja nie wymaga ograniczenia limitu czasu. Przepływ odbiera szczegóły sesji, w tym wartości wejściowe przekazane z C TWO.
Uruchamianie przepływu z żądania sesji z limitem czasu

Sonduje nowe sesje C TWO i wyzwala przepływ z ograniczeniem limitu czasu. Użyj tego wyzwalacza, gdy automatyzacja musi zostać ukończona w określonym przedziale czasu. Jeśli sesja przekroczy limit czasu, C TWO obsłuży go zgodnie z zasadami limitu czasu.

Uruchamianie przepływu z żądania sesji bez przekroczenia limitu czasu

Identyfikator operacji:
StartFlowWithoutTimeout

Sonduje nowe sesje języka C TWO i wyzwala przepływ po utworzeniu sesji dla wybranego zadania. Użyj tego wyzwalacza, gdy automatyzacja nie wymaga ograniczenia limitu czasu. Przepływ odbiera szczegóły sesji, w tym wartości wejściowe przekazane z C TWO.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zadania
 taskId True integer

Wybierz zadanie C TWO, które wyzwoli ten przepływ. Po utworzeniu nowej sesji dla tego zadania w języku C DWA przepływ zostanie uruchomiony automatycznie bez wymuszania limitu czasu.

Zwraca

Nazwa Ścieżka Typ Opis
sessions
 sessions array of object

Zestaw sesji wyzwalanych przez C DWA bez limitu czasu
identyfikator sesji
 sessions.sessionId integer

identyfikator sesji
workflowTaskId
 sessions.workflowTaskId integer

workflowTaskId
Nazwa_przepływu pracy
 sessions.workflowName string

Nazwa_przepływu pracy
nazwa zadania
 sessions.taskName string

nazwa zadania
utworzone
 sessions.created string

utworzone
processInputValues
 sessions.processInputValues object

processInputValues

Uruchamianie przepływu z żądania sesji z limitem czasu

Identyfikator operacji:
StartFlowWithTimeout

Sonduje nowe sesje C TWO i wyzwala przepływ z ograniczeniem limitu czasu. Użyj tego wyzwalacza, gdy automatyzacja musi zostać ukończona w określonym przedziale czasu. Jeśli sesja przekroczy limit czasu, C TWO obsłuży go zgodnie z zasadami limitu czasu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zadania
 taskId True integer

Wybierz zadanie C TWO, które wyzwoli ten przepływ. Po utworzeniu sesji dla tego zadania przepływ rozpoczyna się od określonego limitu czasu wymuszonego.
Limit czasu sekund
 timeout True integer

Maksymalny czas w sekundach, przez który sesja może być uruchamiana, zanim C DWA oznacza go jako przekroczony limit czasu.

Zwraca

Nazwa Ścieżka Typ Opis
sessions
 sessions array of object

Zestaw sesji wyzwalanych przez C DWA z przekroczeniem limitu czasu
identyfikator sesji
 sessions.sessionId integer

identyfikator sesji
workflowTaskId
 sessions.workflowTaskId integer

workflowTaskId
Nazwa_przepływu pracy
 sessions.workflowName string

Nazwa_przepływu pracy
nazwa zadania
 sessions.taskName string

nazwa zadania
utworzone
 sessions.created string

utworzone
processInputValues
 sessions.processInputValues object

processInputValues

Definicje

ciąg

Jest to podstawowy typ danych "string".

obiekt

Jest to typ "object".