スプレッドシートを使用してデータを追加する
Microsoft Excel スプレッドシートをアップロードして、アプリケーションにデータテーブルとレコードを追加します。
始める前に
必要なロール:admin、sn_app_eng_studio.user
手順
スプレッドシートをインポート
Microsoft Excel スプレッドシートをアップロードし、それを使用してアプリケーションデータモデルを作成します。
始める前に
- 水平列とそれぞれのヘッダーラベルでフォーマットされている
- XLSX ファイルタイプとして保存されている
必要なロール:admin、sn_app_eng_studio.user または委任開発者権限。詳細については、「AES を使用する開発者の委任」を参照してください。
手順
- 移動先 すべて > App Engine > App Engine Studio.
- [自分のアプリ] ページからアプリケーションを開きます。
-
[データ] 見出しの横にある追加アイコン (
) を選択します。
- [スプレッドシートをインポート] を選択した後、[続行] を選択します。
-
スプレッドシートをアップロードした後、[続行] を選択します。
スプレッドシートファイルを App Engine Studio にドラッグするか、コンピューターを参照できます。
-
次のいずれかのパスが表示されます。
- スプレッドシートのワークシートタブが 1 つしかない場合は、次のステップに進みます。
- スプレッドシートに複数のワークシートタブがある場合は、シートのリストが表示されて、そこから選択します。このシートのリストから、最初にアプリケーションにテーブルとして追加するワークシートタブを選択できます。
-
[テーブルヘッダーの行数を入力します] フィールドに、シートの列ヘッダーの行番号を入力します。
たとえば、ヘッダーが 2 行目にある場合は、「2」と入力します。
- オプション:
シートの列ヘッダーの下にある情報 (すなわちスプレッドシートのデータ) をアップロードするには、[スプレッドシートデータをインポート] オプションを選択します。
列ヘッダーのみをアップロードするには、このチェックボックスをオフのままにします。このテーブルをテンプレートとして使用し、他のデータを自分の AES テーブルに追加しない場合は、ヘッダーのみをアップロードします。
-
次のいずれかを選択します。
- 複数のワークシートタブを含む Excel ファイルをアップロードした場合は、[テーブルに変換します] を選択して、選択したワークシートタブをテーブルに変換してから、次のステップに進みます。
- 単一のワークシートタブを含む Excel ファイルをアップロードした場合は、[続行] を選択します。
ファイルのインポート先のオプションが表示されます。 -
スプレッドシートデータで何を実行するかに基づいて、次のいずれかの手順に移動して続行します。
オプション 説明 スプレッドシートのインポートから直接新しいテーブルを作成する 次の手順については、「スプレッドシートのインポートから新しいテーブルを作成する」を参照してください。 既存のテーブルを拡張して新しいテーブルを作成し、スプレッドシートのインポートを使用して更新する 次の手順については、「拡張可能なテーブルとスプレッドシートのインポートから新しいテーブルを作成する」を参照してください。 スプレッドシートのインポートを使用して既存のアプリケーションテーブルを更新する 次の手順については、「スプレッドシートのインポートを使用して既存のテーブルを変更する」を参照してください。
スプレッドシートのインポートから新しいテーブルを作成する
Microsoft Excel スプレッドシートのインポートから直接新しいテーブルを作成します。
始める前に
- スプレッドシートを App Engine Studio にインポートします。「スプレッドシートをインポート」を参照してください。
必要なロール:admin、sn_app_eng_studio.user または委任開発者権限。詳細については、「AES を使用する開発者の委任」を参照してください。
手順
-
スプレッドシートをインポート の説明に従ってスプレッドシートをアップロードした後、表示されたウィザードで、インポートされたデータで実行する処理を選択します。
図 : 1. スプレッドシートから新しいテーブルを作成する - [新しいテーブル] を選択します。
- [新テーブルの作成] を選択します。
- [続行] を選択します。
-
[オプションを展開します]ドロップダウンを使用してさらにプロパティを表示して、各列ヘッダーのプロパティを確認します。
列ヘッダープロパティ 説明 フィールドラベル 列の一意のラベル。 フィールド名 列のデータベース名。 タイプ 列に含まれる情報のタイプ。たとえば、列にプレーンテキストを含める場合は、[文字列] を選択します。
選択したタイプによっては、他のフィールドに入力してテーブル列をさらに定義します。たとえば、[文字列] を選択した場合は、文字列入力の文字数制限を定義します。または、[選択肢] を選択した場合は、ユーザーが選択できる選択肢を定義します。
「Field types」を参照してください。
文字数制限 格納できる文字列の最大長。
表示 その列をテーブルの表示値として設定するオプション。 参照フィールドには、参照先のテーブルの表示値が表示されます。たとえば、タスクテーブルの [オープン者 (Opened by)] 列はユーザーテーブルを参照します。ユーザーテーブルの表示値はユーザー名であるため、[オープン者 (Opened by)] フィールドには「Beth Anglin」や「Joe Employee」のように表示されます。表示値を選択するときは、個々のレコードの適切なタイトルとして機能するテーブル列を選択します。
テーブルの表示値として機能できるのは 1 つの列のみです。
必須 新しいレコードを保存する前に、その列が値を持つ必要があるかどうかのオプション。 テーブルに別の列を追加するには、[新しいフィールドを追加] を選択します。
列を削除するには、ごみ箱アイコン (
) を選択します。
- [続行] を選択してテーブルのプロパティを定義します。
-
フォームのフィールドに入力します。
フィールド 説明 テーブル ラベル テーブルを識別する一意のラベル。 テーブル名 テーブルのデータベース名。テーブルラベルを入力すると、列名が自動的に作成されます。必要に応じてその名前を編集できます。 拡張性を高める 他のテーブルがこのテーブルのデータを共有できるようにするオプション。テーブルの拡張の詳細については、「テーブル拡張」を参照してください。 自動番号 一意の番号でテーブルレコードを追跡するオプション。このオプションを選択する場合は、[プリフィックス]、[開始番号]、および [桁数] を定義します。 プリフィックス レコード番号の先頭に追加するテーブルの省略名。たとえば、「Laptop」テーブルを作成する場合、プリフィックスは「LPTP」または「LT」のようになります。
開始番号 テーブルに作成された最初のレコードを識別する番号。
桁数 レコード番号の最大桁数。この値は、最大のレコード番号を決定します。たとえば、「7」と入力した場合、最大値は 9999999 です。
- [続行] を選択します。
-
既存のロールに対して、新規ロールを追加したり、作成、読み取り、書き込み、削除権限を必要に応じて定義することで、このテーブルのコンテンツを作成、読み取り、書き込み、および削除するアクセス権を持つユーザーを制御します。
テーブルで作成したロールはアプリケーション全体で保持され、追加した他のテーブルでさらに定義できます。セキュリティ権限の仕組みの詳細については、「アプリケーションセキュリティの追加」を参照してください。
注:テーブルをプレビューするには、少なくとも 1 つのロールに読み取りアクセス権が必要です。 - [続行] を選択して、スプレッドシートから作成した新しいテーブルをアプリに追加します。
- オプション:
ファイルに複数のワークシートタブが含まれている場合は、残りのワークシートを変換します。
- 注:変換するシートごとに [テーブルに変換] を選択し、この手順の手順を繰り返すか、追加のワークシートに対して別の経路を選択する必要があります (手順については 拡張可能なテーブルとスプレッドシートのインポートから新しいテーブルを作成する または スプレッドシートのインポートを使用して既存のテーブルを変更する を参照)。
- 複数のワークシートがない場合は、次の手順に進みます。
-
サマリー画面で、[完了] を選択します。
または、テーブルビルダー でテーブルを表示するには、サマリー画面で [テーブルの編集] を選択します。
次のタスク
テーブルビルダー でのデータテーブルの編集の詳細については、「テーブルビルダー」を参照してください。
拡張可能なテーブルとスプレッドシートのインポートから新しいテーブルを作成する
既存のテーブルを拡張して新しいテーブルを作成し、Microsoft Excel スプレッドシートのインポートを使用して更新またはカスタマイズします。
始める前に
- スプレッドシートを App Engine Studio にインポートします。「スプレッドシートをインポート」を参照してください。
必要なロール:admin、sn_app_eng_studio.user、データのインポートとマッピングのオプションを表示するには、「統合」の委任開発者権限が必要です。詳細については、「AES を使用する開発者の委任」を参照してください。
手順
-
スプレッドシートをインポート の説明に従ってスプレッドシートをアップロードした後、表示されたウィザードでファイルをインポートする場所を選択します。
図 : 2. 新しいデータテーブルへのインポート - [新しいテーブル] を選択します。
- [拡張可能なテーブルから作成] を選択します。
- [続行] を選択します。
-
既存の [テーブル] を検索して、そのテーブルのデータをアプリに追加し、分岐ロジックを使用して拡張を作成します。
注:既にアプリにあるテーブルがリストの最初に表示され、次に推奨される Now Platform テーブルが、テーブルに格納されている情報のタイプの簡単な説明とともに表示されます。
- [続行] を選択します。
-
フォームのフィールドに入力します。
フィールド 説明 テーブル ラベル テーブルを識別する一意のラベル。 テーブル名 テーブルのデータベース名。テーブルラベルを入力すると、列名が自動的に作成されます。必要に応じてその名前を編集できます。 拡張性を高める 他のテーブルがこのテーブルのデータを共有できるようにするオプション。テーブルの拡張の詳細については、「テーブル拡張」を参照してください。 自動番号 一意の番号でテーブルレコードを追跡するオプション。このオプションを選択する場合は、[プリフィックス]、[開始番号]、および [桁数] を定義します。 プリフィックス レコード番号の先頭に追加するテーブルの省略名。たとえば、「Laptop」テーブルを作成する場合、プリフィックスは「LPTP」または「LT」のようになります。
開始番号 テーブルに作成された最初のレコードを識別する番号。
桁数 レコード番号の最大桁数。この値は、最大のレコード番号を決定します。たとえば、「7」と入力した場合、最大値は 9999999 です。
- [続行] を選択します。
-
既存のロールに対して、新規ロールを追加したり、作成、読み取り、書き込み、削除権限を必要に応じて定義することで、このテーブルのコンテンツを作成、読み取り、書き込み、および削除するアクセス権を持つユーザーを制御します。
テーブルで作成したロールはアプリケーション全体で保持され、追加した他のテーブルでさらに定義できます。セキュリティ権限の仕組みの詳細については、「アプリケーションセキュリティの追加」を参照してください。
注:テーブルをプレビューするには、少なくとも 1 つのロールに読み取りアクセス権が必要です。 -
[続行] を選択します。
注:これでテーブルにデータを格納する準備ができました。次のステップでは、インポートのフィールドが新しく拡張されたテーブルのフィールドと照合されます。マッピングを調整するか、インポートから新しいフィールドを作成することができます。
-
[続行] を選択してマッピングフィールドに進みます。
左側のソーススプレッドシートのフィールド列を、右側に作成した新しく拡張されたターゲットテーブルのフィールド列にマッピングできる画面が表示されます。
図 : 3. インポートされたフィールドのマッピング -
このステップでは、次の選択肢を使用できます。
オプション 説明 自動マッピングを使用したフィールドのバッチマッピング スプレッドシートのフィールドを選択したターゲットテーブルの表示されたフィールドに自動的にマッピングするには、[自動マッピング] を選択します。自動マッピングは、ソースエンティティを同様の名前のターゲットエンティティにマッピングします。既にマッピングされているターゲットエンティティの場合、[自動マッピング] を選択してもその値は変更されません。自動マッピングされたフィールドには、データピルに杖のアイコンがあります。 ドラッグアンドドロップによるフィールドのマッピング インポートされたスプレッドシートの列を表すデータピルをターゲットテーブルの [値] 列にドラッグして、インポートからターゲットテーブルにフィールドをマッピングします。各ターゲットテーブルフィールドの右側にあるピルピッカーを使用して、フィールドをマッピングすることもできます。
データピッカーを使用したフィールドのマッピング ターゲットテーブルの右側にあるピルピッカー (
) を使用してデータをマッピングします。[値] 列には複数の値を入力でき、テキストを入力することもできます。
変換オプション 右側のペインで FX アイコン () をクリックして、マッピングされた個々のスプレッドシートフィールドの変換オプションを追加します。たとえば、大文字変換機能を使用して、入力文字列をすべて大文字に変換できます。これらを使用してインポートされたスプレッドシートフィールドのデータをトリミングする方法については、「Transform functions」を参照してください。
注:Flow Designer で利用可能なすべての変換関数が利用できるわけではありません。データレコードの照合をアクティブ化する システムが一致するデータをチェックする必要があるフィールドを指定し、見つかった場合は、ターゲットテーブルで [一致] トグルをアクティブ化して、新しいレコードを作成する代わりに既存のレコードを更新します。たとえば、ターゲットテーブルに [注文番号] フィールドと注文番号が 743 のレコードがある場合、一致する可能性のあるものを処理するためのオプションが 2 つあります。- [注文番号] フィールドの [一致] トグルスイッチがオンの場合、システムは一致するデータをチェックします。ソースデータに同じ注文番号のレコードがある場合、システムはターゲットテーブルの既存のレコードを更新します。
- [注文番号] フィールドの [一致] トグルスイッチがオフの場合、システムは一致するデータをチェックしません。ソースデータに同じ注文番号のレコードがある場合、システムはターゲットテーブルに新しいレコードを作成します。この場合、ターゲットテーブルには 2 つのレコードがあり、どちらも注文番号は 743 です。
参照および選択肢フィールドの動作の構成 [選択肢] および [参照] フィールドタイプの動作を構成します。 - 歯車アイコン (
) をクリックします。
- [フィールド] で、ターゲットテーブルの受信レコード値を照合するフィールド列を選択します。
- [一致するレコードがない場合は、次の操作を行います] で、そのレコードがターゲットテーブルに見つからない場合の対処方法を指定します。
- [新しい選択肢/レコードを作成]:フィールドにインポートされたデータから、ターゲットテーブルの一致するフィールド列に選択肢またはレコードを作成します。
- [このフィールドを無視]:ターゲットテーブルのそのフィールドを無視し、null のままにします。
- [このレコードをスキップ]:ターゲットテーブルのレコード (行) 全体の追加をスキップします。
- [完了] をクリックします。
ターゲットテーブルへの新しいフィールド列の追加 インポートからターゲットテーブルにマッピングされていないフィールド列を追加するか、ターゲットテーブルに新しいフィールドを作成します。 - 右側のターゲットテーブルの上にある [フィールドを追加] を選択します。
- 左側のチェックボックスをオンにしてターゲットテーブルに追加するフィールドを選択するか、[すべて] を選択してすべてのフィールドを選択します。
- 次の機能を実行することもできます。
- インポートされたフィールドの [フィールドラベル] を編集します。
- インポートされたフィールドのフィールドプロパティを編集するには、[編集] アイコン (
) を選択します。
- ウィンドウの右上隅にある [新規フィールドの作成] をクリックして、新しいフィールドを作成します。
- [フィールドを追加] を選択して、選択したフィールドをターゲットテーブルに追加します。
- [続行] を選択してデータインポートマッピングを作成し、ターゲットテーブルを更新します。
- オプション:
ファイルに複数のワークシートタブが含まれている場合は、残りのワークシートを変換します。
- 注:変換するシートごとに [テーブルに変換] を選択し、この手順の手順を繰り返すか、追加のワークシートに対して別の経路を選択する必要があります (手順については スプレッドシートのインポートから新しいテーブルを作成する または スプレッドシートのインポートを使用して既存のテーブルを変更する を参照)。
- 複数のワークシートがない場合は、次の手順に進みます。
-
サマリー画面で、[完了] を選択します。
または、テーブルビルダー でテーブルを表示するには、サマリー画面で [テーブルの編集] を選択します。
次のタスク
テーブルビルダー でのデータテーブルの編集の詳細については、「テーブルビルダー」を参照してください。
スプレッドシートのインポートを使用して既存のテーブルを変更する
Microsoft Excel スプレッドシートのインポートを使用して、既存のアプリケーションテーブルを更新します。
始める前に
- スプレッドシートを App Engine Studio にインポートします。「スプレッドシートをインポート」を参照してください。
必要なロール:admin、sn_app_eng_studio.user または委任開発者権限。詳細については、「AES を使用する開発者の委任」を参照してください。
手順
-
スプレッドシートをインポート の説明に従ってスプレッドシートをアップロードした後、表示されたウィザードでファイルをインポートする場所を選択します。
図 : 4. 既存のアプリケーションテーブルへのインポート - [既存のテーブル] を選択します。
- 表示されるリストから既存のアプリケーションテーブルを選択します。
-
[続行] を選択します。
左側のソーススプレッドシートのフィールド列を、右側の既存のターゲットアプリケーションテーブルのフィールド列にマッピングできる画面が表示されます。注:マッピングを調整するか、インポートから新しいフィールドを作成することができます。
図 : 5. インポートされたフィールドのマッピング -
このステップでは、次のアクションを使用できます。
オプション 説明 自動マッピングを使用したフィールドのバッチマッピング スプレッドシートのフィールドを選択したターゲットテーブルの表示されたフィールドに自動的にマッピングするには、[自動マッピング] を選択します。自動マッピングは、ソースエンティティを同様の名前のターゲットエンティティにマッピングします。既にマッピングされているターゲットエンティティの場合、[自動マッピング] を選択してもその値は変更されません。自動マッピングされたフィールドには、データピルに杖のアイコンがあります。 ドラッグアンドドロップによるフィールドのマッピング インポートされたスプレッドシートの列を表すデータピルをターゲットテーブルの [値] 列にドラッグして、インポートからターゲットテーブルにフィールドをマッピングします。各ターゲットテーブルフィールドの右側にあるピルピッカーを使用して、フィールドをマッピングすることもできます。
データピッカーを使用したフィールドのマッピング ターゲットテーブルの右側にあるピルピッカー (
) を使用してデータをマッピングします。[値] 列には複数の値を入力でき、テキストを入力することもできます。
変換オプション 右側のペインで FX アイコン () をクリックして、マッピングされた個々のスプレッドシートフィールドの変換オプションを追加します。たとえば、大文字変換機能を使用して、入力文字列をすべて大文字に変換できます。これらを使用してインポートされたスプレッドシートフィールドのデータをトリミングする方法については、「Transform functions」を参照してください。
注:Flow Designer で利用可能なすべての変換関数が利用できるわけではありません。データレコードの照合をアクティブ化する システムが一致するデータをチェックする必要があるフィールドを指定し、見つかった場合は、ターゲットテーブルで [一致] トグルをアクティブ化して、新しいレコードを作成する代わりに既存のレコードを更新します。たとえば、ターゲットテーブルに [注文番号] フィールドと注文番号が 743 のレコードがある場合、一致する可能性のあるものを処理するためのオプションが 2 つあります。- [注文番号] フィールドの [一致] トグルスイッチがオンの場合、システムは一致するデータをチェックします。ソースデータに同じ注文番号のレコードがある場合、システムはターゲットテーブルの既存のレコードを更新します。
- [注文番号] フィールドの [一致] トグルスイッチがオフの場合、システムは一致するデータをチェックしません。ソースデータに同じ注文番号のレコードがある場合、システムはターゲットテーブルに新しいレコードを作成します。この場合、ターゲットテーブルには 2 つのレコードがあり、どちらも注文番号は 743 です。
参照および選択肢フィールドの動作の構成 [選択肢] および [参照] フィールドタイプの動作を構成します。 - 歯車アイコン (
) をクリックします。
- [フィールド] で、ターゲットテーブルの受信レコード値を照合するフィールド列を選択します。
- [一致するレコードがない場合は、次の操作を行います] で、そのレコードがターゲットテーブルに見つからない場合の対処方法を指定します。
- [新しい選択肢/レコードを作成]:フィールドにインポートされたデータから、ターゲットテーブルの一致するフィールド列に選択肢またはレコードを作成します。
- [このフィールドを無視]:ターゲットテーブルのそのフィールドを無視し、null のままにします。
- [このレコードをスキップ]:ターゲットテーブルのレコード (行) 全体の追加をスキップします。
- [完了] をクリックします。
ターゲットテーブルへの新しいフィールド列の追加 インポートからターゲットテーブルにマッピングされていないフィールド列を追加するか、ターゲットテーブルに新しいフィールドを作成します。 - 右側のターゲットテーブルの上にある [フィールドを追加] を選択します。
- 左側のチェックボックスをオンにしてターゲットテーブルに追加するフィールドを選択するか、[すべて] を選択してすべてのフィールドを選択します。
- 次の機能を実行することもできます。
- インポートされたフィールドの [フィールドラベル] を編集します。
- インポートされたフィールドのフィールドプロパティを編集するには、[編集] アイコン (
) を選択します。
- ウィンドウの右上隅にある [新規フィールドの作成] をクリックして、新しいフィールドを作成します。
- [フィールドを追加] を選択して、選択したフィールドをターゲットテーブルに追加します。
-
[続行] を選択してデータインポートマッピングを作成し、ターゲットテーブルを更新します。
注:スプレッドシートにマッピングされていないフィールドが残っている場合は、プロンプトが表示されます。これらのフィールドをマッピングすることも、マッピングせずに続行することもできます。
- オプション:
ファイルに複数のワークシートタブが含まれている場合は、残りのワークシートを変換します。
- 注:変換するシートごとに [テーブルに変換] を選択し、この手順の手順を繰り返すか、追加のワークシートに対して別の経路を選択する必要があります (手順については スプレッドシートのインポートから新しいテーブルを作成する または 拡張可能なテーブルとスプレッドシートのインポートから新しいテーブルを作成する を参照)。
- 複数のワークシートがない場合は、次の手順に進みます。
-
サマリー画面で、[完了] を選択します。
または、テーブルビルダー でテーブルを表示するには、サマリー画面で [テーブルの編集] を選択します。
次のタスク
テーブルビルダー でのデータテーブルの編集の詳細については、「テーブルビルダー」を参照してください。