intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

Copyright © 2015 NTT DATA INTRAMART CORPORATION

↑Top

1

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

目次
1. 改訂情報
2. はじめに2.1. 本書の目的
2.2. 対象読者
2.3. サンプルコードについて
2.4. 本書の構成
3. Office 365 連携 プログラミング概要
3.1. Office 365 連携 の流れ
4. SharePoint Online のファイラを作成する （JavaEE開発モデル）
4.1. SharePoint Online 上にディレクトリを新規作成する
4.2. SharePoint Online 上にファイルをアップロードする
4.3. SharePoint Online 上のファイルをダウンロードする
4.4. SharePoint Online 上のファイルの詳細情報を表示する
4.5. SharePoint Online 上のファイルを削除する
4.6. SharePoint Online 上のドキュメントをiframeで表示する
4.7. SharePoint Online のファイラを作成する
5. SharePoint Online のファイラを作成する （スクリプト開発モデル）
5.1. SharePoint Online 上にディレクトリを新規作成する
5.2. SharePoint Online 上にファイルをアップロードする
5.3. SharePoint Online 上のファイルをダウンロードする
5.4. SharePoint Online 上のファイルの詳細情報を表示する
5.5. SharePoint Online 上のファイルを削除する
5.6. SharePoint Online 上のドキュメントをiframeで表示する
5.7. SharePoint Online のファイラを作成する
5.8. ルーティングテーブルを作成する

2

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

改訂情報
変更年月日

変更内容

2015-08-01

初版

2015-12-01

第2版 下記を追加・変更しました「SharePoint Online のファイラを作成する （スクリプト開発モデル） 」を追加

2017-08-01

第3版 下記を変更しました。
「SharePoint Online のファイラを作成する （JavaEE開発モデル） 」にOffice 365 連携の低レベルAPIを新たに提供されたOneDrive APIに変更

2024-04-01

第4版 下記を変更しました。
名称変更のため、Office 365 を Microsoft 365、 Azure Active Directory（AzureAD）
を Microsoft Entra ID に修正

3

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

はじめに
コラム
「Azure Active Directory (AzureAD)」 の名称は 「Microsoft Entra ID」 に変更されました。
https://learn.microsoft.com/entra/fundamentals/new-name「Office 365」 の名称は 「Microsoft 365」 に変更されました。

本書の目的
本書では intra-mart Accel Platform における Office 365 連携機能 を用いたプログラミング方法について説明します。

対象読者
次の開発者を対象としています。
intra-mart Accel Platform で Microsoft 365 上のリソースを利用したアプリケーションを作成したい開発者

サンプルコードについて
本書に掲載されているサンプルコードは可読性を重視しており、性能面や保守性といった観点において必ずしも適切な実装ではありません。
サンプルコードを参考に開発する場合は、上記について十分に注意してください。
なお、ドキュメントの流れに合わせてサンプルを実装し、実際に動作確認を行う場合の前提条件は以下の通りです。
Office 365 連携 セットアップガイド を参考に Office 365 連携 の環境を作成してください。

本書の構成
本書は以下のような構成です。
Office 365 連携 プログラミング概要
SharePoint Online のファイラを作成する （JavaEE開発モデル）
SharePoint Online のファイラを作成する （スクリプト開発モデル）

4intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

Office 365 連携 プログラミング概要
Office 365 連携 の流れ
Office 365 連携機能のAPIは、Microsoft 365 のWebAPIをラップする形で提供しています。
Microsoft 365 のWebAPIの実行に必要なアクセストークンは、 intra-mart Accel Platform （Office 365 連携）が OAuth2.0の仕様に則って、自動的に取得・更新します。
これにより開発者は OAuth2.0 関連の実装が不要となり、Office 365 連携機能の APIを利用したビジネスロジックの実装に集中できます。
開発者は以下の図の 7 と 10 に 必要な処理や画面を実装することで、Office 365 連携機能を利用したプログラムを作成できます。
Office 365 連携のフロー図

1. ユーザが「個人設定」-「外部連携アプリケーション」画面で Office 365 連携 のプロバイダ を「許可」します。
2. intra-mart Accel Platform （Office 365 連携）は ユーザを Microsoft Entra ID にリダイレクトさせます。
3. ユーザは Microsoft Entra ID にサインインを行い認証し、必要な場合は許諾を行います。
4. Microsoft Entra ID は intra-mart Accel Platform （Office 365 連携）の リダイレクトURI に認可コードを返します。
5. intra-mart Accel Platform （Office 365 連携API） は、Microsoft Entra ID に認可コードを提示し、アクセストークンを要求します。
6. Microsoft Entra ID は、アクセストークンとリフレッシュトークンを返却します。（アクセストークンの有効期限が切れた場合、リフレッシュトークンを利用し新しいアクセストークンに更新します。）
7. ユーザが SharePoint Online のファイル操作などの Office 365 連携機能のAPIを利用した画面をリクエストします。
8. intra-mart Accel Platform （Office 365 連携API）は、アクセストークンを利用し Microsoft 365 の Web API を実行します。
9. Microsoft 365 の Web API はリクエストされたデータを返します。
10. intra-mart Accel Platform （Office 365 連携）は、データを利用しユーザのリクエストに応答します。

5

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
コラム
Microsoft Entra ID のアクセストークンの取得フローについての詳細は以下のページを参照してください。
https://msdn.microsoft.com/en-US/library/azure/dn645542.aspx （English）

6

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

SharePoint Online のファイラを作成する （JavaEE開発モデル）
Office 365 連携機能 では、Microsoft 365 の SharePoint Online のドキュメントにアクセスするための以下の API を提供します。
Microsoft 365 のOneDrive REST APIをラップした低レベルAPI
jp.co.intra_mart.foundation.office365.api.v2_0.onedrive.operation.OneDriveOperation
intra-mart Accel Platform の Storageインタフェースを継承した高レベルAPI
jp.co.intra_mart.foundation.office365.service.storage.SharePointStorage
ここでは、 Office 365 連携機能 の SharePointStorage APIを利用して実際にプログラムを作成する過程を説明します。
本項では、例として JavaEE開発モデル を利用しています。
また、サンプルコードは可読性を重視しているため、JSP内で全ての処理を行っています。
本項に記載のサンプルを組み合わせると 以下のような SharePoint Online のファイラが完成します。
SharePoint Online のファイラの完成イメージ

項目
SharePoint Online 上にディレクトリを新規作成する
SharePoint Online 上にファイルをアップロードする
SharePoint Online 上のファイルをダウンロードする
SharePoint Online 上のファイルの詳細情報を表示する
SharePoint Online 上のファイルを削除する
SharePoint Online 上のドキュメントをiframeで表示する
SharePoint Online のファイラを作成する

7

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
注意Office 365 連携 のAPIの詳細については以下を参照してください。
「 APIドキュメント - SharePointStorage 」「 APIドキュメント - OneDriveOperation 」
Office 365 連携 のタグライブラリの詳細については以下を参照してください。
「 タグライブラリ - im-office365:excel 」「 タグライブラリ - im-office365:powerPoint 」「 タグライブラリ - im-office365:word 」

