다음을 통해 공유

K2 워크플로(미리 보기)

K2 워크플로 API 서비스를 사용하여 워크플로 및 작업을 원격으로 작업합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps 스탠다드 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
URL https://portal.k2.com/ticket/default
커넥터 메타데이터
게시자 K2
웹 사이트 https://www.k2.com
개인 정보 보호 정책 https://www.k2.com/legal/privacy-policy

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
K2 URL 문자열 K2 URL(예: https://[K2ID].onk2.com). 진실
사용자 이름 시큐어스트링 (보안 문자열) 이 API의 사용자 이름 진실
암호 시큐어스트링 (보안 문자열) 이 API의 암호 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

리디렉션 작업

작업을 다른 사람에게 보냅니다.
릴리스 작업

작업을 해제합니다.
마침 서버 이벤트

응답을 기다리는 비동기 서버 작업에 완료 응답 보내기
서버 이벤트 가져오기

일련 번호로 서버 이벤트를 가져옵니다.
워크플로 가져오기

ID별로 워크플로 정의를 가져옵니다.
워크플로 가져오기

사용 가능한 워크플로 목록을 가져옵니다.
워크플로 시작

새 워크플로 인스턴스를 만들고 시작합니다.
작업 가져오기

일련 번호로 작업을 가져옵니다.
작업 가져오기

연결된 사용자가 사용할 수 있는 작업 목록을 가져옵니다.
작업 작업 가져오기

작업에 대한 작업 목록을 가져옵니다.
작업 태스크

워크플로 작업을 수행합니다.
작업 할당

현재 사용자에게 작업을 할당합니다.
절적 작업

잠자는 작업을 깨운다.
절전 작업

시간(초) 또는 날짜까지 작업을 대기합니다.

리디렉션 작업

작업 ID:
Tasks_PostRedirectAction

작업을 다른 사람에게 보냅니다.

매개 변수

Name 키 필수 형식 Description
일련 번호
 serialNumber True string

작업의 일련 번호입니다. 예: 1234_5678
리디렉션 정보
 RedirectTo True string

작업이 리디렉션되는 사람입니다.

릴리스 작업

작업 ID:
Tasks_PostReleaseAction

작업을 해제합니다.

매개 변수

Name 키 필수 형식 Description
일련 번호
 serialNumber True string

작업의 일련 번호입니다. 예: 1234_5678

마침 서버 이벤트

작업 ID:
ServerEvent_Finish

응답을 기다리는 비동기 서버 작업에 완료 응답 보내기

매개 변수

Name 키 필수 형식 Description
서버 이벤트 일련 번호
 serialNumber True string

서버 이벤트의 일련 번호입니다. 예: 1234_5678
XML 필드 이름
 name string

XML 필드의 이름입니다.
XML 필드 값
 value string

XML 필드의 값입니다.
항목 참조
 ItemReferences object

워크플로 인스턴스의 항목 참조 필드입니다.
데이터 필드
 DataFields object

워크플로 인스턴스의 데이터 필드입니다.

서버 이벤트 가져오기

작업 ID:
ServerEvent_Get

일련 번호로 서버 이벤트를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
서버 이벤트 일련 번호
 serialNumber True string

서버 이벤트의 일련 번호입니다. 예: 1234_5678.

반환

몸
ServerEventDataResponse

워크플로 가져오기

작업 ID:
GetWorkflow

ID별로 워크플로 정의를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
워크플로 ID
 id True integer

워크플로의 ID입니다.

반환

몸
WorkflowDataResponse

워크플로 가져오기

작업 ID:
GetWorkflows

사용 가능한 워크플로 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
워크플로 유형
 type string

워크플로의 유형입니다. 시작 가능 또는 소유.

반환

몸
WorkflowLabelsResponse[WorkflowLabel]

워크플로 시작

작업 ID:
StartWorkflow

새 워크플로 인스턴스를 만들고 시작합니다.

매개 변수

Name 키 필수 형식 Description
워크플로 ID
 id True integer

인스턴스를 시작할 워크플로 ID를 지정합니다.
워크플로 인스턴스 세부 정보
 instance True dynamic

워크플로 인스턴스 개체를 보내 워크플로를 시작합니다.

반환

response
integer

작업 가져오기

작업 ID:
Tasks_GetTask

일련 번호로 작업을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
일련 번호
 serialNumber True string

작업의 일련 번호입니다. 예: 1234_5678

반환

몸
Task

작업 가져오기

작업 ID:
Tasks_Get

연결된 사용자가 사용할 수 있는 작업 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
All, Allocated, Sleeping, SharedFrom, SharedTo
 state string

연결된 사용자의 작업 목록을 반환합니다.

반환

몸
TasksResponse

작업 작업 가져오기

작업 ID:
Tasks_GetTaskActions

작업에 대한 작업 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
일련 번호
 serialNumber True string

작업의 일련 번호입니다. 예: 1234_5678

반환

몸
TaskActionsResponse

작업 태스크

작업 ID:
Tasks_TaskCustomAction

워크플로 작업을 수행합니다.

매개 변수

Name 키 필수 형식 Description
일련 번호
 serialNumber True string

작업의 일련 번호입니다. 예: 1234_5678
사용자 지정 작업
 customAction True string

워크플로에서 정의한 작업 작업입니다.
XML 필드 이름
 name string

XML 필드의 이름입니다.
XML 필드 값
 value string

XML 필드의 값입니다.
항목 참조
 ItemReferences object

워크플로 인스턴스의 항목 참조 필드입니다.
데이터 필드
 DataFields object

워크플로 인스턴스의 데이터 필드입니다.

작업 할당

작업 ID:
Tasks_PostAssignAction

현재 사용자에게 작업을 할당합니다.

매개 변수

Name 키 필수 형식 Description
일련 번호
 serialNumber True string

작업의 일련 번호입니다. 예: 1234_5678

반환

response
object

절적 작업

작업 ID:
Tasks_PostWakeAction

잠자는 작업을 깨운다.

매개 변수

Name 키 필수 형식 Description
일련 번호
 serialNumber True string

작업의 일련 번호입니다. 예: 1234_5678

반환

response
object

절전 작업

작업 ID:
Tasks_PostSleepAction

시간(초) 또는 날짜까지 작업을 대기합니다.

매개 변수

Name 키 필수 형식 Description
일련 번호
 serialNumber True string

작업의 일련 번호입니다. 예: 1234_5678
절전 모드
 SleepFor integer

작업을 대기할 시간(초)입니다.
절전 모드
 SleepUntil date-time

작업을 깨워야 하는 날짜 및 시간입니다. 형식: yyyy-MM-ddTHH:mm:ss:fffZ UTC

정의

ServerEventDataResponse

Name 경로 형식 Description
서버 이벤트 일련 번호
 serialNumber string

서버 이벤트의 일련 번호입니다. 예: 1234_5678
서버 이벤트 워크플로 ID
 workflowID integer

서버 이벤트와 연결된 워크플로의 ID입니다.
서버 이벤트 워크플로 이름
 workflowName string

서버 이벤트와 연결된 워크플로의 이름입니다.
서버 이벤트 워크플로 표시 이름
 workflowDisplayName string

서버 이벤트와 연결된 워크플로의 표시 이름입니다.
서버 이벤트 워크플로 범주
 workflowCategory string

서버 이벤트와 연결된 워크플로의 범주입니다.
서버 이벤트 워크플로 인스턴스 ID
 workflowInstanceID integer

서버 이벤트와 연결된 워크플로의 인스턴스 ID입니다.
서버 이벤트 워크플로 Folio
 workflowInstanceFolio string

서버 이벤트와 연결된 워크플로 인스턴스의 folio입니다.
서버 이벤트 활동 인스턴스 ID
 activityInstanceID integer

서버 이벤트의 활동 인스턴스 ID입니다.
서버 이벤트 활동 대상 ID
 activityInstanceDestinationID integer

서버 이벤트의 활동 인스턴스 대상 ID입니다.
서버 이벤트 활동 이름
 activityName string

서버 이벤트의 활동 이름입니다.
서버 이벤트 이벤트 이름
 eventName string

서버 이벤트의 이벤트 이름입니다.
서버 이벤트 이벤트 설명
 eventDescription string

서버 이벤트에 대한 이벤트 설명입니다.
보낸 사람
 originator User
eventInstance
 eventInstance EventInstanceWrapper
서버 이벤트 활동 데이터 필드
 dataFields object

활동의 데이터 필드입니다.
서버 이벤트 활동 XML 필드
 xmlFields array of UserDefinedXmlField

활동의 XML 필드입니다.
서버 이벤트 항목 참조
 itemReferences object

워크플로 인스턴스의 항목 참조입니다.
서버 이벤트 워크플로 데이터 필드 문자열
 workflowInstanceDataFieldsString string

워크플로 인스턴스의 데이터 필드 문자열 표현입니다.
서버 이벤트 항목 참조 문자열
 itemReferencesString string

워크플로 인스턴스의 항목 참조를 나타내는 문자열입니다.
viewFlowURL
 viewFlowURL string

EventInstance

Name 경로 형식 Description
이벤트 인스턴스 시작 날짜
 StartDate date-time

이벤트 인스턴스가 시작된 날짜 및 시간입니다.
이벤트 인스턴스 예상 기간
 ExpectedDuration integer

이벤트 인스턴스의 예상 기간입니다.
이벤트 인스턴스 우선 순위
 Priority integer

이벤트 인스턴스의 우선 순위입니다.
이벤트 인스턴스 메타데이터
 MetaData string

이벤트 인스턴스에 대한 메타데이터입니다.
이벤트 인스턴스 설명
 Description string

이벤트 인스턴스에 대한 설명입니다.
이벤트 인스턴스 이름
 Name string

이벤트 인스턴스의 이름입니다.
이벤트 인스턴스 ID
 ID integer

이벤트 인스턴스의 ID입니다.

UserDefinedXmlField

Name 경로 형식 Description
XML 필드 이름
 name string

XML 필드의 이름입니다.
XML 필드 값
 value string

XML 필드의 값입니다.

TasksResponse

Name 경로 형식 Description
작업 수
 itemCount integer

반환된 작업 수입니다.
업무
 tasks array of TaskLite

하나 이상의 작업.

TaskLite

Name 경로 형식 Description
작업 일련 번호
 serialNumber string

작업의 일련 번호입니다. 예: 1234_5678
작업 상태
 status string

작업의 상태입니다. 예: 열기, 완료됨, 절전 모드, 할당됨, 사용 가능
작업 시작 날짜
 taskStartDate date-time

작업의 시작 날짜입니다.
작업 대기 시간
 sleepUntil date-time

작업이 해제되는 날짜 및 시간입니다.
작업 우선 순위
 priority integer

작업의 우선 순위입니다.
작업 양식 URL
 formURL string

작업의 양식 URL입니다.
작업 보기 흐름 URL
 viewFlowURL string

작업의 보기 흐름 URL입니다.
작업 워크플로 ID
 workflowID integer

작업과 연결된 워크플로의 ID입니다.
작업 워크플로 이름
 workflowName string

작업과 연결된 워크플로의 이름입니다.
작업 워크플로 표시 이름
 workflowDisplayName string

작업과 연결된 워크플로의 표시 이름입니다.
작업 워크플로 범주
 workflowCategory string

작업과 연결된 워크플로의 범주입니다.
작업 워크플로 인스턴스 ID
 workflowInstanceID integer

작업과 연결된 워크플로의 인스턴스 ID입니다.
작업 워크플로 Folio
 workflowInstanceFolio string

작업과 연결된 워크플로 인스턴스의 folio입니다.
작업 인스턴스 ID
 activityInstanceID integer

작업의 활동 인스턴스 ID입니다.
작업 작업 대상 ID
 activityInstanceDestinationID integer

작업의 활동 인스턴스 대상 ID입니다.
작업 작업 이름
 activityName string

작업의 활동 이름입니다.
작업 이벤트 이름
 eventName string

작업의 이벤트 이름입니다.
작업 이벤트 설명
 eventDescription string

작업에 대한 이벤트 설명입니다.
보낸 사람
 originator User
행동
 actions TaskActionsResponse
작업 지침
 instruction string

작업과 관련된 지침입니다.

사용자

Name 경로 형식 Description
사용자 이름
 username string

사용자의 사용자 이름입니다.
사용자 FQN
 fqn string

사용자의 정규화된 이름입니다. 예: bob@denallix.com, K2:Denallix\Bob
사용자 Email
 email string

사용자의 전자 메일 주소입니다.
사용자 관리자
 manager string

사람의 관리자입니다.
사용자 표시 이름
 displayName string

사용자의 표시 이름입니다.

TaskActionsResponse

Name 경로 형식 Description
일치하지 않는 작업
 nonBatchableActions array of string

작업을 할당하지 않고는 수행할 수 없는 작업 목록입니다.
일괄 처리 가능한 작업
 batchableActions array of string

작업을 할당하지 않고 수행할 수 있는 작업 목록입니다.
시스템 작업
 systemActions array of string

시스템 작업 목록입니다.

과업

Name 경로 형식 Description
작업 일련 번호
 serialNumber string

작업의 일련 번호입니다. 예: 1234_5678
작업 상태
 status string

작업의 상태입니다. 예: 열기, 완료됨, 절전 모드, 할당됨, 사용 가능
작업 시작 날짜
 taskStartDate date-time

작업의 시작 날짜입니다.
작업 대기 시간
 sleepUntil date-time

작업이 해제되는 날짜 및 시간입니다.
작업 우선 순위
 priority integer

작업의 우선 순위입니다.
작업 양식 URL
 formURL string

작업의 양식 URL입니다.
작업 보기 흐름 URL
 viewFlowURL string

작업의 보기 흐름 URL입니다.
작업 워크플로 ID
 workflowID integer

작업과 연결된 워크플로의 ID입니다.
작업 워크플로 이름
 workflowName string

작업과 연결된 워크플로의 이름입니다.
작업 워크플로 표시 이름
 workflowDisplayName string

작업과 연결된 워크플로의 표시 이름입니다.
작업 워크플로 범주
 workflowCategory string

작업과 연결된 워크플로의 범주입니다.
작업 워크플로 인스턴스 ID
 workflowInstanceID integer

작업과 연결된 워크플로의 인스턴스 ID입니다.
작업 워크플로 Folio
 workflowInstanceFolio string

작업과 연결된 워크플로 인스턴스의 folio입니다.
작업 인스턴스 ID
 activityInstanceID integer

작업의 활동 인스턴스 ID입니다.
작업 대상 ID
 activityInstanceDestinationID integer

작업의 활동 인스턴스 대상 ID입니다.
작업 작업 이름
 activityName string

작업의 활동 이름입니다.
작업 이벤트 이름
 eventName string

작업의 이벤트 이름입니다.
작업 이벤트 설명
 eventDescription string

작업에 대한 이벤트 설명입니다.
보낸 사람
 originator User
행동
 actions TaskActionsResponse
작업 워크플로 데이터 필드
 workflowInstanceDataFields object

워크플로 인스턴스의 데이터 필드입니다.
작업 작업 데이터 필드
 activityDataFields object

활동의 데이터 필드입니다.
작업 워크플로 XML 필드
 workflowInstanceXmlFields array of UserDefinedXmlField

워크플로 인스턴스의 XML 필드입니다.
작업 항목 참조
 itemReferences object

워크플로 인스턴스의 항목 참조입니다.
명령
 instruction string
작업 워크플로 데이터 필드 문자열
 workflowInstanceDataFieldsString string

워크플로 인스턴스의 데이터 필드 문자열 표현입니다.
작업 항목 참조 문자열
 itemReferencesString string

워크플로 인스턴스의 항목 참조를 나타내는 문자열입니다.

WorkflowLabelsResponse[WorkflowLabel]

Name 경로 형식 Description
항목 수
 itemCount integer

워크플로 수입니다.
Workflows
 workflows array of WorkflowLabel

워크플로 목록입니다.

WorkflowLabel

Name 경로 형식 Description
워크플로 ID
 id integer

워크플로의 ID입니다.
워크플로 기본 버전
 defaultVersionId integer

기본 워크플로 버전입니다.
워크플로 이름
 name string

워크플로 이름입니다.
워크플로 폴더
 folder string

워크플로 폴더입니다.
워크플로 시스템 이름
 systemName string

워크플로 시스템 이름입니다.

WorkflowDataResponse

Name 경로 형식 Description
workflowInfo
 workflowInfo WorkflowDefinition
워크플로 스키마
 workflowSchema string

워크플로의 스키마입니다.

WorkflowDefinition

Name 경로 형식 Description
워크플로 이름
 name string

워크플로의 이름입니다.
워크플로 설명
 description string

워크플로 설명입니다.
워크플로 폴더
 folder string

워크플로의 폴더(범주)입니다.
워크플로 시스템 이름
 systemName string

워크플로의 시스템 이름입니다.
워크플로 예상 기간
 expectedDuration integer

워크플로의 예상 기간입니다.

EventInstanceWrapper

Name 경로 형식 Description
EventInstance
 EventInstance EventInstance
이벤트 인스턴스 설명
 Description string

이벤트 인스턴스에 대한 설명입니다.
이벤트 인스턴스 예상 기간
 ExpectedDuration integer

이벤트 인스턴스의 예상 기간입니다.
이벤트 인스턴스 ID
 ID integer

이벤트 인스턴스의 ID입니다.
이벤트 인스턴스 메타데이터
 MetaData string

이벤트 인스턴스에 대한 메타데이터입니다.
이벤트 인스턴스 이름
 Name string

이벤트 인스턴스의 이름입니다.
이벤트 인스턴스 우선 순위
 Priority integer

이벤트 인스턴스의 우선 순위입니다.
이벤트 인스턴스 시작 날짜
 StartDate date-time

이벤트 인스턴스가 시작된 날짜 및 시간입니다.

integer

기본 데이터 형식 '정수'입니다.

객체

'object' 형식입니다.