<p>プロダクト開発部の永元です。<br />
先日『はじめよう!プロセス設計　要件定義のその前に』という本を読みました。<br />
AIによるプログラム・アプリケーション生成技術の進化が著しい中、プロジェクトマネジメントやプロダクトオーナーに挑戦したいソフトウェアエンジニアにとって、プロセス設計の重要性はますます高まっています。<br />
本書『はじめよう!プロセス設計』は、そんな方々に寄り添い、実践的な知識を提供してくれる一冊です。<br />
この記事では、本書を読んで感じたことを共有します。</p>
<h2 id="%E3%80%8E%E3%81%AF%E3%81%98%E3%82%81%E3%82%88%E3%81%86!%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9%E8%A8%AD%E8%A8%88-%E8%A6%81%E4%BB%B6%E5%AE%9A%E7%BE%A9%E3%81%AE%E3%81%9D%E3%81%AE%E5%89%8D%E3%81%AB%E3%80%8F%E3%81%AF%E3%81%A9%E3%82%93%E3%81%AA%E6%9C%AC%EF%BC%9F"><a class="header-anchor-link" href="#%E3%80%8E%E3%81%AF%E3%81%98%E3%82%81%E3%82%88%E3%81%86!%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9%E8%A8%AD%E8%A8%88-%E8%A6%81%E4%BB%B6%E5%AE%9A%E7%BE%A9%E3%81%AE%E3%81%9D%E3%81%AE%E5%89%8D%E3%81%AB%E3%80%8F%E3%81%AF%E3%81%A9%E3%82%93%E3%81%AA%E6%9C%AC%EF%BC%9F" aria-hidden="true"></a> 『はじめよう!プロセス設計　要件定義のその前に』はどんな本？</h2>
<p>ECサイトの本書の紹介文から引用します。</p>
<blockquote>
<p>業務改革やIT化プロジェクトからカスタマー・エクスペリエンスまで、「どうしたらうまくいくんだろう?」とモヤモヤするようなさまざまな場面。その解決の鍵は「プロセス設計」にあります。「プロセス設計」の不在こそ、日々の「モヤモヤ」を解決してくれる存在なのです。どんな現場にもマッチする、ストーリー指向で実現する業務フローの見える化と仕組み化のハウツーが今回も「はじめて」の方にもわかりやすく解説されています。</p>
</blockquote>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__f8d6c45804a3" src="https://embed.zenn.studio/card#zenn-embedded__f8d6c45804a3" data-content="https%3A%2F%2Famzn.asia%2Fd%2Fi8PTdmP" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://amzn.asia/d/i8PTdmP" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://amzn.asia/d/i8PTdmP</a></p>
<p>詳細はリンク先のサンプルをご覧ください。</p>
<h2 id="%E6%9C%AC%E3%82%92%E8%AA%AD%E3%82%93%E3%81%A7%E7%89%B9%E3%81%AB%E6%84%9F%E3%81%98%E3%81%9F%E3%81%93%E3%81%A8"><a class="header-anchor-link" href="#%E6%9C%AC%E3%82%92%E8%AA%AD%E3%82%93%E3%81%A7%E7%89%B9%E3%81%AB%E6%84%9F%E3%81%98%E3%81%9F%E3%81%93%E3%81%A8" aria-hidden="true"></a> 本を読んで特に感じたこと</h2>
<ul>
<li>丁寧でわかりやすい言葉の使い方</li>
<li>誠実で実直な表現</li>
<li>豊富な具体例で読者に寄り添う内容</li>
</ul>
<h3 id="%E4%B8%81%E5%AF%A7%E3%81%A7%E3%82%8F%E3%81%8B%E3%82%8A%E3%82%84%E3%81%99%E3%81%84%E8%A8%80%E8%91%89%E3%81%AE%E4%BD%BF%E3%81%84%E6%96%B9"><a class="header-anchor-link" href="#%E4%B8%81%E5%AF%A7%E3%81%A7%E3%82%8F%E3%81%8B%E3%82%8A%E3%82%84%E3%81%99%E3%81%84%E8%A8%80%E8%91%89%E3%81%AE%E4%BD%BF%E3%81%84%E6%96%B9" aria-hidden="true"></a> 丁寧でわかりやすい言葉の使い方</h3>
<p>「CHAPTER 02 プロセスとは何か」では丁寧すぎるくらいに『プロセス』という言葉を説明しています。<br />
類義語を説明する中で、『プロセス』を抽象化し、この言葉の核を理解しやすくなっています。<br />
『プロセス』以外にも、重要な言葉はいくら聞き馴染みのあるありふれた言葉でも、定義から丁寧に説明してあります。<br />
同じ言葉を使っていても意味が異なる場合や、違う言葉を使っていても意味が同じ場合があるということを入念に伝えているのだと私は解釈しました。</p>
<p>実際に、私は業務フローのヒアリング中に、同じ意見だと思っていたのに実際は違っていたという経験が何度もありました。</p>
<h3 id="%E8%AA%A0%E5%AE%9F%E3%81%A7%E5%AE%9F%E7%9B%B4%E3%81%AA%E8%A1%A8%E7%8F%BE"><a class="header-anchor-link" href="#%E8%AA%A0%E5%AE%9F%E3%81%A7%E5%AE%9F%E7%9B%B4%E3%81%AA%E8%A1%A8%E7%8F%BE" aria-hidden="true"></a> 誠実で実直な表現</h3>
<p>本書では業務フローを描く手法として<a href="https://www.magicaland.org/%E3%83%9E%E3%82%B8%E3%82%AB%E3%81%A3%E3%81%A6%E4%BD%95/" target="_blank" rel="nofollow noopener noreferrer">マジカ</a>を利用する提案がありました。<br />
それなりのページ数を割いており、著者が推している手法ということは明確でしたが、銀の弾丸かのような誇張した表現はありませんでした。<br />
一般的に有名な手法やその背景についても触れており、読者が他の手法についてさらに調べようと思った時の指針にできるようになっていました。</p>
<h3 id="%E8%B1%8A%E5%AF%8C%E3%81%AA%E5%85%B7%E4%BD%93%E4%BE%8B%E3%81%A7%E8%AA%AD%E8%80%85%E3%81%AB%E5%AF%84%E3%82%8A%E6%B7%BB%E3%81%86%E5%86%85%E5%AE%B9"><a class="header-anchor-link" href="#%E8%B1%8A%E5%AF%8C%E3%81%AA%E5%85%B7%E4%BD%93%E4%BE%8B%E3%81%A7%E8%AA%AD%E8%80%85%E3%81%AB%E5%AF%84%E3%82%8A%E6%B7%BB%E3%81%86%E5%86%85%E5%AE%B9" aria-hidden="true"></a> 豊富な具体例で読者に寄り添う内容</h3>
<p>本書には具体例が多く含まれているため、「あるある」という気持ちとともに理解が進み、よくある問題・課題に対する心構えができます。<br />
具体例を少し紹介します。</p>
<ul>
<li>業務のヒアリングでは、全体の中で小さい割合しか占めない例外的な処理を重要視しすぎてしまうことがある</li>
<li>業務フローを整理する際に主語や動詞を省略してしまい、誤解を生んでしまうこと（能動態を推奨）</li>
</ul>
<p>また、問題を抱えた業務を改善するためにはヒアリングなど地道な取り組みが必要ですが、余裕がない業務担当者には悠長な取り組みに見えてしまうことがあります。<br />
そして新しいプロセスを作ったあとも、新しいやり方に変えてもらうこと、それを軌道に乗せることは難しいです。<br />
本書はそれらに挑戦する人（読者）に寄り添って、背中を押すような言葉が溢れています。<br />
コミュニケーションや前向きな姿勢の作り方などにおいても参考になりました。</p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81"><a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p>本書は、以下のような方に特におすすめです。</p>
<ul>
<li>要件定義がうまくできないと感じている方</li>
<li>業務フローの整理やヒアリングを行う予定がある方</li>
<li>プロジェクトマネジメントやプロダクトオーナーに挑戦したいソフトウェアエンジニア</li>
</ul>
<p>プロセス設計に課題を感じている方や、これから挑戦したい方にとって、本書は実践的な知識と心強いサポートを提供してくれる一冊です。</p>
<h2 id="we-are-hiring!"><a class="header-anchor-link" href="#we-are-hiring!" aria-hidden="true"></a> We Are Hiring!</h2>
<p>プロセス設計をしてみたいと思った方、プロセス設計に自信がる方、ぜひクラッソーネで一緒に働きませんか？興味を持っていただけたら、気軽にご連絡ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__7ed161716e226" src="https://embed.zenn.studio/card#zenn-embedded__7ed161716e226" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



プロダクト開発部の永元です。
先日『はじめよう!プロセス設計　要件定義のその前に』という本を読みました。
AIによるプログラム・アプリケーション生成技術の進化が著しい中、プロジェクトマネジメントやプロダクトオーナーに挑戦したいソフトウェアエンジニアにとって、プロセス設計の重要性はますます高まっています。
本書『はじめよう!プロセス設計』は、そんな方々に寄り添い、実践的な知識を提供してくれる一冊です。
この記事では、本書を読んで感じたことを共有します。

『はじめよう!プロセス設計　要件定義のその前に』はどんな本？
ECサイトの本書の紹介文から引用します。

> 業務改革やIT化プロジェクトからカスタマー・エクスペリエンスまで、「どうしたらうまくいくんだろう?」とモヤモヤするようなさまざまな場面。その解決の鍵は「プロセス設計」にあります。「プロセス設計」の不在こそ、日々の「モヤモヤ」を解決してくれる存在なのです。どんな現場にもマッチする、ストーリー指向で実現する業務フローの見える化と仕組み化のハウツーが今回も「はじめて」の方にもわかりやすく解説されています。