SharePoint Online 上にディレクトリを新規作成する
SharePoint Online 上にディレクトリを新規作成する実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのディレクトリパス、ディレクトリの名称 を元に新規ディレ
クトリを作成します。
実装例
SharePointStorage#makeDirectories() を利用します。
%CONTEXT_PATH%/sample/office365/filer/create_dir.jsp

8

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

9

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

<%@ page contentType="text/html; charset=utf-8" pageEncoding="utf-8" %><%@ taglib prefix="imui" uri="http://www.intra-mart.co.jp/taglib/imui" %><%@ page import="java.io.IOException" %><%@ page import="jp.co.intra_mart.common.platform.log.Logger" %><%@ page import="jp.co.intra_mart.foundation.context.Contexts" %><%@ page import="jp.co.intra_mart.foundation.context.model.AccountContext" %><%@ page import="jp.co.intra_mart.foundation.office365.service.storage.SharePointStorage"%><%
String userCd = Contexts.get(AccountContext.class).getUserCd();
String providerId = request.getParameter("providerId");
String currentDirPath =request.getParameter("targetDirPath") != null ? request.getParameter("targetDirPath") : "/";
String createDirName =request.getParameter("createDirName") != null ? request.getParameter("createDirName") : null;
String dirPath = currentDirPath + createDirName;
String successMsg = null;
String errorMsg = null;
if (createDirName == null) {errorMsg = "ディレクトリ名が指定されていません。";} else {SharePointStorage storage = new SharePointStorage(userCd, providerId, dirPath);try {//ディレクトリの作成
boolean result = storage.makeDirectories();if (result) {successMsg = "ディレクトリを作成しました。<br/><br/>" + dirPath;} else {errorMsg = "ディレクトリを作成できませんでした。<br/><br/>" + dirPath;}} catch (IOException e) {errorMsg = buildErrorMessage("ディレクトリ作成時にエラーが発生しました。", e);}}%><imui:head><title>Office365 - SharePointStorage API サンプル - ディレクトリ作成</title><script type="text/javascript">$(document).ready(function() {if(<%=successMsg != null%>){imuiShowSuccessMessage('<%=successMsg%>');}
if(<%=errorMsg != null%>){imuiShowErrorMessage('<%=errorMsg%>');}});</script></imui:head><div class="imui-title"><h1><%=dirPath%></h1></div><div class="imui-toolbar-wrap"><div class="imui-toolbar-inner"><ul class="imui-list-toolbar"><li><a href="javascript:$('#backToIndex').submit();" class="imui-toolbar-icon" title="一覧に戻る"><span class="im-ui-icon-common-16-back"></span>一覧に戻る

10intra-mart
Accel
Platform — Oﬃce 365 連携プログラミングガイド
66<spanclass="im-ui-icon-common-16-back"></span>一覧に戻る
67
</a>
68
</li>
69
</ul>
70
</div>
71</div>
72
73<form method="post" action="sample/office365/filer/index.jsp" id="backToIndex">
74<input type="hidden" name="targetDirPath" value="<%=currentDirPath%>"/>
75</form>76<%!
77
private static Logger logger = Logger.getLogger("sample.office365.filer.create_dir");
78
private String buildErrorMessage(String errorMessage, Exception errorDetail) {79
logger.error(errorDetail.getMessage(), errorDetail);80
return errorMessage + "<br/><br/>" + errorDetail.getMessage();
81
}
82
%>

第4版 2024-04-01

注意Microsoft社が提供する Microsoft 365 のWebAPIの動作仕様に起因し以下の制限があります。
SharePointStorage#makeDirectories() および OneDriveOperation#createFolderByPath() を利用しディレクトリを作成する場合、ルートディレクトリ直下に存在するディレクトリ名と同名のディレクトリを任意のディレ
クトリ配下に作成することはできません。

SharePoint Online 上にファイルをアップロードする
SharePoint Online 上にファイルをアップロードする実装のサンプルです。
マルチパートフォームデータとして受け取った プロバイダID、ターゲットのディレクトリパス、ファイルを元にファイルをアップロードします。
実装例
SharePointStorage#create() を利用します。
%CONTEXT_PATH%/sample/office365/filer/upload.jsp

11

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

<%@ page contentType="text/html; charset=utf-8" pageEncoding="utf-8" %><%@ page import="java.io.InputStream" %><%@ page import="java.io.OutputStream" %><%@ page import="jp.co.intra_mart.foundation.context.Contexts" %><%@ page import="jp.co.intra_mart.foundation.context.model.AccountContext" %><%@ page import="jp.co.intra_mart.common.aid.javaee.http.MultipartFormData" %><%@ page import="jp.co.intra_mart.common.aid.javaee.http.MultipartFormData.Entity" %><%@ page import="jp.co.intra_mart.foundation.office365.service.storage.SharePointStorage"%><%@ page import="jp.co.intra_mart.common.aid.jdk.java.io.IOUtil" %><%String userCd = Contexts.get(AccountContext.class).getUserCd();//Web Application Server によってはレスポンスにテーマが含まれてしまうため notheme を指定
request.setAttribute("imui-theme-builder-module", "notheme");
response.setContentType("json");MultipartFormData data = new MultipartFormData(request);
String providerId = data.getEntity("providerId").getContent();
String targetDirPath = new String(data.getEntity("targetDirPath").getBytes(), "utf-8");
Entity localFileEntity = data.getEntity("local_file");String fileName = localFileEntity.getFileName();SharePointStorage storage = new SharePointStorage(userCd, providerId, targetDirPath + "/" + fileName);try (OutputStream outputStream = storage.create();InputStream inputStream = localFileEntity.getInputStream()){
IOUtil.transfer(inputStream, outputStream);}
response.setContentType("json");%>[{"name":"<%= localFileEntity.getFileName() %>",
"size":<%= localFileEntity.getContentLength() %>,"error":""}]SharePoint Online 上のファイルをダウンロードする
SharePoint Online 上のファイルをダウンロードする実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのファイルパス、ファイルの名称を元にファイルをダウンロードします。
実装例
SharePointStorage#open() を利用します。
%CONTEXT_PATH%/sample/office365/filer/download.jsp

12intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

<%@ page contentType="text/html; charset=utf-8" pageEncoding="utf-8" %><%@ page import="java.io.InputStream" %><%@ page import="java.io.OutputStream" %><%@ page import="javax.activation.FileTypeMap" %><%@ page import="jp.co.intra_mart.common.aid.jdk.java.io.IOUtil" %><%@ page import="jp.co.intra_mart.foundation.context.Contexts" %><%@ page import="jp.co.intra_mart.foundation.context.model.AccountContext" %><%@ page import="jp.co.intra_mart.foundation.office365.service.storage.SharePointStorage" %><%@ page import="jp.co.intra_mart.foundation.http.ResponseUtil" %><%String userCd = Contexts.get(AccountContext.class).getUserCd();
String providerId = request.getParameter("providerId");
String targetFilePath = request.getParameter("targetFilePath");String targetFileName = request.getParameter("targetFileName");
response.resetBuffer();
response.setCharacterEncoding(null);String mimeType = FileTypeMap.getDefaultFileTypeMap().getContentType(targetFileName);
response.setContentType(mimeType);
String encodedFileName = ResponseUtil.encodeFileName(request, "UTF-8", targetFileName);
response.setHeader("Content-Disposition", "attachment; " + encodedFileName);
SharePointStorage sharePointStorage = new SharePointStorage(userCd, providerId, targetFilePath);try (InputStream inputStream = sharePointStorage.open();OutputStream outputStream = response.getOutputStream();){
IOUtil.transfer(inputStream, outputStream);}%>

