파일 노드를 사용하여 구성 데이터 모델의 파일 관리

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분
  • 앱의 CDM 구성 데이터 모델 또는 구성요소 라이브러리에서 파일 노드를 사용하여 파일을 추가하고 관리합니다.

    시작하기 전에

    중요사항:
    DevOps 구성 은 이제 더 이상 지원되지 않으며 새로운 활성화에 사용할 수 없습니다.

    필요한 역할: cdm_editor 또는 cdm_admin

    이 태스크 정보

    적용 가능한 노드에 파일을 첨부하면 해당 노드 아래에 파일 노드가 생성됩니다. 파일 노드에는 구성 데이터를 저장하는 첨부 파일에 대한 링크가 포함되어 있습니다. 예를 들어 속성 파일 또는 로고 이미지 파일이 있습니다.
    • 앱에서 구성요소, 컬렉션 또는 배포 가능 항목 폴더 아래의 노드에 파일 노드를 추가할 수 있습니다. 컬렉션에 구성요소를 포함하고 앱의 배포 가능 항목에 컬렉션을 포함할 때에도 구성요소의 파일 노드가 포함됩니다. 다른 구성 데이터 항목과 마찬가지로 수집 또는 배포 가능 수준에 포함된 파일 노드를 재정의할 수 있습니다.
    • 구성요소 라이브러리에서 공유 구성요소 아래의 노드에 파일 노드를 추가할 수 있습니다. 공유 구성요소가 앱에서 사용되는 경우 파일 노드는 첨부된 파일과 함께 복사됩니다.
    앱 개발자와 앱의 작성 그룹 구성원은 파일 노드에 액세스하고 첨부된 파일을 다운로드할 수도 있습니다. 파일의 내용을 수동으로 확인한 다음 스냅샷을 게시할 수 있습니다. DevOps 사용자는 URL이 있는 파일 노드를 포함하여 확인된 구성 데이터를 익스포트가 실행된 인스턴스에서 ServiceNow 호스팅된 첨부 파일로 익스포트할 수 있습니다.

    프로시저

    1. 다음으로 이동 모두 > DevOps Config > DevOps 구성 작업 공간.
    2. DevOps 구성 앱 또는 구성요소 라이브러리를 열어 구성 데이터 모델에 파일 노드를 추가합니다.
      옵션단계
      앱에서 파일 노드 추가
      1. 왼쪽 탐색 창에서 앱 아이콘( DevOps 구성 앱 아이콘)을 선택합니다.
      2. 애플리케이션 목록에서 앱을 선택합니다.
      3. 구성 데이터 편집을 선택하여 변경 세트를 엽니다.
      구성요소 라이브러리에 파일 노드 추가
      1. 왼쪽 탐색 창에서 구성요소 라이브러리 아이콘( 구성요소 라이브러리 아이콘.)을 선택합니다.
      2. 구성요소 라이브러리를 선택하여 열거나 생성합니다.
      3. 편집을 선택하여 변경 세트를 엽니다.
      구성 데이터 탭이 선택된 상태로 변경 세트가 열립니다.
    3. 구성 데이터 트리에서 파일 노드를 추가할 노드 옆에 있는 추가 작업 아이콘( 추가 작업 아이콘)을 선택한 다음 메뉴에서 파일 추가 를 선택합니다.
      주:
      앱에서 구성 요소, 컬렉션 또는 배포 가능 항목 아래의 노드에 파일 노드를 추가할 수 있지만 앱의 구성 요소, 컬렉션 또는 배포 폴더에 직접 추가할 수는 없습니다. 공유 라이브러리에서 공유 구성요소 아래의 노드에 파일 노드를 추가할 수 있습니다.
    4. 파일을 추가하여 파일 노드를 생성합니다.
      1. 파일 추가 대화 상자에서 시스템에서 파일을 찾아 선택하고 파일 추가를 선택합니다.
        에서 지원하는 ServiceNow AI Platform MIME 형식 파일을 추가할 수 있으며, 최대 파일 크기는 5MB입니다.
      2. 노드 이름 필드에 파일 노드의 이름을 입력합니다.
        기본적으로 첨부 파일 이름은 파일 노드 이름으로 채워집니다. 콘텐츠 유형 필드는 첨부된 파일의 콘텐츠 유형으로도 채워집니다.
      3. 파일 추가를 선택합니다.
      파일 노드가 선택한 노드에 추가됩니다. 구성 데이터 트리에서 파일 노드를 선택하여 파일 정보 창에 해당 메타데이터를 표시하고 파일 내용 창에서 파일의 내용을 미리 봅니다.
      주:
      컨텐츠 미리 보기는 다음과 같은 MIME 유형의 파일에 사용할 수 있습니다. text/yaml, text/css, text/csv, text/html,text/javascript,text/plain,text/richtext,text/x-vcard,text/x-vcalendar,application/xml,application/javascript,application/json. 추가 MIME 형식 파일의 컨텐츠를 보려면 해당 파일을 시스템 속성 sn_cdm.attachment.display_mime_types에 쉼표로 구분된 목록으로 추가합니다. 오디오, 이미지 및 비디오와 같은 이진 파일 MIME 형식에는 미리 보기를 사용할 수 없습니다.

      구성요소 노드에 추가된 파일 노드입니다.

    5. 옵션: 파일 노드가 구성 데이터에 추가된 후 파일 노드 또는 그 안의 파일 첨부 파일에서 다음 작업을 수행할 수 있습니다.
      주:
      파일 노드 또는 파일 첨부에 대한 모든 작업은 파일 노드의 추가 작업 메뉴를 통해서만 수행할 수 있습니다.
      작업단계
      파일 노드 이름 바꾸기
      1. 파일 노드 옆에 있는 추가 작업 아이콘을 선택한 다음 메뉴에서 이름 바꾸 기를 선택합니다.
      2. 이름 바꾸기 대화 상자의 노드 이름 필드에 파일 노드의 새 이름을 입력합니다.

      파일 노드가 컬렉션에 포함되어 있으면 컬렉션에서도 이름이 바뀝니다.

      변수 추출
      1. 파일 노드 옆에 있는 추가 작업 아이콘을 선택한 다음 메뉴에서 변수 추출을 선택합니다.
      2. 변수 추출 대화 상자에서 변수를 추출할 파일 경로를 지정합니다.

      @@<variableName>@@으로 태그가 지정된 파일 노드의 모든 변수가 지정한 파일 경로로 추출됩니다. 그런 다음 파일 경로도 포함하도록 변수가 수정됩니다.

      그런 다음 추출된 모든 변수를 해결할 수 있습니다. 추출한 변수를 정의한 다음 양식 컨텍스트 메뉴에서 변수 적용 을 선택합니다. 이 동작은 파일 컨텐츠에서 추출된 모든 변수를 정의된 변수 값으로 바꿉니다.

      파일 노드 삭제
      1. 파일 노드 옆에 있는 추가 작업 아이콘을 선택한 다음 메뉴에서 삭제를 선택합니다.
      2. 삭제 팝업에서 삭제를 선택합니다.
      파일 노드를 삭제하면 해당 노드와 파일 첨부 파일에 다음과 같은 영향이 있습니다.
      • 파일 노드가 컬렉션에 포함되면 컬렉션에서도 삭제됩니다. 재정의된 파일 노드는 직접 파일 노드가 됩니다.
      • 아직 커밋되지 않은 현재 열려 있는 변경 집합에서 파일 노드가 만들어지면 파일 노드와 해당 파일 첨부 파일이 영구적으로 삭제됩니다.
      • 파일 노드가 이전에 커밋된 변경 집합에서 만들어지고 현재 열려 있는 변경 집합에서 삭제된 경우 파일 노드는 구성 데이터에서 삭제되지만 파일 첨부 파일은 시스템에 남아 있습니다.
      첨부 파일 다운로드 파일 노드 옆에 있는 추가 작업 아이콘을 선택한 다음 메뉴에서 파일 다운로드 를 선택합니다.

      또는 파일 노드를 선택한 다음 파일 정보 창에서 다운로드 를 선택하여 파일을 다운로드할 수 있습니다.

      첨부 파일 바꾸기
      1. 파일 노드 옆에 있는 추가 작업 아이콘을 선택한 다음, 메뉴에서 파일 바꾸기를 선택합니다.
      2. 파일 바꾸기 대화 상자에서 시스템에서 파일을 첨부하고 파일 바꾸기를 선택합니다.
      포함된 파일 노드 재정의 파일 노드가 컬렉션 및 배포 가능 항목에 포함된 경우 첨부된 파일을 새 파일로 대체하여 재정의할 수 있습니다.
      1. 컬렉션 또는 배포 가능 폴더에 포함된 파일 노드 옆에 있는 추가 작업 아이콘을 선택한 다음, 메뉴에서 파일 바꾸기를 선택합니다.
      2. 파일 바꾸기 대화 상자에서 시스템에서 파일을 첨부하고 파일 바꾸기를 선택합니다.