Oracle APEX Workshop I 日本語版

Slide 1

Slide 1 text

Slide 2

Slide 2 text

• スプレッドシートからアプリケーションを作成 • 対話モード・レポートの操作 • フォームの編集 • 警告を表示するリージョンの追加とフォームのレイアウト調整 • 動的アクションの追加による、CostとBudgetアイテムの有効化/無効化の実装 • タスクがクローズしたときに電子メールを送信する • カレンダの追加 • テーマのカスタマイズ • ダッシュボードの更新本ワークショップにて実施する内容 Copyright © 2020, Oracle and/or its affiliates 2

Slide 3

Slide 3 text

3 Copyright © 2020, Oracle and/or its affiliates 資料のダウンロード • 以下のリンクにアクセスし、資料をダウンロードする。ワークショップで使用するCSVファイル https://apex.oracle.com/pls/apex/r/japancommunity/simcontents/downloa d?id=Project_and_Tasks.csv ワークショップで使用するスニペット https://apex.oracle.com/pls/apex/r/japancommunity/simcontents/downloa d?id=APEX_Workshop1_snippets.txt

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

6 Copyright © 2020, Oracle and/or its affiliates Step 2 - 新規に作成するワークスペース情報の指定 • 名、姓、電子メール、ワークスペース名、国、使用状況を、それぞれ入力する。 • Oracleプライバシ・ポリシーを確認する。 • 国は「日本」、使用状況の組織は教育機関を想定しているため、「個人」を選択します。ワークスペースの制限は • 英数字と”_”アンダースコア • 30文字以下 • 大文字小文字の区別なし • 他の利用者も含み、既に使用済みのワークスペース名は使えない

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

14 Copyright © 2020, Oracle and/or its affiliates Step 10 – Oracle APEXホーム画面 • アプリケーション・ビルダー • アプリケーション開発を行う。 • SQLワークショップ • DBの操作、表、ビュー、索引、パッケージといったDBオブジェクトの作成 /更新/削除を行う。 • チーム開発 • アプリケーションのリリース管理を行う機能を提供する。 • アプリケーション・ギャラリー • サンプル・アプリケーションを提供する。

Slide 15

Slide 15 text

Slide 16

Slide 16 text

• 以下のURLからワークショップで使用するCSVファイルをダウンロードし、ファイルに保存する。 Step 1 – CSVファイルのダウンロード Copyright © 2020, Oracle and/or its affiliates 16 https://apex.oracle.com/pls/apex/r/japancommunity/simcontents/download?id=Project_and_Tasks.csv ファイルの内容 Project,Task Name,Start Date,End Date,Status,Assigned To,Cost,Budget ACME Web Configuration,Identify server requirements,2020-5-17,2020-5-18,Closed,John Watson,100,200 Maintain Support Systems,HR software upgrades,2020-5-17,2020-7-14,On-Hold,Pam King,8000,7000 Maintain Support Systems,Apply Billing System updates,2020-5-17,2020-7-18,On-Hold,Russ Sanders,9500,7000 ACME Web Configuration,Determine Web listener configuration(s),2020-5-18,2020-5-18,Closed,James Cassidy,100,100 ACME Web Configuration,Specify security authentication scheme(s),2020-5-19,2020-5-21,Closed,John Watson,200,300 ACME Web Configuration,"Select servers for Development, Test, Production",2020-5-19,2020-5-24,Closed,James Cassidy,200,600 Email Integration,Complete plan,2020-5-24,2020-7-1,Closed,Mark Nile,3000,1500 ACME Web Configuration,Configure Workspace provisioning,2020-5-26,2020-5-26,Closed,John Watson,200,100 ACME Web Configuration,Create pilot workspace,2020-5-26,2020-5-26,Closed,John Watson,100,100 ACME Web Configuration,Run installation,2020-5-27,2020-5-27,Closed,James Cassidy,100,100 Bug Tracker,Implement bug tracking software,2020-5-31,2020-5-31,Closed,Myra Sutcliff,100,100 Bug Tracker,Review automated testing tools,2020-6-1,2020-7-2,On-Hold,Myra Sutcliff,2750,1500

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Slide 19