SharePoint Online 上のファイルの詳細情報を表示する
SharePoint Online 上のファイルの詳細情報を表示する実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのファイルパスをファイルの詳細情報を表示します。
実装例%CONTEXT_PATH%/sample/office365/filer/show_detail.jsp

13

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

14

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

<%@ page contentType="text/html; charset=utf-8" pageEncoding="utf-8" %><%@ taglib prefix="imui" uri="http://www.intra-mart.co.jp/taglib/imui" %><%@ taglib prefix="imtag" uri="http://www.intra-mart.co.jp/taglib/core/standard" %><%@ taglib prefix="i18n" uri="http://www.intra-mart.co.jp/taglib/im-i18n" %><%@ page import="jp.co.intra_mart.foundation.context.Contexts" %><%@ page import="jp.co.intra_mart.foundation.context.model.AccountContext" %><%@ page import="jp.co.intra_mart.foundation.office365.service.storage.SharePointStorage"%><%
String userCd = Contexts.get(AccountContext.class).getUserCd();
String providerId = request.getParameter("providerId");
String targetPathForShowDetail = request.getParameter("targetPathForShowDetail");
String errorMsg = "";if(targetPathForShowDetail == null){errorMsg = "ファイル、または、ディレクトリが指定されていません。";}
SharePointStorage storage = new SharePointStorage(userCd, providerId, targetPathForShowDetail);%><imui:head><title>Office365 - SharePointStorage API サンプル - 詳細表示</title><script type="text/javascript">$(document).ready(function() {if(<%= errorMsg != null %>){
imuiShowErrorMessage('<%= errorMsg %>');}});</script></imui:head><div class="imui-title"><imtag:condition validity="<%= Boolean.toString(errorMsg.isEmpty()) %>">
<h1><%=storage.getCanonicalPath()%></h1></imtag:condition></div><div class="imui-form-container-narrow"><div class="imui-chapter-title"><h2>詳細情報</h2></div><imtag:condition validity="<%= Boolean.toString(errorMsg.isEmpty()) %>">
<table class="imui-table"><tr><th class="wd-335px">正規化したパス</th><td><%=storage.getCanonicalPath()%></td>
</tr>
<tr>
<th>コンテンツをブラウザ上で確認可能なWeb URL</th><td><a href="<%=storage.getWebUrl()%>"><%=java.net.URLDecoder.decode(storage.getWebUrl(), "UTF8")%></a>
</td>
</tr>
<tr>
<th>作成時刻</th><td><i18n:dateTime value="<%=new java.util.Date(storage.created())%>" pattern="yyyy/MM/dd
hh:mm:ss"/></td>
</tr>
<tr>
<th>作成ユーザID</th><td><%=storage.createdUserId()%></td>
</tr>
<tr>

15

intra-mart
66<tr> Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
67<th>作成ユーザ名</th>68<td><%=storage.createdUserName()%></td>
69
</tr>
70
<tr>
71
<th>最終更新時刻</th>72<td><i18n:dateTime value="<%=new java.util.Date(storage.lastModified())%>"
73
pattern="yyyy/MM/dd hh:mm:ss"/></td>
74
</tr>
75
<tr>
76
<th>最終更新ユーザID</th>77<td><%=storage.lastModifiedUserId()%></td>
78
</tr>
79
<tr>
80
<th>最終更新ユーザ名</th>81<td><%=storage.lastModifiedUserName()%></td>
82
</tr>
83
<tr>
84
<th>ファイルサイズ</th>85<td><%=storage.length()%>バイト</td>86</tr></table></imtag:condition></div>

SharePoint Online 上のファイルを削除する
SharePoint Online 上のファイルを削除する実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのファイルパスを元にファイルを削除します。
実装例
SharePointStorage#remove() を利用します。
%CONTEXT_PATH%/sample/office365/filer/remove.jsp

16

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

17

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

<%@ page contentType="text/html; charset=utf-8" pageEncoding="utf-8" %><%@ taglib prefix="imui" uri="http://www.intra-mart.co.jp/taglib/imui" %><%@ page import="java.io.IOException" %><%@ page import="jp.co.intra_mart.common.platform.log.Logger" %><%@ page import="jp.co.intra_mart.foundation.context.Contexts" %><%@ page import="jp.co.intra_mart.foundation.context.model.AccountContext" %><%@ page import="jp.co.intra_mart.foundation.office365.service.storage.SharePointStorage"%><%
String userCd = Contexts.get(AccountContext.class).getUserCd();
String providerId = request.getParameter("providerId");
String targetPath = request.getParameter("targetPathForRemove");
String currentDirPath =request.getParameter("targetDirPath") != null ? request.getParameter("targetDirPath") : "/";
String successMsg = null;
String errorMsg = null;
if (targetPath == null) {errorMsg = "ファイル、または、ディレクトリが指定されていません。";} else {SharePointStorage storage = new SharePointStorage(userCd, providerId, targetPath);try {//ファイルまたはディレクトリの削除
boolean result = storage.remove(true);if (result) {successMsg = "「" + targetPath + "」を削除しました。";} else {errorMsg = "「" + targetPath + "」を削除できませんでした。";}} catch (IOException e) {errorMsg = buildErrorMessage("削除時にエラーが発生しました。", e);}}%><imui:head><title>Office365 - SharePointStorage API サンプル - 削除</title><script type="text/javascript">$(document).ready(function() {if(<%=successMsg != null%>){imuiShowSuccessMessage('<%=successMsg%>');}
if(<%=errorMsg != null%>){imuiShowErrorMessage('<%=errorMsg%>');}});</script></imui:head><div class="imui-title"><h1><%=targetPath%></h1></div><div class="imui-toolbar-wrap"><div class="imui-toolbar-inner"><ul class="imui-list-toolbar"><li><a href="javascript:$('#backToIndex').submit();" class="imui-toolbar-icon" title="一覧に戻る"><span class="im-ui-icon-common-16-back"></span>一覧に戻る
</a>
</li>
</ul>
</div>

18

intra-mart
66</div> Accel Platform — Oﬃce 365 連携プログラミングガイド
67</div>
68
69<form method="post" action="sample/office365/filer/index.jsp" id="backToIndex">70<input type="hidden" name="targetDirPath" value="<%=currentDirPath%>"/>
71</form>
72
73
<%!
74
private static Logger logger = Logger.getLogger("sample.office365.filer.remove");75
private String buildErrorMessage(String errorMessage, Exception errorDetail) {76
logger.error(errorDetail.getMessage(), errorDetail);77
return errorMessage + "<br/><br/>" + errorDetail.getMessage();
78
}
79
%>

第4版 2024-04-01

SharePoint Online 上のドキュメントをiframeで表示する
SharePoint Online 上のドキュメントをiframeで表示する実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのファイルパスを元にドキュメントをiframeで表示します。
実装例
im-office365 タグを利用します。
%CONTEXT_PATH%/sample/office365/filer/show_iframe.jsp

19intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

20

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

