kunitaka's SharePoint Factory 〜2nd Season〜

こんばんは、ソノリテの費です。

さて、予告通りの Yammer API ネタを書いてみます。
何故、急に Yammer ネタなのかというと、休み中で会社に置いてある検証環境に触れないので、触らなくても書けるネタということで、これになりました・・・ (苦笑い)

• 開発者向けコミュニティ

昔、グローバルな開発者向けコミュニティとしては、Yammer の外部ネットワークで Yammer Developer Network (YDN) というのがあったのですが、私が前職を退職して Yammer から遠ざかっている間にクローズになっていました。
こちらによると、昨年の 9月末に終了とのこと。

・Yammer Developer Network (YDN) is shutting down
http://nubo.eu/news/yammernews/plamber/yammer-developer-network-ydn-is-shutting-down/

現在、その代わりとして、Office 365 Community という Yammer 外部ネットワークがあって、この中の「O365 Dev Yammer Apps」というグループがあります。

・Office 365 Community
https://www.yammer.com/itpronetwork

参加申請を行うと、ほどなく管理者から招待されるので、承諾すれば参加が出来ます。

私は Yammer Developer Network にて、今回書くネタでほんの少し貢献していたのですが、残念ながらそれも参照することが出来ず・・・



• Yammer REST API

ここでは、特に REST API については触れません。　簡単に言えば、HTTP 仕様に準拠した Web サービスということでしょうか。
なお、Yammer の REST API については、こちらに簡単なリファレンスがあります。

・REST API
https://developer.yammer.com/restapi/

Yammer REST API では、JSON または XML 形式のエンドポイントが利用可能です。

例えば、アクセスしているユーザー (つまり、自分の情報) については、ブラウザ上で以下の URL をリクエストすると、結果が XML で返って来ます。

https://www.yammer.com/api/v1/users/current.xml



JSON 形式で返して欲しい場合は、以下のような URL になります。

https://www.yammer.com/api/v1/users/current.json

つまり、拡張子を XML にすると XML 形式で、拡張子を JSON にすると JSON 形式で返ってくる訳です。
なお、拡張子を省略すると、推奨されている JSON 形式で返されます。

こちらの結果には、/response/web-preferences/home-tabs/home-tab の 9番目のノードから、自分の所属するグループが展開されています。
但し、グループに関する情報は最低限で、名前、グループID、URL、プライベートグループかどうかのフラグ位しか含まれていません。

詳細のグループ情報が欲しい場合は、以下の URL をリクエストします。

https://www.yammer.com/api/v1/groups.xml

こちらで、グループID、名前、説明、プライベートグループかどうかのフラグ、URL、Web URL、Office 365 URL、グループアイコン、グループ作成日、グループ作成者ID、メンバー数、最終更新日などが分かります。
つまり、これらの2つのリソースを使うことで、自分の所属するグループに関する情報が得られるわけです。

ところが、実は、1つのリクエストで、自分の所属するグループに関する情報を得る方法があります。
それが、こちらの URL です。

https://www.yammer.com/api/v1/groups.xml?mine=1

ちなみに、これ、「グループを参照」で「他のグループを参照」を選択して、「グループ」ページで、「マイ グループ」タブを選択した時の内容と同じものです。

なお、前者はグループが文字コード順となっていますが、後者は、グループが参加メンバーが多い順となっています。



• ブラウザでの Yammer ページでの自分の所属するグループ一覧

ところで、ブラウザで Yammer ページを参照した時に、画面左側に自分が参加しているグループの一覧が表示されていると思います。



これは、スマートフォーンでの Yammer アプリで「マイ グループ」を見た時と同じはずですが、Yammer では参照頻度に応じて、こちらのグループ一覧の順序が最適化されています。
Web ベースの場合、最大 20 グループまでが表示されていると思います。

実は、これを REST API で取得する方法があります。
それが、こちらの URL です。

https://www.yammer.com/api/v1/networks/current.json?exclude_own_messages_from_unseen=true&include_group_counts=true

残念ながら、こちらは XML 形式での取得が出来ないようで、JSON 形式でのリクエストとなります。
返って来た JSON の中で、is_primary が true のネットワーク構造の中に、group_counts の配下にグループIDと未読件数がペアで、かつ、Yammer ページでのグループ一覧の順序で展開されています。
副産物？として、グループ毎の未読件数が参照出来ます。

こちらの情報はリファレンスにも記載がありません。
では、どうやって知ったのか？
Yammer ページをアクセスした際の HTTP のリクエスト状況を IE の「F12 開発者ツール」でトレースして解析した結果です (苦笑い)

