パブリック 360
Public 360 は、ノルディックスの市場をリードする ECM システムです。 Public 360 コネクタを使用すると、ユーザーはケース、ドキュメント、ファイルをパブリック 360 にアーカイブするフローを作成できます。 Public 360 コネクタを使用すると、ユーザーはより簡単にアーカイブできるようになります。 これには、ソーシャル メディアの投稿、Outlook アイテム、または OneDrive ドキュメントのアーカイブが含まれます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate(パワーオートメート) | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | 360 のサポート |
| URL | https://tieto.service-now.com/tsc |
| public360.support@tietoevry.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | ティトエブリ ノルウェー |
| Website | https://www.tietoevry.com/ |
| プライバシー ポリシー | https://www.tietoevry.com/siteassets/files/privacy-notice/privacy-notice-public-360-power-automate-connetor.pdf |
| カテゴリ | コンテンツとファイル。生産性 |
Public 360° は、ノルディックスの市場をリードするエンタープライズ コンテンツ管理システムです。 Public 360° Connector は、SIF (Simple Integration Framework) API を介してシステムと統合され、パブリック 360° でケース、ドキュメント、ファイルを直接自動的に作成できます。 メール、ソーシャル メディアの投稿、クラウド ストレージからのドキュメントなどの情報は、一貫した構造化された方法でキャプチャおよび整理できます。 このコネクタは、Public 360° でのレコードの作成を簡素化することで、信頼性とコンプライアンスに準拠した記録を確保しながら、組織がデジタル プロセスを拡張するのに役立ちます。
[前提条件]
このコネクタを使用するには、次の要件が満たされていることを確認します。
- 有効な Azure サブスクリプション
- Microsoft Entra ID の承認済みユーザー アカウント
- パブリック 360° でデータにアクセスおよびアーカイブするために必要なアクセス許可
資格情報を取得する方法
Public 360° コネクタでは、Azure Active Directory (AAD) を介したベアラー トークン認証が使用されます。 接続するには、Public 360° インスタンスにアクティブなユーザー アカウントが必要です。 Public 360° 資格情報を使用してサインインすると、AAD 経由で認証が行われ、接続を確立するために必要なベアラー トークンが生成されます。 この接続は個人用であり、共有することはできません。 このコネクタを使用する Power App が別のユーザーと共有されている場合、そのユーザーは独自の接続を明示的に作成するように求められます。 必要なアカウントまたはアクセス許可が不明な場合は、Public 360° 管理者にお問い合わせください。
既知の問題と制限
コネクタは現在、3 つのアクションをサポートしています。Public 360° での新しいケースの作成、既存のケースへのドキュメントのアップロードとアーカイブ、ドキュメントへのファイルの添付、またはパブリック 360° での直接の添付です。 コネクタ インターフェイスで直接使用できるパラメーターの数は限られていますが、一覧にないパラメーターは AdditionalFields パラメーターを使用して構成できます。 近い将来、利用可能なサービスの範囲を拡大し、ユーザーのフィードバックに基づいて改善を導入する予定です。 プロセスをシンプルにし、ペイロード サイズを小さくするには、Public 360° の既定値セットを使用することをお勧めします。 AdditionalFields を使用したパラメーターの設定、既定値セットの使用、コネクタのその他の側面の最適化に関するガイダンスについては、360° 管理者にお問い合わせください。
一般的なエラーと解決方法
コネクタを使用するときの潜在的な問題は次のとおりです。
-
401 Unauthorized: 認証が失敗した場合に発生します。 これは、SIF API にアクセスするために指定された資格情報が無効、期限切れ、または不足している場合、またはユーザーが要求されたアクションを実行するための十分なアクセス許可を持っていない場合に発生する可能性があります。 -
502 Bad Gateway: コネクタがパブリック 360° サービスと正常に通信できなかったことを示します。 一般的な原因としては、一時的なサービスの停止、ネットワークの問題、API エンドポイントでの構成の誤りなどがあります。 ホスト URL に https:// プレフィックスを含めると、よくある間違いがあります。ホストを指定せずに指定する必要があります (たとえば、 https://my360.comの代わりに my360.com を使用します)。 それ以外の場合は、基になる SIF API 呼び出しが失敗した場合でも、HTTP 応答コードは 200 になります。 SIF API 呼び出しの実際の結果は、応答本文の Successful プロパティによって示されます。 [成功] の値が [いいえ] の場合、操作は成功しませんでした。 エラーの詳細については、ErrorMessage プロパティと ErrorDetails プロパティを参照してください。
このコネクタでは、パブリック 360 との通信に SIF API を使用しています。 詳細については、https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf を参照してください。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ケースの作成 |
この操作は、SIF API を使用して Public 360 でケースを作成するために使用されます。 必須フィールドには、タイトル、ケースの種類、責任者の電子メール/ID 番号、または責任あるエンタープライズ番号が含まれます。 Public 360 の既定値セット機能を使用して、ケース、ドキュメント、およびファイルのこれらの値を事前構成することをお勧めします。 これは、フォームから、または外部システムとの統合によってドキュメントを自動的に作成する場合に特に便利です。 詳細については、以下を参照してください。 https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf |
| ドキュメントの作成 |
この操作は、SIF API を使用して Public 360 でドキュメントを作成するために使用され、登録済みドキュメントと未登録ドキュメントの両方をサポートします。 必須フィールドには、タイトル、アーカイブ、カテゴリ、および状態が含まれます。 登録されたドキュメントには、ケース番号を含める必要があります。 未登録のドキュメントには大文字と小文字は必要ありませんが、ToOrigin、CF_ExtSystem、Commited の 3 つのフィールドを追加する必要があります。 未登録のドキュメントのアーカイブは、"Import archive" (既定の recno: 7) に設定する必要があります。 これらの値を事前に構成するには、Public 360 の既定値セット機能を使用することをお勧めします。 詳細については、以下を参照してください。 https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf |
| ファイルの作成 |
この操作により、SIF API を使用して Public 360 にファイルが作成されます。 詳細については、以下を参照してください。 https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf |
ケースの作成
この操作は、SIF API を使用して Public 360 でケースを作成するために使用されます。 必須フィールドには、タイトル、ケースの種類、責任者の電子メール/ID 番号、または責任あるエンタープライズ番号が含まれます。 Public 360 の既定値セット機能を使用して、ケース、ドキュメント、およびファイルのこれらの値を事前構成することをお勧めします。 これは、フォームから、または外部システムとの統合によってドキュメントを自動的に作成する場合に特に便利です。 詳細については、以下を参照してください。 https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ホスト URL
|
hosturl | True | string |
パブリック 360 ソリューションを指すホスト URL。 |
|
Title
|
Title | True | string |
ケースのタイトル。 |
|
既定値の設定
|
DefaultValueSet | string |
渡されない場合、それらの値を既定値として使用してケースを作成するために使用される Case エンティティに対して定義された値のセット。 |
|
|
非公式タイトル
|
UnofficialTitle | string |
ケースの非公式タイトル。 |
|
|
サポート案件のタイプ
|
CaseType | string |
"Case" や "recno:2" などのコード値または recno 値。 Case 型コード テーブルを参照します。 |
|
|
責任者の電子メール
|
ResponsiblePersonEmail | string |
ケースの責任者。 |
|
|
責任者 ID 番号
|
ResponsiblePersonIdNumber | string |
有効な連絡先外部 ID を参照します。責任者の電子メールに代わるもの。 |
|
|
責任あるエンタープライズ番号
|
ResponsibleEnterpriseNumber | string |
外部 ID または参照番号に基づいてエンタープライズを検索します。 責任者の電子メールと ID 番号に代わるもの。 |
|
|
進行状況プラン ID
|
ProgressPlanId | integer |
ケースを進行状況プランに接続するための進行状況プラン ID。 進行状況プラン ID には、recno、workunit ID、または説明を指定できます。 |
|
|
名前
|
Name | string |
フィールド名を指定します。 この名前は、360° メタ モデルの名前です (常に 360° GUI で見られる名前と同じとは限りません)。 |
|
|
価値
|
Value | string |
フィールドに設定する値。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Recno
|
Recno | integer |
Recno |
|
案件番号
|
CaseNumber | string |
案件番号 |
|
成功
|
Successful | boolean |
成功 |
|
エラーメッセージ
|
ErrorMessage | string |
エラーメッセージ |
|
ErrorDetails
|
ErrorDetails | string |
ErrorDetails |
ドキュメントの作成
この操作は、SIF API を使用して Public 360 でドキュメントを作成するために使用され、登録済みドキュメントと未登録ドキュメントの両方をサポートします。 必須フィールドには、タイトル、アーカイブ、カテゴリ、および状態が含まれます。 登録されたドキュメントには、ケース番号を含める必要があります。 未登録のドキュメントには大文字と小文字は必要ありませんが、ToOrigin、CF_ExtSystem、Commited の 3 つのフィールドを追加する必要があります。 未登録のドキュメントのアーカイブは、"Import archive" (既定の recno: 7) に設定する必要があります。 これらの値を事前に構成するには、Public 360 の既定値セット機能を使用することをお勧めします。 詳細については、以下を参照してください。 https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ホスト URL
|
hosturl | True | string |
パブリック 360 ソリューションを指すホスト URL。 |
|
Title
|
Title | True | string |
ドキュメントのタイトル。 |
|
サポート案件番号
|
CaseNumber | string |
このドキュメントが属するケースのケース番号。 |
|
|
既定値の設定
|
DefaultValueSet | string |
渡されない場合、それらの値を既定値としてドキュメントを作成するために使用されるドキュメント エンティティに対して定義された値のセット |
|
|
非公式タイトル
|
UnofficialTitle | string |
ドキュメントの非公式タイトル。 |
|
|
責任者の電子メール
|
ResponsiblePersonEmail | string |
ドキュメントの責任者。 |
|
|
カテゴリ
|
Category | string |
ドキュメントのカテゴリ。 F.ex. recno:60005 for Internal memo without follow-up |
|
|
ステータス
|
Status | string |
ドキュメントの状態。 F.ex. recno:1 for Reserved または recno:6 for Officially recorded |
|
|
アーカイブ
|
Archive | string |
このドキュメントのドキュメント アーカイブ |
|
|
注記
|
Notes | string |
ドキュメントのメモ。 |
|
|
Role
|
Role | string |
特定のドキュメントに対する連絡先の役割。 コードまたは recno を指定できます。 |
|
|
参照番号
|
ReferenceNumber | string |
参照番号は、個人の個人 ID 番号と企業のエンタープライズ番号です。 |
|
|
名前
|
Name | string |
フィールド名を指定します。 この名前は、360° メタ モデルの名前です (常に 360° GUI で見られる名前と同じとは限りません)。 |
|
|
価値
|
Value | string |
フィールドに設定する値。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Recno
|
Recno | integer |
Recno |
|
DocumentNumber
|
DocumentNumber | string |
DocumentNumber |
|
成功
|
Successful | boolean |
成功 |
|
エラーメッセージ
|
ErrorMessage | string |
エラーメッセージ |
|
ErrorDetails
|
ErrorDetails | string |
ErrorDetails |
ファイルの作成
この操作により、SIF API を使用して Public 360 にファイルが作成されます。 詳細については、以下を参照してください。 https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ホスト URL
|
hosturl | True | string |
パブリック 360 ソリューションを指すホスト URL。 |
|
Title
|
Title | True | string |
ファイルのタイトル。 |
|
ドキュメント番号
|
DocumentNumber | string |
このファイルが属するドキュメントのドキュメント番号。 伝票番号または伝票レキュノを指定する必要があります。 |
|
|
ドキュメント Recno
|
DocumentRecno | integer |
このファイルが属するドキュメントのドキュメント Recno。 伝票番号または伝票レキュノを指定する必要があります。 |
|
|
Format
|
Format | True | string |
ファイルの作成時に渡されるファイルの種類 (例: "txt"、"htm")。 |
|
データ
|
Base64Data | True | string |
ファイルの内容。"Base64" でエンコードされています。 |
|
名前
|
Name | string |
フィールド名を指定します。 この名前は、360° メタ モデルの名前です (常に 360° GUI で見られる名前と同じとは限りません)。 |
|
|
価値
|
Value | string |
フィールドに設定する値。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Recno
|
Recno | integer |
Recno |
|
成功
|
Successful | boolean |
成功 |
|
エラーメッセージ
|
ErrorMessage | string |
エラーメッセージ |
|
ErrorDetails
|
ErrorDetails | string |
ErrorDetails |