Slide 19 text

Slide 20

Slide 20 text

Slide 21

Slide 21 text

Slide 22

Slide 22 text

Slide 23

Slide 23 text

Slide 24

Slide 24 text

Slide 25

Slide 25 text

Slide 26

Slide 26 text

Slide 27

Slide 27 text

Slide 28

Slide 28 text

Slide 29

Slide 29 text

Slide 30

Slide 30 text

Slide 31

Slide 31 text

Slide 32

Slide 32 text

• アプリケーション・ビルダーとアプリケーションは、異なるウィンドウ/タブで実行されます。 • 認証やセッションなどは、それぞれ独立しています。 • アプリケーション・ビルダーおよびページ・デザイナから実施された変更は、アプリケーションに即時で反映されます。 • 表示中のページへの反映は、ページの再ロードを行う必要があります。 Tips – アプリケーション・ビルダーとアプリケーションの画面 Copyright © 2020, Oracle and/or its affiliates 32 変更は即時で確認可能アプリケーション実行中に変更可能

Slide 33

Slide 33 text

Slide 34

Slide 34 text

Slide 35

Slide 35 text

Slide 36

Slide 36 text

Slide 37

Slide 37 text

Slide 38

Slide 38 text

Slide 39

Slide 39 text

Slide 40

Slide 40 text

Slide 41

Slide 41 text

Slide 42

Slide 42 text

Slide 43

Slide 43 text

Slide 44

Slide 44 text

Slide 45

Slide 45 text

Slide 46

Slide 46 text

Slide 47

Slide 47 text

Slide 48

Slide 48 text

Slide 49

Slide 49 text

Slide 50

Slide 50 text

• 以下の値を指定する： • 列ラベル：予算コスト差 • 書式マスク：プルダウン・リストから４番目の(5,345)を選択 • 計算式: I – H • 「適用」をクリックする。 • レポートに予算コスト差という列が追加され、それぞれのタスクのBudgetから Costを引いた値が表示される。 Step 17 – 計算カラムの追加 Copyright © 2020, Oracle and/or its affiliates 50

Slide 51

Slide 51 text

Slide 52

Slide 52 text

Slide 53

Slide 53 text

Slide 54

Slide 54 text

Slide 55

Slide 55 text

Slide 56

Slide 56 text

• Oracle APEXのアプリケーション・ビルダーから起動したアプリケーションには、開発者ツール・バーが表示されます。 • ホーム：アプリケーション・ビルダーのホーム画面に戻ります。 • アプリケーションnnnn：実行中のアプリケーションの編集画面に戻ります。 • ページの編集nn：実行中のページをページ・デザイナで開きます。 • セッション：セッション情報の表示画面（デバッグ画面のひとつ）を開きます。 • デバッグの表示：デバッグ画面を開きます。 • デバッグ：アプリケーションの実行ログの取得を開始します。 • ページ情報：画面レイアウト、ページ処理に要した時間を表示します。 • クイック編集：指定したリージョンのテンプレート・オプションを編集する画面を開きます。 • テーマ・ローラー：アプリケーションの見た目を更新します。 Tips – 開発者ツール・バーについて Copyright © 2020, Oracle and/or its affiliates 56 赤字のコンポーネントは、本ワークショップで使用します。

Slide 57

Slide 57 text

Slide 58

Slide 58 text

Slide 59

Slide 59 text

• Oracle APEXのページはページにコンポーネントを配置することで作成されます。 • コンポーネントには、リージョン、ページ・アイテム、ボタン、プロセスなどがあります。 • それぞれのコンポーネントはプロパティを持ちます。そのプロパティを編集する画面が、プロパティ・エディタです。 Tips – プロパティ・エディタ Copyright © 2020, Oracle and/or its affiliates 59 ページに含まれるコンポーネントが配置されているプロパティ・エディタ選択されたコンポーネントのプロパティを編集する

Slide 60

Slide 60 text

Slide 61

Slide 61 text