つまり、Yammer ページも REST API を利用して JavaScript コードにより表示内容を作成している訳ですね。
恐らく、Yammer アプリについても、同様に、こちらの REST API を利用していると思われます。

次回は、実際に JavaScript の中で Yammer REST API を利用する場合について、解説したいと思います。

---

Kokuho Hi (Sonorite / SharePoint Technology Center)

こんばんは、ソノリテの費です。

前回、Windows Server 2012 R2 のサーバー OSの仮想マシンのディスクイメージを作成したので、これに SharePoint Server 2013 をセットアップした状態の仮想マシンのディスクイメージを作成することにします。

• SharePoint Server 2013 のセットアップ

まずは作成済みのサーバー OSの仮想マシンのディスクイメージを利用して、新しい仮想マシンを作成します。
そして、普通に起動します。
ほどなく、インストールイメージの一般化が行われて、再起動すると、ログイン待ちの状態になっています。
ここまで、手元の環境で 4分程度でした。
Windows Server 2012 R2 を最初からセットアップを行う場合は十数分掛かって、更に、最新の更新プログラムの適用を行うと物凄く時間が掛かります。
そう意味でも、sysprep による仮想マシンのディスクイメージはとても助かります。

次に、SharePoint Server 2013 のセットアップを行います。
ISO イメージとしては、SharePoint Server 2013 with SP1 というスリップストリームイメージがあるので、まずは、こちらのセットアップを行います。



既に SP1 がリリースされている現在では、かなりのバグ修正が行われていると考えられることから、こちらでセットアップを行うのは必須ですね。

・SharePoint Server 2013 SP1 の特徴
http://www.microsoft.com/ja-jp/sharepoint/sharepoint2013sp1.aspx
・SharePoint Server 2013 Service Pack 1 が再リリースされました
http://blogs.technet.com/b/sharepoint_support/archive/2014/04/23/sharepoibnt-2013-sp1-rerelease.aspx
・Description of Microsoft SharePoint Server 2013 Service Pack 1 (SP1)
http://support.microsoft.com/kb/2880552



• SharePoint Server 2013 累積的更新プログラム

次に、累積的更新プログラム (CU) の適用を行います。

ところで、SharePoint の累積的更新プログラム (CU: Cumulative Update) は、2014年7月から、2か月毎のリリースから、1カ月毎のリリースに変わったんですね。
それに伴って、パッケージング方法が2種類になっています。

コンポーネント毎のモジュールと、全てのコンポーネントを含むサーバー パッケージというものがあります。
これは、修正モジュールのリリースをタイムリー、かつ、確実にリリースするための処置のようです。

サーバーパッケージの場合、直前のサービスパック以後の全てのコンポーネントの累積的更新プログラムとなるので、Project Server のパッケージには、SharePoint Server と Foundation が含まれ、harePoint Server のパッケージには Foundation 含まれるという形になります。
これに対して、コンポーネント毎のモジュールの場合、SharePoint Server であれば、SharePoint Server と Foundation のそれぞれの累積的更新プログラムの適用が必要になります。

適切に必要な修正モジュールだけを適用することが出来るという意味では、有難いのかも知れませんが、ちょっと複雑にはなっています。

・SharePoint patching demystified
http://blogs.technet.com/b/stefan_gossner/archive/2014/08/19/sharepoint-patching-demystified.aspx

そして、山崎愛さんが分かり易く解説してくれているのはこちらです。

・SharePoint の更新プログラムについての要約
http://shanqiai.weblogs.jp/sharepoint_technical_note/2014/09/sharepoint-patching.html

現在、最新は2014年12月の累積的更新プログラムがリリースされています。

・2014年 12 月の Office 2013 の累積的な更新
http://support.microsoft.com/kb/3020816/ja



• 直近の累積的更新プログラム リリース状況

直近、半年分の累積的更新プログラムのリリース状況を整理してみました。



月	リリース状況	リリース内容	リソース
７月	サーバー パッケージ	Foundation, SharePoint Server, Project Server, OWA Server	リンク
８月	個別モジュール	Foundation, SharePoint Server, Project Server, OWA Server	リンク
９月	サーバー パッケージ	Foundation, SharePoint Server, Project Server	リンク
１０月	個別モジュール	Foundation, SharePoint Server, Connector for Documentum, Project Server, OWA Server	リンク
１１月	サーバー パッケージ	Foundation, SharePoint Server, Project Server	リンク
１２月	サーバー パッケージ	Foundation, SharePoint Server, Project Server, OWA Server	リンク





