캔버스 앱에서 SharePoint 연결

SharePoint

SharePoint 사이트에 연결하여 사용자 지정 목록에서 자동으로 앱을 생성하거나 기존 앱에 데이터를 추가하거나 처음부터 앱을 빌드하기 전에 연결을 만듭니다.

데이터가 있는 위치에 따라 다음 방법 중 하나 또는 둘 다를 수행할 수 있습니다.

  • SharePoint 온라인 사이트 또는 온-프레미스 사이트의 사용자 지정 목록에서 데이터를 표시합니다.
  • 라이브러리에서 이미지를 표시하고 비디오 또는 오디오 파일을 재생합니다( SharePoint Online에서만 가능합니다).

앱 생성

사용자 지정 목록에서 데이터를 관리하려면 Power Apps는 자동으로 3 화면 앱 생성이 가능합니다. 사용자는 첫 번째 화면에서 목록을 찾아보고 두 번째 화면에서 항목의 세부 사항을 표시하며 세 번째 화면에서 항목을 작성하거나 업데이트할 수 있습니다.

참고

SharePoint 목록에 선택, 조회 또는 개인 또는 그룹 열이 포함된 경우 이 토픽의 뒷부분에 나오는 갤러리에 데이터 표시를 참조하십시오.

연결 만들기

  1. Power Apps에 로그인, 왼쪽 탐색 모음에서 데이터 > 연결 을 선택하고 왼쪽 상단 근처에서 새로운 연결 을 선택합니다.

    왼쪽 탐색 모음에서 데이터 > 연결을 선택하고 왼쪽 상단 근처에서 새로운 연결을 선택합니다.

  2. 오른쪽 상단에 있는 검색창에 SharePoint 를 입력하거나 붙여넣기한 다음 SharePoint 를 선택합니다.

    오른쪽 상단에 있는 검색창에 SharePoint를 입력하거나 붙여넣기한 다음 SharePoint를 선택합니다.

  3. 다음의 단계 세트 중 하나를 수행합니다.

    • SharePoint Online에 연결하려면 직접 연결(클라우드 서비스) 를 선택하고 만들기 를 누른 다음 자격 증명을 제공합니다(프롬프트가 표시되면).

      SharePoint Online에 연결하려면 직접 연결(클라우드 서비스)을 선택합니다

      연결이 생성되고 처음부터 앱을 빌드할 때 또는 기존 캔버스 앱에서 데이터 연결을 추가합니다.

    • 온-프레미스 데이터 게이트웨이를 사용하여 연결 을 선택하여 온-프레미스 SharePoint 사이트에 연결합니다.

      온-프레미스 데이터 게이트웨이를 사용하여 **연결

      인증 유형으로 Windows 를 지정한 다음 자격 증명을 지정합니다. 자격 증명에 도메인 이름이 포함된 경우 도메인\별칭 형식으로 지정합니다.

      자격 증명 지정

      게이트웨이 선택 아래, 사용하려는 게이트웨이를 선택한 다음 생성 을 선택합니다.

      참고

      온-프레미스 데이터 게이트웨이를 설치하지 않은 경우 하나를 설치한 다음 게이트웨이 목록을 새로 고침하는 아이콘을 선택합니다.

      게이트웨이 선택

      연결이 생성되고 처음부터 앱을 빌드할 때 또는 기존 캔버스 앱에서 데이터 연결을 추가합니다.

기존 앱에 데이터 추가

  1. Power Apps Studio에서 업데이트하려는 앱을 열고 보기 탭을 선택한 다음 데이터 원본 을 선택합니다.

    보기 탭에서, 데이터 원본을 선택합니다

  2. 데이터 창에서 데이터 원본 추가 > SharePoint 를 선택합니다.

  3. SharePoint 사이트에 연결 에서 최근 사이트 목록의 엔트리를 선택하고(또는 사용할 사이트의 URL을 입력하거나 붙여넣고) 연결 을 선택합니다.

    사이트 선택

  4. 목록 선택 에서 사용할 문서 또는 하나 이상의 목록에 대해 확인란을 선택한 다음 연결 을 선택합니다.

    목록 선택에서 사용할 문서 또는 하나 이상의 목록에 대해 확인란을 선택한 다음 연결을 선택합니다

    일부 목록 형식은 기본적으로 표시되지 않습니다. Power Apps는 탬플릿 기반 목록이 아닌 사용자 지정 목록을 지원합니다. 사용할 목록의 이름이 표시되지 않는 경우 아래쪽으로 스크롤한 다음 사용자 지정 목록 이름 입력 이 포함된 상자에 테이블 이름을 입력합니다.

    사용자 정의 목록 이름 입력을 포함하는 상자에 목록 이름을 입력

    데이터 원본 또는 원본이 앱에 추가됩니다.