• すべてのページで共通する操作を実行します。 • ページの保存と実行：ページに実施した変更を保存し、対象ページをアプリケーションを実行している画面で開きます。 • ページの保存：ページに実施した変更を保存します。これ以降、実施した変更を元に戻す/やり直すことができなくなります。 • 共有コンポーネント：共有コンポーネントの画面を呼び出します。 • ユーティリティ：ユーティリティを呼び出します。 • 作成：コンポーネントを作成します。 • 元に戻す/やり直し：実施した変更を元に戻したり、やり直したりできます。 • ロック：現在のページの、他の開発者による変更を禁止します。 • ページ・ロケータ：ページ番号を指定して、ページ・デザイナで開きます。 Tips – ページ・デザイナのツール・バー Copyright © 2020, Oracle and/or its affiliates 61

Slide 62

Slide 62 text

Slide 63

Slide 63 text

Slide 64

Slide 64 text

Slide 65

Slide 65 text

Slide 66

Slide 66 text

Slide 67

Slide 67 text

Slide 68

Slide 68 text

Slide 69

Slide 69 text

Slide 70

Slide 70 text

Slide 71

Slide 71 text

Slide 72

Slide 72 text

Slide 73

Slide 73 text

Slide 74

Slide 74 text

Slide 75

Slide 75 text

Slide 76

Slide 76 text

Slide 77

Slide 77 text

Slide 78

Slide 78 text

Slide 79

Slide 79 text

Slide 80

Slide 80 text

• 「保存」をクリックする。 • アプリケーションを実行しているタブに切り替える。 • フォームをクローズして、再度オープンする。 • StatusがClosedのタスクと、Closedでないタスクの双方の編集を試みる。 Step 11 – 保存してフォームをテスト Copyright © 2020, Oracle and/or its affiliates 80 StatusがClosedの場合 StatusがClosed以外の場合

Slide 81

Slide 81 text

Slide 82

Slide 82 text

• StatusがClosedに設定されたときに、CostとBudgetの入力を禁止する。 • ページ・デザイナのタブに移動する。 • レンダリング・ツリーにあるページ・アイテムP6_STATUS上で右クリックすると表示されるメニューから、「動的アクションの作成」を実行する。 Step 1 – 動的アクションの作成 Copyright © 2020, Oracle and/or its affiliates 82

Slide 83

Slide 83 text

Slide 84

Slide 84 text

• レンダリング・ツリーからTrueアクションの表示をクリックする。 • プロパティ・エディタにて： • アクションとして「クラスの追加」を設定する。 • クラスとして「apex_disabled」を設定する。 • 影響を受ける要素の選択タイプとしてアイテムを設定する。 • アイテムの横にあるアイコンをクリックし、P6_COSTを選択する。 • 同様にP6_BUDGETを選択する。 Step 3 – Trueアクションの設定 Copyright © 2020, Oracle and/or its affiliates 84 アクションに「有効化/無効化」があるが、こちらで無効化するとページ・サブミット時に値の送信が行われない。クラスapex_disabledの追加は、入力のみ不可になり、値は送信の対象となる。

Slide 85

Slide 85 text

Slide 86

Slide 86 text

• アプリケーションの画面に切り替える。 • フォームを一旦閉じる。 • StatusがClosedであるタスクを、フォームで開く。 • CostとBudgetが無効化されていることを確認する。 • StatusをOpenやその他、Closed 以外のステータスに変更し、 CostとBudgetが有効になることを確認する。 Step 5 – 動的アクションの動作確認 Copyright © 2020, Oracle and/or its affiliates 86

Slide 87

Slide 87 text

Slide 88

Slide 88 text

Slide 89

Slide 89 text

Slide 90

Slide 90 text

• ページをまたがって使用されるコンポーネントです。 • アプリケーション・ロジック：アプリケーション・アイテム（グローバル変数のようなもの）を含みます。 • セキュリティ：アプリケーションの認証や認可のスキームを設定します。 • ナビゲーション：メニューやブレッドクラムを含みます。 • ユーザー・インターフェース：アプリケーションの外観を決めるテーマやテンプレートを含みます。 • ファイル：静的ファイルを保存します。 • データ・ソース：主に外部に存在するデータを定義します。 • グローバリゼーション：各言語への翻訳を定義します。 Tips – 共有コンポーネント Copyright © 2020, Oracle and/or its affiliates 90

