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

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기8분

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

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

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

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

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

    시작하기 전에

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

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

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

    필요한 역할: sp_admin 또는 admin

    프로시저

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

        복사 붙여넣기 및 끌어서 놓기 지원을 해제하려면 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" 지시문을 or <section> 요소의 속성 <div> 으로 추가합니다.
      영역에는 전체 위젯 또는 일부만 포함될 수 있습니다.
      <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. ng-if="isDesktopBrowser" 지시어를 sp-attachment-picker 지시어에 추가한다. 
        <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. ng-if="isDesktopBrowser" 지시어를 sp-attachment-picker 지시어에 추가한다. 
        <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에서는 첨부 파일 붙여넣기가 지원되지 않습니다.