처음부터 앱 빌드하기

처음부터 앱 만들기의 개념을 Excel 대신 SharePoint에 적용합니다.

사용자 지정 목록에 이러한 유형의 열이 포함된 경우 해당 데이터를 수식 입력줄을 사용하여 갤러리에서 하나 이상의 Label 컨트롤의 Text 속성을 설정하여 Gallery 컨트롤에 데이터를 표시합니다.

  • 선택 또는 조회 열에 대해 해당 열에 데이터를 표시하도록 ThisItem.ColumnName.Value 를 지정합니다.

    예를 들어 이름이 Location선택 열이 있으면 ThisItem.Location.Value 을, 이름이 PostalCode조회 열이 있으면 ThisItem.PostalCode.Value 를 지정합니다.

  • 개인 또는 그룹 열에 대해 ThisItem.ColumnName.DisplayName 을 지정하여 사용자 또는 그룹의 표시 이름을 표시합니다.

    예를 들어 이름이 Manager개인 또는 그룹 을 표시하려면 ThisItem.Manager.DisplayName 을 지정합니다.

    이메일 주소나 직함 등과 같은 다른 사용자 정보를 표시할 수도 있습니다. 전체 옵션 목록을 표시하려면 ThisItem.ColumnName. 을 지정합니다 (맨 마지막에 마침표 있음).

    참고

    참고: CreatedBy 열에 대해 목록에서 항목을 만든 사용자의 표시 이름을 표시하려면 ThisItem.Author.DisplayName 을 지정합니다. ModifiedBy 열에 대해 목록에서 항목을 변경한 사용자의 표시 이름을 표시하려면 ThisItem.Editor.DisplayName 을 지정합니다.

  • 관리되는 메타데이터 열에 대해 해당 열에 데이터를 표시하도록 ThisItem.ColumnName.Label 을 지정합니다.

    예를 들어 이름이 Languages관리되는 메타데이터 가 있으면 ThisItem.Languages.Label 을 지정합니다.

라이브러리에서 데이터 표시하기

SharePoint 라이브러리에 여러 이미지가 있는 경우 앱에 Drop down 컨트롤을 추가하여 사용자가 표시할 이미지를 지정할 수 있게 합니다. Gallery 컨트롤 및 기타 유형의 데이터(예: 비디오)와 같은 원칙을 다른 컨트롤에도 적용할 수 있습니다.

  1. 아직 하지 않았다면 연결 만들기기존 앱에 데이터 추가를 하는 것이 좋습니다.

  2. Drop down 컨트롤을 추가하고 ImageList 로 이름을 지정합니다.

  3. ImageListItems 속성을 Documents 로 설정합니다.

  4. 오른쪽 창의 속성 탭을 열고 Value 목록을 선택한 다음 이름 을 선택합니다.

    라이브러리에 있는 이미지의 파일 이름이 ImageList 로 나타납니다.

    이미지 목록

  5. Image 컨트롤을 추가하고 Image 속성을 다음 식으로 설정합니다.

    ImageList.Selected.'Link to item'

  6. F5를 누르고 ImageList 에서 다른 값을 선택합니다.

    지정한 이미지가 나타납니다.

    이미지 목록

SharePoint 라이브러리에서 데이터를 표시하는 것보다 더 복잡한 샘플 앱을 다운로드할 수 있습니다.

  1. 앱을 다운로드한 후 Power Apps Studio를 열고 왼쪽 탐색 모음에서 열기 를 선택한 후 탐색 을 선택합니다.
  2. 열기 대화 상자에서 다운로드한 파일을 찾아서 연 다음 SharePoint 라이브러리를 이 토픽의 첫 두 절차에 따라 데이터 원본으로 추가합니다.

참고

