OPROARTS Connectorヘルプ

クライアント環境の要件

オペレーティングシステム

• Salesforceに対応しているすべてのオペレーティングシステム

ウェブブラウザー

• Salesforceに対応しているすべてのウェブブラウザー（文書出力時）
• 最新のMozilla Firefox, Google Chrome, Apple Safari（デザイン時）

*.oproarts.comドメインのCookieの受け入れ、および、JavaScriptの実行の許可が必要です。

アプリケーションソフトウェア

• Adobe Acrobat ReaderなどのPDF文書を表示できるソフトウェア（PDF出力時）
• OPRO X Browser（OPR出力時、直接印刷時）
• Microsoft Excel (Excelブック出力時)

Salesforce環境の要件

Salesforce（Sales Cloud, Service Cloud, Force.com）の以下のエディションにインストールできます。

• Unlimited Edition
• Enterprise Edition
• Professional Edition
• Developer Edition

パッケージのインストール

1. [パッケージインストールの詳細]ページの内容を確認し、[次へ]ボタンをクリックします。
2. [パッケージAPIアクセスの承認]ページが表示されますので、内容を確認します。すべての項目にチェックが入っていますが、本アプリケーションはユーザの権限を越えてデータを取得することはありません。[次へ]ボタンをクリックします。
3. [セキュリティレベルの選択]ページが表示されます。[セキュリティ設定の選択]の[セキュリティ設定の選択]ラジオボタンをクリックして選択し、使用させる予定のないユーザのアクセス権限を外します。[次へ]ボタンをクリックします。
4. [パッケージのインストール]ページが表示されますので、[インストール]ボタンをクリックします。

ユーザ権限の設定

使用するユーザのプロファイルが「システム管理者」以外の場合、プロファイルを編集して以下の権限を与えてください。編集できない標準のプロファイルの場合は、プロファイルを新規作成して、そのプロファイルをコピーし、それを編集して、各ユーザに割り当ててください。

(*1) カスタマーポータルユーザの場合、プロファイルの編集画面にカスタムオブジェクトOPROARTS・OPROARTSユーザの権限が表示されないことがあります。その場合は、以下の手順で、これらのオブジェクトをカスタマーポータルで使用できるようにしてください。

1. [設定]から、[ビルド] | [作成] | [オブジェクト]をクリックして、[カスタムオブジェクト]ページを開きます。
2. [インストール済みパッケージ]列がOPROARTS Connector、[表示ラベル]列がOPROARTSである行の、[編集]リンクをクリックして、OPROARTS (管理)の編集ページを開きます。
3. [追加の機能]セクションで、[カスタマーポータルで利用可]チェックボックスを選択します。
4. [保存]ボタンをクリックします。
5. 同様に、[インストール済みパッケージ]列がOPROARTS Connector、[表示ラベル]列がOPROARTSユーザである行の、[編集]リンクをクリックして、OPROARTSユーザ (管理)の編集ページを開きます。
6. [追加の機能]セクションで、[カスタマーポータルで利用可]チェックボックスを選択します。
7. [保存]ボタンをクリックします。

ログインセッションの設定

デザイン機能と文書作成処理はOPROARTSのクラウド環境にて実行されます。その際、Salesforceへのログインセッションを使用して、必要に応じてSalesforceから情報を取得します。そのため、以下のようにして、ログインセッションを使用した外部アクセスを許可してください。

1. [設定]から、[管理] | [セキュリティのコントロール] | [セッションの設定]をクリックします。
2. [ログイン時の IP アドレスとセッションをロックする]チェックボックスをオフにします。
3. [保存]ボタンをクリックします。
4. 設定を変更した場合は、一旦、Salesforceからログアウトして、ログインしなおします。

認証情報の取得

「OPROARTS Connector」を使用するには、「OPROARTS認証情報」が必要です。株式会社オプロへお問い合わせの上、認証情報を取得してください。認証情報が発行されるまで、使用を開始することはできません。お待たせして大変申し訳ありませんが、ご了承ください。

認証情報には、テンプレートデザインのライセンスに対する認証情報（デザイン）と文書出力のライセンスに対する認証情報（出力）があります。いずれも3個の値（CID、UID、パスワード）で構成されます。それぞれの認証情報について、お客様組織ごとに1個のCIDと、使用するユーザごとに1組ずつのUID・パスワードが与えられます。通常は、認証情報（デザイン）のCIDと認証情報（出力）のCIDは共通のコードになります。

