다음을 통해 공유

Aranda 서비스 관리(미리 보기)

비즈니스 프로세스 및 서비스를 관리, 통합 및 자동화할 수 있는 다중 테넌트 솔루션인 Aranda Service Management Suite를 사용하여 회사의 생산성을 높이고 사용자 환경을 혁신합니다.

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

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Aranda Software
URL https://arandasoft.com/
전자 메일 soporte@arandasoft.com
커넥터 메타데이터
게시자 Aranda Software Corporation
웹 사이트 https://arandasoft.com/
개인 정보 보호 정책 https://arandasoft.com/politica-de-privacidad/
카테고리 비즈니스 관리; 합작

ASMS(Aranda Service Management Suite)

비즈니스 프로세스 및 서비스를 관리, 통합 및 자동화할 수 있는 다중 테넌트 솔루션인 Aranda Service Management Suite를 사용하여 회사의 생산성을 높이고 사용자 환경을 혁신합니다. 인시던트, 요구 사항 및 변경 내용을 포함하여 ASMS의 모든 작업 영역(프로젝트)에 저장된 레코드를 만들고, 검색하고, 업데이트합니다.

Pre-requisites

계속하려면 다음 필수 구성 요소를 유의하세요.

  • ASMS(Aranda Service Management Suite)의 구독 및 인스턴스입니다. 여기에서 시작합니다. https://arandasoft.com/
  • 프리미엄 커넥터 기능이 있는 활성 Microsoft Power Automate 구독

자격 증명 가져오기

  • 인증을 수행하려면 통합 토큰을 사용합니다. 다음 링크에서 통합 토큰을 가져오는 방법에 대한 정보를 찾을 수 있습니다.

커넥터 시작

  1. ASMS(Aranda Service Management Suite)에 대한 구독이 필요합니다.

  2. 통합 토큰 가져오기

  3. ApiAsms(Aranda Service Management ASMS API)의 인스턴스 URL을 가져옵니다.

  4. Aranda Service Management Suite 커넥터와의 연결을 설정합니다.

  5. 커넥터에서 제공하는 다음 함수 중 하나를 선택합니다.

    표

  6. 커넥터에 대한 자세한 설명서는 를 참조하세요. https://docs.arandasoft.com/connectors

다음과 같은 경우에 이 커넥터를 사용할 수 있습니다.

  1. 사용 가능한 다른 작업 중에서 티켓을 만들고, 검색하고, 업데이트합니다.
  2. 티켓 추적 가능성을 가져옵니다.
  3. 티켓과 관련된 첨부 파일을 다운로드합니다.
  4. Aranda Service Management Suite에서 KB(기술 자료) 문서를 검색합니다.
  5. 기술 자료(KB) 문서에서 첨부 파일을 다운로드합니다.
  6. 구성 항목 만들기, 검색 및 업데이트(CI).
  7. 이를 통해 조직은 내부 지원 요청을 해결하고 기술 문제 해결 프로세스를 관리하고 간소화할 수 있습니다.
  8. 요청자와 지원 에이전트 간의 통신 추적을 허용합니다.
  9. 요청자에게 티켓 상태를 알리는 자동화된 응답을 제공합니다.

성공적인 응답

코드 이름 Description
200 그래 요청이 성공했습니다.
204 내용 없음 요청에서 데이터를 찾을 수 없음

일반적인 오류 및 해결

