포털 페이지에서 기록에 파일 첨부

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 8분

    • 첨부 파일은 파일 시스템을 탐색하거나, 클립보드에서 파일을 붙여넣거나, 파일을 끌어서 놓아 포털 페이지에서 기록에 추가할 수 있습니다.

    기본적으로 여러 기본 시스템 위젯은 이러한 방법 중 하나 이상을 사용하여 포털 사용자의 첨부 파일을 수락합니다. 포털 사용자가 첨부 파일을 추가하는 방법을 수정하려면 다음 절차의 설명에 따라 위젯을 복제하고 편집하여 파일 첨부 환경을 사용자 지정할 수 있습니다.

    포털 사용자가 포털의 페이지에서 기록에 파일을 첨부하는 방법을 추적하려면 에서 SP 파일 첨부 이벤트를 사용량 인사이트 참조하십시오.서비스 포털 사용 가능한 이벤트에 대한 자세한 내용은 다음 문서를 참조하십시오 서비스 포털 이벤트.

    파일을 붙여넣거나 놓아 첨부 파일 추가

    포털 사용자가 첨부 파일 추가 대화 상자에서 파일을 붙여넣거나 놓아 파일을 첨부할 수 있도록 허용합니다.

    시작하기 전에

    기본적으로 양식, 티켓 첨부 파일, 티켓 대화 및 SC 카탈로그 항목 기본 시스템 위젯은 파일 시스템을 탐색하는 것만이 아니라 첨부 파일 추가 대화 상자에서 파일을 붙여넣거나 놓아 첨부 파일을 추가할 수 있도록 지원합니다.

    다른 위젯에 대해 이 기능을 구성하려면 sp-attachment-button 지시문을 사용하여 첨부 파일 추가를 지원하는 위젯을 복제하거나 만들 수 있습니다. 위젯 복제에 대한 자세한 내용은 다음 문서를 참조하십시오 위젯 복제.

    주:
    기본 시스템 위젯은 읽기 전용이므로 향후 업데이트를 활용할 수 있습니다. 변경하려면 기본 시스템 위젯을 복제할 수 있습니다. 그러나 복제된 위젯은 사용자 지정으로 간주되며 복제된 위젯에 대한 향후 업데이트의 이점을 얻지 못합니다.

    필요한 역할: sp_admin 또는 admin

    프로시저

    1. 다음으로 이동 모두 > 서비스 포털 > 서비스 포털 구성.
    2. 위젯 편집기를 선택합니다.
    3. 기존 위젯 편집 메뉴에서 복제한 위젯을 선택합니다.
    4. 위젯의 HTML 템플릿 에서 sp-attachment-button 요소를 찾습니다.
    5. sp-attachment-button 요소의 속성을 구성합니다.
      • modal: 예로 설정하면 복사-붙여넣기 및 끌어서 놓기 지원을 활성화합니다.

        복사-붙여넣기 및 끌어서 놓기 지원을 끄려면 false로 설정합니다.

      • supported-extensions: 첨부 파일 추가 대화 상자 하단에 첨부 파일에서 지원되는 파일 확장명 목록을 표시합니다.

        시스템 속성에 지정된 지원되는 파일 확장명을 glide.attachment.extensions 나열하려면 {{::d ata.supportedAttachmentExtensions}}로 설정합니다.

      <sp-attachment-button modal="true" supported-extensions="{{::data.supportedAttachmentExtensions}}"></sp-attachment-button>
    6. 저장을 선택합니다.

    결과

    위젯이 있는 페이지에서 다음 예와 같이 첨부 파일 추가 대화 상자 위에 파일을 붙여넣거나 놓아 기록에 첨부할 수 있습니다.

    주:
    이 기능은 모바일 환경에서 지원되지 않습니다. 첨부 파일 붙여넣기는 Firefox에서 지원되지 않습니다.

    첨부 파일 추가 대화 상자에서 파일을 선택, 놓기 또는 붙여넣는 옵션

    파일 첨부를 위한 끌어서 놓기 영역 추가

    포털 사용자가 페이지의 전용 영역에 첨부 파일을 놓아 기록에 파일을 빠르게 첨부할 수 있도록 허용합니다.

    시작하기 전에

    페이지에서 끌어서 놓기 첨부 파일 영역을 구성하려면 클라이언트 스크립트에서 nowAttachmentHandler 인스턴스로 설정된 attachmentHandler를 호출하여 첨부 파일 추가를 지원하는 위젯을 복제하거나 만들어야 합니다. 이와 같은 위젯의 예는 다음 양식 위젯문서를 참조하십시오. 위젯 복제에 대한 자세한 내용은 다음 문서를 참조하십시오 위젯 복제.

    주:
    기본 시스템 위젯은 읽기 전용이므로 향후 업데이트를 활용할 수 있습니다. 변경하려면 기본 시스템 위젯을 복제할 수 있습니다. 그러나 복제된 위젯은 사용자 지정으로 간주되며 복제된 위젯에 대한 향후 업데이트의 이점을 얻지 못합니다.

    필요한 역할: sp_admin 또는 admin

    이 태스크 정보

    기본적으로 포털 사용자는 첨부 파일 추가 아이콘(첨부 파일 아이콘)을 선택하여 첨부 파일 추가 대화 상자를 열면 여러 기본 시스템 페이지에 첨부 파일을 추가할 수 있습니다. 끌어서 놓기 첨부 파일 영역을 사용하면 포털 사용자가 적은 클릭으로 첨부 파일을 추가할 수 있습니다. 예를 들어 카탈로그 요청 또는 양식의 영역에 첨부 파일을 놓을 수 있습니다.

    이 예에서 영역은 양식 위젯의 본문 위에 있는 영역입니다. 영역은 파일을 그 위로 이동할 때만 표시됩니다.
    그림 1. 위젯 위의 첨부 파일 영역
    양식 위젯의 첨부 파일 영역 위로 파일 끌기

    프로시저

    1. 다음으로 이동 모두 > 서비스 포털 > 서비스 포털 구성.
    2. 위젯 편집기를 선택합니다.
    3. 기존 위젯 편집 메뉴에서 첨부 파일 영역을 추가할 복제한 위젯을 선택합니다.
    4. 위젯의 HTML 템플릿 에서 sp-attachment-picker attachment-handler="attachmentHandler" 지시문을 a <div> or <section> 요소의 속성으로 추가합니다.
      영역에는 위젯 전체 또는 일부만 포함될 수 있습니다.
      <div sp-attachment-picker attachment-handler="attachmentHandler">
    5. 옵션: sp-attachment-picker 지시문의 속성을 구성합니다.
      • disable-picker-overlay="true": 파일을 첨부 파일 영역 위로 드래그할 때 첨부 파일 영역 위에 오버레이가 표시되는 것을 끕니다. 기본적으로 오버레이는 사용 설정되어 있습니다.
      • onFilePick: 파일이 선택되면 이벤트를 트리거하여 사용자 지정 논리를 구현합니다. 선택한 모든 파일의 참조를 첫 번째 매개변수로 배열로 사용하는 함수로 값을 설정합니다. 예: on-file-pick="attachFiles($files)". 구현할 수 있는 사용자 지정 논리의 예로는 파일 미리 보기, 사용자 지정 확인 또는 사용자 지정 업로드 논리가 있습니다. 이 속성이 구성된 경우 attachment-handler="attachmentHandler" 속성이 필요하지 않으며 제거할 수 있습니다.
    6. 옵션: 모바일 장치에서 첨부 파일 영역을 숨깁니다.
      1. sp-attachment-picker 지시문에 ng-if="isDesktopBrowser" 지시문을 추가합니다. 
        <div sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser">
      2. 위젯의 클라이언트 스크립트 에서 다음 스크립트를 추가합니다. 
        $scope.isNative = cabrillo.isNative();
