Zellis (プレビュー)
このコネクタは、日々のタスクを実行するために使用できるさまざまな GET/POST/PUT/PATCH アクションで構成されています。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Zellis サポート |
| [URL] | https://www.zellis.com/contact-existing-zellis-customer/ |
| メール | support@service.zellis.com |
| Connector Metadata | |
|---|---|
| 発行者 | Zellis |
| Web サイト | https://www.zellis.com/ |
| プライバシー ポリシー | https://www.zellis.com/privacy-policy/ |
| カテゴリー | ビジネス インテリジェンス;人事 |
Power Automate 用の Zellis コネクタを使用すると、Zellis HCM のデータと直接やり取りできるため、豊富なビジネスプロセスの自動化が可能になります。 データの変化にリアルタイムで反応し、フローをトリガーします。 Zellis Intelligence プラットフォームを通じて、フローがデータを検索、取得、更新できるようにします。
前提条件
このコネクタを使用するには、Zellis HCM Cloud のバージョン 6.0 以降を使用しており、Zellis Notification Hub が有効になっている必要があります。 Zellis HCM Cloud の旧バージョンには、コネクタ操作をサポートするために必要な機能がありません。 Notification Hub の詳細については、以下のリンクを参照してください: https://help.zellis.com/csm?id=kb_article_view&table=kb_knowledge&sys_id=de3907e71bb3d51068a843f5e34bcbb9 Power Automate のフローを作成するユーザーについて、Zellis Intelligence Platform APIへのユーザー接続を構成しておく必要があります。
資格情報の入手方法
Zellis Intelligence プラットフォームのアクセス認証情報のリクエスト方法については、Zellis カスタマー ヘルプセンターの https://help.zellis.com/csm をご覧ください。
コネクタの使用を開始する
Zellis Intelligence プラットフォームへの接続構成に関する詳細なドキュメントは、Zellis カスタマー ヘルプセンターの Power Automate ナレッジハブ https://help.zellis.com/csm をご覧ください。 弊社では、業務効率化を迅速に実現するために、Power Automate のフローをテンプレート化したライブラリをご用意しています。 また、ご利用のビジネス オートメーションにより近いものを構築するための基礎やインスピレーションを提供することもできます。 テンプレート ライブラリはカスタマー ヘルプセンターでご覧いただけます。
既知の問題と制限事項
Search Zellis Records アクションは、現時点では改ページ位置の自動修正に対応していないため、結果セットを 1000 レコード以下に制限するよう注意してください。 大量のレコードを取得することが予想される場合は、フィルターを使用してレコードを分割することを検討してください。
一般的なエラーと解決策
Zellis Intelligence プラットフォームとの接続をインスタンス化できない場合は、接続パラメータに正しいクライアント ID、シークレット、サブスクリプション キーが入力されているか確認してください。 エンティティ トリガーのリストを取得できない場合は、接続パラメータに正しい Notification Hub ドメイン、コンテキスト、および HMAC キーが入力されていることを確認してください。 検索または更新アクションでエンティティのリストを取得できない場合は、接続パラメータに正しい Zellis Intelligence プラットフォーム ドメインとコンテキストが入力されていることを確認してください。
よくあるご質問
Zellis Intelligence プラットフォームの操作方法に関するナレッジベースにアクセスするには、Zellis カスタマー ヘルプセンターの https://help.zellis.com/csm をご覧ください。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | Description | Required |
|---|---|---|---|
| クライアント ID | string | クライアント ID | True |
| Client Secret | securestring | Client Secret | True |
| 範囲 | string | スコープ (例: api://OdataServerClientId/.default)。 | True |
| リソース URI | string | リソース URI (例: api://OdataServerClientId/.default)。 | True |
| ZIP ドメイン | string | http/https を含まない URL (例: abc.com)。 | True |
| ZIP 読込みコンテキスト | string | ZIP 読み取りコンテキスト (例: zip/odata)。 | True |
| ZIP 書き込みコンテキスト | string | ZIP 書き込みコンテキスト (例: zip/api)。 | True |
| 通知ハブドメイン | string | http/https を含まない URL (例: abc.com)。 | True |
| 通知ハブコンテキスト | string | 通知ハブのコンテキスト (例: notificationhub)。 | True |
| APIM サブスクリプション キー | string | APIM URL 経由で ZIP にアクセスするための APIM サブスクリプション キー。 | |
| HMAC 署名キー | string | HMAC アクセス トークン を生成するための HMAC 署名キー。 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| Partially amend Zellis record |
リストから入手可能な Zellis 標準 Zellis レコードを部分的に修正します。例えば、Worker、WorkerNumber を介して。 |
| Zellis レコードの更新 |
リストから利用可能な Zellis 標準レコードを更新します。例: Zellis Intelligence Platform での固定支払い。 |
| Zellis レコードを検索する |
Zellis 標準レコードのリストを取得します。例えば、検索条件に一致する労働者。 |
| 通知の検証 |
受信した Webhook 通知を検証するには |
Partially amend Zellis record
リストから入手可能な Zellis 標準 Zellis レコードを部分的に修正します。例えば、Worker、WorkerNumber を介して。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Entity
|
entity | True | string |
エンティティ名の選択 |
|
要求本文
|
body | True | dynamic |
選択したエンティティに対するリクエスト。 |
戻り値
Zellis レコードの更新
リストから利用可能な Zellis 標準レコードを更新します。例: Zellis Intelligence Platform での固定支払い。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Entity
|
entity | True | string |
エンティティ名の選択 |
|
要求本文
|
body | True | dynamic |
選択したエンティティに対するリクエスト。 |
戻り値
Zellis レコードを検索する
Zellis 標準レコードのリストを取得します。例えば、検索条件に一致する労働者。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Entity
|
entity | True | string |
エンティティ名の選択 |
|
フィルター
|
$filter | string |
レコードをフィルタリングするための条件を入力します |
|
|
Expand
|
$expand | string |
展開するエンティティ名を入力してください |
|
|
並べ替え
|
$orderby | string |
結果を並べ替えるフィールドを入力してください |
|
|
上
|
$top | string |
返されるレコードの数 |
|
|
Skip Token
|
$skiptoken | string |
ページネーション結果の次のセットに進むためのトークン番号 |
|
|
選択
|
$select | string |
結果として返されるフィールドを入力します |
戻り値
通知の検証
受信した Webhook 通知を検証するには
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X-Zip シグネチャ
|
X-Zip-Signature | True | string |
X-Zip シグネチャ |
|
Payload
|
payload | True | string |
Payload to verify |
戻り値
トリガー
| エンティティ トリガー |
webhook のトリガー |
エンティティ トリガー
webhook のトリガー
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エンティティ名
|
Event | True | string |
トリガーが配置されたエンティティの名前 |
|
イベントの作成
|
Create | True | boolean |
新しいエンティティの作成時にトリガーを有効にするかどうか |
|
イベントの削除
|
Delete | True | boolean |
エンティティの削除時にトリガーを有効にするかどうか |
|
イベントを更新する
|
Update | True | boolean |
エンティティの更新時にトリガーを有効にするかどうか |
|
トリガーの有効化/無効化
|
IsEnabled | True | boolean |
この機能を有効または無効にするには |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
specversion
|
specversion | string |
specversion |
|
id
|
id | string |
id |
|
source
|
source | string |
source |
|
タイプ
|
type | string |
タイプ |
|
時刻
|
time | string |
時刻 |
|
topic
|
topic | string |
topic |
|
validationCode
|
data.validationCode | string |
validationCode |
|
validationUrl
|
data.validationUrl | string |
validationUrl |
|
Action
|
data.Action | string |
Action |
|
Entity
|
data.Entity | string |
Entity |
|
EntityId
|
data.EntityId | string |
EntityId |
|
EntityPath
|
data.EntityPath | string |
EntityPath |
|
UpdatedFields
|
data.UpdatedFields | array of string |
UpdatedFields |
|
UpdatedFieldsUrl
|
data.UpdatedFieldsUrl | string |
UpdatedFieldsUrl |
|
LeaveDate
|
data.LeaveDate | string |
LeaveDate |
|
ParameterFive
|
data.Payload.ParameterFive | string |
ParameterFive |
|
EventUUID
|
data.Payload.EventUUID | string |
EventUUID |
|
ConnectionType
|
data.Payload.ConnectionType | string |
ConnectionType |
|
ParameterOne
|
data.Payload.ParameterOne | string |
ParameterOne |
|
ParameterThree
|
data.Payload.ParameterThree | string |
ParameterThree |
|
OperatorId
|
data.Payload.OperatorId | string |
OperatorId |
|
DateTimeAmended
|
data.Payload.DateTimeAmended | string |
DateTimeAmended |
|
OperatorSelectionNo
|
data.Payload.OperatorSelectionNo | string |
OperatorSelectionNo |
|
ParameterFour
|
data.Payload.ParameterFour | string |
ParameterFour |
|
EventDatetime
|
data.Payload.EventDatetime | string |
EventDatetime |
|
ParameterTwo
|
data.Payload.ParameterTwo | string |
ParameterTwo |
|
DateTimeCreated
|
data.Payload.DateTimeCreated | string |
DateTimeCreated |
|
アプリケーション
|
data.Payload.Application | string |
アプリケーション |
|
hmac
|
data.additionalDetails.hmac | string |
hmac |
|
subject
|
subject | string |
subject |
|
eventType
|
eventType | string |
eventType |
|
eventTime
|
eventTime | string |
eventTime |
|
metadataVersion
|
metadataVersion | string |
metadataVersion |
|
dataVersion
|
dataVersion | string |
dataVersion |
|
verifySubscription
|
verifySubscription | boolean |
verifySubscription |
定義
StaticResponseWriteSchema
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
timeTaken
|
payload.timeTaken | string |
timeTaken |
|
サービス
|
payload.service | string |
サービス |
|
transactionId
|
payload.transactionId | string |
transactionId |
|
transactionId
|
transactionId | string |
transactionId |
|
errors
|
errors | array of object |
errors |
|
errorType
|
errors.errorType | string |
errorType |
|
errorCode
|
errors.errorCode | string |
errorCode |
|
message
|
errors.message | string |
message |
|
成功
|
processingStatus.success | string |
成功 |
|
workerNumber
|
worker.workerNumber | string |
workerNumber |