C TWO (Preview)

C TWO je platforma pro správu agentů, která orchestruje pracovní postupy automatizace, spravuje interakce lidského robota a zpracovává pracovní položky prostřednictvím univerzálních front. Pomocí tohoto konektoru můžete aktivovat toky z relací C TWO, spravovat životní cyklus relace, vytvářet a zpracovávat položky fronty a povolovat interakce mezi lidmi a digitálními pracovními procesy.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate kromě následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logické aplikace Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Azure Government oblastí
     – Azure oblasti Čína
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Automatizace napájení Premium Všechny oblasti Power Automate kromě následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Contact
název Podpora C TWO
URL https://ctwo.com/
Email customersuccess@ctwo.com
Metadata konektoru
Vydavatel C TWO
Internetová stránka https://ctwo.com/
Zásady ochrany osobních údajů https://ctwo.com/privacy-policy/
Kategorie Business Intelligence; Umělá inteligence

C TWO

C TWO je platforma pro správu agentů, která orchestruje pracovní postupy automatizace, spravuje interakce lidského robota a zpracovává pracovní položky prostřednictvím univerzálních front. Tento konektor umožňuje Power Automate, Power Apps, Azure Logic Apps a Copilot Studio trigger a aktivovat relacemi C TWO, spravovat životní cyklus relace, vytvářet a zpracovávat položky univerzální fronty a povolovat interakce mezi lidmi a digitálními pracovníky.

C TWO se nachází nad aktivy automatizace jako jedna vrstva orchestrace, zásad správného řízení a monitorování: cokoli vytváří nebo spouští práci, C TWO přidává sledování smluv SLA, opakování a samoopravení, telemetrii živé relace a úplný záznam auditu.

Předpoklady

Před vytvořením připojení budete potřebovat:

  1. Aktivní tenant C TWO – buď C TWO Cloud (hostovaný) nebo místní server C TWO dostupný přes HTTPS.
  2. Token účtu služby nebo osobní přístupový token vydaný vaším správcem C TWO (viz Získání přihlašovacích údajů).
  3. Pokud je C TWO hostovaný místně, musí být server dostupný z Power Platform přes HTTPS (brána firewall umožňující Microsoft Power Automate rozsahy odchozích IP adres – Azure značky AzureConnectors.<region> služeb a PowerPlatformPlex pro vaši platformu Power Platform Geo).
  4. Prostředí Power Platform s oprávněními vlastního konektoru a úrovní licencí, která podporuje vlastní konektory (Power Automate Premium nebo ekvivalentní).

Vytvoření připojení

Při vytváření připojení zadáte tři hodnoty, a to vše z vlastního prostředí C TWO:

  1. C TWO Host – pouze název hostitele serveru C TWO (bez schématu, bez koncového lomítka), např. connect24.ctwo.cloudnebo místního hostitele s volitelným portem, například ctwo.contoso.com:8443.
  2. C TWO Base URL – základní cesta rozhraní C TWO API včetně dělení, počínaje lomítkem a bez koncového lomítka, např. /DEFAULT/CTWO.Server/api
  3. Klíč rozhraní API – váš token, zadaný jako Bearer <your-token>. Doporučuje se token účtu služby ; Osobní přístupový token funguje také.