• SharePoint Server 2013 2014年9月 累積的更新プログラム

今回は保守的に、最新のものを避けて、2014年9月の累積的更新プログラムをセットアップしました。

・Office 2013 の累積的な更新の 2014年 9 月
http://support.microsoft.com/kb/2995905/ja

実際の累積的更新プログラムについては、以下のサポート技術情報からダウンロードのリクエストを行えます。

・2014 年 9 月 9 日 SharePoint Server 2013 のパッケージ用の累積的な更新
http://support2.microsoft.com/kb/2883068/ja

後は、ダウンロードして解凍した結果の ubersrv を実行するだけです。
但し、セットアップ後の構成ウィザードの実行は必要ありません。



これで、SharePoint Server 2013 SP1 + 2014年9月 累積的更新プログラムをセットアップした、仮想マシン ディスクイメージが出来上がります。
このアプローチは、新規に複数サーバーで構成するサーバーファームを構築する場合に利用するだけでなく、既存のサーバーファームのノードサーバー障害時の復元用としても利用することが出来ます。

最後に、作成した仮想マシン イメージを起動した結果の PC のプロパティは以下のようにしています。

これで、SharePoint Server 2013 のディスクイメージが作成出来ました。　今度こそ、次は SharePoint サーバーファーム環境を作成します。　ということで、続きは、また次回ということで・・・

---

Kokuho Hi (Sonorite / SharePoint Technology Center)

こんばんは、ソノリテの費です。

前回までで SharePoint シングルサーバー環境が出来たので、今度は SharePoint ファーム環境を作るのですが、複数の SharePoint サーバーをちまちまとセットアップするのは嫌なので、sysprep による仮想マシンのディスクイメージを作成することにします。

• Windows システム イメージ マネージャー

ついつい、私は形から入る人なので、どうせマシンイメージを複製するなら、セットアップ時の操作を無くしたいということで、応答ファイルのカスタマイズを行います。
応答ファイルの作成、カスタマイズには、「Windows システム イメージ マネージャー」が必要になります。

このツールは、Windows アセスメント & デプロイメント キット (Windows ADK) に含まれるので、まずは、こちらをダウンロードします。

・Windows 8.1 Update 用 Windows アセスメント & デプロイメント キット (Windows ADK)
http://www.microsoft.com/ja-jp/download/details.aspx?id=39982

「Windows システム イメージ マネージャー」のみをインストールする場合には、ダウンロードした adksetup.exe を実行して、「Deployment Tools」だけを選択してインストールを実行します。

それから、Windows Server 2012 以降のメディアには、カタログファイル (.clg) が含まれていないようなので、予め、メディアの中の「Sources」フォルダ内にある「install.wim」をローカルディスクにコピーしておきます。



• 応答ファイルの作成

「Windows システム イメージ マネージャー」を起動すると、こちらのような画面が表示されます。



最初に、左下の「Windows イメージまたはカタログ ファイルを指定してください」を右クリックして、「Windows イメージの選択」を選択します。
「Windows イメージの選択」ダイアログで、ローカルディスクにコピーした「install.wim」を選択します。
次の「イメージの選択」ダイアログにて、目的のエディションを選択します。



私の場合、「Windows Server 2012 R2 SERVERDATACENTER」を選択しています。
最初はカタログファイルが作成されますが、作成が終わると、「Windows イメージ」のペインにコンポーネント一覧が展開されます。

次に、真ん中上の「応答ファイルを作成または開きます」を右クリックして、「新しい応答ファイル」を選択します。

その次に、「Windows イメージ」ペインにて、「Components」を展開して、以下のコンポーネントを選択して、右クリックで設定を追加を選択します。

・amd64_Microsoft-Windows-International-Core 〜
　⇒ 「パス 7 oobeSystem に設定を追加」
・amd64_Microsoft-Windows-Security-SPP 〜
　⇒ 「パス 3 generalize に設定を追加」
・amd64_Microsoft-Windows-Shell-Setup 〜
　⇒ 「パス 4 specialize に設定を追加」
　⇒ 「パス 7 oobeSystem に設定を追加」

追加した結果、「応答ファイル」ペインで、主な要素を展開した結果はこのようになります。





• 応答ファイルの設定

最初に、「3 generalize」配下の「amd64_Microsoft-Windows-Security-SPP」を選択して、右側のプロパティ ペインで、「設定」セクションの下の「SkipRearm」に「1」を設定します。