$scope.isMobileBrowser = spUtil.isMobile() && !$scope.isNative;
$scope.isDesktopBrowser = !$scope.isNative && !$scope.isMobileBrowser;
    7. 저장을 선택합니다.

    결과

    위젯이 있는 페이지에서 하나 이상의 선택한 파일을 첨부 파일 영역 위로 끌어다 놓아 기록에 첨부할 수 있습니다.

    위젯에 첨부 파일 섹션 추가

    포털 사용자가 위젯의 섹션에 있는 파일을 붙여넣거나, 놓거나, 탐색하여 기록에 파일을 빠르게 첨부할 수 있도록 허용합니다.

    시작하기 전에

    위젯에서 첨부 파일 섹션을 구성하려면 클라이언트 스크립트에서 nowAttachmentHandler 인스턴스로 설정된 attachmentHandler를 호출하여 첨부 파일 추가를 지원하는 위젯을 복제하거나 만들어야 합니다. 이와 같은 위젯의 예는 다음 양식 위젯문서를 참조하십시오. 위젯 복제에 대한 자세한 내용은 다음 문서를 참조하십시오 위젯 복제.

    주:
    기본 시스템 위젯은 읽기 전용이므로 향후 업데이트를 활용할 수 있습니다. 변경하려면 기본 시스템 위젯을 복제할 수 있습니다. 그러나 복제된 위젯은 사용자 지정으로 간주되며 복제된 위젯에 대한 향후 업데이트의 이점을 얻지 못합니다.

    필요한 역할: sp_admin 또는 admin

    이 태스크 정보

    기본적으로 포털 사용자는 첨부 파일 추가 아이콘(첨부 파일 아이콘)을 선택하여 첨부 파일 추가 대화 상자를 열면 여러 기본 시스템 페이지에 첨부 파일을 추가할 수 있습니다. 첨부 파일 섹션을 사용하면 포털 사용자가 적은 클릭으로 첨부 파일을 추가할 수 있습니다.

    이 예시에서는 첨부 파일 섹션이 카탈로그 항목 위젯 하단에 추가되었습니다.
    그림 2. 위젯의 첨부 파일 섹션
    카탈로그 항목 위젯 내에서 첨부 파일을 추가하는 섹션

    프로시저

    1. 다음으로 이동 모두 > 서비스 포털 > 서비스 포털 구성.
    2. 위젯 편집기를 선택합니다.
    3. 기존 위젯 편집 메뉴에서 첨부 파일 섹션을 추가할 복제한 위젯을 선택합니다.
    4. 위젯의 HTML 템플릿 에서 첨부 파일 섹션을 표시할 요소로 sp-attachment-picker 지시문을 추가합니다. 
      <sp-attachment-picker attachment-handler="attachmentHandler"></sp-attachment-picker>
    5. 옵션: sp-attachment-picker 지시문의 속성을 구성합니다.
      • disable-picker-overlay="true": 파일을 첨부 파일 섹션 위로 드래그할 때 첨부 파일 섹션 위에 오버레이 표시를 끕니다. 기본적으로 오버레이는 사용 설정되어 있습니다.
      • onFilePick: 파일이 선택되면 이벤트를 트리거하여 사용자 지정 논리를 구현합니다. 선택한 모든 파일의 참조를 첫 번째 매개변수로 배열로 사용하는 함수로 값을 설정합니다. 예: on-file-pick="attachFiles($files)". 구현할 수 있는 사용자 지정 논리의 예로는 파일 미리 보기, 사용자 지정 확인 또는 사용자 지정 업로드 논리가 있습니다.
    6. 옵션: 모바일 장치에서 첨부 파일 섹션을 숨깁니다.
      1. sp-attachment-picker 지시문에 ng-if="isDesktopBrowser" 지시문을 추가합니다. 
        <sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser"></sp-attachment-picker>
      2. 위젯의 클라이언트 스크립트 에서 다음 스크립트를 추가합니다. 
        $scope.isNative = cabrillo.isNative();
$scope.isMobileBrowser = spUtil.isMobile() && !$scope.isNative;
$scope.isDesktopBrowser = !$scope.isNative && !$scope.isMobileBrowser;
    7. 저장을 선택합니다.

    결과

    위젯이 있는 페이지에서 선택한 하나 이상의 파일을 첨부 파일 섹션 위에 붙여넣거나 놓아 기록에 첨부할 수 있습니다.

    주:
    첨부 파일 붙여넣기는 Firefox에서 지원되지 않습니다.