https://amzn.asia/d/i8PTdmP

詳細はリンク先のサンプルをご覧ください。

本を読んで特に感じたこと
丁寧でわかりやすい言葉の使い方
誠実で実直な表現
豊富な具体例で読者に寄り添う内容

丁寧でわかりやすい言葉の使い方
「CHAPTER 02 プロセスとは何か」では丁寧すぎるくらいに『プロセス』という言葉を説明しています。
類義語を説明する中で、『プロセス』を抽象化し、この言葉の核を理解しやすくなっています。
『プロセス』以外にも、重要な言葉はいくら聞き馴染みのあるありふれた言葉でも、定義から丁寧に説明してあります。
同じ言葉を使っていても意味が異なる場合や、違う言葉を使っていても意味が同じ場合があるということを入念に伝えているのだと私は解釈しました。

実際に、私は業務フローのヒアリング中に、同じ意見だと思っていたのに実際は違っていたという経験が何度もありました。

誠実で実直な表現
本書では業務フローを描く手法としてマジカを利用する提案がありました。
それなりのページ数を割いており、著者が推している手法ということは明確でしたが、銀の弾丸かのような誇張した表現はありませんでした。
一般的に有名な手法やその背景についても触れており、読者が他の手法についてさらに調べようと思った時の指針にできるようになっていました。

豊富な具体例で読者に寄り添う内容
本書には具体例が多く含まれているため、「あるある」という気持ちとともに理解が進み、よくある問題・課題に対する心構えができます。
具体例を少し紹介します。
業務のヒアリングでは、全体の中で小さい割合しか占めない例外的な処理を重要視しすぎてしまうことがある
業務フローを整理する際に主語や動詞を省略してしまい、誤解を生んでしまうこと（能動態を推奨）

また、問題を抱えた業務を改善するためにはヒアリングなど地道な取り組みが必要ですが、余裕がない業務担当者には悠長な取り組みに見えてしまうことがあります。
そして新しいプロセスを作ったあとも、新しいやり方に変えてもらうこと、それを軌道に乗せることは難しいです。
本書はそれらに挑戦する人（読者）に寄り添って、背中を押すような言葉が溢れています。
コミュニケーションや前向きな姿勢の作り方などにおいても参考になりました。

まとめ
本書は、以下のような方に特におすすめです。
要件定義がうまくできないと感じている方
業務フローの整理やヒアリングを行う予定がある方
プロジェクトマネジメントやプロダクトオーナーに挑戦したいソフトウェアエンジニア

プロセス設計に課題を感じている方や、これから挑戦したい方にとって、本書は実践的な知識と心強いサポートを提供してくれる一冊です。

We Are Hiring!
プロセス設計をしてみたいと思った方、プロセス設計に自信がる方、ぜひクラッソーネで一緒に働きませんか？興味を持っていただけたら、気軽にご連絡ください。

https://www.crassone.co.jp/recruit/engineer/


『はじめよう!プロセス設計　要件定義のその前に』が寄り添ってくれる良書だった

<p>クラッソーネでは業務効率化のためにノーコードツールを利用することがあります。<br />
私は最近makeを初めて利用しました。試行錯誤する中で覚えていった工夫を少し紹介します。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__1445264015023" src="https://embed.zenn.studio/card#zenn-embedded__1445264015023" data-content="https%3A%2F%2Fwww.make.com%2Fen" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.make.com/en" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.make.com/en</a></p>
<h2 id="%E3%81%9D%E3%82%82%E3%81%9D%E3%82%82%E3%81%A9%E3%81%86%E3%81%84%E3%81%A3%E3%81%9F%E7%94%A8%E9%80%94%E3%81%A7%E3%83%8E%E3%83%BC%E3%82%B3%E3%83%BC%E3%83%89%E3%83%84%E3%83%BC%E3%83%AB%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%81%8B"><a class="header-anchor-link" href="#%E3%81%9D%E3%82%82%E3%81%9D%E3%82%82%E3%81%A9%E3%81%86%E3%81%84%E3%81%A3%E3%81%9F%E7%94%A8%E9%80%94%E3%81%A7%E3%83%8E%E3%83%BC%E3%82%B3%E3%83%BC%E3%83%89%E3%83%84%E3%83%BC%E3%83%AB%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%81%8B" aria-hidden="true"></a> そもそもどういった用途でノーコードツールを利用しているか</h2>
<ul>
<li>一部業務ではNotionに情報を集めている</li>
<li>ユーザーに回答してもらうフォームをtallyで作成している</li>
<li>makeでは回答内容をSlackへ投稿したり、Notion上に記録するなどの処理を行っている</li>
</ul>
<p>これらを組み合わせて、tallyフォームの回答内容をNotionに保存したり、それをSlackへ通知したりしています。</p>
<h2 id="make%E7%94%A8%E8%AA%9E"><a class="header-anchor-link" href="#make%E7%94%A8%E8%AA%9E" aria-hidden="true"></a> make用語</h2>
<ul>
<li>scenario: 一連の動作の流れのこと。後述するmoduleとlinkなどを組み合わせてscenarioを作る。</li>
<li>module: 動作の最小単位、ソフトウェアでいうシンプルなメソッドのようなもの。</li>
<li>link: module同士を繋ぐ線。動作の繋がり・流れを表現する。linkに条件を設定することもできる。</li>
</ul>
<p><img src="/images/posts/makes-tips/words.png" alt="make用語説明画像" /></p>
<h2 id="make%E4%B8%8A%E3%81%A7%E5%A4%89%E6%95%B0%E3%82%92%E5%A4%9A%E6%95%B0%E6%89%B1%E3%81%86%E9%9A%9B%E3%81%AF%E5%90%84%E3%80%85%E3%81%AE%E3%82%A8%E3%83%87%E3%82%A3%E3%82%BF%E3%81%A7%E6%95%B4%E3%81%88%E3%81%A6%E3%80%81web%E3%82%A2%E3%83%97%E3%83%AA%E4%B8%8A%E3%81%AB%E3%83%9A%E3%83%BC%E3%82%B9%E3%83%88%E3%81%99%E3%82%8B"><a class="header-anchor-link" href="#make%E4%B8%8A%E3%81%A7%E5%A4%89%E6%95%B0%E3%82%92%E5%A4%9A%E6%95%B0%E6%89%B1%E3%81%86%E9%9A%9B%E3%81%AF%E5%90%84%E3%80%85%E3%81%AE%E3%82%A8%E3%83%87%E3%82%A3%E3%82%BF%E3%81%A7%E6%95%B4%E3%81%88%E3%81%A6%E3%80%81web%E3%82%A2%E3%83%97%E3%83%AA%E4%B8%8A%E3%81%AB%E3%83%9A%E3%83%BC%E3%82%B9%E3%83%88%E3%81%99%E3%82%8B" aria-hidden="true"></a> make上で変数を多数扱う際は各々のエディタで整えて、WEBアプリ上にペーストする</h2>
<p>直感的なGUI操作で一連の処理を作成できるのは素晴らしいです。<br />
makeはとてもリッチな機能を持つWEBアプリケーションだと言えるでしょう。<br />
ただし、その分なかなかスムーズに動いてくれません。<br />
マシンパワーが不足し、ファンがうるさく鳴るほどに熱くなったパソコンの入力と画面反映のタイムラグを彷彿とさせることすらあります。<br />
そんな中で多数の変数を扱う項目を変更するのはなかなかに骨が折れます。<br />
make上で扱う変数は一定のルールのもと命名されているため、GUIを用いずとも手入力で対応できることがあります。<br />
そういうときは使い慣れたエディタで整えて、makeの入力欄にペーストしてしまいましょう。</p>
<p>入力欄のスクリーンショット<br />
<img src="/images/posts/makes-tips/blog01.png" alt="make入力欄" /></p>
<p>テキストとしてコピーしたものがこちらです。</p>
<div class="code-block-container"><pre><code>`アスファルト・コンクリートがら`
{{if(1.fieldsById.question_xxxxxx[] = "有り"; "廃棄物を持っていく処分場の数：" + 1.fieldsById.question_xxxxxx[] + newline + "予定数量：" + 1.fieldsById.question_xxxxxx + 1.fieldsById.question_xxxxxx[] + newline + "処分先：" + 1.fieldsById.question_xxxxxx + newline + "処分先住所：" + 1.fieldsById.question_xxxxxx + if(1.fieldsById.question_xxxxxx; newline + "2つ目の処分場" + newline + "予定数量：" + 1.fieldsById.question_xxxxxx + 1.fieldsById.question_xxxxxx[] + newline + "処分先：" + 1.fieldsById.question_xxxxxx + newline + "処分先住所：" + 1.fieldsById.question_xxxxxx; emptystring) + if(1.fieldsById.question_xxxxxx; newline + "3つ目の処分場" + newline + "予定数量：" + 1.fieldsById.question_xxxxxx + 1.fieldsById.question_xxxxxx[] + newline + "処分先：" + 1.fieldsById.question_xxxxxx + newline + "処分先住所：" + 1.fieldsById.question_xxxxxx; emptystring); "廃棄無し")}}
</code></pre></div><p>私は 1.fieldsById(以下略) のようなmake上の変数を数十個以上扱っていたため、使い慣れたエディタで作業する前はかなり辛かったです。</p>
<h2 id="%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E9%96%93%E3%81%AE%E5%BD%B1%E9%9F%BF%E3%82%92%E4%B8%8E%E3%81%88%E3%82%8B%E7%AE%87%E6%89%80%E3%82%92%E8%AA%BF%E3%81%B9%E3%82%8B%E9%9A%9B%E3%81%AFlink%E3%82%92%E5%88%87%E3%81%A3%E3%81%A6%E3%81%BF%E3%82%8B"><a class="header-anchor-link" href="#%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E9%96%93%E3%81%AE%E5%BD%B1%E9%9F%BF%E3%82%92%E4%B8%8E%E3%81%88%E3%82%8B%E7%AE%87%E6%89%80%E3%82%92%E8%AA%BF%E3%81%B9%E3%82%8B%E9%9A%9B%E3%81%AFlink%E3%82%92%E5%88%87%E3%81%A3%E3%81%A6%E3%81%BF%E3%82%8B" aria-hidden="true"></a> モジュール間の影響を与える箇所を調べる際はlinkを切ってみる</h2>
<p>所謂プログラムでは、特定の値やメソッドがどこで利用されているかはgrepすればわかります。<br />
WEBアプリケーションとして、GUI上で利用するmakeではそれも慣れが必要です。<br />
まだまだ試行錯誤中ですが、対象のmoduleへのlinkを切るとその後のmoduleでエラーのような表示が出るため、気づきやすくなります。</p>
<p><img src="/images/posts/makes-tips/link.jpg" alt="linkをきると黄色のアイコンが表示される" /></p>
<h2 id="%E5%85%A5%E5%8A%9B%E3%82%92%E5%8F%97%E3%81%91%E3%81%9F%E5%A4%89%E6%95%B0%E3%81%AE%E6%95%B4%E5%BD%A2%E3%82%84%E6%96%87%E5%AD%97%E5%88%97%E9%80%A3%E7%B5%90%E3%82%92%E5%86%92%E9%A0%AD%E3%81%A7%E3%81%BE%E3%81%A8%E3%82%81%E3%81%A6%E8%A1%8C%E3%81%86"><a class="header-anchor-link" href="#%E5%85%A5%E5%8A%9B%E3%82%92%E5%8F%97%E3%81%91%E3%81%9F%E5%A4%89%E6%95%B0%E3%81%AE%E6%95%B4%E5%BD%A2%E3%82%84%E6%96%87%E5%AD%97%E5%88%97%E9%80%A3%E7%B5%90%E3%82%92%E5%86%92%E9%A0%AD%E3%81%A7%E3%81%BE%E3%81%A8%E3%82%81%E3%81%A6%E8%A1%8C%E3%81%86" aria-hidden="true"></a> 入力を受けた変数の整形や文字列連結を冒頭でまとめて行う</h2>
<p>makeは条件ごとの分岐を簡単に実現できて素晴らしいですが、分岐後に合流して似た処理を行うことはできません。<br />
最初に作る時は似た処理をコピー&amp;ペーストで容易に複製できますが、ろくに考えずにコピペすると変更したいときに大きな手間が発生しますし、変更漏れも発生します。<br />
シナリオが次の画像のような構造に近づいてきたときは、変数の整形など冒頭でまとめて行うようなリファクタリングを検討しましょう。</p>
<p><img src="/images/posts/makes-tips/sample.png" alt="分岐が多くとも処理が似ているシナリオ例" /></p>
<p>この工夫はtallyフォームからの入力を受け取る場合、さらに重要だと感じます。<br />
ユーザの回答が想定と異なって後の処理に支障をきたすケースや、そもそもフォームの変更がその後のmakeに反映されていないなどのケースに気付く可能性があがります。<br />
冒頭でエラーを検出できれば、誤ったSlackメッセージの送信など、手戻りの手間が低減します。</p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81"><a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p>ノーコード・ローコードツールも知見が重要だからどんどんアウトプットしよう。<br />
WEBアプリで提供されていても、ブラウザ上での操作に捉われずに快適なやり方を模索しよう。</p>
<h2 id="we-are-hiring!"><a class="header-anchor-link" href="#we-are-hiring!" aria-hidden="true"></a> We Are Hiring!</h2>
<p>クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__471bfcfde815" src="https://embed.zenn.studio/card#zenn-embedded__471bfcfde815" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