認証情報（デザイン）の設定

テンプレートデザインを作成するユーザに認証情報（デザイン）を割り当てます。割り当てられたユーザは、[OPROARTS]タブから「OPROARTS Designer」を起動できるようになります。

1. アプリケーションメニュー（ページの上部右に表示されているドロップダウンリスト）から[OPROARTS Connector]を選択します。
2. [OPROARTS]タブをクリックします。
3. ページ下部の[OPROARTS]セクションで、下記の項目を入力します。すでに[LAD]が追加されていればこの手順は不要です。
   • OPROARTS列のドロップダウンから、[デザイン (LAD)]を選択します。
   • CID列の入力欄に、取得した認証情報のCIDを入力します。
   • [追加]ボタンをクリックします。
4. 下のリストに追加された行で、OPROARTS列の[LAD]リンクをクリックして、OPROARTSの詳細ページを開きます。
5. [OPROARTSユーザ]セクションで、下記の項目を入力します。
   • ユーザ列の入力欄の右のボタンをクリックして、Salesforceのユーザを選択します。
   • UID列の入力欄に、取得した認証情報のUIDを入力します。
   • UPW列の入力欄に、取得した認証情報のパスワードを入力します。
   • [追加]ボタンをクリックします。
6. 他のユーザにもテンプレートデザインの作成を許可する場合は、5.の手順を繰り返します。

認証情報（出力）の設定

文書出力を許可するユーザに認証情報（出力）を割り当てます。割り当てられたユーザは、OPROARTS Designerで作成した出力ボタンから、文書出力することができます。

1. アプリケーションメニュー（ページの上部右に表示されているドロップダウンリスト）から[OPROARTS Connector]を選択します。
2. [OPROARTS]タブをクリックします。
3. ページ下部の[OPROARTS]セクションで、下記の項目を入力します。すでに[LA]が追加されていればこの手順は不要です。
   • OPROARTS列のドロップダウンから、[出力 (LA)]を選択します。
   • CID列の入力欄に、取得した認証情報のCIDを入力します。
   • [追加]ボタンをクリックします。
4. 下のリストに追加された行で、OPROARTS列の[LA]リンクをクリックして、OPROARTSの詳細ページを開きます。
5. [OPROARTSユーザ]セクションで、下記の項目を入力します。
   • ユーザ列の入力欄の右のボタンをクリックして、Salesforceのユーザを選択します。
   • UID列の入力欄に、取得した認証情報のUIDを入力します。
   • UPW列の入力欄に、取得した認証情報のパスワードを入力します。
   • [追加]ボタンをクリックします。
6. 他のユーザにも文書出力を許可する場合は、5.の手順を繰り返します。

テンプレートデザインの作成

OPROARTS Designerでテンプレートデザインを作成します。

1. 認証情報（デザイン）が割り当てられたユーザでSalesforceにログインします。
2. アプリケーションメニュー（ページの上部右に表示されているドロップダウンリスト）から[OPROARTS Connector]を選択します。
3. [OPROARTS]タブをクリックします。
4. [START]ボタンをクリックします。すると、OPROARTS Designerが開きます。
5. OPROARTS Designerで、テンプレートデザインを作成します。OPROARTS Designerの使い方については、OPROARTS Designerヘルプをご覧ください。

テンプレートデザインが作成できたら、テンプレートをOPROARTSサービスへ配備します。

文書出力ボタンの作成

OPROARTS Designerでテンプレートの配備が完了すると、文書出力するためのスクリプトが発行されます。そのスクリプトを用いてカスタムボタンを作成します。

1. 発行されたスクリプトをクリップボードにコピーします。
2. 認証情報（デザイン）が割り当てられたユーザでSalesforceにログインします。
3. Salesforce上で文書出力するオブジェクトの設定ページを開きます。
   • 標準オブジェクトの場合: [設定]から、[ビルド] | [カスタマイズ] | オブジェクト名 | [ボタンとリンク]をクリックします。
   • カスタムオブジェクトの場合: [設定]から、[ビルド] | [作成] | [オブジェクト]をクリックして、[表示ラベル]列から該当するオブジェクト名のリンクをクリックします。