코드 이름 Description 해결 방법
400 잘못된 요청 CriteriaNeedsSomeArguments 검색 매개 변수가 비어 있지 않은지 확인합니다.
400 잘못된 요청 InvalidAdditionalFieldId 추가 필드의 ID가 올바른지 확인합니다.
400 잘못된 요청 InvalidItemType 사례 유형이 잘못되었습니다. 사례 유형 ID를 변경합니다.
400 잘못된 요청 InvalidProjectId 프로젝트 ID가 잘못되었습니다. 사례를 연결할 프로젝트 ID를 변경합니다.
400 잘못된 요청 InvalidStateId 티켓을 만들거나 업데이트할 때 추가된 상태 확인
400 잘못된 요청 InvalidUploadType 파일을 첨부할 때 오류 발생, 시스템 관리자의 지원 요청
400 잘못된 요청 RequestNeedsSomeArguments 티켓의 필수 필드를 확인하고 커넥터에 해당 값을 추가합니다.
400 잘못된 요청 SearchListIsRequired 시스템 관리자의 지원 요청
400 잘못된 요청 매개 변수 이름: {Name 매개 변수} 오류에 언급된 속성이 null이 아닌지 확인합니다.
400 잘못된 요청 null 매개 변수 이름입니다. {Name 매개 변수} 오류에 언급된 속성이 null이 아닌지 확인합니다.
400 잘못된 요청 ItemTypeIsRequired 사례 유형 추가
400 잘못된 요청 ModelIdIsEmpty modelId 매개 변수를 추가합니다. 필수 항목입니다.
400 잘못된 요청 StateIdIsEmpty stateId 매개 변수를 추가합니다. 필수 항목입니다.
400 잘못된 요청 ServiceIdIsEmpty serviceId 매개 변수를 추가합니다. 필수 항목입니다.
400 잘못된 요청 CategoryIdIsEmpty categoryId 매개 변수를 추가합니다. 필수 항목입니다.
400 잘못된 요청 TypesListNeedsSomeArguments 티켓을 검색할 때 사례 유형을 추가해야 하며 시스템 관리자의 지원 요청
400 잘못된 요청 '{PARAMETER_NAME}' AdditionalFieldIsRequired 추가 필드 '{PARAMETER_NAME}'은(는) 필수입니다.
400 잘못된 요청 ModelNotActive 사례와 연결된 모델이 활성 상태가 아닙니다.
400 잘못된 요청 FailedToCloseTaskPendingCloseTasksPredecessors 대/소문자를 닫으려고 하면 부모 사례에 닫을 보류 중인 작업이 있는 경우
400 잘못된 요청 DuplicatedObject Ci가 데이터베이스에 이미 있습니다.
400 잘못된 요청 EmptyValue 매개 변수 이름: {PARAMETER_NAME} {PARAMETER_NAME} 매개 변수가 필요합니다.
400 잘못된 요청 EmptyEnumeration 매개 변수 이름: {PARAMETER_NAME} {PARAMETER_NAME} 매개 변수는 목록이며 필수 항목입니다.
403 금지 DoNotHavePermissionForThisAction 시스템 관리자에게 문의하여 사용 권한 할당
코드 이름 Description 해결 방법
500 내부 서버 오류 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureExportExcel 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetAdditionalFields 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetCategoriesByService 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetChangeFSC 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetFields 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetFieldsList 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetFiles 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetLookupValues 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetMailTemplates 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetModelByCategory 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetOperators 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetReassignmentReasons 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureGetSimilarItems 시스템 관리자의 지원 요청
500 내부 서버 오류 FailureSearchQuickManagement 시스템 관리자의 지원 요청

자주 묻는 질문(FAQ)

  1. 커넥터에서 다양한 작업을 사용하는 데 필요한 특성의 ID를 검색하는 방법(예: 프로젝트, 서비스, 범주, 그룹, 전문가)?

    ID는 여러 가지 방법으로 검색할 수 있습니다.

    • Aranda 쿼리 관리자를 사용하여 필요한 데이터가 있는 ASMS(Aranda Service Management Suite) 테이블을 쿼리하는 보고서를 만들 수 있습니다. 솔루션의 데이터 개체에 대한 지침이 필요한 경우 다음 링크를 https://docs.arandasoft.com/docs/database.html 방문하여 ASMS 설치에 해당하는 Aranda 데이터베이스 버전을 식별합니다.
    • ASMS 온-프레미스 설치를 사용하는 경우 SQL 클라이언트를 통해 필요한 데이터가 있는 ASMS 테이블을 쿼리할 수 있습니다.
    • Aranda 지원 센터를 통해 다음 웹 사이트 지원에 표시된 연락처 채널을 통해 지원 요청을 만듭니다.

  2. "첨부 파일 추가" 작업을 사용할 때 첨부할 파일의 최대 크기는 어떻게 됩니까?

    최대 크기는 ASMS 인스턴스/설치의 특정 구성에 따라 달라집니다. ASMS 관리자에게 문의하세요.

  3. 커넥터에 필요한 ASMS 연결 구성에 토큰이 사용되는 기술자 계정에 필요한 데이터 액세스 수준은 무엇인가요?

    액세스 수준은 ASMS에서 정기적으로 사용되는 기술자 계정과 동일합니다. 즉, ASMS에서 해당 기술자의 역할 및 권한에 따라 커넥터를 사용하여 데이터에 액세스할 수 있습니다.

  4. 커넥터에서 토큰을 사용할 기술자 계정이 명명 또는 동시이어야 하나요?

    커넥터는 시간당 여러 번 관련 ASMS 인스턴스에 액세스할 수 있으므로 계정이 명명된 형식인 것이 좋습니다.

  5. 커넥터를 사용하여 사례를 만들거나 수정하는 경우 ASMS 인터페이스에 있는 것과 동일한 데이터 유효성 검사 규칙을 따르나요?

    예, 동일한 유효성 검사 규칙을 따릅니다. 예를 들어 특정 프로젝트, 서비스 및 범주에 대한 사례를 만들 때 네이티브 및 추가 필드를 채워야 하는 경우 커넥터를 통해 사례를 제출할 때도 이러한 데이터가 필요합니다.

  6. 클라우드 및 온-프레미스 환경에서 ASMS 인스턴스에 커넥터를 사용할 수 있나요?

    예, ASMS의 클라우드 및 온-프레미스 설치 모두에서 사용할 수 있습니다. 온-프레미스 설치에서는 ASMS 서버와 Power Automate 환경 간의 연결을 고려해야 합니다.

  7. 표준 커넥터만 사용할 수 있는 Power Automate 라이선스가 있습니다. ASMS 커넥터를 사용할 수 있나요?

    ASMS 커넥터는 프리미엄 유형이므로 불가능합니다.

  8. Power Automate에서 ASMS의 이벤트(예: 케이스가 생성된 경우, 특정 그룹에 사례가 할당된 경우)에서 시작하는 흐름을 만들려고 합니다. ASMS에서 발생하는 이벤트에서 시작하는 트리거를 사용할 수 있나요?

    예, 가능합니다. 다음 단계를 수행하는 것이 좋습니다.

    • "HTTP 요청을 받은 경우" 트리거를 초기화하고 ASMS에서 수신될 것으로 예상되는 데이터 구조를 포함하는 요청 본문 JSON 스키마를 만듭니다. 트리거가 만들어지면 ASMS 인스턴스에서 사용할 HTTP POST URL(WebHook URL)을 받게 됩니다. WebHook URL(예: 토큰)에 액세스하는 인증 메커니즘을 고려하는 것을 잊지 마세요.
    • 충족될 때 Power Automate에서 흐름을 시작해야 하는 조건 집합에 대한 비즈니스 규칙을 ASMS에 만듭니다. 규칙 내에서 작업으로 "웹후크 호출"을 선택하고 호출 대상 URL에 이전에 가져온 WebHook URL, 보낼 매개 변수 및 요청 본문(요청 본문 JSON 스키마와 일치해야 함)을 입력합니다. ASMS의 규칙에서 웹후크를 호출하는 방법에 대한 자세한 내용은 다음 링크를 참조하세요. 웹후크 규칙
    • 만든 규칙을 테스트하고 HTTP 요청이 WebHook URL로 전송되고 Power Automate에서 흐름을 초기화하는지 확인합니다.

  9. POWER Automate에서 흐름의 작업으로 ASMS REST API 엔드포인트를 호출할 수 있나요?

    예, 가능합니다. "HTTP" 작업을 사용하고 필요한 데이터(URI, 메서드, 헤더, 본문 등)를 입력합니다.