クラッソーネでは業務効率化のためにノーコードツールを利用することがあります。
私は最近makeを初めて利用しました。試行錯誤する中で覚えていった工夫を少し紹介します。
https://www.make.com/en

そもそもどういった用途でノーコードツールを利用しているか
一部業務ではNotionに情報を集めている
ユーザーに回答してもらうフォームをtallyで作成している
makeでは回答内容をSlackへ投稿したり、Notion上に記録するなどの処理を行っている

これらを組み合わせて、tallyフォームの回答内容をNotionに保存したり、それをSlackへ通知したりしています。

make用語
scenario: 一連の動作の流れのこと。後述するmoduleとlinkなどを組み合わせてscenarioを作る。
module: 動作の最小単位、ソフトウェアでいうシンプルなメソッドのようなもの。
link: module同士を繋ぐ線。動作の繋がり・流れを表現する。linkに条件を設定することもできる。

make用語説明画像

make上で変数を多数扱う際は各々のエディタで整えて、WEBアプリ上にペーストする
直感的なGUI操作で一連の処理を作成できるのは素晴らしいです。
makeはとてもリッチな機能を持つWEBアプリケーションだと言えるでしょう。
ただし、その分なかなかスムーズに動いてくれません。
マシンパワーが不足し、ファンがうるさく鳴るほどに熱くなったパソコンの入力と画面反映のタイムラグを彷彿とさせることすらあります。
そんな中で多数の変数を扱う項目を変更するのはなかなかに骨が折れます。
make上で扱う変数は一定のルールのもと命名されているため、GUIを用いずとも手入力で対応できることがあります。
そういうときは使い慣れたエディタで整えて、makeの入力欄にペーストしてしまいましょう。

入力欄のスクリーンショット
make入力欄

テキストとしてコピーしたものがこちらです。
アスファルト・コンクリートがら
{{if(1.fieldsById.questionxxxxxx[] = "有り"; "廃棄物を持っていく処分場の数：" + 1.fieldsById.questionxxxxxx[] + newline + "予定数量：" + 1.fieldsById.questionxxxxxx + 1.fieldsById.questionxxxxxx[] + newline + "処分先：" + 1.fieldsById.questionxxxxxx + newline + "処分先住所：" + 1.fieldsById.questionxxxxxx + if(1.fieldsById.questionxxxxxx; newline + "2つ目の処分場" + newline + "予定数量：" + 1.fieldsById.questionxxxxxx + 1.fieldsById.questionxxxxxx[] + newline + "処分先：" + 1.fieldsById.questionxxxxxx + newline + "処分先住所：" + 1.fieldsById.questionxxxxxx; emptystring) + if(1.fieldsById.questionxxxxxx; newline + "3つ目の処分場" + newline + "予定数量：" + 1.fieldsById.questionxxxxxx + 1.fieldsById.questionxxxxxx[] + newline + "処分先：" + 1.fieldsById.questionxxxxxx + newline + "処分先住所：" + 1.fieldsById.questionxxxxxx; emptystring); "廃棄無し")}}

私は 1.fieldsById(以下略) のようなmake上の変数を数十個以上扱っていたため、使い慣れたエディタで作業する前はかなり辛かったです。

モジュール間の影響を与える箇所を調べる際はlinkを切ってみる
所謂プログラムでは、特定の値やメソッドがどこで利用されているかはgrepすればわかります。
WEBアプリケーションとして、GUI上で利用するmakeではそれも慣れが必要です。
まだまだ試行錯誤中ですが、対象のmoduleへのlinkを切るとその後のmoduleでエラーのような表示が出るため、気づきやすくなります。

linkをきると黄色のアイコンが表示される

入力を受けた変数の整形や文字列連結を冒頭でまとめて行う
makeは条件ごとの分岐を簡単に実現できて素晴らしいですが、分岐後に合流して似た処理を行うことはできません。
最初に作る時は似た処理をコピー&ペーストで容易に複製できますが、ろくに考えずにコピペすると変更したいときに大きな手間が発生しますし、変更漏れも発生します。
シナリオが次の画像のような構造に近づいてきたときは、変数の整形など冒頭でまとめて行うようなリファクタリングを検討しましょう。

分岐が多くとも処理が似ているシナリオ例

この工夫はtallyフォームからの入力を受け取る場合、さらに重要だと感じます。
ユーザの回答が想定と異なって後の処理に支障をきたすケースや、そもそもフォームの変更がその後のmakeに反映されていないなどのケースに気付く可能性があがります。
冒頭でエラーを検出できれば、誤ったSlackメッセージの送信など、手戻りの手間が低減します。

まとめ
ノーコード・ローコードツールも知見が重要だからどんどんアウトプットしよう。
WEBアプリで提供されていても、ブラウザ上での操作に捉われずに快適なやり方を模索しよう。

We Are Hiring!
クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。

https://www.crassone.co.jp/recruit/engineer/


make(ノーコードツール)を利用する際のちょっとした工夫

