目次 DEV for CITIZEN 操作マニュアルの記載内容ページ数 DEV for CITIZEN について DEV for CITIZEN に係る機能概要およびアクセス方法について記載しています P2 データを確認してみよう DEV for CITIZEN にて公開されているデータの確認方法

Size: px

Start display at page:

Download "目次 DEV for CITIZEN 操作マニュアルの記載内容ページ数 DEV for CITIZEN について DEV for CITIZEN に係る機能概要およびアクセス方法について記載しています P2 データを確認してみよう DEV for CITIZEN にて公開されているデータの確認方法"

やすもりあきます
5 years ago
Views:

1 DEV for CITIZEN 操作マニュアル

2 目次 DEV for CITIZEN 操作マニュアルの記載内容ページ数 DEV for CITIZEN について DEV for CITIZEN に係る機能概要およびアクセス方法について記載しています P2 データを確認してみよう DEV for CITIZEN にて公開されているデータの確認方法について記載しています P5 アプリケーションを作ってみよう DEV for CITIZEN にて公開されているデータを利用したアプリケーションの作成方法について記載しています P7 オープンデータを登録してみよう自分が作成したオープンデータを登録する方法について記載しています P14 1

3 DEV for CITIZEN について DEV for CITIZEN とは街を見える化したい毎日を便利にしたい市民みんなで街をよくしたいそんな思いを持つ開発者の方のためのプラットフォームですアプリケーション作って市民のためになりたい公共データを分析して行動解析したい!!! 作ったアプリを公開できる仕組みがあるといいなぁデータ取得のAPI 欲しいなぁ DEV for CITIZEN Platform API 2

4 DEV for CITIZEN について -DEV for CITIZEN が提供する機能 - DEV for CITIZEN にはオープンデータ登録機能オープンデータのダウンロード機能 API 経由の ODQL(SQL クエリ ) 実行機能及びアプリケーション公開機能があります機能 1 機能 2 機能 3 オープンデータ登録機能オープンデータのダウンロード機能 API 経由の ODQL(SQL クエリ ) 実行機能会津若松市オープンデータプラットフォーム ( 一般ユーザ向け ) ( 開発者向け ) ブラウザ上で直接コーディングアプリケーション公開機能機能 4 3 ローカル開発資源をアップロード

5 DEV for CITIZEN について -DEV for CITIZEN へのアクセス - DEV for CITIZEN のアクセスログイン ( ログアウト ) 方法についてご説明します Step 1 操作説明 DEV for CITIZEN にアクセス画面説明 ( トップ画面 ) 以下 URL にアクセスします右の画面は Devepoler 向けトップ画面になります Step 2 ユーザ登録トップ画面にてサインインボタンをクリックすると地域 SNS サイトあいべあの連携アプリケーション承認画面が表示されるため開発者にて必要項目を入力の上登録承認願います 4

データを確認してみよう DEV for CITIZEN では行政地元民間企業等が公開したオープンデータを SQL ライクにデータ取得確認することが可能な API Open Data Query Language( 以下 ODQL と記載 ) を提供しています Step 1 Step 2 操作説明データを利用するにアクセスメニューのオープンデータ >> データの利用をクリックします

6 データを確認してみよう DEV for CITIZEN では行政地元民間企業等が公開したオープンデータを SQL ライクにデータ取得確認することが可能な API Open Data Query Language( 以下 ODQL と記載 ) を提供しています Step 1 Step 2 操作説明データを利用するにアクセスメニューのオープンデータ >> データの利用をクリックしますデータを確認テキストボックスに ODQL クエリを入力しデータ取得をクリックすると条件に該当するデータが表示されます画面説明 ( データ確認画面 ) 制約事項試験中につき将来的に仕様が変更される可能性があります * 禁止 union union all 禁止 cast 関数禁止 5 秒以上時間がかかるクエリはキャンセルされます 10,000 件以上の問い合わせ結果のクエリはキャンセルされます件数を絞り検索してください 5

検索したいテーブルをクリックするとポップアップメニューが表示されます表示メニューから SELECT 文サンプルをクリックします ( データ確認画面 ) 検索したいテーブルをクリックし