연결을 만드는 중

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

기본값

적용 가능: 모든 지역

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

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

이름 유형 Description 필수
호스트 ASMS 문자열 호스트 ASMS 진실
권한 부여 토큰 시큐어스트링 (보안 문자열) 권한 부여 토큰 진실

제한 한도

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

동작

검색 사례

쿼리에 추가된 검색 조건에 따라 ASMS 사례 레코드 목록을 검색합니다.
구성 항목 가져오기

이름 및 직렬로 CI를 가져옵니다.
구성 항목 검색

쿼리에 추가된 검색 조건에 따라 CMDB CI 레코드 목록을 검색합니다.
구성 항목 만들기

Aranda CMDB에서 CI를 만듭니다.
구성 항목 업데이트

Aranda CMDB에서 CI를 업데이트합니다.
문서 검색

쿼리에 추가된 검색 조건에 따라 문서 목록을 검색합니다.
문서 첨부 파일 다운로드

문서와 관련된 첨부 파일을 다운로드합니다.
사례 가져오기

ASMS 사례의 메타데이터 레코드를 가져옵니다.
사례 기록 가져오기

대/소문자 기록을 가져옵니다. 기본적으로 노트는 포함되지 않습니다.
사례 만들기

ASMS에서 새 사례 레코드를 만듭니다.
사례에 메모 추가

ASMS의 특정 사례 레코드에 메모를 추가합니다.
사례에 첨부 파일 추가

ASMS의 특정 사례 레코드에 파일을 첨부합니다.
업데이트 사례

ASMS 사례에 대한 레코드를 업데이트합니다.
케이스 첨부 파일 다운로드

문서와 관련된 첨부 파일을 다운로드합니다.

검색 사례

작업 ID:
SearchTickets

쿼리에 추가된 검색 조건에 따라 ASMS 사례 레코드 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
필터 간 관계
 logicOperator True string

검색 조건 간의 관계를 지정합니다.
필터링할 필드
 field True string

필터링할 대/소문자 필드(예: 'stateName')입니다.
검색 연산자
 operator True string

검색 연산자입니다.
찾을 값
 value True string

찾을 필드 값입니다.

반환

Name 경로 형식 Description
array of object
사례 ID
 id integer

레코드의 시스템 식별자입니다.
프로젝트별 ID
 idByProject string

레코드에 대한 프로젝트별 ID입니다.
주제
 subject string

사례 주체입니다.
Description
 description string

사례에 대한 자세한 설명입니다.
프로젝트 ID
 projectId integer

프로젝트 식별자입니다.
프로젝트
 projectName string

프로젝트 이름입니다.
케이스 유형
 itemTypeName string