<p>自作アプリ作る作る詐欺をしている永元です。<br />
Herokuの無料枠が廃止されてから1年以上たちました。<br />
今更ながら<br />
「とりあえずRailsアプリをデプロイするためのプラットフォームを試そう」<br />
と思い立ったので、実際に手を動かしていくつかのプラットフォームを試してみました。</p>
<h2 id="%E9%81%B8%E5%AE%9A%E5%9F%BA%E6%BA%96"><a class="header-anchor-link" href="#%E9%81%B8%E5%AE%9A%E5%9F%BA%E6%BA%96" aria-hidden="true"></a> 選定基準</h2>
<p>次の前提をもとにプラットフォームを選びました。</p>
<ul>
<li><a href="https://github.com/rails/docked" target="_blank" rel="nofollow noopener noreferrer">https://github.com/rails/docked</a> で構築した簡単なRailsアプリをデプロイする</li>
<li>リポジトリはGitHubで管理し、そこから容易にデプロイできると望ましい</li>
<li>東京（あるいはアジア・オセアニア）に利用可能なリージョンがある</li>
</ul>
<p>デプロイを試したアプリは下記に公開しています。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__fd10567bf3fb" src="https://embed.zenn.studio/card#zenn-embedded__fd10567bf3fb" data-content="https%3A%2F%2Fgithub.com%2Fnagamoto%2Fweblog" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/nagamoto/weblog" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/nagamoto/weblog</a></p>
<h3 id="%E5%80%99%E8%A3%9C%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0"><a class="header-anchor-link" href="#%E5%80%99%E8%A3%9C%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0" aria-hidden="true"></a> 候補プラットフォーム</h3>
<p>今回デプロイまで行ったのは次の3つです。<br />
<a href="https://railway.app" target="_blank" rel="nofollow noopener noreferrer">Railway</a><br />
<a href="https://app.koyeb.com" target="_blank" rel="nofollow noopener noreferrer">Koyeb</a><br />
<a href="https://dashboard.render.com" target="_blank" rel="nofollow noopener noreferrer">Render</a></p>
<p>他には<a href="https://fly.io/" target="_blank" rel="nofollow noopener noreferrer">Fly.io</a>も有名で評判が良いようです。</p>
<h2 id="%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4%E3%81%AE%E6%BA%96%E5%82%99"><a class="header-anchor-link" href="#%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4%E3%81%AE%E6%BA%96%E5%82%99" aria-hidden="true"></a> デプロイの準備</h2>
<p><a href="https://github.com/nagamoto/weblog" target="_blank" rel="nofollow noopener noreferrer">公開しているこのアプリ</a>は<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__c76b2ec4bfe79" src="https://embed.zenn.studio/card#zenn-embedded__c76b2ec4bfe79" data-content="https%3A%2F%2Fgithub.com%2Frails%2Fdocked" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/rails/docked" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/rails/docked</a><br style="display:none" />
にサンプルとして記載されているアプリを同じ手順で作成しました。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash">docked rails new weblog
<span class="token builtin class-name">cd</span> weblog
docked rails generate scaffold post title:string body:text
docked rails db:migrate
docked rails server
</code></pre></div><p>これでlocal環境での起動が確認できます。<br />
作成したアプリをGitHub上にリポジトリにpushして準備完了です。</p>
<h2 id="%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0%E3%81%94%E3%81%A8%E3%81%AE%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4"><a class="header-anchor-link" href="#%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0%E3%81%94%E3%81%A8%E3%81%AE%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4" aria-hidden="true"></a> プラットフォームごとのデプロイ</h2>
<h3 id="railway"><a class="header-anchor-link" href="#railway" aria-hidden="true"></a> <a href="https://railway.app" target="_blank" rel="nofollow noopener noreferrer">Railway</a></h3>
<p>公式サイトにチュートリアルまで整備されています。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__4eae22e9aa8eb" src="https://embed.zenn.studio/card#zenn-embedded__4eae22e9aa8eb" data-content="https%3A%2F%2Fdocs.railway.app%2Ftutorials%2Fgetting-started" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://docs.railway.app/tutorials/getting-started" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.railway.app/tutorials/getting-started</a></p>
<p>CLIでの操作にも対応していますが、今回はWEBアプリのUIからデプロイを試してみました。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__02130f17ac8f9" src="https://embed.zenn.studio/card#zenn-embedded__02130f17ac8f9" data-content="https%3A%2F%2Frailway.app%2Fnew" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://railway.app/new" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://railway.app/new</a><br style="display:none" />
からデプロイ設定ができます。おおまかな手順は次のとおりです。</p>
<ol>
<li>デプロイ方法を選ぶ</li>
<li>デプロイするリポジトリを選ぶ</li>
<li>環境変数設定を行う(スキップ可能ですが、環境変数RAILS_MASTER_KEYの設定は必要です)</li>
</ol>
<p><img src="/images/posts/app-deploy-some-platforms/Railway_setting.png" alt="環境変数設定画面" /></p>
<p>Railwayにはシンガポールリージョンがあるようです。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__25ba42d20e92e" src="https://embed.zenn.studio/card#zenn-embedded__25ba42d20e92e" data-content="https%3A%2F%2Fdocs.railway.app%2Freference%2Fdeployment-regions" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://docs.railway.app/reference/deployment-regions" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.railway.app/reference/deployment-regions</a></p>
<h3 id="koyeb"><a class="header-anchor-link" href="#koyeb" aria-hidden="true"></a> <a href="https://app.koyeb.com" target="_blank" rel="nofollow noopener noreferrer">Koyeb</a></h3>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__56179ee37d81f" src="https://embed.zenn.studio/card#zenn-embedded__56179ee37d81f" data-content="https%3A%2F%2Fwww.koyeb.com%2Fdocs%2Fdeploy%2Fruby-on-rails" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.koyeb.com/docs/deploy/ruby-on-rails" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.koyeb.com/docs/deploy/ruby-on-rails</a><br style="display:none" />
こちらのページに記載されている通りの手順で滞りなくデプロイできました。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__e09263267f0da" src="https://embed.zenn.studio/card#zenn-embedded__e09263267f0da" data-content="https%3A%2F%2Fapp.koyeb.com%2Fapps%2Fnew" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://app.koyeb.com/apps/new" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://app.koyeb.com/apps/new</a><br style="display:none" />
からデプロイ設定ができます。おおまかな手順は次のとおりです。</p>
<ol>
<li>デプロイ方法を選ぶ(GitHub or Docker)</li>
<li>インポートするプロジェクトを選ぶ(GitHubならリポジトリ選択)</li>
<li>各種設定を行う(環境変数RAILS_MASTER_KEYの設定は必要)</li>
</ol>
<p><img src="/images/posts/app-deploy-some-platforms/koyabs_settings.png" alt="settingページ" /></p>
<p>有料アカウントであれば日本リージョンを選択できそうです。</p>
<h3 id="render"><a class="header-anchor-link" href="#render" aria-hidden="true"></a> <a href="https://dashboard.render.com" target="_blank" rel="nofollow noopener noreferrer">Render</a></h3>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__320303090d4b6" src="https://embed.zenn.studio/card#zenn-embedded__320303090d4b6" data-content="https%3A%2F%2Fdocs.render.com%2Fdeploy-rails" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://docs.render.com/deploy-rails" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.render.com/deploy-rails</a><br style="display:none" />
こちらのページに記載されている通りの手順で滞りなくデプロイできました。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__883d10b55833b" src="https://embed.zenn.studio/card#zenn-embedded__883d10b55833b" data-content="https%3A%2F%2Fdashboard.render.com%2Fcreate%3Ftype%3Dweb" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://dashboard.render.com/create?type=web" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://dashboard.render.com/create?type=web</a><br style="display:none" />
からデプロイ設定ができます。おおまかな手順は次のとおりです。</p>
<ol>
<li>デプロイ方法を選ぶ(Gitリポジトリ or image)</li>
<li>インポートするプロジェクトを選ぶ(GitHubならリポジトリ選択)</li>
<li>各種設定を行う(環境変数RAILS_MASTER_KEYの設定は必要)</li>
</ol>
<p><img src="/images/posts/app-deploy-some-platforms/render.png" alt="各種設定画面" /></p>
<p>最初からシンガポールリージョンを選べるのがいいです。<br />
個人的にダッシュボードはRenderが一番わかりやすかったです。</p>
<h2 id="%E6%89%80%E6%84%9F"><a class="header-anchor-link" href="#%E6%89%80%E6%84%9F" aria-hidden="true"></a> 所感</h2>
<p>どのプラットフォームも、アカウントを作成してGitHub連携をすれば、わずかな設定のみで簡単にデプロイができました。おかげで特にアドバイスもなく、この記事の内容が薄くなりました。</p>
<p>いくつかのプラットフォームにシンガポールリージョンがある中で、日本リージョンがないことにわずかながら悔しさを覚えました。実際のところ、シンガポールリージョンであれば遅延はだいたい気にしないですむのでありがたい限りです。</p>
<p>また、プラットフォームを選ぶ際に、無料枠やリージョン、DBを追加する場合の料金やその他もろもろの拡張性なども含めて調べるとキリがなさそうでした。プレイベートなちょっとしたアプリもAWSにデプロイしていいんじゃないかな？と感じました。<br />
なんてときにちょうどいい記事が弊ブログにあるのでこちらの記事もどうぞ！<br />
<a href="https://tech.crassone.jp/posts/deploy-rails7_1-with-aws-copilot-cli" target="_blank" rel="nofollow noopener noreferrer">Rails7.1アプリをAWS Copilot CLIでAWS Fargateにデプロイする</a></p>
<h2 id="%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE"><a class="header-anchor-link" href="#%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE" aria-hidden="true"></a> 参考文献</h2>
<ul>
<li><a href="https://blog.unasuke.com/2022/compare-heroku-alternatives/" target="_blank" rel="nofollow noopener noreferrer">RailsアプリをHerokuから移行するならどれがいいのか比較する</a></li>
<li><a href="https://zenn.dev/sesere/articles/1e302e22c26b3e" target="_blank">💻 Railsをdeployする時に使えそうなPaaSのメモと簡単な評価</a></li>
</ul>
<h2 id="we-are-hiring!"><a class="header-anchor-link" href="#we-are-hiring!" aria-hidden="true"></a> We Are Hiring!</h2>
<p>クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__ea11f0a05f7c4" src="https://embed.zenn.studio/card#zenn-embedded__ea11f0a05f7c4" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



自作アプリ作る作る詐欺をしている永元です。
Herokuの無料枠が廃止されてから1年以上たちました。
今更ながら
「とりあえずRailsアプリをデプロイするためのプラットフォームを試そう」
と思い立ったので、実際に手を動かしていくつかのプラットフォームを試してみました。

