キャンバス アプリから SharePoint に接続します。Connect to SharePoint from a canvas app

SharePoint

カスタムの一覧からアプリを自動的に生成する SharePoint サイトに接続するか、既存のアプリにデータを追加したり、アプリをゼロから作成する前に、接続を作成します。Connect to a SharePoint site to generate an app automatically from a custom list, or create a connection before you add data to an existing app or build an app from scratch.

によって、データが存在するいずれかまたは両方の手法を実行できます。Depending on where your data resides, you can take either or both of these approaches:

  • SharePoint Online サイトまたはオンプレミス サイトでは、カスタムの一覧からデータを表示します。Show data from a custom list in a SharePoint Online site or an on-premises site.
  • イメージを表示し、(SharePoint Online のみ) ライブラリのビデオまたはオーディオ ファイルを再生します。Show images and play video or audio files in a library (SharePoint Online only).

アプリを生成するGenerate an app

PowerApps には、カスタム リストでデータを管理する場合は、 3 画面アプリを自動的に生成します。If you want to manage data in a custom list, PowerApps can generate a three-screen app for you automatically. ユーザーは、最初の画面で一覧を参照して、2 番目の画面で項目の詳細を表示、作成、または 3 番目の画面で項目を更新できます。Users can browse the list on the first screen, show details of an item in the second screen, and create or update items in the third screen.

注意

SharePoint リストに含まれている場合、選択肢ルックアップ、またはユーザーまたはグループ列を参照してくださいギャラリーでデータを表示するこのトピックで後述します。If your SharePoint list contains a Choice, Lookup, or Person or group column, see Show data in a gallery later in this topic.

接続を作成するCreate a connection

  1. PowerApps にサインインを選択しますデータ > 接続左側のナビゲーション バーで、新しい接続近く、左上隅にあります。Sign in to PowerApps, select Data > Connections in the left navigation bar, and then select New connection near the upper-left corner.

    データを選択 >、左側のナビゲーション バーでの接続および左上隅の近くの新しい接続を順に選択します。Select Data > Connections in the left navigation bar, and then select New connection near the upper-left corner.

  2. 右上隅の近くの検索ボックスに入力するか貼り付けますSharePoint、し、 SharePointします。In the search box near the upper-right corner, type or paste SharePoint, and then select SharePoint.

    右上隅の近くの検索ボックスには、入力または貼り付けます SharePoint、し、SharePoint を選択します。In the search box near the upper-right corner, type or paste SharePoint, and then select SharePoint.

  3. これらの一連の手順のいずれかを実行します。Perform either of these sets of steps:

    • SharePoint Online に接続するには、選択直接接続 (クラウド サービス) を選択します作成、(メッセージは表示) する場合に資格情報を提供します。To connect to SharePoint Online, select Connect directly (cloud services), select Create, and then provide credentials (if prompted).

      SharePoint Online に接続するには、直接接続 (クラウド サービス) を選択します。To connect to SharePoint Online, select Connect directly (cloud services)

      接続を作成すると既存のアプリにデータを追加またはアプリをゼロから作成できます。The connection is created, and you can add a data to an existing app or build an app from scratch.

    • オンプレミス サイトに接続するには、選択 、オンプレミス データ ゲートウェイを使用して接続します。To connect to an on-premises site, select Connect using on-premises data gateway.

      オンプレミス サイトに接続する、次のように選択します * * オンプレミス データ ゲートウェイを使用して接続)。To connect to on-premises site, select **Connect using on-premises data gateway)

      認証の種類として [Windows] を指定し、資格情報を入力します Specify Windows as the authentication type, and then specify your credentials. (資格情報にドメイン名が含まれる場合は、<ドメイン><エイリアス> 形式で入力します)。(If your credentials include a domain name, specify it as domain\alias.)

      資格情報を指定します。Specify credentials

      ゲートウェイを選択する、ゲートウェイを使用し、するを選択します作成です。Under Choose a gateway, select the gateway that you want to use, and then select Create.

      注意

      インストールされているオンプレミス データ ゲートウェイがあるない場合いずれかをインストール、し、ゲートウェイの一覧を更新するアイコンを選択します。If you don't have an on-premises data gateway installed, install one, and then select the icon to refresh the list of gateways.

      ゲートウェイを選択します。Choose gateway

      接続を作成すると既存のアプリにデータを追加またはアプリをゼロから作成できます。The connection is created, and you can add a data to an existing app or build an app from scratch.