대/소문자 유형 이름입니다.
대/소문자 유형 ID
 itemTypeId integer

대/소문자 유형 식별자입니다.
서비스 아이디
 serviceId integer

서비스 식별자입니다.
서비스
 serviceName string

서비스 이름입니다.
모델 아이디
 modelId integer

모델 식별자입니다.
Model
 modelName string

모델 이름입니다.
범주 ID
 categoryId integer

범주 식별자입니다.
카테고리
 categoryName string

범주 이름입니다.
신청자 ID
 applicantId integer

신청자 식별자입니다.
CI ID
 ciId integer

구성 항목 식별자입니다.
CI
 ciName string

기본 구성 항목 이름입니다.
클라이언트 ID
 customerId integer

클라이언트 식별자입니다.
클라이언트
 customerName string

클라이언트 이름입니다.
회사 ID
 companyId integer

회사 식별자입니다.
회사
 companyName string

회사 이름입니다.
SLA ID
 slaId integer

SLA 식별자입니다.
서비스 수준 계약 (SLA)
 slaName string

SLA 이름입니다.
상태 ID
 stateId integer

상태 식별자입니다.
상태
 stateName string

상태 이름입니다.
이유 ID
 reasonId integer

이유 식별자입니다.
이유
 reasonName string

이유 이름입니다.
그룹 아이디
 groupId integer

그룹 식별자.
그룹
 groupName string

그룹 이름입니다.
책임 ID
 responsibleId integer

책임 있는 식별자입니다.
책임
 responsibleName string

책임 있는 이름입니다.
영향 ID
 impactId integer

영향 식별자입니다.
Impact
 impactName string

영향 이름입니다.
레지스트리 날짜
 openedDate string

레지스트리 날짜입니다.
작성자 ID
 authorId integer

작성자 식별자입니다.
작성자
 authorName string

작성자 이름입니다.

구성 항목 가져오기

작업 ID:
GetCI

이름 및 직렬로 CI를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
이름 또는 직렬 CI
 request True string

구성 항목의 이름 또는 직렬을 입력합니다.

반환

Name 경로 형식 Description
추가 필드
 additionalFields array of object

추가 필드입니다.
아이디
 additionalFields.fieldId integer

필드 식별자
이름
 additionalFields.nameField string

필드 이름
values
 additionalFields.values array of string

추가 필드 값
:아이디
 additionalFields.valueDetails.id integer

목록 또는 카탈로그 형식 필드 사양: 식별자
:값
 additionalFields.valueDetails.value string

목록 또는 카탈로그 형식 필드 사양: 값
자산 태그
 assetTag string

자산 태그입니다.
바코드
 barCode string

바코드입니다.
아이디
 brand.id integer

브랜드 식별자입니다.
이름
 brand.name string

브랜드 이름입니다.
아이디
 category.id integer

범주 식별자입니다.
이름
 category.name string

범주 이름입니다.
아이디
 costCenter.id integer

비용 센터 식별자입니다.
이름
 costCenter.name string

비용 센터 이름입니다.
승인 날짜
 acceptDate date-time

승인 날짜입니다.
회사에 배달 날짜
 checkinDate date-time

회사에 배달한 날짜입니다.
초기 책임 날짜
 responsibilityDate date-time

책임의 초기 날짜입니다.
만든 날짜
 createdDate date-time

만든 날짜입니다.
수정된 날짜
 modifiedDate date-time

수정된 날짜입니다.
Description
 description string

CI에 대한 자세한 설명입니다.
CI ID
 id integer

레코드의 시스템 식별자입니다.
아이디
 impact.id integer

영향 식별자입니다.
이름
 impact.name string

영향 이름입니다.
라이선스 번호
 licenseNumber string

라이선스 번호입니다.
아이디
 manufacturer.id integer

제조업체 식별자입니다.
이름
 manufacturer.name string

제조업체 이름입니다.
아이디
 model.id integer

모델 식별자입니다.
이름
 model.name string

모델 이름입니다.
CI 이름
 name string

구성 항목 이름입니다.
프로젝트
 projects array of object

프로젝트.
아이디
 projects.id integer

식별자.
아이디
 provider.id integer

제조업체 식별자입니다.
이름
 provider.name string

제조업체 이름입니다.
아이디
 reason.id integer

이유 식별자입니다.
이름
 reason.name string

이유 이름
아이디
 responsible.id integer

책임 있는 식별자입니다.
이름
 responsible.name string

책임 있는 이름입니다.
아이디
 risk.id integer

위험 식별자입니다.
이름
 risk.name string

위험 이름입니다.
RFID
 rfid string

RFID
일련 번호
 serial string

일련 번호
아이디
 state.id integer

상태 식별자입니다.
이름
 state.name string

상태 이름입니다.
임시 항목 식별자
 tempItemId integer

임시 항목 식별자입니다.
CI 유형
 type string

구성 항목 유형입니다.
아이디
 unit.id integer