7 データを確認してみよう -ODQL テンプレートクエリの挿入 - でーた確認画面から検索したいオープンデータテーブル名をクリックすると ODQL クエリ (select) のテンプレートをテキストフィールドに挿入できます操作説明画面説明 Step 1 検索するテーブル名をクリックデータ確認画面のオープンデータ一覧から検索したいテーブルをクリックするとポップアップメニューが表示されます表示メニューから SELECT 文サンプルをクリックします ( データ確認画面 ) 検索したいテーブルをクリックし SELECT 文サンプルをクリック Step 2 テキストフィールドにサンプル文挿入 ODQL 入力テキストボックスに ODQL クエリ (SELECT 文 ) が表示されます選択したテーブルの SELECT 文サンプルが挿入される 6

アプリケーションを作ってみよう DEV for CITIZEN では行政地元民間企業等が公開したオープンデータを基に Web アプリケーション作成プラットフォームを提供していますアプリケーションの作成方法としては 1 ブラウザのテキストフォームでの作成 2 ローカル開発した資源の zip アップロードの 2 通りがあります Step 1 操作説明アプリを作るにアクセスメニューの

8 アプリケーションを作ってみよう DEV for CITIZEN では行政地元民間企業等が公開したオープンデータを基に Web アプリケーション作成プラットフォームを提供していますアプリケーションの作成方法としては 1 ブラウザのテキストフォームでの作成 2 ローカル開発した資源の zip アップロードの 2 通りがあります Step 1 操作説明アプリを作るにアクセスメニューのアプリケーション >> アプリを新規作成するをクリックします画面説明 ( アプリケーション作成画面 ) Step 2 アプリの作成方法 HTML ファイル (html) javascript ファイル (js) スタイルシートファイル (css) 画像イメージファイル (jpeg,png,gif) の登録をサポートおり HTML ベースでのアプリケーションを公開できますアプリケーション作成方法選択新規アプリケーションの作成ブラウザ上でテキストフォーム上で直接アプリケーションを開発します zipファイルのアップロードローカル開発した資源を zipでアップロードすることでアプリケーションを登録しますローカル環境でもODQLは利用できます 2 テンプレートをダウンロードテンプレートをダウンロードボタンをクリックするとテンプレートファイル (html) がダウンロードされます 7

アプリケーションを作ってみようアプリケーションの開発方法 - 開発者は DEV for CITIZEN

ローカル環境で開発する開発者ブラウザ直接コーディングアプリ編集画面 ( テキストフォーム )

9 アプリケーションを作ってみようアプリケーションの開発方法 - 開発者は DEV for CITIZEN 上で直接コーディングまたはローカルのアプリ資源アップロードによって開発したアプリケーションを公開することができます 1.Dev For Citizen 上で直接編集する Dev For Citizen を活用したアプリ開発方法 2. ローカル環境で開発する開発者ブラウザ直接コーディングアプリ編集画面 ( テキストフォーム ) ブラウザ上で直接編集 1 テキストエディタエディタ上でアプリ編集テンプレートをダウンロード開発者 2 Dev For Citizen 上のアプリ編集画面 8 ブラウザ開発資源をローカルで実行データ取得更新 SQL クエリ実行 (ODQL)