Společně hostování a základní adresa URL směrují konektor na vlastní server C TWO(https://{Host}{Base URL}/…), takže se každý zákazník připojí ke svému vlastnímu prostředí – C TWO Cloud nebo místně.

Získání přihlašovacích údajů

Ověřování používá klíč rozhraní API odeslaný jako nosný token v Authorization hlavičce.

Token účtu služby (doporučeno pro produkční prostředí)

  1. Přihlaste se ke své instanci C TWO.
  2. Přejděte na Aplikace a připojení → Microsoft Power Automate → Vytvoření účtu služby.
  3. Vygenerovaný token zkopírujte okamžitě – zobrazí se jenom jednou.

Osobní přístupový token (vývoj/testování)

  1. Otevřete profil uživatele v C TWO.
  2. Přejděte na kartu Tokeny rozhraní API a vygenerujte nový token.
  3. Zkopírujte ho okamžitě – zobrazí se pouze jednou a zneplatní se, pokud je uživatelský účet zakázaný.

Považovat oba typy tokenů za tajné kódy – ukládat je pouze v přihlašovacích údajích připojení Power Platform, nikdy v proměnných toku nebo v kódu na straně klienta.

Podporované operace

  • Triggery – Spustí tok, když C TWO odešle relaci s vynuceným vypršením časového limitu nebo bez.
  • Správa relací – Dokončení nebo selhání sestavy, zapisované protokoly relace, úprava časového limitu relace a kontrola řádné žádosti o zastavení
  • Univerzální fronta – vytvoření, výpis, uzamčení, odemknutí, opakování a odložení položek fronty; aktualizace dat položek a přidání protokolů na úrovni položek; přidání nebo odebrání značek; načítat přílohy; vytvořit vlastní stavy položek; fronty seznamu.
  • Human-in-the-loop – Vytvoření, přiřazení, zrušení přiřazení a dokončení strukturovaných formulářů lidské pomoci a jejich načtení/dotazování.

Interní pomocné operace naplňují dynamické rozevírací seznamy (výběry úkolů a uživatelů) a nevolají se přímo.

Známé problémy a omezení

  • Je vyžadována správná adresa URL hostitele a základní adresy URL. Oba jsou zadány v době připojení a směrují konektor na váš C TWO server. Nesprávné nebo nedostupné hodnoty vedou k selhání připojení nebo požadavků.
  • Formát klíče rozhraní API Pole Klíč rozhraní API očekává literálový řetězec Bearer <token> – vynechání Bearer výsledků předpony .401 Unauthorized
  • Zadávání dat položek JSON Pole s daty položek (Create Queue Item, Set Queue Item Data) jsou objekty JSON. V toku zadejte literál JSON s výrazem json('…') , aby se odeslal jako objekt, a ne jako řetězec.
  • Latence triggeru dotazování Aktivuje dotaz místo nasdílení změn, takže mezi odesláním relace v jazyce C TWO a spuštěním toku dochází k malému zpoždění (vázanému opakováním triggeru).
  • Typy polí formuláře. Některá pole identifikátoru vrácená operacemi formuláře můžou být celé číslo, řetězec nebo null v závislosti na stavu formuláře.

Běžné chyby a nápravné prostředky

Error Pravděpodobná příčina Náprava
401 Unauthorized Klíč rozhraní API chybí předpona Bearer , vypršela platnost nebo byla odvolána. Znovu zadejte přihlašovací údaje jako Bearer <token>; vygenerujte nový token účtu služby, pokud byl odvolán.
400 Bad request při vytvoření položky fronty Chybí povinné pole (reference, queueItemState, itemKey) Vyplňte všechna tři povinná pole.
Trigger se nikdy neaktivuje Vybrán nesprávný úkol nebo není úkol C TWO vystavený Power Automate Ověřte, že se úloha zobrazí v rozevíracím seznamu ID úlohy a je nakonfigurovaná jako vystavený tok v jazyce C TWO.
Data položek uložená jako řídicí řetězec JSON zadaný jako text místo objektu json('…') Použijte výraz (toky) nebo nezpracované tělo (test konektoru), aby byl odeslán jako objekt.

časté otázky

Můžu tento konektor používat z Power Apps, Azure Logic Apps a Copilot Studio, nejen Power Automate? Yes. Triggery jsou Power Automate specifické, ale po vytvoření připojení je možné volat každou akci z libovolné z těchto platforem.

Spravuje tento konektor licencování? No. C TWO orchestruje a řídí provádění; zákazníci zodpovídají za vlastní Microsoft licencování.

Kde získám pomoc? Obraťte se na C TWO Customer Success na adrese customersuccess@ctwo.com.

Vytvoření připojení

Konektor podporuje následující typy ověřování:
Default Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

název Typ Description Povinné
C TWO Host řetězec Název hostitele vašeho serveru C TWO pouze â € " žádné schéma, bez koncové lomítko. Například connect24.ctwo.cloud nebo místního hostitele s volitelným portem, jako je ctwo.contoso.com:8443. Pravdivé
C TWO Base URL řetězec Základní cesta rozhraní C TWO API včetně dělení. Začněte lomítkem, bez koncového lomítka. Například /DEFAULT/CTWO. Server/rozhraní API. Pravdivé
Klíč API securestring Váš token rozhraní API C TWO zadaný jako: Bearer <your-token>. Doporučuje se token účtu služby; Osobní přístupový token funguje také. Pravdivé

Akce

Měla by se relace zastavit.

Zkontroluje, jestli C TWO požádala o řádné (obnovitelné) zastavení pro danou relaci. Pomocí této akce uvnitř smyček můžete pravidelně kontrolovat, jestli by se relace měla ukončit včas, což toku umožní před zastavením vyčistit prostředky.
Nastavení dat položky fronty

Aktualizuje datový obsah položky fronty. Tato akce slouží k úpravě datové části pracovní položky během zpracování, například k ukládání průběžných výsledků.
Nastavení stavu položky fronty

Změní stav položky fronty (např. čeká na dokončení nebo vlastní stav). Pomocí této akce můžete procházet položky prostřednictvím kanálu pracovního postupu.
Nastavení stavu provádění toku na dokončené

Označí relaci C TWO jako dokončenou a signalizují, že tok úspěšně dokončil svou práci. Tuto akci umístěte na konec toku a nahlašte zprávu zpět do C TWO, kterou automatizace dokončila bez chyb.
Nastavení stavu spuštění toku na selhání

Označí relaci C TWO jako neúspěšnou a signalizují, že během provádění toku došlo k chybě. Tuto akci použijte v oborech zpracování chyb k hlášení chyb zpět na C TWO s podrobnostmi o tom, co se nepovedlo.
Nastavení časového limitu relace

Aktualizuje hodnotu časového limitu aktivní relace C TWO. Pomocí této akce můžete prodloužit nebo zkrátit povolenou dobu provádění pro spuštěnou relaci, když původní časový limit vyžaduje úpravu.
Odebrání značek z položky fronty

Odebere jednu nebo více značek z položky fronty. Tato akce slouží k aktualizaci kategorizace pracovních položek během zpracování.
Odemknout položku fronty

Odemkne dříve uzamčenou položku fronty a vrátí ji do dostupného stavu. Tuto akci použijte při přerušení zpracování a položka by měla být uvolněna pro ostatní pracovníky.
Odložit položku fronty

Odmakne položku fronty, aby se nezpracovala do zadaného data a času. Tuto akci použijte, pokud nyní nelze zpracovat položku, ale měla by se opakovat později.
Opakovat položku fronty

Zopakujte konkrétní položku fronty, nastavte její data zpět na původní hodnotu a vytvořte nový pokus.
Přidání protokolu do položky fronty

Přidá zprávu protokolu do položky fronty pro záznam auditu a sledovatelnost. Tato akce slouží k zaznamenání kroků zpracování, upozornění nebo chyb u konkrétní pracovní položky.
Přidání protokolu do relace

Zapíše položku protokolu do relace C TWO. Tato akce slouží ke sledování průběhu, zaznamenávání rozhodnutí nebo diagnostických informací protokolu během provádění toku. Protokoly jsou viditelné na platformě C TWO pro účely auditování a řešení potíží.
Přidání značek do položky fronty

Přidá jednu nebo více značek do položky fronty pro kategorizaci a filtrování. Značky pomáhají organizovat a vyhledávat pracovní položky napříč frontami.
Přiřadit formulář

Přiřadí formulář interakce robota konkrétnímu uživateli, který je zodpovědný za kontrolu a dokončení žádosti o interakci člověka ve smyčce.
Vytvoření stavu položky fronty

Vytvoří nový vlastní stav v rámci konkrétní fronty. Vlastní stavy umožňují definovat dílčí fáze pracovního postupu nad rámec výchozích stavů (Čekající, Dokončeno, Odkaz) a přizpůsobit frontu vašemu obchodnímu procesu.
Vytvořit formulář

Vytvoří nový formulář interakce robota, který umožňuje digitálnímu pracovníkovi požádat o lidskou pomoc. Formulář se zobrazí přiřazeným uživatelům na platformě C TWO, což umožňuje scénáře lidské smyčky, ve kterých je potřeba k řešení výjimek nebo složitých rozhodnutí odborných znalostí člověka.
Vytvořit položku fronty

Vytvoří novou pracovní položku v zadané univerzální frontě. Pomocí této akce můžete přidat položky pro zpracování digitálními pracovníky, včetně datových částí, značek a volitelných příloh souborů.
Zamknout položku fronty

Uzamkne položku fronty, aby ostatní pracovníci nemohli zpracovávat ji souběžně. Tuto akci použijte před zpracováním pracovní položky, abyste zajistili výhradní přístup.
Zrušit přiřazení formuláře

Odebere aktuální přiřazení uživatele z formuláře interakce robota a zpřístupní ho ostatním uživatelům, kteří si ho můžou vyžádat.
Získání formuláře podle ID

Načte konkrétní formulář interakce robota jeho jedinečným identifikátorem. Tato akce slouží k načtení podrobností, polí a aktuálního stavu formuláře lidské smyčky vytvořeného digitálním pracovníkem.
Získání formulářů

Načte seznam formulářů interakce robota s volitelným filtrováním. Pomocí této akce můžete dotazovat čekající požadavky na uživatele ve smyčce, zkontrolovat jejich stav nebo najít formuláře přiřazené konkrétním uživatelům.
Získání front

Načte univerzální fronty na základě kritérií filtru. Pomocí této akce můžete zobrazit seznam dostupných front, zkontrolovat jejich konfiguraci nebo vyhledat podrobnosti fronty. Tato operace také umožňuje dynamické rozevírací seznamy v jiných akcích.
Získání položek fronty

Načte položky fronty na základě zadaných kritérií filtru, jako jsou stav, značky, kalendářní data a názvy front. Pomocí této akce můžete vyhledávat a monitorovat pracovní položky napříč univerzálními frontami.
Získání přílohy položky fronty

Načte určitou přílohu souboru z položky fronty jako data zakódovaná v base64. Pomocí této akce můžete stahovat soubory připojené k pracovním položkám během vytváření nebo zpracování.
Úplný formulář

Označí formulář interakce robota jako dokončený a signalizují, že uživatel poskytl požadovaný vstup a digitální pracovník může pokračovat ve zpracování.

Měla by se relace zastavit.

ID operace:
IsStopRequested

Zkontroluje, jestli C TWO požádala o řádné (obnovitelné) zastavení pro danou relaci. Pomocí této akce uvnitř smyček můžete pravidelně kontrolovat, jestli by se relace měla ukončit včas, což toku umožní před zastavením vyčistit prostředky.

Parametry

Name Klíč Vyžadováno Typ Description
ID relace
 sessionId True string

ID relace C TWO ke kontrole žádosti o zastavení. Výchozí hodnota je ID relace z výstupu triggeru.

Návraty

Name Cesta Typ Description
isStopRequested
 isStopRequested boolean

isStopRequested

Nastavení dat položky fronty

ID operace:
SetItemData

Aktualizuje datový obsah položky fronty. Tato akce slouží k úpravě datové části pracovní položky během zpracování, například k ukládání průběžných výsledků.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId True string

ID položky fronty, která se má aktualizovat.
Data
 data object

Nová datová část položky fronty jako objekt JSON.
Vytvořeno
 created date-time

Časové razítko vytvoření pro tato data.

Nastavení stavu položky fronty

ID operace:
SetItemState

Změní stav položky fronty (např. čeká na dokončení nebo vlastní stav). Pomocí této akce můžete procházet položky prostřednictvím kanálu pracovního postupu.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId True string

ID položky fronty, která se má aktualizovat.
Kraj
 state string

Nový stav položky fronty.

Nastavení stavu provádění toku na dokončené

ID operace:
SetSessionCompleted

Označí relaci C TWO jako dokončenou a signalizují, že tok úspěšně dokončil svou práci. Tuto akci umístěte na konec toku a nahlašte zprávu zpět do C TWO, kterou automatizace dokončila bez chyb.

Parametry

Name Klíč Vyžadováno Typ Description
ID relace
 sessionId True string

ID relace C TWO, které se má označit jako úspěšně dokončené. Výchozí hodnota je ID relace z výstupu triggeru.

Návraty

response
object

Nastavení stavu spuštění toku na selhání

ID operace:
SetSessionFailed

Označí relaci C TWO jako neúspěšnou a signalizují, že během provádění toku došlo k chybě. Tuto akci použijte v oborech zpracování chyb k hlášení chyb zpět na C TWO s podrobnostmi o tom, co se nepovedlo.

Parametry

Name Klíč Vyžadováno Typ Description
ID relace
 sessionId True string

ID relace C TWO, které se označí jako neúspěšné. Výchozí hodnota je ID relace z výstupu triggeru.
details
 details True string

Popis chyby nebo výjimky, která způsobila selhání relace.

Nastavení časového limitu relace

ID operace:
SetTimeout

Aktualizuje hodnotu časového limitu aktivní relace C TWO. Pomocí této akce můžete prodloužit nebo zkrátit povolenou dobu provádění pro spuštěnou relaci, když původní časový limit vyžaduje úpravu.

Parametry

Name Klíč Vyžadováno Typ Description
ID relace
 sessionId True string

ID relace C TWO pro aktualizaci časového limitu Výchozí hodnota je ID relace z výstupu triggeru.
Přerušení zápasu
 timeout True integer

Nová hodnota časového limitu v sekundách, která se má použít pro relaci.

Návraty

response
string

Odebrání značek z položky fronty

ID operace:
RemoveItemTag

Odebere jednu nebo více značek z položky fronty. Tato akce slouží k aktualizaci kategorizace pracovních položek během zpracování.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId True string

ID položky fronty pro odebrání značek.
Tags
 tags string

Čárkami oddělený seznam značek, které chcete odebrat.

Odemknout položku fronty

ID operace:
UnlockItem

Odemkne dříve uzamčenou položku fronty a vrátí ji do dostupného stavu. Tuto akci použijte při přerušení zpracování a položka by měla být uvolněna pro ostatní pracovníky.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId True string

ID položky fronty, která se má odemknout.

Odložit položku fronty

ID operace:
DeferItem

Odmakne položku fronty, aby se nezpracovala do zadaného data a času. Tuto akci použijte, pokud nyní nelze zpracovat položku, ale měla by se opakovat později.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId True string

ID položky fronty, které se má odložit.
Odloženo do
 deferredUntil date-time

Datum a čas odložit do (formát ISO 8601).

Návraty

response
string

Opakovat položku fronty

ID operace:
RetryItem

Zopakujte konkrétní položku fronty, nastavte její data zpět na původní hodnotu a vytvořte nový pokus.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId True integer

Konkrétní ID položky fronty, které se má opakovat.
ID stavu
 stateId integer

Konkrétní ID stavu čekající položky fronty, které se má nastavit; má přednost před parametrem stavu.
Kraj
 state string

Konkrétní název stavu čekající položky fronty, který se má nastavit.
ID úkolu pracovního postupu
 workflowTaskId integer

Identifikátor WorkflowTask
ID aplikace
 appId integer

Identifikátor aplikace.

Přidání protokolu do položky fronty

ID operace:
AddItemLog

Přidá zprávu protokolu do položky fronty pro záznam auditu a sledovatelnost. Tato akce slouží k zaznamenání kroků zpracování, upozornění nebo chyb u konkrétní pracovní položky.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId True string

ID položky fronty pro přihlášení.
Úroveň záznamu
 level string

Úroveň závažnosti položky protokolu.
Zpráva
 message string

Obsah zprávy protokolu.

Přidání protokolu do relace

ID operace:
AddLogToSession

Zapíše položku protokolu do relace C TWO. Tato akce slouží ke sledování průběhu, zaznamenávání rozhodnutí nebo diagnostických informací protokolu během provádění toku. Protokoly jsou viditelné na platformě C TWO pro účely auditování a řešení potíží.

Parametry

Name Klíč Vyžadováno Typ Description
ID relace
 sessionId True string

ID relace C TWO, kde bude zaznamenána položka protokolu. Výchozí hodnota je ID relace z výstupu triggeru.
úroveň
 level True string

Úroveň závažnosti položky protokolu.
zpráva
 message True string

Obsah zprávy protokolu, který se má zaznamenat.

Přidání značek do položky fronty

ID operace:
AddItemTag

Přidá jednu nebo více značek do položky fronty pro kategorizaci a filtrování. Značky pomáhají organizovat a vyhledávat pracovní položky napříč frontami.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId True string

ID položky fronty pro přidání značek.
Tags
 tags string

Seznam značek oddělených čárkami, které chcete přidat.

Přiřadit formulář

ID operace:
AssignForm

Přiřadí formulář interakce robota konkrétnímu uživateli, který je zodpovědný za kontrolu a dokončení žádosti o interakci člověka ve smyčce.

Parametry

Name Klíč Vyžadováno Typ Description
ID formuláře
 formId True string

Id formuláře smyčky, které chcete přiřadit, je člověk ve smyčce.
userId
 userId integer

ID uživatele, kterému má být formulář přiřazen.

Vytvoření stavu položky fronty

ID operace:
CreateItemState

Vytvoří nový vlastní stav v rámci konkrétní fronty. Vlastní stavy umožňují definovat dílčí fáze pracovního postupu nad rámec výchozích stavů (Čekající, Dokončeno, Odkaz) a přizpůsobit frontu vašemu obchodnímu procesu.

Parametry

Name Klíč Vyžadováno Typ Description
název
 name string

Název nového stavu.
Výpočet doby odezvy
 responseTimeCalculationBasis True string

Určuje způsob výpočtu smluv SLA doby odezvy pro položky, které zadávají tento stav.
Typ stavu
 state True string

Typ stavu (Čekající, Dokončeno nebo Odkaz).
ID fronty
 queueId True integer

ID fronty, ve které bude tento stav vytvořen.
Description
 description string

Popis toho, co tento stav představuje ve vašem pracovním postupu
Čas uložený na položku
 timeSavedPerItem integer

Čas uložený pro každou položku v tomto stavu (sekundy) používaný pro generování sestav NÁVRATNOSTI
Hodnota vygenerovaná na položku
 valueGeneratedPerItem integer

Hodnota vygenerovaná pro každou položku v tomto stavu, která se používá pro generování sestav ROI.
Zahrnout do sestav
 includeInReports boolean

Zda se má tento stav zahrnout do analýz a sestav.

Vytvořit formulář

ID operace:
CreateForm

Vytvoří nový formulář interakce robota, který umožňuje digitálnímu pracovníkovi požádat o lidskou pomoc. Formulář se zobrazí přiřazeným uživatelům na platformě C TWO, což umožňuje scénáře lidské smyčky, ve kterých je potřeba k řešení výjimek nebo složitých rozhodnutí odborných znalostí člověka.

Parametry

Name Klíč Vyžadováno Typ Description
datová pole
 fields string

Řetězec formátovaný ve formátu JSON definující pole formuláře, která musí uživatel vyplnit.
nadpis
 title string

Název, který se zobrazí uživateli, když formulář otevře.
konečný termín
 deadline date-time

Konečný termín, kterým musí člověk odpovědět na formulář (formát ISO 8601).
Intro
 intro string

Úvodní text zobrazený uživateli vysvětlující, co je potřeba udělat.
itemId
 itemId integer

ID položky fronty přidružené k tomuto formuláři, které propojuje lidskou interakci s konkrétní pracovní položkou.
workflowTaskId
 workflowTaskId integer

Úloha C TWO, která vytvořila tento formulář.

Návraty

Name Cesta Typ Description
id
 id integer

id

Vytvořit položku fronty

ID operace:
CreateItem

Vytvoří novou pracovní položku v zadané univerzální frontě. Pomocí této akce můžete přidat položky pro zpracování digitálními pracovníky, včetně datových částí, značek a volitelných příloh souborů.

Parametry

Name Klíč Vyžadováno Typ Description
Klíč položky
 itemKey True string

Jedinečný obchodní klíč pro identifikaci této položky fronty (např. číslo faktury, ID případu).
Stav položky fronty
 queueItemState True string

Počáteční stav položky fronty (např. Čeká na vyřízení).
Referenční dokumentace ke frontě
 reference True string

Odkaz na frontu, kde se položka vytvoří.
Odloženo do
 deferredUntil date-time

Odložit zpracování do tohoto data a času (formát ISO 8601).
Data položky
 itemData object

Datová část položky fronty ve formátu JSON.
Tags
 tags string

Značky pro položku fronty (oddělené čárkami).
fileName
 fileName string

Název souboru přílohy.
fileData
 fileData string

Data souboru s kódováním Base64.
ID relace
 sessionId string

ID relace přidružené k této položce.
Zařízení
 device string

Zařízení, které tuto položku vytvořilo.
User
 user string

Uživatel, který tuto položku vytvořil.
Zprostředkovatel služby Automation
 automationProvider string

Zprostředkovatel automatizace pro tuto položku.

Návraty

Name Cesta Typ Description
id
 id integer

id
itemKey
 itemKey string

itemKey
pokusy
 attempts integer

pokusy
queueId
 queueId integer

queueId
id
 state.id integer

id
název
 state.name string

název
stav
 state.state string

stav
tags
 tags array of string

tags
vytvořeno
 created string

vytvořeno
createdByVendorSessionId
 createdByVendorSessionId integer

createdByVendorSessionId
Uzavřených
 concluded string

Uzavřených
Odložené
 deferred string

odloženo
test
 test boolean

test
zamčený
 locked boolean

zamčený

Zamknout položku fronty

ID operace:
LockItem

Uzamkne položku fronty, aby ostatní pracovníci nemohli zpracovávat ji souběžně. Tuto akci použijte před zpracováním pracovní položky, abyste zajistili výhradní přístup.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId string

ID položky fronty, která se má uzamknout. Pokud tuto možnost vynecháte, další dostupná položka odpovídající filtru se uzamkne.
Název fronty
 reference string

Odkaz na frontu pro uzamčení položky.
ID stavu
 stateId string

ID stavu pro filtrování položek.
Název státu
 stateName string

Název stavu pro filtrování položek podle.
ID relace
 sessionId string

ID relace pro tento zámek.

Návraty

Name Cesta Typ Description
id
 id integer

Jedinečný identifikátor uzamčené položky.
itemKey
 itemKey string

Jedinečný klíč uzamčené položky.
pokusy
 attempts integer

Počet pokusů o zpracování.
queueId
 queueId integer

Identifikátor nadřazené fronty.
id
 state.id integer

Identifikátor stavu.
název
 state.name string

Název stavu.
stav
 state.state string

Hodnota stavu.
tags
 tags array of string

Značky přidružené k položce fronty.
vytvořeno
 created string

Časové razítko vytvoření.
createdByVendorSessionId
 createdByVendorSessionId integer

ID relace, které tuto položku vytvořilo.
Uzavřených
 concluded string

Časové razítko závěru.
odloženo
 deferred string

Odložené časové razítko.
test
 test boolean

Určuje, jestli se jedná o testovací položku.
zamčený
 locked boolean

Určuje, jestli je položka uzamčená.

Zrušit přiřazení formuláře

ID operace:
UnassignForm

Odebere aktuální přiřazení uživatele z formuláře interakce robota a zpřístupní ho ostatním uživatelům, kteří si ho můžou vyžádat.

Parametry

Name Klíč Vyžadováno Typ Description
ID formuláře
 formId True string

Id formuláře smyčky člověka zruší přiřazení.

Získání formuláře podle ID

ID operace:
GetFormById

Načte konkrétní formulář interakce robota jeho jedinečným identifikátorem. Tato akce slouží k načtení podrobností, polí a aktuálního stavu formuláře lidské smyčky vytvořeného digitálním pracovníkem.

Parametry

Name Klíč Vyžadováno Typ Description
ID formuláře
 formId True string

Id formuláře smyčky pro získání podrobností získáte člověkem ve smyčce.

Návraty

Name Cesta Typ Description
id
 id integer

id
divisionId
 divisionId

divisionId
sessionId
 sessionId

sessionId
queueItemId
 queueItemId

queueItemId
claimedByUserId
 claimedByUserId

claimedByUserId
claimedOn
 claimedOn string

claimedOn
createdByWorkflowTaskId
 createdByWorkflowTaskId

createdByWorkflowTaskId
createdByUserId
 createdByUserId

createdByUserId
createdOn
 createdOn string

createdOn
konečný termín
 deadline string

konečný termín
Dokončena
 completed string

Dokončena
nadpis
 title string

nadpis
Intro
 intro string

Intro
datová pole
 fields string

datová pole

Získání formulářů

ID operace:
GetForms

Načte seznam formulářů interakce robota s volitelným filtrováním. Pomocí této akce můžete dotazovat čekající požadavky na uživatele ve smyčce, zkontrolovat jejich stav nebo najít formuláře přiřazené konkrétním uživatelům.

Parametry

Name Klíč Vyžadováno Typ Description
Přeskočit
 skip integer

Počet záznamů, které se mají přeskočit pro stránkování
Vezměte
 take integer

Počet vrácených záznamů
Konečný termín před
 deadlineBefore date-time

Filtrujte formuláře s termínem před tímto datem a časem (ISO 8601).
Konečný termín za
 deadlineAfter date-time

Filtrujte formuláře s termínem po tomto datu a čase (ISO 8601).
Zahrnout dokončené
 includeCompleted boolean

Zda se mají do výsledků zahrnout vyplněné formuláře.
Nárokované podle ID uživatele
 claimedByUserId integer

Filtrujte formuláře deklarované podle konkrétního ID uživatele.
Vytvořeno podle ID úkolu pracovního postupu
 createdByWorkflowTaskId integer

Filtrování formulářů vytvořených podle konkrétního ID úkolu pracovního postupu

Návraty

Name Cesta Typ Description
array of object
id
 id integer

id
divisionId
 divisionId

divisionId
sessionId
 sessionId

sessionId
queueItemId
 queueItemId

queueItemId
claimedByUserId
 claimedByUserId

claimedByUserId
claimedOn
 claimedOn string

claimedOn
createdByWorkflowTaskId
 createdByWorkflowTaskId

createdByWorkflowTaskId
createdByUserId
 createdByUserId

createdByUserId
createdOn
 createdOn string

createdOn
konečný termín
 deadline string

konečný termín
Dokončena
 completed string

Dokončena
undeferred
 undeferred boolean

undeferred

Získání front

ID operace:
GetQueues

Načte univerzální fronty na základě kritérií filtru. Pomocí této akce můžete zobrazit seznam dostupných front, zkontrolovat jejich konfiguraci nebo vyhledat podrobnosti fronty. Tato operace také umožňuje dynamické rozevírací seznamy v jiných akcích.

Parametry

Name Klíč Vyžadováno Typ Description
ID fronty
 id string

Filtrovat podle ID fronty
Referenční dokumentace ke frontě
 reference string

Filtrovat podle odkazu na frontu
Název fronty
 name string

Filtrovat podle názvu fronty
Název státu
 stateName string

Filtrovat podle názvu státu.
Deleted
 deleted boolean

Filtrovat podle odstraněného stavu
Přeskočit
 skip integer

Počet záznamů, které se mají přeskočit pro stránkování
Vezměte
 take integer

Počet vrácených záznamů

Návraty

Name Cesta Typ Description
array of object
id
 id integer

Jedinečný identifikátor fronty.
smazaný
 deleted boolean

Zda je fronta odstraněna.
název
 name string

Název fronty.
description
 description string

Popis fronty.
viditelný
 visible boolean

Určuje, jestli je fronta viditelná.
includeInReports
 includeInReports boolean

Zda se má zahrnout do sestav.
vytvořeno
 created string

Časové razítko vytvoření.
aktualizovaný
 updated string

Časové razítko poslední aktualizace.
deletedTime
 deletedTime string

Časové razítko odstranění.
divisionId
 divisionId integer

Identifikátor dělení.
typ
 type integer

Typ fronty.
odkazovat
 reference string

Odkaz na frontu.
státy
 states array of object

Stavy dostupné v této frontě.
id
 states.id integer

Identifikátor stavu.
název
 states.name string

Název státu.
description
 states.description string

Popis stavu.
tagfilter
 states.tagfilter string

Filtr značek pro tento stav.
stav
 states.state integer

Typ stavu.
timeSavedPerItem
 states.timeSavedPerItem integer

Čas uložený pro každou položku
includeInReports
 states.includeInReports boolean

Zda se má zahrnout do sestav.
responseTimeCalculationBasis
 states.responseTimeCalculationBasis integer

Výpočet doby odezvy

Získání položek fronty

ID operace:
GetItems

Načte položky fronty na základě zadaných kritérií filtru, jako jsou stav, značky, kalendářní data a názvy front. Pomocí této akce můžete vyhledávat a monitorovat pracovní položky napříč univerzálními frontami.

Parametry

Name Klíč Vyžadováno Typ Description
Klíč položky
 itemKey string

Filtrovat podle klíče položky
Attempts
 attempts integer

Filtrovat podle počtu pokusů
Odloženo před
 deferredBefore date-time

Filtrovat odložené položky před tímto datem.
Odloženo po
 deferredAfter date-time

Filtrovat položky odložené po tomto datu.
Vytvořeno před
 createdBefore date-time

Filtrovat položky vytvořené před tímto datem
Vytvořeno po
 createdAfter date-time

Filtrovat položky vytvořené po tomto datu
Uzavřeno před
 concludedBefore date-time

Filtrování položek uzavřených před tímto datem
Uzavřeno po
 concludedAfter date-time

Filtrování položek uzavřených po tomto datu
Stav zadaný před
 stateEnteredTimeBefore date-time

Vyfiltrujte položky, které před tímto časem zadaly stav.
Stát zadaný za
 stateEnteredTimeAfter date-time

Vyfiltrujte položky, které po této době zadaly stav.
States
 states string

Filtrovat podle stavu položky fronty
ID stavu položky fronty
 queueItemStateIds integer

Filtrovat podle ID stavu položky fronty
Názvy stavů položek fronty
 queueItemStateNames string

Filtrovat podle názvů stavů položek fronty
Tags
 tags string

Filtrovat podle značek (oddělených čárkami).
ID fronty
 queueIds integer

Filtrovat podle ID fronty
Názvy front
 queueNames True string

Filtrovat podle názvů front (povinné)
References
 references string

Filtrování podle odkazů na frontu
Zahrnout data položky
 includeItemData boolean

Zda zahrnout data položky do odpovědi.
Přeskočit
 skip integer

Počet záznamů, které se mají přeskočit pro stránkování
Vezměte
 take integer

Počet vrácených záznamů

Návraty

Name Cesta Typ Description
array of object
id
 id integer

Jedinečný identifikátor položky fronty.
itemKey
 itemKey string

Jedinečný klíč položky fronty.
pokusy
 attempts integer

Počet pokusů o zpracování.
queueId
 queueId integer

Identifikátor nadřazené fronty.
id
 state.id integer

Identifikátor stavu.
název
 state.name string

Název stavu.
stav
 state.state string

Hodnota stavu.
tags
 tags array of string

Značky přidružené k položce fronty.
vytvořeno
 created string

Časové razítko vytvoření.
createdByVendorSessionId
 createdByVendorSessionId integer

ID relace, které tuto položku vytvořilo.
uzavřeno
 concluded string

Časové razítko závěru.
Odložené
 deferred string

Odložené časové razítko.
test
 test boolean

Určuje, jestli se jedná o testovací položku.
zamčený
 locked boolean

Určuje, jestli je položka uzamčená.

Získání přílohy položky fronty

ID operace:
GetItemAttachment

Načte určitou přílohu souboru z položky fronty jako data zakódovaná v base64. Pomocí této akce můžete stahovat soubory připojené k pracovním položkám během vytváření nebo zpracování.

Parametry

Name Klíč Vyžadováno Typ Description
ID položky fronty
 queueItemId True string

ID položky fronty obsahující přílohu.
ID přílohy
 attachmentId True string

ID přílohy, která se má načíst.
Jméno souboru
 filename string

Název souboru přílohy.

Návraty

response
string

Úplný formulář

ID operace:
CompleteForm

Označí formulář interakce robota jako dokončený a signalizují, že uživatel poskytl požadovaný vstup a digitální pracovník může pokračovat ve zpracování.

Parametry

Name Klíč Vyžadováno Typ Description
ID formuláře
 formId True string

Člověk v ID formuláře smyčky, který se označí jako dokončený.
completedAt
 completedAt date-time

Časové razítko, kdy byl formulář dokončen (formát ISO 8601).

Aktivační události

Spuštění toku z žádosti o relaci bez časového limitu

Dotazuje se na nové relace C TWO a aktivuje tok při vytvoření relace pro vybranou úlohu. Tento trigger použijte, pokud automatizace nevyžaduje omezení časového limitu. Tok přijímá podrobnosti relace, včetně vstupních hodnot předaných z C TWO.
Spuštění toku z žádosti o relaci s vypršením časového limitu

Dotazuje se na nové relace C TWO a aktivuje tok s omezením časového limitu. Tento trigger použijte, když se automatizace musí dokončit v určitém časovém intervalu. Pokud relace překročí časový limit, jazyk C TWO ho zpracuje podle zásad časového limitu.

Spuštění toku z žádosti o relaci bez časového limitu

ID operace:
StartFlowWithoutTimeout

Dotazuje se na nové relace C TWO a aktivuje tok při vytvoření relace pro vybranou úlohu. Tento trigger použijte, pokud automatizace nevyžaduje omezení časového limitu. Tok přijímá podrobnosti relace, včetně vstupních hodnot předaných z C TWO.

Parametry

Name Klíč Vyžadováno Typ Description
ID úkolu
 taskId True integer

Vyberte úlohu C TWO, která tento tok aktivuje. Při vytvoření nové relace pro tuto úlohu v jazyce C TWO se tok spustí automaticky bez vynucení časového limitu.

Návraty

Name Cesta Typ Description
sessions
 sessions array of object

Sada relací aktivovaných C TWO bez časového limitu
sessionId
 sessions.sessionId integer

sessionId
workflowTaskId
 sessions.workflowTaskId integer

workflowTaskId
Název pracovního postupu
 sessions.workflowName string

Název pracovního postupu
název úkolu
 sessions.taskName string

název úkolu
vytvořeno
 sessions.created string

vytvořeno
processInputValues
 sessions.processInputValues object

processInputValues

Spuštění toku z žádosti o relaci s vypršením časového limitu

ID operace:
StartFlowWithTimeout

Dotazuje se na nové relace C TWO a aktivuje tok s omezením časového limitu. Tento trigger použijte, když se automatizace musí dokončit v určitém časovém intervalu. Pokud relace překročí časový limit, jazyk C TWO ho zpracuje podle zásad časového limitu.

Parametry

Name Klíč Vyžadováno Typ Description
ID úkolu
 taskId True integer

Vyberte úlohu C TWO, která tento tok aktivuje. Při vytvoření relace pro tuto úlohu začíná tok zadaným vypršením časového limitu.
Časový limit sekund
 timeout True integer

Maximální doba v sekundách, po kterou může relace běžet, než C TWO označí, že vypršel časový limit.

Návraty

Name Cesta Typ Description
sessions
 sessions array of object

Sada relací aktivovaných C TWO s časovým limitem
sessionId
 sessions.sessionId integer

sessionId
workflowTaskId
 sessions.workflowTaskId integer

workflowTaskId
Název pracovního postupu
 sessions.workflowName string

Název pracovního postupu
název úkolu
 sessions.taskName string

název úkolu
vytvořeno
 sessions.created string

vytvořeno
processInputValues
 sessions.processInputValues object

processInputValues

Definice

řetězec

Toto je základní datový typ String.

objekt

Toto je typ "object".