단위 식별자입니다.
이름
 unit.name string

단위 이름입니다.
단위 값 측정
 unitSize string

단위 값을 측정합니다.
유용한 수명
 usefulLife integer

유용한 삶.
버전
 version integer

version

구성 항목 검색

작업 ID:
SearchCIs

쿼리에 추가된 검색 조건에 따라 CMDB CI 레코드 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
필터 간 관계
 logicOperator True string

검색 조건 간의 관계를 지정합니다.
필터링할 필드
 field True string

필터링할 CI 필드(예: 'stateName')
검색 연산자
 operator True string

검색 연산자입니다.
찾을 값
 value True string

찾을 필드 값입니다.

반환

Name 경로 형식 Description
array of object
승인 날짜
 acceptDate date-time

승인 날짜
자산 태그
 assetTag string

자산 태그
책임 있는 이름
 responsibleName string

책임 있는 이름
아이디
 category.id integer

범주 식별자
이름
 category.name string

범주 이름
회사에 배달 날짜
 checkinDate date-time

회사에 배달한 날짜입니다.
만든 날짜
 createdDate date-time

만든 날짜
Description
 description string

CI에 대한 자세한 설명입니다.
CI ID
 id integer

레코드의 시스템 식별자입니다.
아이디
 impact.id integer

영향 식별자
이름
 impact.name string

영향 이름
수정된 날짜
 modifiedDate date-time

수정된 날짜
CI 이름
 name string

구성 항목 이름입니다.
초기 책임 날짜
 responsibilityDate date-time

책임의 초기 날짜입니다.
일련 번호
 serial string

일련 번호
아이디
 state.id integer

상태 식별자입니다.
이름
 state.name string

상태 이름입니다.
CI 유형
 type string

구성 항목 유형입니다.

구성 항목 만들기

작업 ID:
CreateCI

Aranda CMDB에서 CI를 만듭니다.

매개 변수

Name 키 필수 형식 Description
이름
 name True string

이름
Description
 description string

CI에 대한 자세한 설명입니다.
일련 번호
 serial string

직렬.
자산 태그
 assetTag string

자산 태그입니다.
프로젝트
 projectId True integer

프로젝트를 선택하거나 프로젝트 식별자를 수동으로 입력합니다.
카테고리
 categoryId True integer

범주를 선택하거나 범주 식별자를 수동으로 입력합니다.
책임 ID
 responsibleId True integer

책임 있는 식별자입니다.
라이선스 번호
 licenseNumber string

라이선스 번호입니다.
생산자
 manufacturerId integer

제조업체를 선택하거나 제조업체 식별자를 수동으로 입력합니다.
브랜드
 brandId integer

브랜드를 선택하거나 브랜드 식별자를 수동으로 입력합니다.
Model
 modelId integer

모델을 선택하거나 모델 식별자를 수동으로 입력합니다.
공급자 ID
 providerId integer

공급자를 선택하거나 공급자 식별자를 수동으로 입력합니다.
이유 ID
 reasonId integer

이유 식별자입니다.
가격
 price number

값.
RFID
 rfid string

RFID
승인 날짜
 acceptDate date-time

승인 날짜입니다.
회사에 배달 날짜
 checkInDate date-time

회사에 배달한 날짜입니다.
초기 책임 날짜
 responsibilityDate date-time

책임의 초기 날짜입니다.
바코드
 barCode string

바코드입니다.
단위 값 측정
 unitSize string

단위 값을 측정합니다.
측정 단위
 unitId integer

측정 단위를 선택하거나 측정 단위 식별자를 수동으로 입력합니다.
원가 센터
 costCenterId integer

비용 센터를 선택하거나 비용 센터 식별자를 수동으로 입력합니다.
Impact
 impactId integer

영향을 선택하거나 영향 식별자를 수동으로 입력합니다.
위험
 riskId integer

위험을 선택하거나 위험 식별자를 수동으로 입력합니다.
위치
 locationId integer

위치를 선택하거나 위치 식별자를 수동으로 입력합니다.
fieldId
 fieldId string

필드 식별자입니다.
values
 values array of string

가치

반환

Name 경로 형식 Description
구성 항목 식별자
 id integer

구성 항목 식별자입니다.

구성 항목 업데이트

작업 ID:
UpdateCI

Aranda CMDB에서 CI를 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
이름 또는 직렬 CI
 request True string

구성 항목의 이름 또는 직렬을 입력합니다.
Description
 description string

CI에 대한 자세한 설명입니다.
일련 번호
 serial string

일련 번호
자산 태그
 assetTag string

자산 태그입니다.
카테고리
 categoryId integer

범주를 선택하거나 범주 식별자를 수동으로 입력합니다.
책임 ID
 responsibleId integer

책임 있는 식별자입니다.
상태 ID
 stateId integer

상태 식별자입니다.
라이선스 번호
 licenseNumber string

라이선스 번호입니다.
제조업체 ID
 manufacturerId integer