これにより、ライセンス認証クロックをリセットしないように出来ます。

次に、「4 specialize」配下の「amd64_Microsoft-Windows-Shell-Setup」を選択して、右側のプロパティ ペインで、「設定」セクションの下の「RegisteredOrganization」に登録組織名、「RegisteredOwner」に登録者、「ComputerName」に「*」、「ProductKey」に製品プロダクトキーを設定します。



「RegisteredOrganization」、「RegisteredOwner」に設定した内容はレジストリの「HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion」配下に、同じ名前で設定されます。
また、「RegisteredOwner」の内容は最初から7文字目までが、「ComputerName」に「*」を設定した場合に、自動生成されるコンピュータ名に使われます。

その次に、「amd64_Microsoft-Windows-Shell-Setup」の配下の「OEMInformation」を選択して、右側のプロパティ ペインで、「設定」セクションの下の「Logo」にロゴファイル名、「Manufacturer」に製造元、「Model」にモデル名、「SupportURL」にサポート URLを設定します。



ロゴファイルには、bmp 形式で 120×120 のサイズのものを指定します。
私はモデル名に、仮想マシンイメージの内容とイメージ作成日などを埋め込んでいます。　更に、「SupportHours」や「SupportPhone」などを利用して、SharePoint のビルド番号や SharePoint の追加構成を残すようにしています。

更に次に、「7 oobeSystem」配下の「amd64_Microsoft-Windows-International-Core」を選択して、右側のプロパティ ペインで、「設定」セクションの下の「SystemLocale」に「ja-JP」、「UILanguage」に「ja-JP」、「UserLocale」に「ja-JP」を設定します。



これにより、言語として日本語が設定された状態になります。

そして、「7 oobeSystem」配下の「amd64_Microsoft-Windows-Shell-Setup」の配下の「OOBE」を選択して、右側のプロパティ ペインで、「設定」セクションの下の「HideEULAPage」に「true」を設定します。



これにより、マイクロソフト ソフトウェア ライセンス条項をスキップさせることが出来ます。

最後に、「amd64_Microsoft-Windows-Shell-Setup」の配下の「UserAccounts」の配下の「AdministratorPassword」を選択して、右側のプロパティ ペインで、「設定」セクションの下の「Value」に Administrator ユーザーのパスワードを設定します。



これにより、Administrator ユーザーのパスワードが設定された状態になります。

設定した内容で、応答ファイルを保存します。



• sysprep の実行

仮想マシンにて、Microsoft Update にて、最新の更新プログラムの適用を行っておきます。

作成した応答ファイルを、C:\Windows\System32\sysprep にコピーします。
また、ロゴに設定するロゴファイルについては、C:\Windows/System32 フォルダにコピーします。

最後に、「コマンド プロンプト」にて、以下のコマンドを実行します。

%SystemRoot%\system32\sysprep\sysprep.exe /generalize /oobe /shutdown /unattend:%SystemRoot%\system32\sysprep\Untitled.xml

これにより、インストールイメージの一般化が行われて、自動的にシャットダウンされます。

作成した仮想マシン イメージを起動すると、何も操作することが無く、起動した状態になります。
予め設定した、Administrator ユーザーのパスワードでログインして、PC のプロパティを確認すると以下のようになります。





• 参考リソース

今回の投稿は以下のリソースを参考にしております。
非常に役立ちました。

・sysprepで環境複製用のマスタ・イメージを作成する（Windows 7／8編）
http://www.atmarkit.co.jp/ait/articles/1307/12/news062.html
・sysprep用の応答ファイルを作る（Windows 7／Server 2008 R2編）
http://www.atmarkit.co.jp/ait/articles/1111/11/news139.html
・Windows Server 2008のSysprepで使うXML形式の自動応答ファイルをWindowsOPKを使って作ってみる
http://type-y.com/2009/08/microsoft-windows-server-2008-sysprep-xml-windows-oem-preinstallation-kit-windows-system-image-manag.html
・Windows Server 2012 の SkipRearm について
https://engineermemo.wordpress.com/2012/09/18/windows-server-2012-%E3%81%AE-skiprearm-%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6/

これで、仮想マシンのディスクイメージのベースが作成出来ました。　今度は、このイメージをベースに SharePoint Server 2013 のディスクイメージを作成します。　ということで、続きは、また次回ということで・・・

---

Kokuho Hi (Sonorite / SharePoint Technology Center)