4. [カスタムボタンとカスタムリンク]セクションの[新規]ボタンをクリックします。
5. 下記項目を設定します。
   • [表示ラベル]: ボタンの文字列を入力します。例えば、文書名など。
   • [名前]: ボタンの名前を入力します。例えば、テンプレート名など。
   • [表示の種類]: スクリプト出力前に選択した[ボタン設置場所]と同じ値を選択します。
   • [動作]: JavaScriptを実行
   • [内容のソース]: OnClick JavaScript
   • スクリプト入力欄: 先ほどコピーしたスクリプトを貼り付けます。
6. [保存]ボタンをクリックします。
7. 詳細ページから出力する場合、[ページレイアウト]セクションで、出力ボタンを配置するレイアウトを開き、先ほど作成したボタンを追加します。
8. リストビューから出力する場合、[検索レイアウト]セクションの[オブジェクト名 リストビュー]レイアウトの[編集]をクリックし、先ほど作成したボタンを追加します。

文書出力

配置したボタンから、文書を出力します。

詳細ページからの場合

1. 出力するオブジェクトのレコードを開きます。
2. 出力ボタンをクリックします。

リストビューからの場合

1. 出力するオブジェクトのタブを開きます。
2. いずれかのビューを選択して、[Go!]ボタンをクリックします。
3. 出力するレコードをチェックボックスで選択します。
4. 出力ボタンをクリックします。

Salesforce連携に関する仕様

出力可能な文書に関する仕様

カスタムボタンの削除

文書出力ボタンの作成で、カスタムボタンを追加した手順と逆の手順を実行して、カスタムボタンを削除します。

1. Salesforce上で文書出力するオブジェクトの設定ページを開きます。
   • 標準オブジェクトの場合: [設定]から、[ビルド] | [カスタマイズ] | オブジェクト名 | [ボタンとリンク]をクリックします。
   • カスタムオブジェクトの場合: [設定]から、[ビルド] | [作成] | [オブジェクト]をクリックして、[表示ラベル]列から該当するオブジェクト名のリンクをクリックします。
2. 詳細ページから出力していた場合、[ページレイアウト]セクションで、出力ボタンを配置するレイアウトを開き、ボタンを取り除きます。
3. リストビューから出力していた場合、[検索レイアウト]セクションの[オブジェクト名 リストビュー]レイアウトの[編集]をクリックし、ボタンを削除します。
4. [カスタムボタンとカスタムリンク]セクションで、当該のカスタムボタンを削除します。

パッケージのアンインストール

1. [設定]から、[ビルド] | [インストール済みパッケージの参照]を開きます。
2. OPROARTS Connectorパッケージの[アンインストール]をクリックします。
3. ページ下部にある、[はい、このパッケージをアンインストールして、すべての関連コンポーネントを永久に削除します]チェックボックスを選択して、[アンインストール]をクリックします。

[OPROARTS]タブに[OPROARTS]セクションが表示されない。OPROARTS認証情報を追加できない。

OPROARTS・OPROARTSユーザオブジェクトへの権限は適切ですか。

ユーザ権限の設定を参照して、それらの権限を設定してください。

OPROARTS Designerの[START]ボタンがない。または、開くとOPROARTSのログインページかエラーページが表示される。

OPROARTS認証情報は適切に設定されていますか。

認証情報（デザイン）の設定を参照して、認証情報を設定してください。

[ログイン時のIPアドレスとセッションをロックする]は無効ですか。

ログインセッションの設定を参照して、この設定を無効にしてください。

OPROARTS・OPROARTSユーザオブジェクトへの権限は適切ですか。

ユーザ権限の設定を参照して、それらの権限を設定してください。

文書出力用のボタンをクリックしても、エラーが表示され文書出力できない。

OPROARTS認証情報は適切に設定されていますか。

認証情報（出力）の設定を参照して、認証情報を設定してください。

[ログイン時のIPアドレスとセッションをロックする]は無効ですか。

ログインセッションの設定を参照して、この設定を無効にしてください。

OPROARTS・OPROARTSユーザオブジェクトへの権限は適切ですか。

ユーザ権限の設定を参照して、それらの権限を設定してください。

アンインストールできない。

文書出力用のカスタムボタンが残っていませんか。

カスタムボタンの削除を参照して、残っているボタンを削除してください。

OPROARTS Connectorパッケージのコンポーネントを使用・参照しているアプリケーション、オブジェクト、ページ等はありませんか。

パッケージのコンポーネントを使用・参照するアプリケーションがあれば、前以ってそれをアンインストールしてください。同様に使用・参照するオブジェクト、ページ等があれば、前以ってそれらを削除してください。