既存のアプリにデータを追加します。Add data to an existing app

  1. PowerApps Studio では、更新、オンにするアプリを開きます、ビュー 、タブを選びデータソースします。In PowerApps Studio, open the app that you want to update, select the View tab, and then select Data sources.

    データ ソースを選択し、表示 タブOn the View tab, and then select Data sources

  2. データペインで、データ ソースの追加 > SharePointします。In the Data pane, select Add data source > SharePoint.

  3. SharePoint サイトへの接続、内のエントリを選択、最近使ったサイトリスト (または型または貼り付けを使用するサイトの URL)、し、 Connectします。Under Connect to a SharePoint site, select an entry in the Recent sites list (or type or paste the URL for the site that you want to use), and then select Connect.

    サイトを選択します。Select site

  4. 一覧の選択、チェック ボックスをオンドキュメントまたは 1 つまたは複数のリストを使用し、するConnect:Under Choose a list, select the check box for Documents or one or more lists that you want to use, and then select Connect:

    一覧 の ドキュメントのチェック ボックスまたは、使用する 1 つ以上のリストを選択し、接続を選択Under Choose a list, select the check box for Documents or one or more lists that you want to use, and then select Connect

    すべての種類のリストが既定で表示されるわけではありません。Not all types of lists appear by default. PowerApps ではカスタム リストはサポートされますが、テンプレート ベースのリストはサポートされません。PowerApps supports custom lists, not template-based lists. 使用するリストの名前が表示されない場合、一番下までスクロールし、ボックスが含まれているリストの名前を入力カスタム テーブル名の入力します。If the name of the list that you want to use doesn't appear, scroll to the bottom, and then type the name of the list in the box that contains Enter custom table name.

    カスタム リスト名を入力するボックスで、リストの名前を入力します。Type the name of the list in the box that contains Enter a custom list name.

    データ ソースまたはソースは、アプリに追加されます。The data source or sources are added to your app.

ゼロからアプリをビルドします。Build your own app from scratch

概念を適用アプリをゼロから作成Excel ではなく SharePoint にします。Apply the concepts in Create an app from scratch to SharePoint instead of Excel.

