ProductInstance – generatePID(String className, String modelCategorySysId, Object jsonKeyValues)

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기3분

    • 제품 인스턴스의 해시된 값을 생성하고 반환한 후 반환합니다.

    이 메서드는 호출 응용 프로그램의 성능에 영향을 주지 않고 여러 번 호출할 수 있습니다. 이 메서드는 데이터베이스의 데이터를 수정하지 않고 PID를 계산하는 데 필요한 데이터를 캐시합니다.

    PID는 제품 인스턴스 식별자 구성 [product_instance_identifier_configuration] 테이블에 정의된 다음 항목을 기반으로 생성됩니다.
    • PID 구성(읽기 전용)
    • 각 구성에 할당된 순서
    Product Instance feature in Hardware Asset Management 또한 참조하십시오.
    표 1. 매개변수
    이름 유형 설명
    Classname 문자열 작성할 PID의 테이블 이름입니다.
    modelCategorySysId 문자열 모델 범주 [cmdb_model_category] 테이블의 모델 범주 sys_id입니다. 자세한 내용은 Model categories 문서를 참조하십시오.
    jsonKeyValues 객체 제품 인스턴스 식별자 구성 [product_instance_identifier_configuration] 테이블에서 구성된 PID 매개변수의 JSON 키-값 쌍입니다.

    키 값 쌍에는 해당 값이 있는 속성 이름이 포함됩니다. 이러한 값은 PID에 대해 정의된 구성 속성에 따라 달라집니다.
    표 2. 반환
    유형 설명
    객체 PID를 생성하는 데 사용되는 정보입니다.
    객체는 다음 조건에서 빈 product_instance_id 속성 값으로 반환됩니다.
    • PID에 필수 PID 구성 속성이 없습니다. PID 구성은 제품 인스턴스 식별자 구성 [product_instance_identifier_configuration] 테이블에 있습니다.
    • 지정된 클래스에 연결된 제품 인스턴스가 없습니다.
    {
  "model_category_sysId": "String",
  "parameters": [Array],
  "product_instance_id": "String"
}
    <Object>.model_category_sysId 모델 범주 [cmdb_model_category] 테이블의 제품 범주 sys_id입니다.

    이 값은 모델 범주 계층 구조가 PID를 생성하는 데 사용된 경우 입력 값과 다를 수 있습니다.

    데이터 유형: 문자열
    <Object>.매개 변수 PID를 생성하는 데 사용되며 제품 인스턴스 식별자 구성 [product_instance_identifier_configuration] 테이블에 정의된 매개변수 목록입니다.

    데이터 유형: 문자열 배열
    <Object>.product_instance_id 자산, CI 또는 설치 기반 항목의 product_instance_id 필드에 있는 PID입니다.
    이 속성에서 PID의 해시된 값을 설정하여 다음 테이블 중 하나의 객체에서 공통 값을 동기화할 수 있습니다.
    • 자산 [alm_asset]
    • 구성 항목 [cmdb_ci]
    • 설치 기반 항목 [sn_install_base_item]
    설치 기반 항목에는 Customer Service com.snc.install_base(설치 기반 관리) 플러그인이 필요합니다.

    데이터 유형: 문자열

    다음 예제에서는 의료 자산 [sn_ent_medical_asset] 테이블에서 자산에 대한 PID를 생성하는 방법을 보여줍니다. 이 테이블은 Customer Service com.snc.install_base(설치 기반 관리) 플러그인에 포함되어 있습니다.

    var output = sn_cmdb.ProductInstance.generatePID('sn_ent_medical_asset', '4b8aa89a77710110dd5fca22fe5a9984', { "serial_number" : "SN1001"});
gs.info(JSON.stringify(output,null,'\t'));

    출력:

    {
  "model_category_sysId": "4b8aa89a77710110dd5fca22fe5a9984",
  "product_instance_id": "tw8QgznsS4cP3b4U0+rSbnbIWxirYpeVSquk3g81K/8=",
  "parameters": [
    "serial_number"
  ]
}