Slide 91

Slide 91 text

Slide 92

Slide 92 text

Slide 93

Slide 93 text

Slide 94

Slide 94 text

タスク#TASK_NAME#は#APP_USER#によってクローズされました。

プロジェクト名 #PROJECT# 期間 #START_DATE# - #END_DATE# コスト #COST# 予算 #BUDGET#

Slide 95

Slide 95 text

• プレイン・テキスト・フォーマットのコンテンツを設定する。 Step 7 – プレイン・テキスト・フォーマットの編集 Copyright © 2020, Oracle and/or its affiliates 95 タスク #TASK_NAME# がクローズしました! タスク詳細 ------------------ プロジェクト: #PROJECT# 期間: #START_DATE# - #END_DATE# コスト: #COST# 予算: #BUDGET#

Slide 96

Slide 96 text

Slide 97

Slide 97 text

Slide 98

Slide 98 text

Slide 99

Slide 99 text

Slide 100

Slide 100 text

• レンダリング・ビュー：ページに表示に関連するコンポーネントを表示します。実際にはHTTP(S)の GETリクエストを受け付けたときに行われる処理を定義します。 • 動的アクション・ビュー：ブラウザ上のJavaScriptによって行われる処理を定義します。 • プロセス・ビュー：HTTP(S)のPOSTリクエストを受け付けたときに行われる処理を定義します。 • ページ共有コンポーネント・ビュー：このページで使用されている共有コンポーネントを参照します。 Tips – 左ペインのビュー Copyright © 2020, Oracle and/or its affiliates 100 レンダリング・ビュー動的アクション・ビュープロセス・ビューページ共有コンポーネント・ビューページ共有コンポーネント・ビューページ共有コンポーネント・ビュー

Slide 101

Slide 101 text

Slide 102

Slide 102 text

• ソースのPL/SQLコードの入力で、拡大をクリックしてコード・エディタを開く。 • 以下のコードをコピペする。APIのサンプルにアイテムを設定している。 • 検証ボタンをクリックして、記述したコードのシンタックスが正しいことを確認し、「OK」をクリックする。 Step 13 – 電子メール送信プロセスの編集 Copyright © 2020, Oracle and/or its affiliates 102 begin apex_mail.send ( p_to => :APP_USER, p_template_static_id => 'TASK_CLOSED', p_placeholders => '{' || ' "APP_USER":' || apex_json.stringify( lower(:APP_USER) ) || ' ,"BUDGET":' || apex_json.stringify( :P6_BUDGET ) || ' ,"COST":' || apex_json.stringify( :P6_COST ) || ' ,"END_DATE":' || apex_json.stringify( :P6_END_DATE ) || ' ,"PROJECT":' || apex_json.stringify( :P6_PROJECT ) || ' ,"START_DATE":' || apex_json.stringify( :P6_START_DATE ) || ' ,"TASK_NAME":' || apex_json.stringify( :P6_TASK_NAME ) || '}' ); end;

Slide 103

Slide 103 text

Slide 104

Slide 104 text

• アプリケーションを実行しているタブに切り替える。 • フォームを一旦閉じる。 • StatusがClosedではないタスクをフォームで開く。 • StatusをClosedへ変更する。 • 「変更の適用」をクリックする。 • 電子メールの受信を確認する。右にあるようなメールを受信しているはずです。 Step 15 – 電子メールの送信を検証 Copyright © 2020, Oracle and/or its affiliates 104

Slide 105

Slide 105 text

Slide 106

Slide 106 text

Slide 107

Slide 107 text

Slide 108

Slide 108 text

Slide 109

Slide 109 text

Slide 110

Slide 110 text

Slide 111

Slide 111 text

Slide 112

Slide 112 text

Slide 113

Slide 113 text

Slide 114

Slide 114 text

Slide 115

Slide 115 text