<%@ page contentType="text/html; charset=utf-8" pageEncoding="utf-8"%><%@ taglib prefix="imtag" uri="http://www.intra-mart.co.jp/taglib/core/standard" %><%@ taglib prefix="im-office365" uri="http://www.intra-mart.co.jp/taglib/im-office365"%><%
String width = "640";
String height = "480";
String providerId = request.getParameter("providerId");
String targetPath = request.getParameter("targetPathForShowIframe");String errorMsg = null;
if (targetPath == null) {errorMsg = "ファイルが指定されていません。";}%><imui:head><title>Office365 - iframe 表示</title><script type="text/javascript">$(document).ready(function() {if(<%=errorMsg != null%>){imuiShowErrorMessage('<%=errorMsg%>');}});</script></imui:head><div class="imui-title"><h1><%=targetPath%></h1></div><div id="imui-container-inner"><imtag:condition validity="<%=isWord(targetPath)%>"><im-office365:word providerId="<%=providerId%>" path="<%=targetPath%>"width="<%=width%>" height="<%=height%>" /></imtag:condition><imtag:condition validity="<%=isExcel(targetPath)%>"><im-office365:excel providerId="<%=providerId%>" path="<%=targetPath%>"width="<%=width%>" height="<%=height%>" /></imtag:condition><imtag:condition validity="<%=isPowerPoint(targetPath)%>"><im-office365:powerPoint providerId="<%=providerId%>" path="<%=targetPath%>"width="<%=width%>" height="<%=height%>" /></imtag:condition></div><%!
private String isWord(final String fileName) {return ".docx".equals(getExtension(fileName)) ? "true" : "false";}
private String isExcel(final String fileName) {return ".xlsx".equals(getExtension(fileName)) ? "true" : "false";}
private String isPowerPoint(final String fileName) {return ".pptx".equals(getExtension(fileName)) ? "true" : "false";}
private String getExtension(String fileName) {final int indexOfLastDot = fileName.lastIndexOf(".");
if (indexOfLastDot == -1) {return null;}
return fileName.substring(indexOfLastDot);21

intra-mart
Platform — Oﬃce 365 連携プログラミングガイド
66
return Accel
fileName.substring(indexOfLastDot);
67
}
68
%>

第4版 2024-04-01

注意ドキュメントを表示するにはユーザが Microsoft 365 - SharePoint Online にログインしている必要があります。

SharePoint Online のファイラを作成する
前述の実装例を組み合わて SharePoint Online のファイラを作成します。
providerId は「 Office 365 連携 セットアップガイド 」で環境構築の際に設定した <im_office365_files_api.xml> のプロバ
イダIDを指定してください。
実装例
SharePointStorage#directoriesStorages()、SharePointStorage#filesStorages() を利用します。
%CONTEXT_PATH%/sample/office365/filer/index.jsp

22

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

23

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

<%@ page contentType="text/html; charset=utf-8" pageEncoding="utf-8" %><%@ taglib prefix="imui" uri="http://www.intra-mart.co.jp/taglib/imui" %><%@ taglib prefix="imtag" uri="http://www.intra-mart.co.jp/taglib/core/standard" %><%@ page import="java.io.InputStream" %><%@ page import="java.io.IOException" %><%@ page import="java.io.OutputStream" %><%@ page import="java.util.ArrayList" %><%@ page import="java.util.Collection" %><%@ page import="jp.co.intra_mart.common.platform.log.Logger" %><%@ page import="jp.co.intra_mart.foundation.context.Contexts" %><%@ page import="jp.co.intra_mart.foundation.context.model.AccountContext" %><%@ page import="jp.co.intra_mart.foundation.oauth.client.service.OAuthPreconditionException" %><%@ page import="jp.co.intra_mart.foundation.office365.service.storage.SharePointStorage"%><%
String providerId = "Please_input_your_ID";
String userCd = Contexts.get(AccountContext.class).getUserCd();
String currentDirPath =request.getParameter("targetDirPath") != null ?
addSlashToTheEnd(request.getParameter("targetDirPath")) : "/";
String errorMsg = null;
SharePointStorage storage = new SharePointStorage(userCd, providerId, currentDirPath);// 一覧取得
Collection<SharePointStorage> directoriesStorages = new ArrayList<SharePointStorage>();Collection<SharePointStorage> filesStorages = new ArrayList<SharePointStorage>();try {directoriesStorages = storage.directoriesStorages(false);
filesStorages = storage.filesStorages(false);} catch (IOException e) {errorMsg = buildErrorMessage("ディレクトリ、または、ファイル一覧の取得時にエラーが発生しました。", e);}// 親ディレクトリの存在チェック
String parentDir = storage.getParent();
String existsParentDir = parentDir != null ? "true" : "false";%><imui:head><title>Office365 - SharePointStorage API サンプル</title><script src="csjs/im_window.js"></script><script type="text/javascript">function moveDir(targetDirPath){$('#targetDirPath').val('<%= currentDirPath %>' + targetDirPath);$('#moveDirForm').submit();}function downloadFile(targetFilePath){$('#targetFilePath').val('<%= currentDirPath %>' + targetFilePath);$('#targetFileName').val(targetFilePath);$('#downloadFileForm').submit();}function removeFileOrDir(targetPath){$('#targetPathForRemove').val('<%= currentDirPath %>' + targetPath);$('#removeFileOrDirForm').submit();}function showDetail(targetPath){
openNewWindow("office365_show_detail").focus();$('#targetPathForShowDetail').val('<%= currentDirPath %>' + targetPath);$('#showDetailForm').submit();}24

intra-mart
Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
66
}
67
68
function showIframe(targetPath){69
openNewWindow("office365_show_iframe").focus();70$('#targetPathForShowIframe').val('<%= currentDirPath %>' + targetPath);
71$('#showIframeForm').submit();
72
}
73
74
$(document).ready(function() {75
if(<%= errorMsg != null %>){
76
imuiShowErrorMessage('<%= errorMsg %>');
77
}
78
79
$('#toParent').click(function() {80$('#targetDirPath').val('/' + '<%= parentDir %>');
81$('#moveDirForm').submit();
82
});
83
84
});
85
</script>86</imui:head>87<div class="imui-container">
88<div class="imui-title">
89<h1><%= currentDirPath %></h1>90</div>
91
92<div class="imui-form-container-narrow">93<div class="imui-chapter-title">
94<h2>ファイル一覧</h2>95</div>
96<form method="post" action="sample/office365/filer/index.jsp">
97<input type="text" name="targetDirPath" value="<%= currentDirPath %>" size="70" />98<input type="submit" value="移動" class="imui-small-button" />99</form>100<br />
101<table class="imui-table">
102
<tr>
103
<th>名前</th>104<th>詳細</th>105<th>削除</th>106<th>iframe表示</th>
107
</tr>
108
<imtag:condition validity="<%= existsParentDir %>">
109
<tr>
110
<td><a href="javascript:void(0)" id="toParent">親ディレクトリへ移動</a></td>
111<td></td>
112<td></td>
113<td></td>
114
</tr>
115
</imtag:condition>
116
117<!-- ディレクトリ一覧 -->118<imtag:repeat list="<%= directoriesStorages %>" type="SharePointStorage" item="dirStorage"
119
index="idx">
120
<tr>
121
<td>
122
<span class="im-ui-icon-common-16-folder"></span>
123<a href="javascript:void(0)"124
onclick="moveDir('<%= dirStorage.getName() %>');"><%= dirStorage.getName() %></a>
125
</td>
126
<td align="center">
127<a href="javascript:void(0)" onclick="showDetail('<%= dirStorage.getName() %>');">
128<span class="im-ui-icon-common-16-information"></span>
129
</a>
130
</td>
131
<td align="center">
132<a href="javascript:void(0)" onclick="removeFileOrDir('<%= dirStorage.getName() %>');">
25

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199

