マニュアル作成で心がけることとは

皆さんはシステム開発現場のマニュアルや仕様書などのドキュメントに対して、どのようなイメージをお持ちでしょうか。 実際にシステム開発の現場で整備されていたマニュアルが、めちゃくちゃ役に立ったと考えているかたは、ごく少数なのではないでしょうか。 各プロジェクトで、エンジニアの入れ替わりが当たり前になった昨今では、業務マニュアルやシステムの操作マニュアルがない会社はないと言っても過言ではありません。 ・分厚くて読む気がしない ・どこに何が書いてあるのか分かりにくい ・そもそも読んでも理解できない ・プロセスやトラブルの解決策が抜けがち ・書いてある内容が古い(アップデートされていない) 上記の内容はいずれも、マニュアルが風化する原因の1つです。 裏を返せば、マニュアルを作る側が、上記のような状態にならないように気をつけるべき項目とも考えることが出来ます。 実際、多くのシステム開発の現場で、マニュアルと実際に稼働しているシステムとの情報が乖離しており、マニュアルはストレージを圧迫する邪魔な存在。だと認識されているケースが多いです。 今回の記事では、システムの操作マニュアルに関して、みなさんが実際にマニュアルを作成する場合に、分かりやすく使いやすいマニュアルを作るために心がけるべき5つのポイントについて解説していこうと思います。

製造・コーディング(PG/バックエンド)

タスク管理ツール、Redmineの使い方

Redmine(レッドマイン)とはオープンソースで公開されているプロジェクト管理ツールのことです。 プロジェクト管理ツールとは、チームで作業する場合の進捗状況やスケジュールを管理することを目的としており、システム開発などエンジニアの仕事においては必須のツールであります。 今は様々なプロジェクト管理ツールが存在していますが、数あるツールの中でもRedmineはオープンソースで自由度が高いという特徴を持っています。 Redmineはフランス人であるJean-Philippe Lang氏によって開発され、2006年に最初のバージョンがリリースされた、かなり歴史の古いプロジェクト管理ツールです。 オープンソースであるためGitHub上でソースコードが公開されており、様々なエンジニアが開発に参画していますしていることから、GitHubでは細かいアップデートが頻繁に行われています。 また、Redmineはオープンソースソフトウェアであるため、全ての機能を無料で使うことが可能です。個人利用としてプロジェクト管理ツールを使いたい場合にも心強いと言えるでしょう。

製造・コーディング(PG/バックエンド)

システム開発のテスト工程で重要な事とは?

システム開発では、不具合やバグが無いかを検証するテスト工程と呼ばれる期間が存在します。 テスト工程には大きく分けて下記4つのテスト内容が存在します。 ・単体テスト・・画面や機能ごとに、動作の検証をする ・結合テスト・・他の機能やシステムと連携させて、動作の検証をする ・総合テスト・・本運用を想定して、システム全体の動作を検証する・ 受入れテスト・・納品前に仕様書の通り完成しているか確認する システム開発におけるテストの役割は、開発したシステム、記述したプログラムが不具合なく動作するか、バグなどがないかをチェックして修正する工程のことを指します。 どれだけ優秀なエンジニアが開発していようと、人の手が介在するシステム開発では、バグがないということは絶対にあり得ません。 たとえば、システム開発の現場でもっともポピュラーな開発の流れの「ウォーターフォール型」を採用している場合、「単体テスト」「結合テスト」「システムテスト(総合テスト)」「受け入れテスト(ユーザーテスト)」の、大きく4つのテスト工程が実施されます。

製造・コーディング(PG/バックエンド)

DX化を加速させるローコード開発とは?

昨今、様々な外的要因により企業をとりまくビジネス環境の変化が大きく加速しています。 これまでと比べて、より柔軟に、よりスピード感を持った迅速な対応が求められる時代になってきているのではないでしょうか。 そんな中、企業のあらゆるニーズに応え、ITをビジネスの成果に直結させる手段としてここ数年で「ローコード開発」というシステム開発の手法が注目されています。 今回の記事では、ローコード開発とはどのようなものなのか、従来の開発手法との違いやメリット・デメリットなどと併せて紹介していこうと思います。

製造・コーディング(PG/バックエンド)

【初心者用】PowerBIで出来ることとは?

