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

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 8분

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

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

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

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

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

    시작하기 전에

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

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

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

    필요한 역할: sp_admin 또는 admin

    프로시저

    1. 다음으로 이동 모두 > 서비스 포털 > 서비스 포털 구성.
    2. 위젯 편집기를 선택합니다.
    3. Edit an existing widget(기존 위젯 편집) 메뉴에서 복제한 위젯을 선택합니다.
    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에서 지원되지 않습니다.