<span class="im-ui-icon-common-16-trashbox"></span>
</a>
</td>
<td></td></tr></imtag:repeat><!-- ファイル一覧 --><imtag:repeat list="<%= filesStorages %>" type="SharePointStorage" item="fileStorage"
index="idx">
<tr>
<td>
<span class="im-ui-icon-common-16-document"></span><a href="javascript:void(0)"onclick="downloadFile('<%= fileStorage.getName() %>');"><%= fileStorage.getName() %></a></td><td align="center"><a href="javascript:void(0)" onclick="showDetail('<%= fileStorage.getName() %>');"><span class="im-ui-icon-common-16-information"></span></a><td align="center"><a href="javascript:void(0)" onclick="removeFileOrDir('<%= fileStorage.getName() %>');"><span class="im-ui-icon-common-16-trashbox"></span>
</a>
</td>
<td align="center"><imtag:condition validity="<%= isWordExcelPowerPointFile(fileStorage.getName()) %>">
<a href="javascript:void(0)" onclick="showIframe('<%= fileStorage.getName() %>');"><span class="im-ui-icon-common-16-preview"></span></a></imtag:condition>
</td>
</tr>
</imtag:repeat></table><br/><div class="imui-chapter-title"><h2>ファイルアップロード</h2></div><form id="uploadForm" action="sample/office365/filer/upload.jsp" enctype="multipart/form-data"><imui:fileUpload outerFormId="uploadForm"/><input type="hidden" name="targetDirPath" value="<%= currentDirPath %>" /><input type="hidden" name="providerId" value="<%= providerId %>" /></form><div class="imui-chapter-title"><h2>ディレクトリ新規作成</h2></div><form method="POST" name="createDir" id="createDir"action="sample/office365/filer/create_dir.jsp"><input type="text" name="createDirName" /><input type="hidden" name="targetDirPath" value="<%= currentDirPath %>" /><input type="hidden" name="providerId" value="<%= providerId %>" /><input type="submit" value="作成" class="imui-small-button" /></form><form method="POST" name="moveDirForm" id="moveDirForm"
action="sample/office365/filer/index.jsp"><input type="hidden" name="targetDirPath" id="targetDirPath" /><input type="hidden" name="providerId" value="<%= providerId %>" /></form><form method="POST" name="downloadFileForm" id="downloadFileForm"
action="sample/office365/filer/download.jsp">

26

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259

action="sample/office365/filer/download.jsp"><input type="hidden" name="targetFilePath" id="targetFilePath" /><input type="hidden" name="targetFileName" id="targetFileName" /><input type="hidden" name="providerId" value="<%= providerId %>" /></form><form method="POST" name="removeFileOrDirForm" id="removeFileOrDirForm"
action="sample/office365/filer/remove.jsp"><input type="hidden" name="targetPathForRemove" id="targetPathForRemove" /><input type="hidden" name="targetDirPath" id="targetDirPath" value="<%=currentDirPath%>"/><input type="hidden" name="providerId" value="<%= providerId %>" /></form><form method="POST" name="showDetailForm" id="showDetailForm"
action="sample/office365/filer/show_detail.jsp" target="office365_show_detail"><input type="hidden" name="targetPathForShowDetail" id="targetPathForShowDetail" /><input type="hidden" name="targetDirPath" id="targetDirPath" value="<%=currentDirPath%>"/><input type="hidden" name="providerId" value="<%= providerId %>" /></form><form method="POST" name="showIframeForm" id="showIframeForm"
action="sample/office365/filer/show_iframe.jsp" target="office365_show_iframe"><input type="hidden" name="targetPathForShowIframe" id="targetPathForShowIframe" /><input type="hidden" name="targetDirPath" id="targetDirPath" value="<%=currentDirPath%>"/><input type="hidden" name="providerId" value="<%= providerId %>" /></form></div></div><%!
private static Logger logger = Logger.getLogger("sample.office365.filer.index");private String buildErrorMessage(final String errorMessage, final Exception errorDetail){logger.error(errorDetail.getMessage(), errorDetail);if(errorDetail instanceof OAuthPreconditionException){
return "「外部連携アプリケーション」画面でアプリケーションを許可してください。";} else {return errorMessage + "<br/><br/>" + errorDetail.getMessage();}}private String isWordExcelPowerPointFile(final String fileName) {final int indexOfLastDot = fileName.lastIndexOf(".");
if (indexOfLastDot == -1) {return "false";}
final String extension = fileName.substring(indexOfLastDot);
if (".docx".equals(extension) || ".xlsx".equals(extension) || ".pptx".equals(extension)) {return "true";} else {return "false";}}
private String addSlashToTheEnd(final String s) {final int indexOfLastSlash = s.lastIndexOf("/");
if((indexOfLastSlash == -1) || (indexOfLastSlash == s.length() - "/".length())){
return s;} else {return s + "/";
}
}
%>

27

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

SharePoint Online のファイラを作成する （スクリプト開発モデル）
ここでは、 Office 365 連携機能 の SharePointStorage APIを利用して実際にプログラムを作成する過程を説明します。
本項では、例として スクリプト開発モデル を利用しています。
本項に記載のサンプルを組み合わせると 以下のような SharePoint Online のファイラが完成します。
SharePoint Online のファイラの完成イメージ

項目
SharePoint Online 上にディレクトリを新規作成する
SharePoint Online 上にファイルをアップロードする
SharePoint Online 上のファイルをダウンロードする
SharePoint Online 上のファイルの詳細情報を表示する
SharePoint Online 上のファイルを削除する
SharePoint Online 上のドキュメントをiframeで表示する
SharePoint Online のファイラを作成する
ルーティングテーブルを作成する

注意
Office 365 連携 のAPIの詳細については以下を参照してください。
「 APIドキュメント - SharePointStorage 」
Office 365 連携 のタグライブラリの詳細については以下を参照してください。
「 タグライブラリ - imOffice365Excel 」「 タグライブラリ - imOffice365PowerPoint 」「 タグライブラリ - imOffice365Word 」

28

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

SharePoint Online 上にディレクトリを新規作成する
SharePoint Online 上にディレクトリを新規作成する実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのディレクトリパス、ディレクトリの名称 を元に新規ディレ
クトリを作成します。
実装例
SharePointStorage#makeDirectories() を利用します。
%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/create_dir.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

