K2 munkafolyamat (előzetes verzió)

A K2 Workflow API szolgáltatással távolról dolgozhat munkafolyamatokkal és feladatokkal.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	Standard	Az összes Power Automate-régió, kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket:      - Azure Government-régiók      - Azure China-régiók      - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások	Standard	Az összes Power Apps-régió , kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Power Automate	Standard	Az összes Power Automate-régió, kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)

Érintkezés
URL	https://portal.k2.com/ticket/default

Összekötő metaadatai
Kiadó	K2
Webhely	https://www.k2.com
Adatvédelmi irányelvek	https://www.k2.com/legal/privacy-policy

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:

Alapértelmezett	A kapcsolat létrehozásának paraméterei.	Minden régió	Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név	Típus	Description	Kötelező
K2 URL-címe	karakterlánc	A K2 URL-címe (példa: https://[K2ID].onk2.com).	True
Felhasználónév	securestring	Az api felhasználóneve	True
Jelszó	securestring	Az api jelszava	True

Szabályozási korlátok

Name	Hívások	Megújítási időszak
API-hívások kapcsolatonként	100	60 másodperc

Műveletek

Alvó tevékenység	Egy tevékenységet egy időtartamig, akár másodpercekig, akár dátumig alvó állapotban tart.
Feladat lekérése	A feladat sorozatszám alapján lesz lekérve.
Feladat átirányítása	Feladatot küld egy másik személynek.
Feladatműveletek lekérése	Lekéri a feladathoz tartozó műveletek listáját.
Feladatok lekérése	Szerezze be a csatlakoztatott felhasználó számára elérhető feladatok listáját.
Kiadási feladat	Feladat kiadása.
Kiszolgálói esemény befejezése	Befejezési válasz küldése a válaszra váró aszinkron kiszolgálói feladatnak
Kiszolgálói esemény lekérése	A kiszolgáló eseményét sorozatszám alapján kapja meg.
Munkafolyamat indítása	Létrehoz és elindít egy új munkafolyamat-példányt.
Munkafolyamat lekérése	Beolvas egy munkafolyamat-definíciót azonosító alapján.
Munkafolyamatok lekérése	Az elérhető munkafolyamatok listájának lekérése.
Művelettevékenység	Munkafolyamat-műveletet hajt végre.
Tevékenység hozzárendelése	Feladat hozzárendelése az aktuális felhasználóhoz.
Ébresztési feladat	Felébreszt egy alvó feladatot.

Alvó tevékenység

Műveletazonosító:

Tasks_PostSleepAction

Egy tevékenységet egy időtartamig, akár másodpercekig, akár dátumig alvó állapotban tart.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sorozatszám	serialNumber	True	string	A tevékenység sorozatszáma. Például: 1234_5678
Alvó állapot	SleepFor		integer	A tevékenységek alvó másodperceinek száma.
Alvó állapotig	SleepUntil		date-time	A tevékenység felébresztésének dátuma és ideje. Formátum: yyyy-MM-ddTHH:mm:ss:fffZ UTC

Feladat lekérése

Műveletazonosító:

Tasks_GetTask

A feladat sorozatszám alapján lesz lekérve.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sorozatszám	serialNumber	True	string	A tevékenység sorozatszáma. Például: 1234_5678

Válaszok

Törzs

Task

Feladat átirányítása

Műveletazonosító:

Tasks_PostRedirectAction

Feladatot küld egy másik személynek.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sorozatszám	serialNumber	True	string	A tevékenység sorozatszáma. Például: 1234_5678
Átirányítási információk	RedirectTo	True	string	Az a személy, akinek a feladatot átirányítja a rendszer.

Feladatműveletek lekérése

Műveletazonosító:

Tasks_GetTaskActions

Lekéri a feladathoz tartozó műveletek listáját.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sorozatszám	serialNumber	True	string	A tevékenység sorozatszáma. Például: 1234_5678

Válaszok

Törzs

TaskActionsResponse

Feladatok lekérése

Műveletazonosító:

Tasks_Get

Szerezze be a csatlakoztatott felhasználó számára elérhető feladatok listáját.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
All, Allocated, Sleeping, SharedFrom, SharedTo	state		string	A csatlakoztatott felhasználó feladatainak listáját adja vissza.

Válaszok

Törzs

TasksResponse

Kiadási feladat

Műveletazonosító:

Tasks_PostReleaseAction

Feladat kiadása.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sorozatszám	serialNumber	True	string	A tevékenység sorozatszáma. Például: 1234_5678

Kiszolgálói esemény befejezése

Műveletazonosító:

ServerEvent_Finish

Befejezési válasz küldése a válaszra váró aszinkron kiszolgálói feladatnak

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Kiszolgálói esemény sorozatszáma	serialNumber	True	string	A kiszolgálóesemény sorozatszáma. Például: 1234_5678
XML-mező neve	name		string	Egy XML-mező neve.
XML-mező értéke	value		string	Az XML-mező értéke.
Elemhivatkozások	ItemReferences		object	A munkafolyamat-példány Elemhivatkozás mezői.
Adatmezők	DataFields		object	A munkafolyamat-példány adatmezői.

Kiszolgálói esemény lekérése

Műveletazonosító:

ServerEvent_Get

A kiszolgáló eseményét sorozatszám alapján kapja meg.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Kiszolgálói esemény sorozatszáma	serialNumber	True	string	A kiszolgálóesemény sorozatszáma. Például: 1234_5678.

Válaszok

Törzs

ServerEventDataResponse

Munkafolyamat indítása

Műveletazonosító:

StartWorkflow

Létrehoz és elindít egy új munkafolyamat-példányt.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Munkafolyamat-azonosító	id	True	integer	Adjon meg egy munkafolyamat-azonosítót a példány elindításához.
Munkafolyamat-példány részletei	instance	True	dynamic	Munkafolyamat-példány objektumának elküldése a munkafolyamat elindításához.

Válaszok

response

integer

Munkafolyamat lekérése

Műveletazonosító:

GetWorkflow

Beolvas egy munkafolyamat-definíciót azonosító alapján.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Munkafolyamat-azonosító	id	True	integer	A munkafolyamat azonosítója.

Válaszok

Törzs

WorkflowDataResponse

Munkafolyamatok lekérése

Műveletazonosító:

GetWorkflows

Az elérhető munkafolyamatok listájának lekérése.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Munkafolyamat típusa	type		string	A munkafolyamat típusa. Indítható vagy saját tulajdonú.

Válaszok

Törzs

WorkflowLabelsResponse[WorkflowLabel]

Művelettevékenység

Műveletazonosító:

Tasks_TaskCustomAction

Munkafolyamat-műveletet hajt végre.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sorozatszám	serialNumber	True	string	A tevékenység sorozatszáma. Például: 1234_5678
Egyéni művelet	customAction	True	string	A munkafolyamat által meghatározott tevékenységművelet.
XML-mező neve	name		string	Egy XML-mező neve.
XML-mező értéke	value		string	Az XML-mező értéke.
Elemhivatkozások	ItemReferences		object	A munkafolyamat-példány Elemhivatkozás mezői.
Adatmezők	DataFields		object	A munkafolyamat-példány adatmezői.

Tevékenység hozzárendelése

Műveletazonosító:

Tasks_PostAssignAction

Feladat hozzárendelése az aktuális felhasználóhoz.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sorozatszám	serialNumber	True	string	A tevékenység sorozatszáma. Például: 1234_5678

Válaszok

response

object

Ébresztési feladat

Műveletazonosító:

Tasks_PostWakeAction

Felébreszt egy alvó feladatot.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sorozatszám	serialNumber	True	string	A tevékenység sorozatszáma. Például: 1234_5678

Válaszok

response

object

Definíciók

ServerEventDataResponse

Name	Elérési út	Típus	Description
Kiszolgálói esemény sorozatszáma	serialNumber	string	A kiszolgálóesemény sorozatszáma. Például: 1234_5678
Kiszolgálói esemény munkafolyamat-azonosítója	workflowID	integer	A kiszolgálóeseményhez társított munkafolyamat azonosítója.
Kiszolgálói esemény munkafolyamatának neve	workflowName	string	A kiszolgálói eseményhez társított munkafolyamat neve.
Kiszolgálói esemény munkafolyamatának megjelenítendő neve	workflowDisplayName	string	A kiszolgálói eseményhez társított munkafolyamat megjelenítendő neve.
Kiszolgálói esemény munkafolyamat-kategóriája	workflowCategory	string	A kiszolgálói eseményhez társított munkafolyamat kategóriája.
Kiszolgálói esemény munkafolyamat-példányának azonosítója	workflowInstanceID	integer	A kiszolgálóeseményhez társított munkafolyamat példányazonosítója.
Kiszolgálói esemény munkafolyamatának fóliója	workflowInstanceFolio	string	A kiszolgálóeseményhez társított munkafolyamat-példány fóliója.
Kiszolgálói eseménytevékenység-példány azonosítója	activityInstanceID	integer	A kiszolgálóesemény tevékenységpéldány-azonosítója.
Kiszolgálói eseménytevékenység célazonosítója	activityInstanceDestinationID	integer	A kiszolgálóesemény tevékenységpéldány-célazonosítója.
Kiszolgáló eseménytevékenységének neve	activityName	string	A kiszolgálóesemény tevékenységneve.
Kiszolgálói esemény eseményneve	eventName	string	A kiszolgálóesemény eseményneve.
Kiszolgálói esemény eseményének leírása	eventDescription	string	A kiszolgálóesemény eseményleírása.
kezdeményező	originator	User
eventInstance	eventInstance	EventInstanceWrapper
Kiszolgálói eseménytevékenység adatmezői	dataFields	object	A tevékenység adatmezői.
Kiszolgálói eseménytevékenység XML-mezői	xmlFields	array of UserDefinedXmlField	A tevékenység XML-mezői.
Kiszolgálói eseményelem-hivatkozások	itemReferences	object	A munkafolyamat-példány elemhivatkozásai.
Kiszolgálói esemény munkafolyamat adatmezőinek sztringje	workflowInstanceDataFieldsString	string	A munkafolyamat-példány adatmezőinek sztring-ábrázolása.
Kiszolgálói eseményelem hivatkozási sztringje	itemReferencesString	string	A munkafolyamat-példány elemhivatkozásait képviselő sztring.
viewFlowURL	viewFlowURL	string

EventInstance

Name	Elérési út	Típus	Description
Eseménypéldány kezdő dátuma	StartDate	date-time	Az eseménypéldány indításának dátuma és időpontja.
Eseménypéldány várható időtartama	ExpectedDuration	integer	Az eseménypéldány várható időtartama.
Eseménypéldány prioritása	Priority	integer	Az eseménypéldány prioritása.
Eseménypéldány metaadatai	MetaData	string	Az eseménypéldány metaadatai.
Eseménypéldány leírása	Description	string	Az eseménypéldány leírása.
Eseménypéldány neve	Name	string	Az eseménypéldány neve.
Eseménypéldány azonosítója	ID	integer	Az eseménypéldány azonosítója.

UserDefinedXmlField

Name	Elérési út	Típus	Description
XML-mező neve	name	string	Egy XML-mező neve.
XML-mező értéke	value	string	Az XML-mező értéke.

TasksResponse

Name	Elérési út	Típus	Description
Tevékenység száma	itemCount	integer	A visszaadott tevékenységek száma.
Tasks	tasks	array of TaskLite	Egy vagy több tevékenység.

TaskLite

Name	Elérési út	Típus	Description
Tevékenység sorozatszáma	serialNumber	string	A tevékenység sorozatszáma. Például: 1234_5678
Tevékenység állapota	status	string	A tevékenység állapota. Például: Megnyitás, Befejezett, Alvó állapot, Lefoglalt, Elérhető
Tevékenység kezdési dátuma	taskStartDate	date-time	A tevékenység kezdő dátuma.
Tevékenység alvó állapotának időtartama	sleepUntil	date-time	A tevékenység felébresztésének dátuma és időpontja.
Tevékenység prioritása	priority	integer	A tevékenység prioritása.
Feladatűrlap URL-címe	formURL	string	A feladat űrlap URL-címe.
Tevékenységnézet folyamatÁNAK URL-címe	viewFlowURL	string	A feladat folyamatának megtekintése URL-címe.
Tevékenység munkafolyamat-azonosítója	workflowID	integer	A tevékenységhez társított munkafolyamat azonosítója.
Feladat munkafolyamatának neve	workflowName	string	A tevékenységhez társított munkafolyamat neve.
Feladat munkafolyamatának megjelenítendő neve	workflowDisplayName	string	A feladathoz társított munkafolyamat megjelenítendő neve.
Tevékenység munkafolyamat-kategóriája	workflowCategory	string	A tevékenységhez társított munkafolyamat kategóriája.
Feladat munkafolyamat-példányának azonosítója	workflowInstanceID	integer	A feladathoz társított munkafolyamat példányazonosítója.
Tevékenység munkafolyamatának fóliója	workflowInstanceFolio	string	A feladathoz társított munkafolyamat-példány fóliója.
Feladatpéldány azonosítója	activityInstanceID	integer	A tevékenység tevékenységpéldány-azonosítója.
Tevékenységtevékenység célazonosítója	activityInstanceDestinationID	integer	A tevékenység tevékenységpéldányának célazonosítója.
Tevékenység tevékenységének neve	activityName	string	A tevékenység tevékenységneve.
Tevékenységesemény neve	eventName	string	A feladat eseményneve.
Tevékenységesemény leírása	eventDescription	string	A feladat eseményleírása.
kezdeményező	originator	User
Műveletek	actions	TaskActionsResponse
Feladatutasítások	instruction	string	A tevékenységhez társított utasítások.

User

Name	Elérési út	Típus	Description
Felhasználónév	username	string	A személy felhasználóneve.
Felhasználói teljes tartománynév	fqn	string	A személy teljes neve. Például: bob@denallix.com, K2:Denallix\Bob
Felhasználói e-mail	email	string	A személy e-mail-címe.
User Manager	manager	string	A személy vezetője.
Felhasználó megjelenítendő neve	displayName	string	A személy megjelenítendő neve.

TaskActionsResponse

Name	Elérési út	Típus	Description
Nem módosítható műveletek	nonBatchableActions	array of string	Azon műveletek listája, amelyeket a tevékenység hozzárendelése nélkül nem lehet végrehajtani.
Kötegelhető műveletek	batchableActions	array of string	A tevékenység hozzárendelése nélkül végrehajtható műveletek listája.
Rendszerműveletek	systemActions	array of string	A rendszerműveletek listája.

Feladatok

Name	Elérési út	Típus	Description
Tevékenység sorozatszáma	serialNumber	string	A tevékenység sorozatszáma. Például: 1234_5678
Tevékenység állapota	status	string	A tevékenység állapota. Például: Megnyitás, Befejezett, Alvó állapot, Lefoglalt, Elérhető
Tevékenység kezdési dátuma	taskStartDate	date-time	A tevékenység kezdő dátuma.
Tevékenység alvó állapotának időtartama	sleepUntil	date-time	A tevékenység felébresztésének dátuma és időpontja.
Tevékenység prioritása	priority	integer	A tevékenység prioritása.
Feladatűrlap URL-címe	formURL	string	A feladat űrlap URL-címe.
Tevékenységnézet folyamatÁNAK URL-címe	viewFlowURL	string	A feladat folyamatának megtekintése URL-címe.
Tevékenység munkafolyamat-azonosítója	workflowID	integer	A tevékenységhez társított munkafolyamat azonosítója.
Feladat munkafolyamatának neve	workflowName	string	A tevékenységhez társított munkafolyamat neve.
Feladat munkafolyamatának megjelenítendő neve	workflowDisplayName	string	A feladathoz társított munkafolyamat megjelenítendő neve.
Tevékenység munkafolyamat-kategóriája	workflowCategory	string	A tevékenységhez társított munkafolyamat kategóriája.
Feladat munkafolyamat-példányának azonosítója	workflowInstanceID	integer	A feladathoz társított munkafolyamat példányazonosítója.
Tevékenység munkafolyamatának fóliója	workflowInstanceFolio	string	A feladathoz társított munkafolyamat-példány fóliója.
Feladatpéldány azonosítója	activityInstanceID	integer	A tevékenység tevékenységpéldány-azonosítója.
Tevékenység célazonosítója	activityInstanceDestinationID	integer	A tevékenység tevékenységpéldányának célazonosítója.
Tevékenység tevékenységének neve	activityName	string	A tevékenység tevékenységneve.
Tevékenységesemény neve	eventName	string	A feladat eseményneve.
Tevékenységesemény leírása	eventDescription	string	A feladat eseményleírása.
kezdeményező	originator	User
Műveletek	actions	TaskActionsResponse
Tevékenység-munkafolyamat adatmezői	workflowInstanceDataFields	object	A munkafolyamat-példány adatmezői.
Tevékenységtevékenység adatmezői	activityDataFields	object	A tevékenység adatmezői.
Tevékenység-munkafolyamat XML-mezői	workflowInstanceXmlFields	array of UserDefinedXmlField	A munkafolyamat-példány XML-mezői.
Tevékenységelem-hivatkozások	itemReferences	object	A munkafolyamat-példány elemhivatkozásai.
tanítás	instruction	string
Tevékenység-munkafolyamat adatmezőinek sztringje	workflowInstanceDataFieldsString	string	A munkafolyamat-példány adatmezőinek sztring-ábrázolása.
Tevékenységelem hivatkozási sztringje	itemReferencesString	string	A munkafolyamat-példány elemhivatkozásait képviselő sztring.

WorkflowLabelsResponse[WorkflowLabel]

Name	Elérési út	Típus	Description
Elemszám	itemCount	integer	A munkafolyamatok száma.
Munkafolyamatok	workflows	array of WorkflowLabel	Munkafolyamatok listája.

WorkflowLabel

Name	Elérési út	Típus	Description
Munkafolyamat-azonosító	id	integer	A munkafolyamat azonosítója.
Munkafolyamat alapértelmezett verziója	defaultVersionId	integer	A munkafolyamat alapértelmezett verziója.
Munkafolyamat neve	name	string	A munkafolyamat neve.
Munkafolyamat-mappa	folder	string	A munkafolyamat mappája.
Munkafolyamat-rendszer neve	systemName	string	A munkafolyamat-rendszer neve.

WorkflowDataResponse

Name	Elérési út	Típus	Description
workflowInfo	workflowInfo	WorkflowDefinition
Munkafolyamat-séma	workflowSchema	string	A munkafolyamat sémája.

WorkflowDefinition

Name	Elérési út	Típus	Description
Munkafolyamat neve	name	string	A munkafolyamat neve.
Munkafolyamat leírása	description	string	A munkafolyamat leírása.
Munkafolyamat-mappa	folder	string	A munkafolyamat mappája (kategóriája).
Munkafolyamat-rendszer neve	systemName	string	A munkafolyamat rendszerneve.
Munkafolyamat várható időtartama	expectedDuration	integer	A munkafolyamat várható időtartama.

EventInstanceWrapper

Name	Elérési út	Típus	Description
EventInstance	EventInstance	EventInstance
Eseménypéldány leírása	Description	string	Az eseménypéldány leírása.
Eseménypéldány várható időtartama	ExpectedDuration	integer	Az eseménypéldány várható időtartama.
Eseménypéldány azonosítója	ID	integer	Az eseménypéldány azonosítója.
Eseménypéldány metaadatai	MetaData	string	Az eseménypéldány metaadatai.
Eseménypéldány neve	Name	string	Az eseménypéldány neve.
Eseménypéldány prioritása	Priority	integer	Az eseménypéldány prioritása.
Eseménypéldány kezdő dátuma	StartDate	date-time	Az eseménypéldány indításának dátuma és időpontja.

egész szám

Ez az "egész szám" alapszintű adattípus.

objektum

Ez az "objektum" típus.