選定基準
次の前提をもとにプラットフォームを選びました。
https://github.com/rails/docked で構築した簡単なRailsアプリをデプロイする
リポジトリはGitHubで管理し、そこから容易にデプロイできると望ましい
東京（あるいはアジア・オセアニア）に利用可能なリージョンがある

デプロイを試したアプリは下記に公開しています。
https://github.com/nagamoto/weblog

候補プラットフォーム
今回デプロイまで行ったのは次の3つです。
Railway
Koyeb
Render

他にはFly.ioも有名で評判が良いようです。

デプロイの準備
公開しているこのアプリは
https://github.com/rails/docked
にサンプルとして記載されているアプリを同じ手順で作成しました。

docked rails new weblog
cd weblog
docked rails generate scaffold post title:string body:text
docked rails db:migrate
docked rails server

これでlocal環境での起動が確認できます。
作成したアプリをGitHub上にリポジトリにpushして準備完了です。

プラットフォームごとのデプロイ
Railway
公式サイトにチュートリアルまで整備されています。
https://docs.railway.app/tutorials/getting-started

CLIでの操作にも対応していますが、今回はWEBアプリのUIからデプロイを試してみました。
https://railway.app/new
からデプロイ設定ができます。おおまかな手順は次のとおりです。
デプロイ方法を選ぶ
デプロイするリポジトリを選ぶ
環境変数設定を行う(スキップ可能ですが、環境変数RAILSMASTERKEYの設定は必要です)

環境変数設定画面

Railwayにはシンガポールリージョンがあるようです。
https://docs.railway.app/reference/deployment-regions

Koyeb
https://www.koyeb.com/docs/deploy/ruby-on-rails
こちらのページに記載されている通りの手順で滞りなくデプロイできました。

https://app.koyeb.com/apps/new
からデプロイ設定ができます。おおまかな手順は次のとおりです。
デプロイ方法を選ぶ(GitHub or Docker)
インポートするプロジェクトを選ぶ(GitHubならリポジトリ選択)
各種設定を行う(環境変数RAILSMASTERKEYの設定は必要)

settingページ

有料アカウントであれば日本リージョンを選択できそうです。

Render
https://docs.render.com/deploy-rails
こちらのページに記載されている通りの手順で滞りなくデプロイできました。

https://dashboard.render.com/create?type=web
からデプロイ設定ができます。おおまかな手順は次のとおりです。
デプロイ方法を選ぶ(Gitリポジトリ or image)
インポートするプロジェクトを選ぶ(GitHubならリポジトリ選択)
各種設定を行う(環境変数RAILSMASTERKEYの設定は必要)

各種設定画面

最初からシンガポールリージョンを選べるのがいいです。
個人的にダッシュボードはRenderが一番わかりやすかったです。

所感
どのプラットフォームも、アカウントを作成してGitHub連携をすれば、わずかな設定のみで簡単にデプロイができました。おかげで特にアドバイスもなく、この記事の内容が薄くなりました。

いくつかのプラットフォームにシンガポールリージョンがある中で、日本リージョンがないことにわずかながら悔しさを覚えました。実際のところ、シンガポールリージョンであれば遅延はだいたい気にしないですむのでありがたい限りです。

また、プラットフォームを選ぶ際に、無料枠やリージョン、DBを追加する場合の料金やその他もろもろの拡張性なども含めて調べるとキリがなさそうでした。プレイベートなちょっとしたアプリもAWSにデプロイしていいんじゃないかな？と感じました。
なんてときにちょうどいい記事が弊ブログにあるのでこちらの記事もどうぞ！
Rails7.1アプリをAWS Copilot CLIでAWS Fargateにデプロイする

参考文献
RailsアプリをHerokuから移行するならどれがいいのか比較する
💻 Railsをdeployする時に使えそうなPaaSのメモと簡単な評価

We Are Hiring!
クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。

https://www.crassone.co.jp/recruit/engineer/


Heroku以外にRailsアプリをデプロイしてみた

<p>子供の成長に喜びつつも、自分は成長しているのか？と焦りも覚えながら育児をしている永元です。<br />
2022年のほとんどを育児休業するという珍しい経験をしたため、記事に残しておきます。</p>
<h2 id="%E3%81%BE%E3%81%88%E3%81%8C%E3%81%8D"><a class="header-anchor-link" href="#%E3%81%BE%E3%81%88%E3%81%8C%E3%81%8D" aria-hidden="true"></a> まえがき</h2>
<ul>
<li>これは1年間育児休業をしたエンジニアの所感記事です</li>
<li>育児休業中ごりごりにスキルアップ！自作アプリをリリース！のような鉄人の話はありません</li>
<li>子供2人の核家族で近隣に親戚なし</li>
</ul>
<h2 id="%E8%82%B2%E5%85%90%E4%BC%91%E6%A5%AD%E9%96%8B%E5%A7%8B%E5%89%8D"><a class="header-anchor-link" href="#%E8%82%B2%E5%85%90%E4%BC%91%E6%A5%AD%E9%96%8B%E5%A7%8B%E5%89%8D" aria-hidden="true"></a> 育児休業開始前</h2>
<h3 id="%E5%87%BA%E6%9D%A5%E4%BA%8B%E3%83%BB%E3%82%84%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8"><a class="header-anchor-link" href="#%E5%87%BA%E6%9D%A5%E4%BA%8B%E3%83%BB%E3%82%84%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8" aria-hidden="true"></a> 出来事・やったこと</h3>
<p>安定期を過ぎ、出産予定3ヶ月前には会社に連絡・申請を始める。<br />
プライベートなことであり、場合によってはセンシティブなことでもあると思い、自分が考える必要な範囲の同僚に伝える。<br />
ほぼすべての人に伝えたのはおよそ1ヶ月前。</p>
<h3 id="%E6%89%80%E6%84%9F"><a class="header-anchor-link" href="#%E6%89%80%E6%84%9F" aria-hidden="true"></a> 所感</h3>
<p>事前に連絡したものの、思っていたより伝えるべき関係者が多く、報連相の下手さが出てしまった。<br />
育児休業を取得することは本人としてはセンシティブな内容でないので、早い段階でどんどん伝えて、やるべきことをあぶり出した方がもっとよかった。<br />
安定期を過ぎたら、変に気を遣わず、仕事で会う人全員に伝えておくくらいで良さそう。</p>
<h2 id="%E8%82%B2%E5%85%90%E4%BC%91%E6%A5%AD%E4%B8%AD"><a class="header-anchor-link" href="#%E8%82%B2%E5%85%90%E4%BC%91%E6%A5%AD%E4%B8%AD" aria-hidden="true"></a> 育児休業中</h2>
<h3 id="%E4%BA%88%E6%83%B3"><a class="header-anchor-link" href="#%E4%BA%88%E6%83%B3" aria-hidden="true"></a> 予想</h3>
<p>正直少し舐めていた。<br />
子供1人の大変さが1なら子供2人なら1.5とか1.7くらいだろうと思っていた。</p>
<h3 id="%E5%87%BA%E6%9D%A5%E4%BA%8B%E3%83%BB%E3%82%84%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8-1"><a class="header-anchor-link" href="#%E5%87%BA%E6%9D%A5%E4%BA%8B%E3%83%BB%E3%82%84%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8-1" aria-hidden="true"></a> 出来事・やったこと</h3>
<p>感染症の流行で上の子が保育園に満足に通えない時期が2ヶ月程度発生した。<br />
上の子と妻は感染。下の子と私が家庭内隔離で感染をなんとか回避できた。</p>
<p>感染症が流行している状況では、復職してもろくに働けないだろうことから、育児休業を大きく延長する決断をし、手続きをした。<br />
※育児休業の延長終了日の繰下げ(延長)は通常1回に限られており、様子を見ながら少しずつ延長することはできないため。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__aa8a8c431a727" src="https://embed.zenn.studio/card#zenn-embedded__aa8a8c431a727" data-content="https%3A%2F%2Felaws.e-gov.go.jp%2Fdocument%3Flawid%3D403AC0000000076" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://elaws.e-gov.go.jp/document?lawid=403AC0000000076" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://elaws.e-gov.go.jp/document?lawid=403AC0000000076</a></p>
<p>分かってはいたものの、子供が0ヶ月〜12ヶ月の間で育児の負担は大きな波があった。</p>
<ul>
<li>授乳頻度が高い時期</li>
<li>夜泣き・寝かしつけの負担が大きい時期</li>
<li>母乳による免疫が切れてよく病気になる時期</li>
<li>はいはいや歩けるようになったばかりで全く目が離せない時期</li>
</ul>
<p>これらの時期は負担が大きく、それらの間に比較的楽な時期があった。<br />
楽な時期には自粛中でもできる趣味を楽しんだり、少しはソフトウェアエンジニアリングの勉強をした。<br />
HugoやNext.jsで静的サイトを作ってみたり、結局Railsに戻ってきたり、技術のつまみ食いだけはやった。<br />
※ほとんど途中で投げ出したためろくな成果物はない</p>
<h3 id="%E6%89%80%E6%84%9F-1"><a class="header-anchor-link" href="#%E6%89%80%E6%84%9F-1" aria-hidden="true"></a> 所感</h3>
<p>2人を育児することは、1人の育児するより2倍以上にしんどいときがあった。予想よりしんどかった。<br />
上の子が拗ねたり、2人で喧嘩したりするのは想像通りだけどやはり対処は難しい。<br />
保育園に通う上の子がそれなりに病気をもらってくるため、下の子がよく体調を崩すのが特にきつかった。<br />
※下の子も保育園に入ればどうせ病気はもらうし、復職してから体調を崩すよりは良い。</p>
<p>感染症の流行がピークの時期は、育児に専念しているにも関わらず相当に辛かった。</p>
<p>休業の延長については会社に感謝しかない。手続きは大変だし、人手の確保・調整も発生したはず。</p>
<p>育児が少し楽になった時期に余暇時間を作れたのはよい息抜きになった。<br />
夫婦が交代で息抜きするスタイルが上手くいった。子供は可愛いが、息抜きは必要。<br />
ただしスプラトゥーン最新作はやりすぎた。復職前の不安は勉強を怠った自分のせい。</p>
<h2 id="%E5%BE%A9%E8%81%B7%E5%BE%8C"><a class="header-anchor-link" href="#%E5%BE%A9%E8%81%B7%E5%BE%8C" aria-hidden="true"></a> 復職後</h2>
<h3 id="%E4%BA%88%E6%83%B3-1"><a class="header-anchor-link" href="#%E4%BA%88%E6%83%B3-1" aria-hidden="true"></a> 予想</h3>
<p>ソフトウェアエンジニアとしてついていけない状態になっているのではないか？<br />
という漠然とした不安はあった。<br />
子供がかわいいからもっと休んでいたい()という気持ちもあった。</p>
<h3 id="%E6%89%80%E6%84%9F-2"><a class="header-anchor-link" href="#%E6%89%80%E6%84%9F-2" aria-hidden="true"></a> 所感</h3>
<p>最低限触っていればブランクは軽減できる…<br />
と思いきやソフトスキル面のブランクを節々で感じた。<br />
報連相などの一般的な社会人力(もともと不得手)、チームでものごとを進める力が低下していた。<br />
休業中に複数人で物事を進める経験を積むのが難しいためかと思う。</p>
<p>子育てと仕事の両方をやることは、油断すると両方を怠慢にする言い訳ができてしまうため、これまで以上に己を律しなければならないと感じた。</p>
<p>ちなみに、6ヶ月より長い育児休業を取得すると家庭内キャッシュフローが大幅に悪化します。<br />
復職後、給料が入るまでの間が1番きついため、カードの支払いに失敗しないように気をつけた方がいいです。<br />
私は失敗しました。</p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81"><a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p>育児休業は休暇ではないし、楽ではない。<br />
でも子供は可愛いし、乳幼児はみるみる成長していくからたくさん見ていられる育児休業は良いぞ！</p>
<p>長期休業では技術的な勉強は大事だが、チームで仕事を進める力が落ちることを意識するのも大事。<br />
子供がいると感染症がより手強くなる。<br />
多数の手続きをスムーズに進めてくれたバックオフィスへの感謝の気持ちが大きくなった。<br />
快く休業させてくれるのは本当にありがたい。</p>
<h2 id="we-are-hiring!"><a class="header-anchor-link" href="#we-are-hiring!" aria-hidden="true"></a> We Are Hiring!</h2>
<p>クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__3f89d59b41401" src="https://embed.zenn.studio/card#zenn-embedded__3f89d59b41401" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