var $currentDirPath;var $successMsg;
var $errorMsg;
var $dirPath;function init(request) {var userCd = Contexts.getAccountContext().userCd;
var providerId = request.providerId;$currentDirPath = request.targetDirPath != null ? request.targetDirPath : '/';
var createDirName = request.createDirName != null ? request.createDirName : null;$dirPath = $currentDirPath + createDirName;
if (createDirName == null) {$errorMsg = 'ディレクトリ名が指定されていません。';} else {try{
var storage = new SharePointStorage(userCd, providerId, $dirPath);var result = storage.makeDirectories();if(result){$successMsg = 'ディレクトリを作成しました。<br><br>' + $dirPath;}else{$errorMsg = 'ディレクトリを作成できませんでした。<br><br>' + $dirPath;}}catch(e){$errorMsg = 'ディレクトリ作成時にエラーが発生しました。' + '<br><br>' + e.errorMessage;}}}%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/create_dir.html

29

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

<script type="text/javascript">$(document).ready(function() {var successMsg = '<imart type="string" value=$successMsg />';
var errorMsg = '<imart type="string" value=$errorMsg />';
if (successMsg != '') {imuiShowSuccessMessage(successMsg);} else if (errorMsg != '') {imuiShowErrorMessage(errorMsg);}});</script><imart type="head"><title>Office365 - SharePointStorage API サンプル - ディレクトリ作成</title></imart><div class="imui-title"><h1><imart type="string" value=$dirPath /></h1></div><div class="imui-toolbar-wrap"><div class="imui-toolbar-inner"><ul class="imui-list-toolbar"><li><a href="javascript:$('#backToIndex').submit();" class="imui-toolbar-icon" title="一覧に戻る"><span class="im-ui-icon-common-16-back"></span> 一覧に戻る
</a>
</li>
</ul>
</div></div><form id="backToIndex" method="post" action="sample/office365/filer"><imart type="hidden" targetDirPath=$currentDirPath /></form>注意
Microsoft社が提供する Microsoft 365 のWebAPIの動作仕様に起因し以下の制限があります。
SharePointStorage#makeDirectories() を利用しディレクトリを作成する場合、ルートディレクトリ直下に存在するディレクトリ名と同名のディレクトリを任意のディレクトリ配下に作成することはできません。

SharePoint Online 上にファイルをアップロードする
SharePoint Online 上にファイルをアップロードする実装のサンプルです。
マルチパートフォームデータとして受け取った プロバイダID、ターゲットのディレクトリパス、ファイルを元にファイルをアップロードします。
実装例30

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
SharePointStorage#createAsBinary() を利用します。
画面遷移を伴わないため、プレゼンテーションページは不要です。
%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/upload.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

function init(request) {var userCd = Contexts.getAccountContext().userCd;var upfile = request.getParameter('local_file');var providerId = request.providerId;var currentDirPath = request.targetDirPath;var response = Web.getHTTPResponse();response.setContentType('json');request.setAttribute('imui-theme-builder-module', 'notheme');var targetFilePath = currentDirPath + upfile.getFileName();
upfile.openValueAsBinary(function(reader) {var storage = new SharePointStorage(userCd, providerId, targetFilePath);storage.createAsBinary(function(writer) {reader.transferTo(writer);
response.sendMessageBodyString(ImJson.toJSONString([{'name':upfile.getFileName(),'size':upfile.getLength()
}]));
});
});
}

SharePoint Online 上のファイルをダウンロードする
SharePoint Online 上のファイルをダウンロードする実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのファイルパス、ファイルの名称を元にファイルをダウンロードします。
実装例
Module.download.send() を利用します。
画面遷移を伴わないため、プレゼンテーションページは不要です。
%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/download.js
1
2
3
4
5
6
7

function init(request) {var userCd = Contexts.getAccountContext().userCd;
var providerId = request.providerId;var targetFilePath = request.targetFilePath;var storage = new SharePointStorage(userCd, providerId, targetFilePath);
Module.download.send(storage, storage.getName());}

SharePoint Online 上のファイルの詳細情報を表示する
SharePoint Online 上のファイルの詳細情報を表示する実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのファイルパスをファイルの詳細情報を表示します。
実装例%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/show_detail.js

31

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

var $errorMsg;
var $targetDirPathForShowDetail;var $detail ={};
function init(request) {var userCd = Contexts.getAccountContext().userCd;
var providerId = request.providerId;$targetDirPathForShowDetail = request.targetDirPathForShowDetail;if ($targetDirPathForShowDetail == null) {$errorMsg = 'ファイル、または、ディレクトリが指定されていません。';} else {var storage = new SharePointStorage(userCd, providerId, $targetDirPathForShowDetail);$detail.canonicalPath = storage.getCanonicalPath();$detail.webUrl = storage.getWebUrl();$detail.decodedWebUrl = decodeURIComponent(storage.getWebUrl());$detail.created = new Date(storage.created());$detail.createdUserId = storage.createdUserId();$detail.createdUserName = storage.createdUserName();$detail.lastModified = new Date(storage.lastModified());$detail.lastModifiedUserId = storage.lastModifiedUserId();$detail.lastModifiedUserName = storage.lastModifiedUserName();$detail.length = storage.length();}}%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/show_detail.html

32intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

33

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

<script type="text/javascript">$(document).ready(function() {var errorMsg = '<imart type="string" value=$errorMsg />';
if (errorMsg != '') {imuiShowErrorMessage(errorMsg);}});</script><imart type="head"><title>Office365 - SharePointStorage API サンプル - 詳細表示</title></imart><div class="imui-title"><h1><imart type="string" value=$targetDirPathForShowDetail /></h1></div><div class="imui-form-container-narrow"><div class="imui-chapter-title"><h2>詳細情報</h2></div><table class="imui-table"><tr><th>正規化したパス</th><td><imart type="string" value=$detail.canonicalPath />
</td>
</tr>
<tr>
<th>コンテンツをブラウザ上で確認可能なWeb URL</th><td><imart type="tag" tagname="a" href=$detail.webUrl><imart type="string" value=$detail.decodedWebUrl /></imart>
</td>
</tr>
<tr>
<th>作成時刻</th><td><imart type="dateTime" value=$detail.created pattern="yyyy/MM/dd hh:mm:ss" />
</td>
</tr>
<tr>
<th>作成ユーザID</th><td><imart type="string" value=$detail.createdUserId />
</td>
</tr>
<tr>
<th>作成ユーザ名</th><td><imart type="string" value=$detail.createdUserName />
</td>
</tr>
<tr>
<th>最終更新時刻</th><td><imart type="dateTime" value=$detail.lastModified pattern="yyyy/MM/dd hh:mm:ss" />
</td>
</tr>
<tr>
<th>最終更新ユーザID</th><td><imart type="string" value=$detail.lastModifiedUserId />34

intra-mart
Accel
Platform— Oﬃce 365 連携プログラミングガイド
66<imarttype="string"value=$detail.lastModifiedUserId
/>
67
</td>
68
</tr>
69
<tr>
70
<th>最終更新ユーザ名</th>
71
<td>
72
<imart type="string" value=$detail.lastModifiedUserName />
73
</td>
74
</tr>
75
<tr>
76
<th>ファイルサイズ</th>
77
<td>
78
<imart type="string" value=$detail.length /> バイト
79
</td>
80
</tr>
81
</table>82</div>

第4版 2024-04-01

SharePoint Online 上のファイルを削除する
SharePoint Online 上のファイルを削除する実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのファイルパスを元にファイルを削除します。
実装例
SharePointStorage#remove() を利用します。
%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/remove.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