제조업체 식별자입니다.
브랜드
 brandId integer

브랜드를 선택하거나 브랜드 식별자를 수동으로 입력합니다.
Model
 modelId integer

모델을 선택하거나 모델 식별자를 수동으로 입력합니다.
공급자 ID
 providerId integer

공급자 식별자입니다.
이유 ID
 reasonId integer

이유 식별자입니다.
가격
 price number

값.
RFID
 rfid string

RFID
승인 날짜
 acceptDate date-time

승인 날짜입니다.
회사에 배달 날짜
 checkInDate date-time

회사에 배달한 날짜입니다.
초기 책임 날짜
 responsibilityDate date-time

책임의 초기 날짜입니다.
바코드
 barCode string

바코드입니다.
단위 값 측정
 unitSize string

단위 값을 측정합니다.
측정 단위
 unitId integer

측정 단위를 선택하거나 측정 단위 식별자를 수동으로 입력합니다.
비용 센터 ID
 costCenterId integer

비용 센터 식별자입니다.
Impact
 impactId integer

영향을 선택하거나 영향 식별자를 수동으로 입력합니다.
위험
 riskId integer

위험을 선택하거나 위험 식별자를 수동으로 입력합니다.
위치 ID
 locationId integer

위치 식별자입니다.
fieldId
 fieldId string

필드 식별자
values
 values array of string

가치

반환

Name 경로 형식 Description
구성 항목 식별자
 id integer

구성 항목 식별자입니다.

문서 검색

작업 ID:
GetArticle

쿼리에 추가된 검색 조건에 따라 문서 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
프로젝트
 projectId True integer

프로젝트를 선택하거나 프로젝트 식별자를 수동으로 입력합니다.
검색 문서
 search True string

제목, 키워드 또는 설명으로 문서를 검색합니다.
카테고리
 folderId integer

범주를 선택하거나 범주 식별자를 수동으로 입력합니다.
유형
 typeId integer

형식을 선택하거나 형식 식별자를 수동으로 입력합니다.

반환

Name 경로 형식 Description
array of object
제목
 title string

타이틀.
Description
 description string

Description.
Content
 content html

콘텐츠.
아티클 키워드
 keyword string

아티클 키워드입니다.
문서 ID
 identifier string

아티클 식별자입니다.
만든 날짜
 createdDate string

만든 날짜입니다.
수정된 날짜
 lastModifiedDate string

수정된 날짜입니다.
수업 ID
 classId integer

클래스 식별자입니다.
문서 ID
 id integer

레코드의 시스템 식별자입니다.
아이디
 type.id integer

형식 식별자입니다.
이름
 type.name string

형식 이름입니다.
URL
 url string

URL
첨부 파일 문서
 attachments array of object

문서와 관련된 첨부 파일입니다.
아이디
 attachments.id integer

첨부 파일 식별자입니다.
이름
 attachments.name string

첨부 파일 이름입니다.

문서 첨부 파일 다운로드

작업 ID:
DownloadArticleFile

문서와 관련된 첨부 파일을 다운로드합니다.

매개 변수

Name 키 필수 형식 Description
문서 ID
 articleId True integer

아티클 식별자입니다.
첨부 파일 ID
 fileId True integer

첨부 파일의 식별자를 나타냅니다.

반환

첨부 파일의 내용입니다.

파일 콘텐츠
binary

사례 가져오기

작업 ID:
GetCase

ASMS 사례의 메타데이터 레코드를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
프로젝트별 ID
 ticketId True string

레코드의 코드

반환

Name 경로 형식 Description
사례 ID
 id integer

레코드의 시스템 식별자입니다.
프로젝트별 ID
 idByProject string

레코드에 대한 프로젝트별 ID입니다.
주제
 subject string

제목.
Description
 description string

사례에 대한 자세한 설명입니다.
해결 방법
 commentary string

사례 솔루션입니다.
프로젝트 ID
 projectId integer

프로젝트 식별자입니다.
프로젝트
 projectName string

프로젝트 이름입니다.
대/소문자 유형
 itemTypeName string

대/소문자 유형 이름입니다.
대/소문자 유형 ID
 itemTypeId integer

대/소문자 유형 식별자입니다.
서비스 아이디
 serviceId integer

서비스 식별자입니다.
서비스
 serviceName string

서비스 이름입니다.
모델 아이디
 modelId integer

모델 식별자입니다.
Model
 modelName string

모델 이름입니다.
범주 ID
 categoryId integer

범주 식별자입니다.
범주 이름
 categoryName string

범주.
신청자 ID
 applicantId integer

신청자 식별자입니다.
클라이언트 ID
 customerId integer

클라이언트 식별자입니다.
클라이언트
 customerName string

클라이언트 이름입니다.
회사 ID
 companyId integer

회사 식별자입니다.
회사
 companyName string

회사 이름입니다.
CI ID
 ciId integer