子供の成長に喜びつつも、自分は成長しているのか？と焦りも覚えながら育児をしている永元です。
2022年のほとんどを育児休業するという珍しい経験をしたため、記事に残しておきます。

まえがき
これは1年間育児休業をしたエンジニアの所感記事です
育児休業中ごりごりにスキルアップ！自作アプリをリリース！のような鉄人の話はありません
子供2人の核家族で近隣に親戚なし

育児休業開始前
出来事・やったこと
安定期を過ぎ、出産予定3ヶ月前には会社に連絡・申請を始める。
プライベートなことであり、場合によってはセンシティブなことでもあると思い、自分が考える必要な範囲の同僚に伝える。
ほぼすべての人に伝えたのはおよそ1ヶ月前。

所感
事前に連絡したものの、思っていたより伝えるべき関係者が多く、報連相の下手さが出てしまった。
育児休業を取得することは本人としてはセンシティブな内容でないので、早い段階でどんどん伝えて、やるべきことをあぶり出した方がもっとよかった。
安定期を過ぎたら、変に気を遣わず、仕事で会う人全員に伝えておくくらいで良さそう。

育児休業中
予想
正直少し舐めていた。
子供1人の大変さが1なら子供2人なら1.5とか1.7くらいだろうと思っていた。

出来事・やったこと
感染症の流行で上の子が保育園に満足に通えない時期が2ヶ月程度発生した。
上の子と妻は感染。下の子と私が家庭内隔離で感染をなんとか回避できた。

感染症が流行している状況では、復職してもろくに働けないだろうことから、育児休業を大きく延長する決断をし、手続きをした。
※育児休業の延長終了日の繰下げ(延長)は通常1回に限られており、様子を見ながら少しずつ延長することはできないため。
https://elaws.e-gov.go.jp/document?lawid=403AC0000000076

分かってはいたものの、子供が0ヶ月〜12ヶ月の間で育児の負担は大きな波があった。
授乳頻度が高い時期
夜泣き・寝かしつけの負担が大きい時期
母乳による免疫が切れてよく病気になる時期
はいはいや歩けるようになったばかりで全く目が離せない時期

これらの時期は負担が大きく、それらの間に比較的楽な時期があった。
楽な時期には自粛中でもできる趣味を楽しんだり、少しはソフトウェアエンジニアリングの勉強をした。
HugoやNext.jsで静的サイトを作ってみたり、結局Railsに戻ってきたり、技術のつまみ食いだけはやった。
※ほとんど途中で投げ出したためろくな成果物はない

所感
2人を育児することは、1人の育児するより2倍以上にしんどいときがあった。予想よりしんどかった。
上の子が拗ねたり、2人で喧嘩したりするのは想像通りだけどやはり対処は難しい。
保育園に通う上の子がそれなりに病気をもらってくるため、下の子がよく体調を崩すのが特にきつかった。
※下の子も保育園に入ればどうせ病気はもらうし、復職してから体調を崩すよりは良い。

感染症の流行がピークの時期は、育児に専念しているにも関わらず相当に辛かった。

休業の延長については会社に感謝しかない。手続きは大変だし、人手の確保・調整も発生したはず。

育児が少し楽になった時期に余暇時間を作れたのはよい息抜きになった。
夫婦が交代で息抜きするスタイルが上手くいった。子供は可愛いが、息抜きは必要。
ただしスプラトゥーン最新作はやりすぎた。復職前の不安は勉強を怠った自分のせい。

復職後
予想
ソフトウェアエンジニアとしてついていけない状態になっているのではないか？
という漠然とした不安はあった。
子供がかわいいからもっと休んでいたい()という気持ちもあった。

所感
最低限触っていればブランクは軽減できる…
と思いきやソフトスキル面のブランクを節々で感じた。
報連相などの一般的な社会人力(もともと不得手)、チームでものごとを進める力が低下していた。
休業中に複数人で物事を進める経験を積むのが難しいためかと思う。

子育てと仕事の両方をやることは、油断すると両方を怠慢にする言い訳ができてしまうため、これまで以上に己を律しなければならないと感じた。

ちなみに、6ヶ月より長い育児休業を取得すると家庭内キャッシュフローが大幅に悪化します。
復職後、給料が入るまでの間が1番きついため、カードの支払いに失敗しないように気をつけた方がいいです。
私は失敗しました。

まとめ
育児休業は休暇ではないし、楽ではない。
でも子供は可愛いし、乳幼児はみるみる成長していくからたくさん見ていられる育児休業は良いぞ！

長期休業では技術的な勉強は大事だが、チームで仕事を進める力が落ちることを意識するのも大事。
子供がいると感染症がより手強くなる。
多数の手続きをスムーズに進めてくれたバックオフィスへの感謝の気持ちが大きくなった。
快く休業させてくれるのは本当にありがたい。

We Are Hiring!
クラッソーネに少しでも興味を持っていただけたら、気軽にご連絡ください。

https://www.crassone.co.jp/recruit/engineer/


エンジニアが１年間の育児休業で感じたこと