var $successMsg;
var $errorMsg;
var $targetPath;var $currentDirPath;function init(request) {var userCd = Contexts.getAccountContext().userCd;
var providerId = request.providerId;$currentDirPath = request.targetDirPath != null ? request.targetDirPath : '/';
$targetPath = request.targetPathForRemove != null ? request.targetPathForRemove : null;
if ($targetPath == null) {$errorMsg = 'ファイル、または、ディレクトリが指定されていません。';} else {try {var storage = new SharePointStorage(userCd, providerId, $targetPath);var result = storage.remove(true);if (result) {$successMsg = '「' + $targetPath + '」を削除しました。';} else {$errorMsg = '「' + $targetPath + '」を削除できませんでした。';}} catch (e) {$errorMsg = '削除時にエラーが発生しました。' + '<br><br>' + e.errorMessage;}}}%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/remove.html

35

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

<script type="text/javascript">$(document).ready(function() {var successMsg = '<imart type="string" value=$successMsg />';
var errorMsg = '<imart type="string" value=$errorMsg />';
if (successMsg != '') {imuiShowSuccessMessage(successMsg);} else if (errorMsg != '') {imuiShowErrorMessage(errorMsg);}});</script><imart type="head"><title>Office365 - SharePointStorage API サンプル - 削除</title></imart><div class="imui-title"><h1><imart type="string" value=$targetPath /></h1></div><div class="imui-toolbar-wrap"><div class="imui-toolbar-inner"><ul class="imui-list-toolbar"><li><a href="javascript:$('#backToIndex').submit();" class="imui-toolbar-icon" title="一覧に戻る"><span class="im-ui-icon-common-16-back"></span> 一覧に戻る
</a>
</li>
</ul>
</div></div><form method="post" action="sample/office365/filer" id="backToIndex"><imart type="hidden" targetDirPath=$currentDirPath /></form>SharePoint Online 上のドキュメントをiframeで表示する
SharePoint Online 上のドキュメントをiframeで表示する実装のサンプルです。
リクエストパラメータとして受け取った プロバイダID、ターゲットのファイルパスを元にドキュメントをiframeで表示します。
実装例
imOffice365 タグを利用します。

36

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/show_iframe.js

37

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

var $errorMsg;
var $targetPathForShowIframe;
var $isWordFile;var $isExcelFile;var $isPowerPointFile;var $providerIdfunction init(request) {var userCd = Contexts.getAccountContext().userCd;$providerId = request.providerId;$targetPathForShowIframe = request.targetPathForShowIframe;
if ($targetPathForShowIframe == null) {$errorMsg = 'ファイルが指定されていません。';} else {var storage = new SharePointStorage(userCd, $providerId, $targetPathForShowIframe);$isWordFile = isWord(storage.getName());$isExcelFile = isExcel(storage.getName());$isPowerPointFile = isPowerPoint(storage.getName());}}
function isWord(fileName) {return getExtension(fileName) == '.docx' ? true : false;}function isExcel(fileName) {return getExtension(fileName) == '.xlsx' ? true : false;}function isPowerPoint(fileName) {return getExtension(fileName) == '.pptx' ? true : false;}function getExtension(fileName) {var indexOfLastDot = fileName.lastIndexOf('.');
if (indexOfLastDot == -1) {return null;}
return fileName.substring(indexOfLastDot);}%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/show_iframe.html

38

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

39

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

<script type="text/javascript">$(document).ready(function() {var errorMsg = '<imart type="string" value=$errorMsg />';
if(errorMsg != ''){
imuiShowErrorMessage(errorMsg);}});</script><imart type="head"><title>Office365 - iframe 表示</title></imart><div class="imui-title"><h1><imart type="string" value=$targetPathForShowIframe /></h1></div><div id="imui-container-inner"><imart type="condition" validity=$isWordFile><imart type="imOffice365Word" providerId=$providerId path=$targetPathForShowIframe
width="640" height="480" /></imart><imart type="condition" validity=$isExcelFile><imart type="imOffice365Excel" providerId=$providerId path=$targetPathForShowIframe
width="640" height="480" /></imart><imart type="condition" validity=$isPowerPointFile><imart type="imOffice365PowerPoint" providerId=$providerId path=$targetPathForShowIframe
width="640" height="480" /></imart></div>

注意
ドキュメントを表示するにはユーザが Microsoft 365 - SharePoint Online にログインしている必要があります。

40

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

SharePoint Online のファイラを作成する
前述の実装例を組み合わて SharePoint Online のファイラを作成します。
providerId は「 Office 365 連携 セットアップガイド 」で環境構築の際に設定した <im_office365_files_api.xml> のプロバ
イダIDを指定してください。
実装例
SharePointStorage#directoriesStorages()、SharePointStorage#filesStorages() を利用します。
%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/index.js

41intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

42

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

var $providerId = 'dhimart_1st.onmicrosoft.com';
var $userCd = Contexts.getAccountContext().userCd;
var $directoriesStorages;
var $filesDetails=[];var $currentDirPath;var $errorMsg;
var $parentDir;
var $existsParentDir;function init(request){$currentDirPath = request.targetDirPath != null ? addSlashToTheEnd(request.targetDirPath) : '/';
try{
var storage = new SharePointStorage($userCd, $providerId, $currentDirPath);$directoriesStorages = storage.directoriesStorages(false);
var filesStorages = storage.filesStorages(false);for (var i = 0 ; i<filesStorages.length ; i++){var fileDetail = {fileName : filesStorages[i].getName() ,filePath : filesStorages[i].getPath() ,isWordExcelPowerPointFile:isWordExcelPowerPointFile(filesStorages[i].getName())};$filesDetails[i] = fileDetail;}$parentDir = storage.getParent();
if($parentDir == null){$existsParentDir = false;}else{$existsParentDir = true;}}catch(e if e.errorCode == 'oauth.precondition'){$errorMsg = '「外部連携アプリケーション」画面でアプリケーションを許可してください。';}catch(e){$errorMsg = 'ディレクトリ、または、ファイル一覧の取得時にエラーが発生しました。'+ '<br><br>' + e.errorMessage;}}function isWordExcelPowerPointFile(fileName){
var indexOfLastDot = fileName.lastIndexOf('.');
if (indexOfLastDot == -1) {return false;}
var extension = fileName.substring(indexOfLastDot);if (extension == '.docx' || extension == '.xlsx' || extension == '.pptx') {return true;} else {return false;}}function addSlashToTheEnd(s) {var indexOfLastSlash = s.lastIndexOf('/');
if((indexOfLastSlash == -1) || s.substr((s.length - 1)) =='/'){
return s;} else {return s + '/';}}

43

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01%CONTEXT_PATH%/WEB-INF/jssp/src/sample/office365/filer/index.html

44intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