CI 식별자입니다.
CI
 ciName string

CI 이름입니다.
SLA ID
 slaId integer

SLA 식별자입니다.
서비스 수준 계약 (SLA)
 slaName string

SLA 이름입니다.
상태 ID
 stateId integer

상태 식별자입니다.
상태
 stateName string

상태 이름입니다.
이유 ID
 reasonId integer

이유 식별자입니다.
이유
 reasonName string

이유 이름입니다.
그룹 아이디
 groupId integer

그룹 식별자.
그룹
 groupName string

그룹 이름입니다.
책임 ID
 responsibleId integer

책임 있는 식별자입니다.
책임
 responsibleName string

책임 있는 이름입니다.
레지스트리 유형 ID
 registryTypeId integer

레지스트리 유형 식별자입니다.
레지스트리 유형
 registryTypeName string

레지스트리 유형 이름입니다.
영향 ID
 impactId integer

영향 식별자입니다.
Impact
 impactName string

영향 이름입니다.
긴급 ID
 urgencyId integer

긴급 식별자입니다.
긴급도
 urgencyName string

긴급 이름입니다.
우선 순위 ID
 priorityId integer

우선 순위 식별자입니다.
Priority
 priorityName string

우선 순위 이름입니다.
위험 ID
 riskId integer

위험 식별자입니다.
위험
 riskName string

위험 이름입니다.
공급자 ID
 providerId integer

공급자 식별자입니다.
Provider
 providerName string

공급자 이름입니다.
UC ID
 ucId integer

UC 식별자입니다.
UC (미국)
 ucName string

UC 이름입니다.
조직 영역 ID
 unitId integer

조직 영역 식별자입니다.
조직 영역
 unitName string

조직 영역 이름입니다.
OLA ID
 olaId integer

OLA 식별자입니다.
OLA
 olaName string

OLA 이름입니다.
레지스트리 날짜
 openedDate string

레지스트리 날짜입니다.
종결한 날짜
 closedDate string

마감 날짜입니다.
최종 날짜
 finalDate string

최종 날짜(작업 레코드에만 해당).
초기 날짜
 initialDate string

초기 날짜(작업 레코드에만 해당).
비용
 cost number

비용.
실제 비용
 realCost number

실제 비용.
예상 비용
 estimatedCost number

예상 비용입니다.
가격
 price number

값.
인터페이스 식별자
 interfaceId string

인터페이스 식별자입니다.
닫힘
 isClosed boolean

닫은.
발전
 currentProgress number

진보.
실제 날짜
 realDate string

실제 날짜입니다.
예상 날짜
 estimatedDate string

예상 날짜입니다.
작성자 ID
 authorId integer

작성자 식별자입니다.
작성자
 authorName string

작성자 이름입니다.
Attachments
 attachments array of object

케이스와 관련된 첨부 파일입니다.
아이디
 attachments.id integer

첨부 파일 식별자입니다.
이름
 attachments.name string

첨부 파일 이름입니다.
추가 필드
 additionalFields array of object

추가 필드입니다.
아이디
 additionalFields.fieldId integer

필드 식별자입니다.
이름
 additionalFields.nameField string

필드 이름입니다.
values
 additionalFields.values array of string

추가 필드 값입니다.
:아이디
 additionalFields.valueDetails.id integer

목록 또는 카탈로그 형식 필드의 사양: 식별자입니다.
:값
 additionalFields.valueDetails.value string

목록 또는 카탈로그 형식 필드 사양: 값입니다.

사례 기록 가져오기

작업 ID:
CaseHistory

대/소문자 기록을 가져옵니다. 기본적으로 노트는 포함되지 않습니다.

매개 변수

Name 키 필수 형식 Description
프로젝트별 ID
 ticketId True string

레코드의 코드
메모 포함
 addNote string

추가하려는 메모 유형을 선택합니다.

반환

Name 경로 형식 Description
array of object
작업 키
 actionId string

작업 키
조치
 actionName string

티켓 수명 주기에서 수행된 활동 또는 작업의 이름입니다.
작성자 ID
 authorId integer

작성자 식별자입니다.
작성자
 authorName string

변경한 작성자입니다.
만든 날짜
 created date-time

작업이 발생한 날짜입니다.
수정된 필드 이름
 fieldName string

수정된 필드 이름입니다.
새 값
 newValue html

속성의 새 값을 나타냅니다.
이전 값
 oldValue html

수정된 값입니다.
메모 유형
 noteType string

메모 유형을 나타냅니다('참고' 작업 키에만 해당).
관련 항목 식별자
 relatedItemId string

관계가 추가된 경우 식별자를 나타냅니다. ('AddedRelated' 작업 키에만 해당).

사례 만들기

작업 ID:
CreateCase

ASMS에서 새 사례 레코드를 만듭니다.

매개 변수

Name 키 필수 형식 Description
주제
 subject True string

제목.
Description
 description string