昨今の経営判断や意思決定には、データ分析が必要とされています。 データ分析や、データの可視化が注目される昨今、「Power BI」という言葉を耳にすることが多くなりましたが、皆様は「Power BI」という言葉をご存知でしょうか? 今回紹介するPower BIはBI(ビジネス・インテリジェンス)ツールとしてマイクロソフト社から提供されている製品の1つです。 BIツールとは、企業が蓄積しているデータを分析し、その結果から得られたデータをあらゆる活動(経営判断など)に生かすためのツールです。 データそのもの自体が蓄積されるデータベースとは違い、レポートを表示したり、データ分析に関する豊富な機能を持ったソフトウェアのことです。 BIツールは世の中に多く存在しますが、BIツールの中でも注目されているのが「セルフサービスBI」と呼ばれる種類のBIツールです。 セルフサービスBIとは、データ分析を行う作業のおおよそ半分以上の作業をBIツールが自動化するというもので、効率良くデータ分析を行うことが出来るということで注目されています。 ただし、セルフサービスだからといって誰でも簡単に扱えるというわけではありません。 セルフサービスBIは、業務部門が主体になってデータ分析を実行できるようにするためのものであるため、ある程度データ分析に関する知識と製品知識が必要となってきます。 今回紹介するPower BIは、このセルフサービスBIに分類される製品であり、一般的なITに関する知識があれば比較的簡単にデータ分析ができます。

製造・コーディング(PG/バックエンド)

【入門編】SQLserverでできることとは?

SQL Server(エスキューエルサーバー)は正式名称「Microsoft SQL Server」と呼ばれます。 Microsoft SQL Server とは、エクセルやワードなどを提供しているマイクロソフトが開発している、リレーショナルデータベース管理システム (RDMS) です。 簡単にいうとマイクロソフトのデータベース製品ということです。 Macでも使えないことはないですが、Microsoft SQL ServerはWindows環境でとても使いやすく、人気が高いデータベースです。 特徴としては「Microsoft SQL Server Management Studio」という管理ツールがあることで、Microsoft SQL Server Management StudioはSQL Server の設定、管理、開発等を行うことが出来ます。 Microsoft SQL Serverでクエリーを書くには、「T-SQL (Transact-SQL)」という SQL 言語を使用します。

製造・コーディング(PG/バックエンド)

【初心者用】javaで出来ることとは?

Javaはプログラミング言語の中でも、昔からエンジニアの圧倒的な支持率とシェア率を持ち、言語の人気では常に上位に位置するプログラミング言語です。 Javaで開発されているシステムはWebサービスから業務系システム、組み込み、スマホアプリまで非常に多岐にわたり、様々な業界、様々な分野の開発現場でjavaは採用されています。 何でもできる汎用性の高さから、エンジニアを目指す際にJavaを習得しようと考える人も多いのが現状です。

製造・コーディング(PG/バックエンド)

【入門編】AWSとは何か?人気の理由まで解説

ITの業務に従事されている方や、インターネットやSNS等でIT関連の情報を収集されている方なら一度は聞いたことのある言葉の一つが、「AWS」ではないでしょうか? AWSとはアマゾンが提供するクラウドプラットフォームであり、正式名称はAmazon Web Service(アマゾンウェブサービス)です。 本記事では、AWSを使うと何ができるのか?なぜそんなに人気なのか?など、初心者の方が疑問に持つであろう部分を網羅的にまとめた記事となっております。 この記事を読むことで分かること ・AWSとは何かが理解できる ・AWSが人気な理由が分かる

製造・コーディング(PG/バックエンド)

【初心者用】PHPフレームワーク、CakePHPについて

今回の記事では、PHPの代表的なフレームワークの一つであるCakePHPとは何か?について解説していこうと思います。 CakePHPはPHPをいうプログラミング言語のフレームワークです。 PHPとは、簡単に言うと高難易度と言われているC言語の設計を模倣しながらもC言語よりも文法が簡易的な点から、初心者にオススメされている人気プログラミング言語です。 そのPHPの機能を部分的にパッケージ化したものが、今回紹介するCakePHPというフレームワークになります。

製造・コーディング(PG/バックエンド)

【初心者用】Pythonでできることについて

現在、最も注目を集めているプログラミング言語の1つといわれているのが、今回紹介する「Python (パイソン)」です。 Pythonの特長としては、人工知能(機械学習や深層学習)などの最先端分野の開発にも使われている一方、プログラムの記述方法が簡単なため、 プログラミングを始めたばかりの初心者の方でも大規模なWebアプリケーション開発が短期間でできることがあげられます。 今回は、そんなPython の魅力について詳しくご紹介します。

製造・コーディング(PG/バックエンド)

【初心者用】JavaとJavaScriptの違いは?Javascriptで出来ることは?

JavaScript(ジャバスクリプト)は、プログラミング言語の一種です。 名前は聞いたことがあっても「実際に、どういうことに使われているのか?」「JavaScriptは何のジャンルが得意で、どういったことが実現できるのか?」ということまでは、あまり知られていないのではないでしょうか? 初心者の方で特に多いのが「Javaが得意な人は、JavaScriptも得意」という誤った認識です。 良く混同されがちですが、JavaとJavaScriptとはまったくの別物です。 では、具体的にどのような違いがあるのでしょうか? JavaScriptの詳しい説明も交えながら、JavaとJavaScriptの違いについてまとめてみました。

製造・コーディング(PG/バックエンド)