<script type="text/javascript">function moveDir(targetDirPath) {$('#targetDirPathForMove').val('/' + targetDirPath);$('#moveDirForm').submit();}function downloadFile(targetFilePath) {$('#targetFilePath').val(targetFilePath);$('#downloadFileForm').submit();}function removeFileOrDir(targetPath) {$('#targetPathForRemove').val(targetPath);$('#removeFileOrDirForm').submit();}function showDetail(targetDirPath) {$('#targetDirPathForShowDetail').val(targetDirPath);$('#showDetailForm').submit();}function showIframe(targetFilePath) {$('#targetPathForShowIframe').val(targetFilePath);$('#showIframeForm').submit();}$(document).ready(function() {var errorMsg = '<imart type="string" value=$errorMsg />';
if(errorMsg != ''){
imuiShowErrorMessage(errorMsg);}});$(function($) {$('#toParent').click(function() {$('#targetDirPathForMove').val('/' + '<imart type="string" value=$parentDir />');$('#moveDirForm').submit();});});</script><imart type="head"><title>Office365 - SharePointStorage API サンプル</title></imart><div class="imui-title"><h1><imart type="string" value=$currentDirPath /></h1></div><div class="imui-form-container-narrow"><div class="imui-chapter-title"><h2>ファイル一覧</h2></div><form method="post" action="sample/office365/filer"><imart type="imuiTextbox" name="targetDirPath" value=$currentDirPath size="70" /><input type="submit" value="移動" class="imui-small-button" /></form><br>45

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
66
67<table class="imui-table">
68
<tr>
69
<th>名前</th>70<th>詳細</th>71<th>削除</th>72<th>iframe表示</th>
73
</tr>
74
<imart type="condition" validity=$existsParentDir>
75
<tr>
76
<td>
77
<a href="javascript:void(0)" id="toParent">親ディレクトリへ移動</a>
78
</td>
79
<td></td>
80<td></td>
81<td></td>
82
</tr>
83
</imart>84<!-- ディレクトリ一覧 -->85<imart type="repeat" list=$directoriesStorages item="dirStorage" index="idx">
86
<tr>
87
<td>
88
<span class="im-ui-icon-common-16-folder"></span>
89<a href="javascript:void(0)"90onclick='moveDir("<imart type="string" value=dirStorage.getPath/>");'>
91<imart type="string" value=dirStorage.getName />
92
</a>
93
</td>
94
95
<td align="center">
96<a href="javascript:void(0)"97onclick='showDetail("<imart type="string" value=dirStorage.getPath/>");'>
98<span class="im-ui-icon-common-16-information"></span>
99
</a>
100
</td>
101
102
<td align="center">
103<a href="javascript:void(0)"104onclick='removeFileOrDir("<imart type="string" value=dirStorage.getPath/>");'>
105<span class="im-ui-icon-common-16-trashbox"></span>
106
</a>
107
</td>
108
<td></td>
109
</tr>
110
</imart>111
112<!-- ファイル一覧 -->113<imart type="repeat" list=$filesDetails item="fileStorage" index="idx">
114
<tr>
115
<td>
116
<span class="im-ui-icon-common-16-document"></span>
117<a href="javascript:void(0)"118
onclick='downloadFile("<imart type="string" value=fileStorage.filePath/>");'>
119<imart type="string" value=fileStorage.fileName />
120
</a>
121
</td>
122
123
<td align="center">
124<a href="javascript:void(0)"125onclick='showDetail("<imart type="string" value=fileStorage.filePath/>");'>
126<span class="im-ui-icon-common-16-information"></span>
127
</a>
128
</td>
129
130
<td align="center">
131<a href="javascript:void(0)"132onclick='removeFileOrDir("<imart type="string" value=fileStorage.filePath/>");'>
46

intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199

<span class="im-ui-icon-common-16-trashbox"></span>
</a>
</td>
<td align="center"><imart type="condition" validity=fileStorage.isWordExcelPowerPointFile><a href="javascript:void(0)"onclick='showIframe("<imart type="string" value=fileStorage.filePath/>");'><span class="im-ui-icon-common-16-preview"></span></a></imart>
</td>
</tr>
</imart></table><br><div class="imui-chapter-title"><h2>ファイルアップロード</h2></div><form id="uploadForm" action="sample/office365/filer/upload" enctype="multipart/form-data"><imart type="imuiFileUpload" outerFormId="uploadForm" /><imart type="input" style="hidden" value=$currentDirPath id="targetDirPath" name="targetDirPath" /><imart type="hidden" providerId=$providerId /></form><div class="imui-chapter-title"><h2>ディレクトリ新規作成</h2></div><form method="POST" name="createDir" id="createDir"action="sample/office365/filer/create_dir"><imart type="imuiTextbox" name="createDirName" /><imart type="hidden" targetDirPath=$currentDirPath providerId=$providerId /><input type="submit" value="作成" class="imui-small-button" /></form><form id="moveDirForm" name="moveDirForm" method="POST"
action="sample/office365/filer"><imart type="input" style="hidden" name="targetDirPath" id="targetDirPathForMove" /><imart type="hidden" providerId=$providerId /></form><form id="showDetailForm" name="showDetailForm" method="POST"
action="sample/office365/filer/show_detail" target="office365_show_detail"><imart type="input" style="hidden" name="targetDirPathForShowDetail"id="targetDirPathForShowDetail" /><imart type="hidden" providerId=$providerId /></form><form name="removeFileOrDirForm" id="removeFileOrDirForm" method="POST"
action="sample/office365/filer/remove"><imart type="input" style="hidden" id="targetPathForRemove" name="targetPathForRemove" /><imart type="hidden" targetDirPath=$currentDirPath providerId=$providerId /></form><form name="downloadFileForm" id="downloadFileForm" method="POST"
action="sample/office365/filer/download"><imart type="input" style="hidden" name="targetFilePath" id="targetFilePath" /><imart type="hidden" providerId=$providerId /></form><form method="POST" name="showIframeForm" id="showIframeForm"
action="sample/office365/filer/show_iframe" target="office365_show_iframe">47intra-mart Accel Platform — Oﬃce 365 連携プログラミングガイド 第4版 2024-04-01

199
200
201
202

action="sample/office365/filer/show_iframe" target="office365_show_iframe"><imart type="input" style="hidden" name="targetPathForShowIframe" id="targetPathForShowIframe" /><imart type="hidden" providerId=$providerId /></form></div>

ルーティングテーブルを作成する「スクリプト開発モデル用ルーティングテーブル」を利用してURLに対して スクリプト開発モデル のプログラムの割り当てを行います。
詳しくは「スクリプト開発モデル プログラミングガイド 」-「ルーティング 」を参照してください。
実装例%CONTEXT_PATH%/WEB-INF/conf/routing-jssp-config/office365.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

<?xml version="1.0" encoding="UTF-8"?><routing-jssp-config
xmlns="http://www.intra-mart.jp/router/routing-jssp-config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.intra-mart.jp/router/routing-jssp-config routing-jssp-config.xsd "><authz-default mapper="welcome-all" ></authz-default><file-mapping path="/sample/office365/filer" page="sample/office365/filer/index" /><file-mapping path="/sample/office365/filer/remove" page="sample/office365/filer/remove"/><file-mapping path="/sample/office365/filer/download" page="sample/office365/filer/download" /><file-mapping path="/sample/office365/filer/upload" page="sample/office365/filer/upload" /><file-mapping path="/sample/office365/filer/create_dir" page="sample/office365/filer/create_dir" /><file-mapping path="/sample/office365/filer/show_detail" page="sample/office365/filer/show_detail" /><file-mapping path="/sample/office365/filer/show_iframe" page="sample/office365/filer/show_iframe" /></routing-jssp-config>

48