カスタム リストがこのような列が含まれる場合にデータを表示、ギャラリーコントロール、数式バーを使用して、テキストプロパティを 1 つ以上のラベルそのギャラリー コントロール:If your custom list contains any of these types of columns, show that data in a Gallery control by using the formula bar to set the Text property of one or more Label controls in that gallery:

  • 選択肢またはルックアップ列指定ThisItemColumnNameします。値その列のデータを表示します。For a Choice or Lookup column, specify ThisItem.ColumnName.Value to show data in that column.

    たとえば、Location という名前の選択肢列がある場合は「ThisItem.Location.Value」と指定し、PostalCode という名前のルックアップ列がある場合は「ThisItem.PostalCode.Value」と指定します。For example, specify ThisItem.Location.Value if you have a Choice column named Location, and specify ThisItem.PostalCode.Value if you have a Lookup column named PostalCode.

  • ユーザーまたはグループ列指定ThisItemColumnNameします。DisplayNameユーザーまたはグループの名前を表示します。For a Person or Group column, specify ThisItem.ColumnName.DisplayName to show the display name of the user or the group.

    たとえば、Manager という名前のユーザーまたはグループ列の名前を表示する場合は、「ThisItem.Manager.DisplayName」と指定します。For example, specify ThisItem.Manager.DisplayName to show display names from a Person or Group column named Manager.

    メール アドレスや役職など、ユーザーに関する別の情報を表示することもできます。You can also show different information about users, such as email addresses or job titles. オプションの完全な一覧を表示するには指定ThisItemColumnNameします。To display a complete list of options, specify ThisItem.ColumnName. (末尾はピリオドを含む)。(including the trailing period).

    注意

    CreatedBy列指定ThisItem.Author.DisplayNameの一覧で項目を作成したユーザーの表示名を表示します。For a CreatedBy column, specify ThisItem.Author.DisplayName to show the display names of users who created items in the list. ModifiedBy 列のリストの項目を変更したユーザーの表示名を表示するには、「ThisItem.Editor.DisplayName」と指定します。For a ModifiedBy column, specify ThisItem.Editor.DisplayName to show the display names of users who changed items in the list.

  • Managed Metadata列指定ThisItemColumnNameします。ラベルその列のデータを表示します。For a Managed Metadata column, specify ThisItem.ColumnName.Label to show data in that column.

    たとえば、Languages という名前の 管理されたメタデータ列がある場合は「ThisItem.Languages.Label」と指定します。For example, specify ThisItem.Languages.Label if you have a Managed Metadata column named Languages.

ライブラリからデータを表示Show data from a library

追加できるかどうか、SharePoint ライブラリにいくつかのイメージがある、ドロップダウンユーザーに表示するイメージを指定できるように、アプリを制御します。If you have several images in a SharePoint library, you can add a Drop down control to your app so that users can specify which image to show. 適用することも、同じ原則、他のコントロールになどギャラリーコントロール、および他の種類のビデオなどのデータ。You can also apply the same principles to other controls, such as Gallery controls, and other types of data, such as videos.

  1. 既に、していない場合は接続を作成、し既存のアプリにデータを追加します。If you haven't already, create a connection, and then add data to an existing app.

  2. 追加、ドロップダウン制御、および名前を付けますImageListします。Add a Drop down control, and name it ImageList.

  3. 設定、項目プロパティのImageListドキュメントします。Set the Items property of ImageList to Documents.

  4. プロパティオープンの右側のウィンドウのタブ、、一覧表示し、名前します。On the Properties tab of the right-hand pane, open the Value list, and then select Name.

    ライブラリ内のイメージのファイル名が表示されるImageListします。The file names of the images in your library appear in ImageList.

    イメージの一覧List of images

  5. 追加、イメージを制御して、設定、イメージプロパティをこの式に。Add an Image control, and set its Image property to this expression:

    ImageList.Selected.'Link to item'

  6. F5 キーを押すし、別の値を選択ImageListします。Press F5, and then select a different value in ImageList.

    指定したイメージが表示されます。The image that you specified appears.

    サンプル イメージSample image

できますサンプル アプリをダウンロードを SharePoint ライブラリからデータを表示するより複雑な方法を示しています。You can download a sample app that demonstrates a more complex approach to showing data from a SharePoint library.

  1. アプリをダウンロードした後に開くPowerApps Studioを選択します開く左側のナビゲーション バーで、参照After you download the app, open PowerApps Studio, select Open in the left navigation bar, and then select Browse.
  2. 開くダイアログ ボックスの検索しダウンロードしたファイルを開き、このトピックの最初の 2 つの手順に従ってデータ ソースとして SharePoint ライブラリを追加します。In the Open dialog box, find and open the file that you downloaded, and then add a SharePoint library as a data source by following the first two procedures in this topic.

注意

既定では、このアプリが表示されます委任の警告は、ライブラリには、500 未満の項目が含まれている場合無視できます。By default, this app shows delegation warnings, but you can ignore them if your library contains fewer than 500 items.