사례에 대한 자세한 설명입니다.
케이스 유형
 itemType True string

사례 유형을 선택하거나 사례 유형 이름을 수동으로 입력합니다.
프로젝트
 projectId True integer

프로젝트를 선택하거나 프로젝트 식별자를 수동으로 입력합니다.
서비스
 serviceId True integer

서비스를 선택하거나 서비스 식별자를 수동으로 입력합니다.
카테고리
 categoryId True integer

범주를 선택하거나 범주 식별자를 수동으로 입력합니다.
이유
 reasonId integer

이유를 선택하거나 이유 식별자를 수동으로 입력합니다.
그룹
 groupId integer

그룹을 선택하거나 그룹 식별자를 수동으로 입력합니다.
책임
 responsibleId integer

책임 있는 식별자를 선택하거나 책임 있는 식별자를 수동으로 입력합니다.
회사
 companyId integer

회사를 선택하거나 수동으로 회사 식별자를 입력합니다.
Provider
 providerId integer

공급자를 선택하거나 공급자 식별자를 수동으로 입력합니다.
조직 영역
 unitId integer

조직 영역을 선택하거나 조직 영역 식별자를 수동으로 입력합니다.
신청자 ID
 applicantId integer

신청자 식별자입니다.
클라이언트 ID
 customerId integer

클라이언트 식별자입니다.
CI 식별자
 ciId integer

CI 식별자입니다.
레지스트리 유형
 registryTypeId integer

레지스트리 유형을 선택하거나 레지스트리 유형 식별자를 수동으로 입력합니다.
긴급도
 urgencyId integer

긴급도를 선택하거나 긴급 식별자를 수동으로 입력합니다.
Impact
 impactId integer

영향을 선택하거나 영향 식별자를 수동으로 입력합니다.
아이디
 fieldId string

필드 식별자입니다.
values
 values array of string

값.

반환

Name 경로 형식 Description
사례 ID
 id integer

대/소문자 식별자
프로젝트별 ID
 idByProject string

레코드에 대한 프로젝트별 ID

사례에 메모 추가

작업 ID:
AttachNote

ASMS의 특정 사례 레코드에 메모를 추가합니다.

매개 변수

Name 키 필수 형식 Description
프로젝트별 ID
 ticketId True string

레코드의 코드
비고
 message True string

레코드에 첨부할 참고 사항입니다.

사례에 첨부 파일 추가

작업 ID:
AttachFile

ASMS의 특정 사례 레코드에 파일을 첨부합니다.

매개 변수

Name 키 필수 형식 Description
프로젝트별 ID
 ticketId True string

레코드의 코드
File
 file True byte

바이트 파일입니다.
파일 이름
 fileName True string

파일 이름(예: 'Vacation_Approval_Form.docx').

업데이트 사례

작업 ID:
UpdateCase

ASMS 사례에 대한 레코드를 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
프로젝트별 ID
 ticketId True string

레코드의 코드
주제
 subject string

제목.
Description
 description string

사례에 대한 자세한 설명입니다.
해결 방법
 commentary string

사례 솔루션입니다.
서비스 아이디
 serviceId integer

서비스 식별자입니다.
범주 ID
 categoryId integer

범주 식별자입니다.
상태 ID
 stateId integer

상태 식별자입니다.
이유 ID
 reasonId integer

이유 식별자입니다.
그룹 아이디
 groupId integer

그룹 식별자.
책임 ID
 responsibleId integer

책임 있는 식별자입니다.
신청자 ID
 applicantId integer

신청자 식별자입니다.
클라이언트 ID
 customerId integer

클라이언트 식별자입니다.
회사 ID
 companyId integer

회사 식별자입니다.
CI ID
 ciId integer

CI 식별자입니다.
공급자 ID
 providerId integer

공급자 식별자입니다.
조직 영역 ID
 unitId integer

조직 영역 식별자입니다.
레지스트리 유형
 registryTypeId integer

레지스트리 유형을 선택하거나 레지스트리 유형 식별자를 수동으로 입력합니다.
긴급도
 urgencyId integer

긴급도를 선택하거나 긴급 식별자를 수동으로 입력합니다.
Impact
 impactId integer

긴급도를 선택하거나 영향 식별자를 수동으로 입력합니다.
인터페이스
 interfaceId string

제3자와의 관계입니다.
필드 식별자
 fieldId string

필드 식별자입니다.
가치들
 values array of string

값.

반환

Name 경로 형식 Description
결과
 result boolean

결과

케이스 첨부 파일 다운로드

작업 ID:
DownloadCaseFile

문서와 관련된 첨부 파일을 다운로드합니다.

매개 변수

Name 키 필수 형식 Description
프로젝트별 ID
 ticketId True string

레코드의 코드
첨부 파일 식별자
 fileId True integer

첨부 파일의 식별자를 나타냅니다.

반환

첨부 파일의 내용입니다.

파일 콘텐츠
binary

정의

이진법

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