• グローバル色のヘッダー・アクセントとして指定されている色をクリックする。 • カラー・ピッカーから会社としての指定色（または好きな色）を選ぶ。 • 16進数によるカラー・コードの入力も可。(右の例は#03b109) • 色を指定したら、テーマ・ローラー内のどこかをクリックして、カラー・ピッカーを閉じる。 Step 2 – アクセント色の変更 Copyright © 2020, Oracle and/or its affiliates 115

Slide 116

Slide 116 text

Slide 117

Slide 117 text

Slide 118

Slide 118 text

Slide 119

Slide 119 text

Slide 120

Slide 120 text

• 本資料の画面ショットはVitaスタイルで取得している。 • 画面ショットと操作画面を合わせるには、Vitaスタイルを「現行として設定」する。 • テーマ・ローラーは右上のをクリックして閉じる。 Tips – 定義済みスタイル Copyright © 2020, Oracle and/or its affiliates 120 Vita -Dark Vita - Red Vita - Slate Vita

Slide 121

Slide 121 text

Slide 122

Slide 122 text

Slide 123

Slide 123 text

Slide 124

Slide 124 text

Slide 125

Slide 125 text

• レンダリング・ツリーの「シリーズ１」をクリックする。 • プロパティ・エディタで名前に「コスト」と入力する。 • レンダリング・ツリーのシリーズ１がコストに変わる。 • SQL問合せに以下を入力する。 Step 4 – シリーズの更新 Copyright © 2020, Oracle and/or its affiliates 125 select PROJECT, sum(cost) value from TASKS group by PROJECT order by 1

Slide 126

Slide 126 text

Slide 127

Slide 127 text

• レンダリング・ツリーの「コスト _1」クリックする。 • プロパティ・エディタの識別の名前を「予算」と入力する。 • レンダリング・ツリーのコスト _1が予算に変わる。 • SQL問合せのcostを「budget」に変更する。 • ページの保存と実行をクリックする。 Step 6 – シリーズ・予算の調整 Copyright © 2020, Oracle and/or its affiliates 127 select PROJECT, sum(budget) value from TASKS group by PROJECT order by 1

Slide 128

Slide 128 text

Slide 129

Slide 129 text

Slide 130

Slide 130 text

• 予算とコスト・リージョンのチャートを確認する。 • X軸のプロジェクト名が切れている。 • Y軸は金額として表示されていない。 • どちらが予算でコストなのか分からない。 • 開発者ツール・バーの「クイック編集」をクリックする。 • 予算とコストリージョンをクリックして、編集画面へ移行する。 Step 10 – 予算とコストのチャートの編集 Copyright © 2020, Oracle and/or its affiliates 130

Slide 131

Slide 131 text

Slide 132

Slide 132 text

Slide 133

Slide 133 text

Slide 134

Slide 134 text

Slide 135

Slide 135 text

Slide 136

Slide 136 text

Slide 137

Slide 137 text

Slide 138

Slide 138 text

Slide 139

Slide 139 text

Slide 140

Slide 140 text

• 新規に作成されたリージョンに以下を設定する。 • タイトルは「オープン中のタスク」 • タイプは「SQL問合せ」 • SQL問合せは以下を入力する。 Step 20 – レポート属性の設定 Copyright © 2020, Oracle and/or its affiliates 140 select project, task_name, start_date from tasks where status = 'Open' order by start_date

Slide 141

Slide 141 text

Slide 142

Slide 142 text

Slide 143

Slide 143 text

Slide 144

Slide 144 text

• 新規に作成されたリージョンに以下を設定する。 • 識別のタイトルは「クローズされたタスク」 • 識別のタイプは「クラシック・レポート」 • ソースのタイプは「SQL問合せ」 • SQL問合せには以下を入力する。 • ページの保存と実行をクリックする。 Step 24 – リージョンの調整 Copyright © 2020, Oracle and/or its affiliates 144 select project, task_name, assigned_to, start_date, end_date from tasks where status = 'Closed' order by end_date desc

Slide 145

Slide 145 text

Slide 146

Slide 146 text

Slide 147

Slide 147 text

Slide 148

Slide 148 text

• 開発者ツール・バーの「クイック編集」をクリックする。 • オープン中のタスクリージョンのスパナ・アイコンをクリックする。 • 「Remove Body Padding 」「Stretch Report」にチェックを入れる。 • 「保存」をクリックする。 Step 28 – オープン中のタスクにも適用 Copyright © 2020, Oracle and/or its affiliates 148