サムザップにおけるNotionの活用事例とPHPでのNotionAPIを利用した仕組み構築の紹介

自己紹介若田部誠・2017年9月サムザップに中途入社・職種：サーバサイドエンジニア・業界経験 20年以上・趣味：謎解き、ロードバイク

会社紹介 ▪事業内容スマートフォンゲームの企画・開発・配信事業

アジェンダ・はじめに・Notionについて・Notionに移行するまでに行った流れ・NotionAPI活用事例

はじめに社内であったドキュメント作成の悩み・ドキュメントを残す文化（ナレッジ共有）がなかなか根付かない ⇒要因の１つとしてツールが使いづらい ⇒動作が遅い ⇒同名のページ作成ができない ⇒ページ編集する度に編集画面に切り替える必要があったなど

Notionについて

Notionについて Notion(ノーション）オールインワン型の情報共有ツール・ドキュメント（メモ）の作成・タスク管理・データ管理 etc

Notionを選んだ理由・CyberAgentグループ内での導入事例が既にあった ⇒Notion有識者が社内にいた・シンプルで使いやすい・動作が早い・様々な情報をデータベースを使って管理できる

Notionへ移行するまでに行った流れ・Notion移行チーム発足・移行専用Slackチェンネル作成・Notion運用ルール決め・チームへのNotionの使い方レクチャー・既存ツールからのデータエクスポート、Notionへのインポート

Notion移行チーム発足・移行専用Slackチャンネル作成・ツールの移行はWrikeというツールの導入で経験済み ⇒詳細はサムザップエンジニアブログに記載・移行チームはプランナー、エンジニアなどの各リーダー陣から選出・質問等は専用Slackチャンネルにて受け付け

Notion運用ルール決め・階層構造階層を事前に移行チーム側で作成しておき、想定してない階層の作成は基本NGとした・ページ作成ルールチーム毎に作成できる場所を事前に決めておき、ドキュメントが乱雑とならないようにルールを設けた

チームへのNotion使い方レクチャー・Notion勉強会実施 Notion有識者が中心となり、ワークショップ形式の勉強会を実施・ワークショップ内容・学習用ページを準備 Notionで旅行計画ページを作成しようというお題で、クエスト形式でお題をこなしてもらいながらNotionの使い方を覚える事ができる学習ページを準備・zoomにて勉強会実施・勉強会は基本的な機能の使い方編とデータベース編として2回実施（1回1時間30分）
・勉強会は進行役と数名のサポートスタッフで実施・勉強会の内容を動画にしてもらい、後から復習できるように対応

学習用ページ

Notionへのインポート・別ツールからデータエクスポートして（HTML形式）、 Notionへインポートする事が可能・移行したプロジェクトの10年分程度のドキュメントデータをNotionへインポートした際にかかった時間は2～3時間程度・移行においてはどうしても手動での対応が必要な点が発生する ⇒テーブルレイアウトが崩れる（シンプルテーブルが導入されたので以前よりは改善しているかも） ⇒以前のツール内のページリンクは外れてしまう（当然ですが） ⇒添付ファイルは引き継がれない

NotionAPI活用事例マスターデータの入力に対して、バリデーション結果をNotionAPIを利用して、NotionDBに格納している(バリデーション部分はPHPで記載)

テストデータにバリデーションをかけた一例

エラーメッセージの対処方法まとめエラーメッセージの解説もNotionのDBにまとめている

サムザップにおけるNotionの活用事例とPHPでのNotionAPIを利用した仕組み構築の紹介

サムザップにおけるNotionの活用事例とPHPでのNotionAPIを利用した仕組み構築の紹介

CyberAgent SGE Engineer

More Decks by CyberAgent SGE Engineer

Other Decks in Programming

Featured

Transcript