<p>こんにちは、プロダクト開発部の永元です。</p>
<p>クラッソーネではCTIシステムとしてGenesysを利用しており、管理する顧客情報を連携するためにいくらかハマることがありました。将来の自分のためにも記事として残しておきます。</p>
<h2 id="cti%E3%81%A8%E3%81%AF"><a class="header-anchor-link" href="#cti%E3%81%A8%E3%81%AF" aria-hidden="true"></a> CTIとは</h2>
<p>CTIは、Computer Telephony Integrationの略称です。ざっくり説明すると、所謂コールセンターの業務をサポートするシステムです。詳細に知りたい方は<a href="https://it-trend.jp/cti/article/23-0002" target="_blank" rel="nofollow noopener noreferrer">こちら</a>をどうぞ。</p>
<h2 id="genesys%E3%81%A8%E3%81%AF"><a class="header-anchor-link" href="#genesys%E3%81%A8%E3%81%AF" aria-hidden="true"></a> Genesysとは</h2>
<blockquote>
<p>従来のコールセンターを劇的に進化させる先進のCTIシステム。それが、ジェネシスのコンタクトセンター・ソリューションです。</p>
</blockquote>
<p><a href="https://www.genesys.com/ja-jp" target="_blank" rel="nofollow noopener noreferrer">コンタクトセンター・コールセンターソリューション | オムニチャネル・カスタマーエクスペリエンス | ジェネシス</a> より</p>
<p>GenesysはCTIシステム業界では大手で機能も充実しています。CTIシステムがB向けという性質を持ち、本社がアメリカのサービスなため、大手とは言え日本での認知度は高くなく、公式サイト以外の日本語情報も少ないです。</p>
<h2 id="%E9%80%A3%E7%B5%A1%E5%85%88%E3%81%AE%E6%89%B1%E3%81%84"><a class="header-anchor-link" href="#%E9%80%A3%E7%B5%A1%E5%85%88%E3%81%AE%E6%89%B1%E3%81%84" aria-hidden="true"></a> 連絡先の扱い</h2>
<p>Genesysでは「外部の連絡先」<sup class="footnote-ref"><a href="#fn-c8d7-1" id="fnref-c8d7-1">[1]</a></sup>という名前で顧客情報を扱います。また、「外部の連絡先」には個人と組織が存在します。エンジニアとしてAPIを扱う都合上、日本語訳より英語で覚えることをおすすめします。<br />
外部の連絡先 → external contacts<br />
外部の連絡先(個人) → external contacts(contacts)<br />
外部の連絡先(組織) → external contacts(organizations)</p>
<h2 id="%E3%83%8F%E3%83%9E%E3%82%8A%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88"><a class="header-anchor-link" href="#%E3%83%8F%E3%83%9E%E3%82%8A%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88" aria-hidden="true"></a> ハマりポイント</h2>
<p>新しいサービスを利用開始するときは多少ハマるのは当たり前だと思います。ここでは私が特にハマったことを紹介します。</p>
<h3 id="%E5%85%AC%E5%BC%8F%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AE%E9%96%B2%E8%A6%A7%E3%81%AB%E5%B0%91%E3%81%97%E6%85%A3%E3%82%8C%E3%81%8C%E5%BF%85%E8%A6%81"><a class="header-anchor-link" href="#%E5%85%AC%E5%BC%8F%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AE%E9%96%B2%E8%A6%A7%E3%81%AB%E5%B0%91%E3%81%97%E6%85%A3%E3%82%8C%E3%81%8C%E5%BF%85%E8%A6%81" aria-hidden="true"></a> 公式ドキュメントページの閲覧に少し慣れが必要</h3>
<p>公式ドキュメントは充実しており、うまく検索できれば目的の情報は見つかります。ただ少し慣れが必要です。</p>
<p>公式ドキュメントページは<a href="https://help.mypurecloud.com/" target="_blank" rel="nofollow noopener noreferrer">Resource Center</a>と<a href="https://developer.genesys.cloud/" target="_blank" rel="nofollow noopener noreferrer">Developer Center</a>と大きく2つに分かれていますが、統一感のあるデザインのため、混同しないように注意しましょう。開発者向けの情報はDeveloper Centerを当たりましょう。Resource Centerの検索ボックスからはサンプルコードなどの開発者が求める情報には辿り着けません。(自戒)</p>
<p>日本語のページもそれなりに存在しますが、英語ページしか存在しないことがよくあるため、最初から英語のページを見るのがおすすめです。</p>
<h4 id="%E7%89%B9%E3%81%AB%E3%82%88%E3%81%8F%E9%96%B2%E8%A6%A7%E3%81%99%E3%82%8B%E3%83%9A%E3%83%BC%E3%82%B8"><a class="header-anchor-link" href="#%E7%89%B9%E3%81%AB%E3%82%88%E3%81%8F%E9%96%B2%E8%A6%A7%E3%81%99%E3%82%8B%E3%83%9A%E3%83%BC%E3%82%B8" aria-hidden="true"></a> 特によく閲覧するページ</h4>
<ul>
<li><a href="https://developer.dev-genesys.cloud/api/rest/v2/externalcontacts/" target="_blank" rel="nofollow noopener noreferrer">External Contacts</a>: 外部連絡先関連のAPI一覧できます。顧客情報に関するAPIはだいたいここを見ればなんとかなります。</li>
<li><a href="https://developer.genesys.cloud/api/rest/client-libraries/#-i-class--devicon-javascript-guest-plain-colored----i--guest-chat-client---javascript" target="_blank" rel="nofollow noopener noreferrer">Software Development Kit (SDK)</a>: 各SDKとそのサンプルコードが一覧できます。</li>
<li><a href="https://developer.genesys.cloud/api/tutorials/" target="_blank" rel="nofollow noopener noreferrer">Tutorials</a>: 各環境・言語における様々な利用シーンのチュートリアル(サンプルコード)を一覧できます。自分の目的に近いサンプルが掲載されているととても嬉しいです。</li>
<li><a href="https://developer.genesys.cloud/developer-tools/" target="_blank" rel="nofollow noopener noreferrer">Developer Tools</a>: ブラウザで動作する開発者向けツールです。色んなAPIを試しに呼び出したり、サンプルコードを動かしたりできて便利です。</li>
</ul>
<h3 id="api%E5%88%A9%E7%94%A8%E3%82%92%E5%A7%8B%E3%82%81%E3%82%8B%E3%81%9F%E3%82%81%E3%81%ABweb%E3%82%A2%E3%83%97%E3%83%AA%E4%B8%8A%E3%81%8B%E3%82%89%E4%BA%8B%E5%89%8D%E6%BA%96%E5%82%99%E3%81%8C%E5%BF%85%E8%A6%81"><a class="header-anchor-link" href="#api%E5%88%A9%E7%94%A8%E3%82%92%E5%A7%8B%E3%82%81%E3%82%8B%E3%81%9F%E3%82%81%E3%81%ABweb%E3%82%A2%E3%83%97%E3%83%AA%E4%B8%8A%E3%81%8B%E3%82%89%E4%BA%8B%E5%89%8D%E6%BA%96%E5%82%99%E3%81%8C%E5%BF%85%E8%A6%81" aria-hidden="true"></a> API利用を始めるためにWEBアプリ上から事前準備が必要</h3>
<p>よくある話ではありますが、GenesysでもAPI利用を可能にする事前設定が必要です。利用する認証方法に応じた設定をしましょう。日本語・英語両方のヘルプページを貼っておきますが、APIやその認証方法に詳しい人は英語版だけを読んだほう理解が早いと思います。<br />
<a href="https://help.mypurecloud.com/articles/create-an-oauth-client/" target="_blank" rel="nofollow noopener noreferrer">Create an OAuth client - Genesys Cloud Resource Center</a><br />
<a href="https://jp-help.mypurecloud.com/articles/create-an-oauth-client/" target="_blank" rel="nofollow noopener noreferrer">OAuthクライアントを作成する-Genesysクラウドリソースセンター</a></p>
<p>GenesysAPIは複数の認証方法に対応しています。次のリンクを参照し、利用シーンに適した認証方法を選びましょう。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__7f2201f6e30d4" src="https://embed.zenn.studio/card#zenn-embedded__7f2201f6e30d4" data-content="https%3A%2F%2Fdeveloper.genesys.cloud%2Fapi%2Frest%2Fauthorization%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://developer.genesys.cloud/api/rest/authorization/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://developer.genesys.cloud/api/rest/authorization/</a></p>
<h3 id="ruby%E3%81%AEsdk%E3%81%8C%E3%81%AA%E3%81%84"><a class="header-anchor-link" href="#ruby%E3%81%AEsdk%E3%81%8C%E3%81%AA%E3%81%84" aria-hidden="true"></a> RubyのSDKがない</h3>
<p>厳密には「サポート中のRuby SDKがない」です。<br />
<a href="https://help.mypurecloud.com/articles/deprecation-genesys-cloud-ruby-sdk/" target="_blank" rel="nofollow noopener noreferrer">Deprecation: Genesys Cloud Ruby SDK - Genesys Cloud Resource Center</a><br />
Deprecationですが<a href="https://github.com/MyPureCloud/platform-client-sdk-ruby" target="_blank" rel="nofollow noopener noreferrer">Ruby SDKはGitHubに公開されている</a>ので参考にすることは可能です。実際に弊社では参考にして認証部分の実装を行いました。</p>
<p>Rubyにはありませんが、JavaScriptを始め、主要言語で複数種類のSDKが提供されています。公式SDKが豊富なのは非常にありがたいです。</p>
<h3 id="%E9%80%A3%E7%B5%A1%E5%85%88%E3%81%AE%E3%83%90%E3%83%AA%E3%83%87%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3"><a class="header-anchor-link" href="#%E9%80%A3%E7%B5%A1%E5%85%88%E3%81%AE%E3%83%90%E3%83%AA%E3%83%87%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3" aria-hidden="true"></a> 連絡先のバリデーション</h3>
<p>外部の連絡先(個人)の場合は姓・名が必須です。姓と名を分けずに管理しているところは対応が必要そうです。<br />
姓: 鈴木一郎<br />
名: .<br />
のように姓と名どちらかにフルネームで設定し、使わない方に意味はなくとも何某かの文字を設定する…といった回避方法はありますが、あまりおすすめしません。Genesysの担当者と自社の状況を踏まえて相談しましょう。</p>
<p>外部の連絡先(組織)の場合は組織名のみ必須です。こちらは特に躓くことはなさそうです。</p>
<h3 id="%E9%9B%BB%E8%A9%B1%E7%95%AA%E5%8F%B7%E3%81%AE%E5%BD%A2%E5%BC%8F"><a class="header-anchor-link" href="#%E9%9B%BB%E8%A9%B1%E7%95%AA%E5%8F%B7%E3%81%AE%E5%BD%A2%E5%BC%8F" aria-hidden="true"></a> 電話番号の形式</h3>
<p>"090xxxxxxxx"<br />
は電話番号として認識されません。電話番号冒頭の0は国内を意味するプレフィックスであり、GenesysのAPI利用時には日本の電話番号であることを明示する必要があるためです。冒頭の"0"を"+81"に置換した"+8190xxxxxxxx"であれば日本の携帯電話番号として認識され、APIから登録が可能です。</p>
<p>ちなみにGenesysのWEBアプリから入力するときは自動的にデフォルトで設定されている国コードに変換して保存してくれます。そのおかげでAPI利用時のエラー原因に気づきにくいです。</p>
<p>※電話番号のプレフィックスなど詳細については<a href="https://www.soumu.go.jp/main_sosiki/joho_tsusin/top/tel_number/q_and_a.html" target="_blank" rel="nofollow noopener noreferrer">総務省｜電気通信番号制度｜電話番号に関するQ&amp;A</a>の参照をおすすめします</p>
<h3 id="%E9%9B%BB%E8%A9%B1%E7%95%AA%E5%8F%B7%E6%A4%9C%E7%B4%A2%E3%81%AB%E7%99%96%E3%81%8C%E3%81%82%E3%82%8B"><a class="header-anchor-link" href="#%E9%9B%BB%E8%A9%B1%E7%95%AA%E5%8F%B7%E6%A4%9C%E7%B4%A2%E3%81%AB%E7%99%96%E3%81%8C%E3%81%82%E3%82%8B" aria-hidden="true"></a> 電話番号検索に癖がある</h3>
<p>"090xxxxxxxx"<br />
という携帯電話番号について検索したいときは<br />
"90-xxxx-xxxx"<br />
で検索しましょう。</p>
<p>冒頭の国を表すプレフィックスは削除し、ハイフン(全角半角どちらでも可らしい)ありの形式であればHITします。これを知らないと、<br />
「APIで外部の連絡先を作成して200レスポンスだったけど、作成したはずの連絡先が見つからない」<br />
と焦ることになります。(自戒)</p>
<p>また、この仕様はAPIを利用した検索・WEBアプリ上の検索どちらも同じ仕様です。Genesysで電話対応を行うスタッフにこそ、知らせたいです。</p>
<h2 id="%E6%9C%80%E5%BE%8C%E3%81%AB"><a class="header-anchor-link" href="#%E6%9C%80%E5%BE%8C%E3%81%AB" aria-hidden="true"></a> 最後に</h2>
<p>ハマった後に「早く担当者に聞いておけばよかったな。聞いたらすぐ解決してたな。」という反省が私にはありました。Genesysに限らず、新しいツール・サービスの利用を始めるときに多少ハマるのは仕方のないことです。早めに積極的に問い合わせていきたいですね。</p>
<h2 id="we-are-hiring!"><a class="header-anchor-link" href="#we-are-hiring!" aria-hidden="true"></a> We Are Hiring!</h2>
<p>クラッソーネに少しでも興味を持っていただけたらぜひお気軽にご連絡ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__45a233992ebd4" src="https://embed.zenn.studio/card#zenn-embedded__45a233992ebd4" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>
<section class="footnotes">
<span class="footnotes-title">脚注</span>
<ol class="footnotes-list">
<li id="fn-c8d7-1" class="footnote-item"><p>コールセンターのメンバーが内部。電話をかける・かけてくる相手が外部という扱いらしいです。 <a href="#fnref-c8d7-1" class="footnote-backref">↩︎</a></p>
</li>
</ol>
</section>



