Day、DataTechという、3つのイベントを開催しております。それぞれ編集部独自の切り口で、業界トレンドや最新事例を網羅。最新の動向を知ることができる場として、好評を得ています。Academy」や、すべてのITパーソンに向けた「新エバンジェリスト養成講座」などの講座を企画しています。EnterpriseZine編集部ならではの切り口・企画・講師セレクトで、明日を担うIT人材の育成をミッションに展開しております。市場を勝ち抜く企業はどこにEnterpriseZine編集部が最旬ITトピックの深層に迫る。ここでしか読めない、エンタープライズITの最新トピックをお届けします。一見すると何の問題もないように思える説明文でも、突き詰めて見ていくと曖昧な表現が紛れ込んでおり、正しく情報を伝えられないことがある。ここでは例題文を検討しながら問題点を見つける力を身につけ、「適切な説明文」が書けるようにトレーニングしていこう。IT技術者が書かなければならない書類は多種多様である。それらの文書を少しでもわかりやすく書ければ、コミュニケーション改善に効果があり、その分仕事が楽になるというものだ。文書の種類により書くべき項目がそれぞれ違っても、大抵どの文書にも「日本語による説明文」がなんらかの形で入っている。いうことは、その「日本語による説明文」の品質を向上させれば、文書全体の品質向上にも役立つということだ。そこでこの連載は「日本語による説明文(数行程度の短いもの)」の品質向上を目的として、IT技術者が直面するさまざまな文書事例からその問題点と改善策を検討しようというテーマを設定した。どんな文書にも数行程度の短い説明文は何かしら入っているし、その数行の範囲でも何かしら改善点は見つかるものだ。そんな短い文面の改善策を考えるという経験を数多く積めば、それに伴って「見る目」が養われていき、次第に良い説明文が書けるようになる。1日3分でいいのである。できるだけ毎日1回は考えるようにしたい。実際の事例を検討してみよう。夜間バッチの例文まずは次の例文を読んでもらいたい。ある設計書の中の「夜間バッチ」に関する記述の一部である。毎日、全国の各支店ならびにグループ企業からの売上報告が上がってくるが、グループ企業のデータフォーマットがまちまちなため、これらを整形し直し、本社DBに格納するために夜間バッチを行う。夜間バッチは平日の深夜2時に動作する。土日は営業がないためバッチは動作しない。動作概要グループ企業内の売り上げ(本店・支店含む)は、グループ企業それぞれのDBに格納されている。夜間バッチは指定時刻に各DBにアクセスし、その日の売り上げ分を取得する。そのデータを本社DBに整形して登録する。最後にバッチ動作ログテーブルにその日の売り上げを集計したことを記録する。基本設計書にはよくある書き方で、一見すると特に問題ないように見える。このような設計書を読む時・書く時には、「設計が適切かどうか」だけではなく、「説明文が適切かどうか」についても執念深く鵜の目鷹の目で検討するようにして欲しい。例文は10行以上あるが、大まかに3つのブロックに分かれているので1ブロックあたりにすれば5行以下である。5行以下の文であれば考えるのにもそれほど時間はかからないはずだ。IT技術者の業務経験を通して「読み解き、考え、説明する」スキルの再教育の必要性を認識し、2003年からその著述・教育業務を開始。Day、DataTechという、3つのイベントを開催しております。それぞれ編集部独自の切り口で、業界トレンドや最新事例を網羅。NEW新着記事一覧を見るイベントイベントカレンダーを見る講座イベントカレンダーを見る「EnterpriseZine」(エンタープライズジン)は、翔泳社が運営する企業のIT活用とビジネス成長を支援するITリーダー向け専門メディアです。データテクノロジー/情報セキュリティ/システム運用の最新動向を中心に、企業ITに関する多様な情報をお届けしています。イラストの無断転載を禁じます。記載されているロゴ、システム名、製品名は各社及び商標権者の登録商標あるいは商標です。