10 アプリケーションを作ってみよう ODQL でデータを取得するには - ODQL を活用する場合は HTML コード上に以下を追加する必要がありますまたアプリケーション開発ルールとして index.html を必ず作成してください Index.html( サンプル ) <html> <body>  <link href="../css/bootstrap.css" rel="stylesheet"> <link href="../css/bootstrap-responsive.css" rel="stylesheet"> <input type="button" name="test" value="odql を実行してみる " onclick="test();"/>  <script src="  <script src=" <script> /** * ODQL 実行用テストメソッドです. */ function test() { //ODQL を以下のように記述し ODQLLoader.loadOpenData を利用して下さい. var data = { odql : "SELECT town_name,year,month FROM O_OOAZA_JINKO where town_name = ' 大戸町上三寄大豆田 '"}; var jsondata = ODQLLoader.loadOpenData(data); alert(json.stringify(jsondata)); } </script> </body> </html> 9 CSS JS ファイル等の読み込みについて CSS JS img には必ず../css/ ファイル名../js/ ファイル名でアクセスしてください << 例 >> <link href="../css/xxxx.css" rel="stylesheet"> <link href="../css/yyyy.css" rel="stylesheet"> ODQL の利用について ODQL を活用する場合は HTML コード上に以下を追加する必要があります  <script src=" js"></script>  <script src=" /code/js/odql.js"></script>

11 アプリケーションを作ってみよう ODQL でデータを取得するには - ODQL を活用したデータ検索を行う場合は HTML コード上に以下を追加する必要がありますまたアプリケーション開発ルールとして index.html を必ず作成してくださいデータ検索時のサンプルコード <html> <body>  <link href="../css/bootstrap.css" rel="stylesheet"> <link href="../css/bootstrap-responsive.css" rel="stylesheet"> <input type="button" name="test" value="odql を実行してみる " onclick="test();"/>  <script src="  <script src=" <script> /** * ODQL 実行用テストメソッドです. */ function test() { //ODQL を以下のように記述し ODQLLoader.loadOpenData を利用して下さい. var data = { odql : "SELECT town_name,year,month FROM O_OOAZA_JINKO where town_name = ' 大戸町上三寄大豆田 '"}; var jsondata = ODQLLoader.loadOpenData(data ); alert(json.stringify(jsondata)); } </script> </body> </html> API コール手順 ODQL クエリを作成検索するテーブルに対する ODQL クエリをパラメータにした連想配列を作成します selectopendata 関数の実行 1 で作成した配列を ODQL.Loader の selectopendata 関数パラメータに設定しメソッド実行する Dev For Citizen の ODQL 画面からオープンデータのテーブル名を右クリックすると ODSQ のクエリテンプレートがテキストフィールドに挿入されますテンプレートを活用し ODQL クエリを作成し 10

12 アプリケーションを作ってみよう ODQL でテーブルを更新するには - ODQL を活用してデータを更新する場合は HTML コード上に ODQL.Loader の updateopendata 関数を使用して行います updateopendata 関数の利用方法は以下を参考にしてくださいデータ更新時のサンプルコード  <script src="  <script src=" <script> /** * データ更新用 API です. */ function updatedata() { //ODQL を以下のように記述し ODQLLoader.updateOpenData を利用して下さい. var data = { "oid": <<oid を入力して下さい >>, "column1":<< 更新する値を入力して下さい.>>, }; // データアップデート時には必ず mode='insert' を指定して下さい. var updatedata = { "mode" : "update", "data" : data }; APIコール手順更新データを連想配列化更新するデータの連想配列を作成します update,delete する際はレコードをユニークに特定する oid を指定する必要があります ODQL はレコードのバルク更新をサポートしていません更新モードの選択 1 で作成した配列をデータ更新するモード選択する値含め再度連想配列を作成しますレコード挿入 : insert レコード更新 : update レコード削除 : delete // スタンドアローンで開発する際には該当データの Access_token を入力して下さい. var jsondata = ODQLLoader.updateOpenData(updateData, table_name',<<access_token>>); alert(json.stringify(jsondata)); } </script> old : OpendataID オープンデータのレコードに対するユニークキーとなりデータinsert 時に自動で付与されます oidを確認するには ODQLでselectする際に取得カラムの oid を含めて取得してください ( 前頁参照 ) 11 updateopendata 関数の実行 2 で作成した配列を ODQL.Loader の updateopendata 関数パラメータに設定しメソッド実行する

zip ( アプリケーション名 ) css js img ローカルで開発する際は必ず以下の規定のフォルダ構成で作成するアップロードする

13 アプリケーションを作ってみよう - 留意事項 - ローカルで開発したアプリケーションを Dev for CITIZEN にアップロードする際に以下の事項に留意してください規定のフォルダ構成規定のフォルダ構成でアップロードして下さい sample.zip ( アプリケーション名 ) css js img ローカルで開発する際は必ず以下の規定のフォルダ構成で作成するアップロードする zip ファイル名は必ず半角英数字にするなお zip ファイル名はアップロードする際のアプリケーション名となりますが後で変更が可能です html Index.html 12

メニューのアプリケーション >> アプリを新規作成するをクリックします該当アプリをエクスポート該当アプリの

14 アプリケーションを作ってみよう - テンプレートダウンロード - 開発したアプリケーションについては zip ファイル形式でエクスポートすることが可能です Step 1 Step 2 操作説明アプリを新規作成するにアクセスメニューのアプリケーション >> アプリを新規作成するをクリックします該当アプリをエクスポート該当アプリのエクスポートボタンをクリックすると zip ファイルでダウンロードすることができます画面説明 ( ログイン画面 ) 13

15 オープンデータを登録してみよう - 新規登録するには - 新たにオープンデータを登録し一般に公開することが可能です Step 1 Step 2 操作説明データを作成するにアクセスメニューのオープンデータ >> データを作成するをクリックしますデータを登録登録用 csv ファイルの選択画面にてオープンデータとして登録する csv ファイルを選択し次へボタンをクリックしますその後 csv ファイルに記載されたデータがテーブル形式で表示されます必須項目を入力し登録ボタンをクリックするとオープンデータとして登録されます画面説明 ( メタ情報登録画面 ) 入力項目の説明は次ページを参照してください 14

16 オープンデータを登録してみよう - 新規登録するには画面説明 1 選択したCSVファイルの内容が画面表示されます 1 行目が項目名 2 行目以降がデータ内容ですのでご確認ください 2 以下項目は全て入力してくださいタイトル: 公開時のタイトルとして表示されますテーブル名:DBに作成されるテーブル名となりますファイル名: 更新時にアップロードする際使用する名称となります組織名: 公開時の提供元として表示されますアップロード時のファイル名: 連続でファイルアップロードする際はリネーム必要としてください - リネーム必要 ( デフォルト ) - リネーム不要 3メタ情報を入力しますサンプルとして値が設定されていますが必要に応じて変更してくださいデータタイプ:DBのカラムタイプになります桁数:DBの桁数となりますカラム名( 論理 ): 論理カラム名として一般ユーザに公開されますサンプルデータ: サンプルとして一般ユーザに公開されますデータタイプと桁数は一度登録すると変更できません 4サンプルアプリケーションとして公開するか否か設定します非公開( デフォルト ): アプリケーションとしては公開しません地図型: マップ上にピンを表示します設定するためには緯度経度が必要です表型: 表形式のアプリケーションを表示します 5Createive Commons Licenseを設定します表示表示- 継承表示- 改変禁止表示- 非営利表示- 非営利 - 継承表示- 非営利 - 改変禁止 15 入力項目は全て入力必須となっています詳細は以下 HP 参照 :

オープンデータを登録してみよう - 登録データを更新するには - 自分が登録したオープンデータについては

さんが登録したオープンデータに自分が登録したオープンデータが表示されているのでその右側にあるデータ更新ボタンをクリックします

CSV ファイルをアップロードします全件洗替 : 対象のオープンデータを全て削除して新たにアップロードした CSV

17 オープンデータを登録してみよう - 登録データを更新するには - 自分が登録したオープンデータについてはデータの洗い替えまたは追加することが可能です Step 1 Step 2 操作説明データ更新にアクセストップ画面の XXX さんが登録したオープンデータに自分が登録したオープンデータが表示されているのでその右側にあるデータ更新ボタンをクリックしますオープンデータを更新画面説明 ( オープンデータ一覧画面 ) ( オープンデータ更新画面 ) データの更新方法を選択しオープンデータの CSV ファイルをアップロードします全件洗替 : 対象のオープンデータを全て削除して新たにアップロードした CSV ファイルの内容を登録します追加 : 対象のオープンデータに対して新たにアップロードした CSV ファイルの内容を追加しますアップロード後しばらくするとバッチプログラムにてオープンデータの取込が実施されます 16

18 オープンデータを登録してみよう - 留意事項 - オープンデータ登録更新時に使用する CSV ファイルは下記点に注意して作成してください制約事項 1 行目は登録時のカラム名となる為必ず英数字にして下さいなお 1 行目のカラム名が DB の物理名として定義されますまた予約語はカラム名として使用できません ( 詳細はオープンデータ >> データを作成するの予約語一覧を参照 ) 新規登録時の上限ファイルサイズは 10MB となります値にエンクォート ( ) 改行を含めないでくださいオープンデータの登録更新を実施すると使用した CSV ファイルは以下のようにデータベースへ登録されます CSV ファイル aaa,bbb,ccc,ddd a1,b1,c1,d1 a2,b2,c2,d2 データベース aaa bbb ccc ddd a1 b1 c1 d1 a2 b2 c2 d2 17

SmartBrowser_document_build30_update.pptx

SmartBrowser_document_build30_update.pptx SmartBrowser Update for ios / Version 1.3.1 build30 2017 年 8 月株式会社ブルーテック更新内容 - 概要 ios Version 1.3.1 build28 の更新内容について 1. 設定をQRから読み込み更新する機能 2.URLをQRから読み込み画面遷移する機能 3.WEBページのローカルファイル保存と外部インテントからの起動 4.JQuery-LoadImageライブラリの組み込み