この単一画面アプリでは、左上隅にある一覧には、ライブラリ内のすべてのファイルが表示されます。In this one-screen app, the list in the lower-left corner shows all files in your library.

  • 入力または貼り付けるいずれかのファイルを検索できます。 または検索ボックスに使用できる文字は、上部します。You can search for a file by typing or pasting one or more characters in the search box near the top.
  • ライブラリにフォルダーが含まれている場合は、タイトル バーのすぐ下のフォルダーの一覧で、フィルターのアイコンを選択して、ファイルの一覧をフィルターできます。If your library contains folders, you can filter the list of files by selecting a filter icon in the list of folders just under the title bar.

ファイルが見つかったら、選択で表示するよう、ビデオイメージ、またはオーディオに沿って、右側にあるコントロール。When you find the file that you want, select it to show it in the Video, Image, or Audio control along the right-hand side.

サンプル イメージSample image

既知の問題Known issues

一覧表示します。Lists

PowerApps はスペースが含まれている列名を読み取ることができますが、スペースは 16 進数のエスケープ コードに置き換えられます "_x0020_" します。PowerApps can read column names that contain spaces, but the spaces are replaced with the hexadecimal escape code "_x0020_". たとえば、SharePoint の "Column Name" は、PowerApps のデータ レイアウトに表示されるときや数式で使用されるときは "Column_x0020_Name" と表示されます。For example, "Column Name" in SharePoint will appear as "Column_x0020_Name" in PowerApps when displayed in the data layout or used in a formula.

列のすべての種類はサポートされているし、列のすべての種類は、あらゆる種類のカードをサポートします。Not all types of columns are supported, and not all types of columns support all types of cards.

列の種類Column type サポートSupport 既定のカードDefault cards
1 行テキストSingle line of text はいYes テキストの表示View text
複数行テキストMultiple lines of text はいYes View textView text
選択肢Choice はいYes ルックアップの表示View lookup
ルックアップの編集Edit lookup
複数選択の表示View multiselect
複数選択の編集Edit multiselect
NumberNumber はいYes パーセンテージの表示View percentage
評価の表示View rating
View textView text
通貨Currency はいYes パーセンテージの表示View percentage
評価の表示View rating
View textView text
日付と時刻Date and Time はいYes View textView text
ルックアップLookup はいYes ルックアップの表示View lookup
ルックアップの編集Edit lookup
複数選択の表示View multiselect
複数選択の編集Edit multiselect
ブール値 (はい/いいえ)Boolean (Yes/No) はいYes View textView text
トグルの表示View toggle
人物またはグループPerson or Group はいYes ルックアップの表示View lookup
ルックアップの編集Edit lookup
複数選択の表示View multiselect
複数選択の編集Edit multiselect
ハイパーリンクHyperlink はいYes URL の表示View URL
View textView text
画像Picture はい (読み取り専用)Yes (read-only) 画像の表示View image
View textView text
添付ファイルAttachment はい (読み取り専用)Yes (read-only) 添付ファイルの表示View Attachments
集計値Calculated はい (読み取り専用)Yes (read-only)
タスクの結果Task Outcome いいえNo
外部データExternal data いいえNo
管理されたメタデータManaged Metadata はい (読み取り専用)Yes (read-only)
評価Rating いいえNo

ライブラリLibraries

  • PowerApps からライブラリにファイルをアップロードすることはできません。You can't upload files from PowerApps to a library.
  • PDF ビューアー コントロールでは、ライブラリから PDF ファイルを表示できません。You can't show PDF files from a library in a PDF Viewer control.
  • PowerApps Mobile をサポートしていない、ダウンロード関数。PowerApps Mobile doesn't support the Download function.
  • 場合は、ユーザーは、PowerApps Mobile または Windows 10 アプリでアプリを実行するを使用して、起動ギャラリーでライブラリのコンテンツを表示する関数。If your users will run the app in PowerApps Mobile or the Windows 10 app, use the Launch function to display library content in a gallery.

次の手順Next steps