기본적으로이 이 앱은 위임 경고를 보여주지만 라이브러리에 500개 미만의 항목이 포함되어 있으면 무시해도 됩니다.

이 한 화면 앱에서 왼쪽 하단의 목록은 라이브러리의 모든 파일이 표시됩니다.

  • 상단 근처의 검색창에 하나 이상의 문자를 입력하거나 붙여넣어 파일을 검색할 수 있습니다.
  • 라이브러리에 폴더가 있는 경우 제목 표시줄 바로 아래의 폴더 목록에서 필터 아이콘을 선택하여 파일 목록을 필터링할 수 있습니다.

원하는 파일을 찾으면 파일을 선택하여 Video, Image, Audio 컨트롤을 오른쪽에 표시합니다.

샘플 이미지

알려진 문제

목록

Power Apps는 공백이 포함된 열의 이름을 읽을 수 있지만 공백은 16진수 이스케이프 코드 "_x0020_" 으로 대체됩니다. 예를 들어 SharePoint에서 "열 이름" 은 데이터 레이아웃에 표시되거나 수식에 사용될 때 Power Apps에서 "Column_x0020_Name" 으로 나타납니다.

일부 열 형식이 지원되지 않으며 일부 열은 모든 카드 형식을 지원하지 않습니다.

열 유형 지원 기본 카드
한 줄 텍스트 텍스트 보기
여러 줄 텍스트 텍스트 보기
선택 항목 조회 보기
조회 편집
다중 선택 보기(SharePoint Online에서만 가능)
다중 선택 편집(SharePoint Online에서만 가능)
번호 보기 백분율
보기 등급
텍스트 보기
통화 보기 백분율
보기 등급
텍스트 보기
날짜 및 시간 텍스트 보기
조회 조회 보기
편집 조회
다중 선택 보기
다중 선택 편집
부울(Yes/No) 텍스트 보기
보기 토글
개인 또는 그룹 조회 보기
조회 편집
다중 선택 보기
다중 선택 편집
하이퍼링크 보기 URL
텍스트 보기
그림 예 (읽기 전용) 보기 이미지
텍스트 보기
첨부 파일 예 (읽기 전용) 첨부 파일 보기
계산 예 (읽기 전용)
이미지 없음
작업 결과 없음
외부 데이터 없음
관리되는 메타데이터 예 (읽기 전용)
등급 없음

라이브러리

  • Power Apps에서 라이브러리로 파일을 업로드할 수 없습니다.
  • PDF 뷰어 컨트롤에서 라이브러리의 PDF 파일을 표시할 수 없습니다.
  • Power Apps 모바일은 Download 함수를 지원하지 않습니다.
  • Power Apps 모바일 또는 Windows 10 앱에서 사용자가 앱을 실행하는 경우 Launch 함수를 사용해 라이브러리 콘텐츠를 갤러리에 표시합니다.

SharePoint 문서 라이브러리 이미지가 간헐적으로 렌더링됨

SharePoint 문서 라이브러리에 저장된 이미지에 대한 링크가 있는 SharePoint 목록은 Power Apps 내부에서 인증 오류를 렌더링하지 못할 수 있습니다.

SharePoint에 대한 Power Apps 연걸은 일반적으로 SharePoint 사이트가 아닌 명시적으로 식별된 목록에서 이루어집니다. Power Apps는 외부 소스에 대한 외부 링크를 해결하려고 시도합니다. 인증이 필요하지 않거나 사용자가 이전에 참조된 SharePoint 사이트에 대해 인증한 경우 이러한 이미지 렌더링이 성공합니다. 그러나 일반적으로 모바일 장치의 Power Apps 사용자는 이미지의 참조된 SharePoint 사이트에 대해 인증을 받지 않았을 수 있습니다. 이 시나리오에서 SharePoint 문서 라이브러리의 이미지를 참조하기 위해 링크를 사용하는 것은 성공하지 못할 수 있습니다. 이 동작은 앱 내부의 문서 라이브러리에 대해 별도의 연결이 있는 경우에도 적용됩니다.

이러한 시나리오에 대한 솔루션으로 Azure Storage와 같은 CORS 지원 소스 또는 익명 액세스를 허용하는 Azure CDN과 같은 CDN 서비스에 이미지를 저장합니다.

다음 단계

참조

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).