こんにちは、プロダクト開発部の永元です。

クラッソーネではCTIシステムとしてGenesysを利用しており、管理する顧客情報を連携するためにいくらかハマることがありました。将来の自分のためにも記事として残しておきます。

CTIとは
CTIは、Computer Telephony Integrationの略称です。ざっくり説明すると、所謂コールセンターの業務をサポートするシステムです。詳細に知りたい方はこちらをどうぞ。

Genesysとは
>従来のコールセンターを劇的に進化させる先進のCTIシステム。それが、ジェネシスのコンタクトセンター・ソリューションです。

コンタクトセンター・コールセンターソリューション | オムニチャネル・カスタマーエクスペリエンス | ジェネシス より

GenesysはCTIシステム業界では大手で機能も充実しています。CTIシステムがB向けという性質を持ち、本社がアメリカのサービスなため、大手とは言え日本での認知度は高くなく、公式サイト以外の日本語情報も少ないです。

連絡先の扱い
Genesysでは「外部の連絡先」という名前で顧客情報を扱います。また、「外部の連絡先」には個人と組織が存在します。エンジニアとしてAPIを扱う都合上、日本語訳より英語で覚えることをおすすめします。
外部の連絡先 → external contacts
外部の連絡先(個人) → external contacts(contacts)
外部の連絡先(組織) → external contacts(organizations)

: コールセンターのメンバーが内部。電話をかける・かけてくる相手が外部という扱いらしいです。

ハマりポイント
新しいサービスを利用開始するときは多少ハマるのは当たり前だと思います。ここでは私が特にハマったことを紹介します。

公式ドキュメントページの閲覧に少し慣れが必要
公式ドキュメントは充実しており、うまく検索できれば目的の情報は見つかります。ただ少し慣れが必要です。

公式ドキュメントページはResource CenterとDeveloper Centerと大きく2つに分かれていますが、統一感のあるデザインのため、混同しないように注意しましょう。開発者向けの情報はDeveloper Centerを当たりましょう。Resource Centerの検索ボックスからはサンプルコードなどの開発者が求める情報には辿り着けません。(自戒)

日本語のページもそれなりに存在しますが、英語ページしか存在しないことがよくあるため、最初から英語のページを見るのがおすすめです。

特によく閲覧するページ
External Contacts: 外部連絡先関連のAPI一覧できます。顧客情報に関するAPIはだいたいここを見ればなんとかなります。
Software Development Kit (SDK): 各SDKとそのサンプルコードが一覧できます。
Tutorials: 各環境・言語における様々な利用シーンのチュートリアル(サンプルコード)を一覧できます。自分の目的に近いサンプルが掲載されているととても嬉しいです。
Developer Tools: ブラウザで動作する開発者向けツールです。色んなAPIを試しに呼び出したり、サンプルコードを動かしたりできて便利です。

API利用を始めるためにWEBアプリ上から事前準備が必要
よくある話ではありますが、GenesysでもAPI利用を可能にする事前設定が必要です。利用する認証方法に応じた設定をしましょう。日本語・英語両方のヘルプページを貼っておきますが、APIやその認証方法に詳しい人は英語版だけを読んだほう理解が早いと思います。
Create an OAuth client - Genesys Cloud Resource Center
OAuthクライアントを作成する-Genesysクラウドリソースセンター

GenesysAPIは複数の認証方法に対応しています。次のリンクを参照し、利用シーンに適した認証方法を選びましょう。
https://developer.genesys.cloud/api/rest/authorization/

RubyのSDKがない
厳密には「サポート中のRuby SDKがない」です。
Deprecation: Genesys Cloud Ruby SDK - Genesys Cloud Resource Center
DeprecationですがRuby SDKはGitHubに公開されているので参考にすることは可能です。実際に弊社では参考にして認証部分の実装を行いました。

Rubyにはありませんが、JavaScriptを始め、主要言語で複数種類のSDKが提供されています。公式SDKが豊富なのは非常にありがたいです。

連絡先のバリデーション
外部の連絡先(個人)の場合は姓・名が必須です。姓と名を分けずに管理しているところは対応が必要そうです。
姓: 鈴木一郎
名: .
のように姓と名どちらかにフルネームで設定し、使わない方に意味はなくとも何某かの文字を設定する…といった回避方法はありますが、あまりおすすめしません。Genesysの担当者と自社の状況を踏まえて相談しましょう。

外部の連絡先(組織)の場合は組織名のみ必須です。こちらは特に躓くことはなさそうです。

電話番号の形式
"090xxxxxxxx"
は電話番号として認識されません。電話番号冒頭の0は国内を意味するプレフィックスであり、GenesysのAPI利用時には日本の電話番号であることを明示する必要があるためです。冒頭の"0"を"+81"に置換した"+8190xxxxxxxx"であれば日本の携帯電話番号として認識され、APIから登録が可能です。

ちなみにGenesysのWEBアプリから入力するときは自動的にデフォルトで設定されている国コードに変換して保存してくれます。そのおかげでAPI利用時のエラー原因に気づきにくいです。

※電話番号のプレフィックスなど詳細については総務省｜電気通信番号制度｜電話番号に関するQ&Aの参照をおすすめします

電話番号検索に癖がある
"090xxxxxxxx"
という携帯電話番号について検索したいときは
"90-xxxx-xxxx"
で検索しましょう。

冒頭の国を表すプレフィックスは削除し、ハイフン(全角半角どちらでも可らしい)ありの形式であればHITします。これを知らないと、
「APIで外部の連絡先を作成して200レスポンスだったけど、作成したはずの連絡先が見つからない」
と焦ることになります。(自戒)

また、この仕様はAPIを利用した検索・WEBアプリ上の検索どちらも同じ仕様です。Genesysで電話対応を行うスタッフにこそ、知らせたいです。

最後に
ハマった後に「早く担当者に聞いておけばよかったな。聞いたらすぐ解決してたな。」という反省が私にはありました。Genesysに限らず、新しいツール・サービスの利用を始めるときに多少ハマるのは仕方のないことです。早めに積極的に問い合わせていきたいですね。

We Are Hiring!
クラッソーネに少しでも興味を持っていただけたらぜひお気軽にご連絡ください。

https://www.crassone.co.jp/recruit/engineer/


クラッソーネ開発者ブログ

永元雄宙が執筆した記事

『はじめよう!プロセス設計　要件定義のその前に』が寄り添ってくれる良書だった

make(ノーコードツール)を利用する際のちょっとした工夫

Heroku以外にRailsアプリをデプロイしてみた

エンジニアが１年間の育児休業で感じたこと

Genesys入門時にハマったポイント

永元 雄宙が執筆した記事

『はじめよう!プロセス設計 要件定義のその前に』が寄り添ってくれる良書だった

make(ノーコードツール)を利用する際のちょっとした工夫

Heroku以外にRailsアプリをデプロイしてみた

エンジニアが１年間の育児休業で感じたこと

Genesys入門時にハマったポイント

永元雄宙が執筆した記事

『はじめよう!プロセス設計　要件定義のその前に』が寄り添ってくれる良書だった