다음을 통해 공유

Dayforce HCM(미리 보기)

Dayforce HCM API에 연결하여 직원 참조 코드로 직원 개인 정보(연락처, 주소, 이름)를 검색합니다. HR 관리자 및 하위 코드 개발자를 위한 것입니다. Dayforce 테넌트, API 자격 증명(기본 인증) 및 적절한 권한이 필요합니다. 읽기 전용입니다. 잘못된 참조 코드가 오류를 반환합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 지역
Copilot Studio 프리미엄 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 표준 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps 프리미엄 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
파워 오토메이트 프리미엄 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Dayforce 지원
URL https://www.dayforce.com/resources/help-center#support-for-employers
전자 메일 MicrosoftPartnership@dayforce.com
커넥터 메타데이터
Publisher Dayforce AI
웹 사이트 https://www.dayforce.com/
개인 정보 보호 정책 https://www.dayforce.com/privacy
카테고리 Ai; 인사

Dayforce HCM

Dayforce HCM은 인적 자본 관리 플랫폼입니다.
이 커넥터는 외부 참조 코드(XRefCode)를 통해 직원의 개인 정보(이름, 주소 및 연락처 세부 정보)를 검색할 수 있는 Dayforce API 작업을 노출합니다. 이 데이터는 다른 Power Platform 시나리오뿐만 아니라 Copilot Studio AI 에이전트의 도구로 사용할 수 있습니다.

게시자: Dayforce

사전 요구 사항

이 커넥터를 사용하려면 다음이 필요합니다.

  • Microsoft Power Platform 환경(예: Copilot Studio에서 커넥터 사용).
  • 활성 Dayforce HCM 환경(QA, UAT 또는 프로덕션)입니다.
  • 직원 개인 정보를 읽을 수 있는 권한이 있는 Dayforce API 사용자 (서비스 계정)입니다.
  • Dayforce 환경의 클라이언트 네임스페이스 입니다.
    • 이 값은 Dayforce API URL에서 네임스페이스 세그먼트로 나타납니다. 예를 들면 다음과 같습니다.
      https://{environmentHost}/{clientNamespace}/V1/...

지원되는 작업

커넥터는 현재 다음 작업을 노출합니다.

직원 개인 정보 가져오기

작업 ID:Get_Employee_Personal_Info
메서드:GET

XRefCode를 기반으로 한 단일 직원에 대한 개인 정보의 필터링되고 간소화된 보기를 검색합니다.

요청

  • Path 매개 변수
    • xRefCode (문자열, 필수)
      검색할 직원의 외부 참조 코드입니다. 값은 기존 직원의 XRefCode와 정확히 일치해야 합니다. 그렇지 않으면 서비스에서 400 잘못된 요청을 반환합니다.

내부적으로 커넥터는 클라이언트 네임스페이스에 대한 Dayforce Employees 엔드포인트로 호출을 라우팅하고 관련 개인 정보를 확장한 다음 커넥터의 스크립트에 의해 간소화된 JSON 개체로 변환됩니다.

응답

성공(HTTP 200)에서는 커넥터가 전체 Dayforce 직원 페이로드를 반환 하지 않습니다.
대신 이 구조를 사용하여 변환된 개체를 반환합니다.

{
  "firstName": "string",
  "lastName": "string",
  "addresses": [
    {
      "address1": "string",
      "address2": "string",
      "address3": "string",
      "city": "string",
      "postalCode": "string",
      "country": "string",
      "state": "string",
      "contactInformationType": "string"
    }
  ],
  "contacts": [
    {
      "personContactId": 0,
      "contactInformationType": "string",
      "electronicAddress": "string",
      "contactNumber": "string",
      "country": "string",
      "effectiveStart": "2024-01-01T00:00:00Z"
    }
  ]
}

즉,

  • 최상위 필드

    • firstName – 직원의 이름입니다.
    • lastName – 직원의 성입니다.
    • addresses – 필터링된 주소 항목 목록입니다.
    • contacts – 필터링된 연락처 항목 목록입니다.

  • Address 개체(addresses[])

    • address1 – 기본 주소 줄입니다.
    • address2 – 보조 주소 줄입니다.
    • address3 – 추가 주소 줄입니다.
    • city – 도시 이름입니다.
    • postalCode – 우편 번호 또는 우편 번호입니다.
    • country – 국가 이름(Dayforce 국가 이름에서 매핑됨).
    • state – 주 또는 주 이름(Dayforce State 이름에서 매핑됨).
    • contactInformationType – Dayforce 연락처 정보 유형에 따라 주소 유형(예: "홈", "메일링")을 설명하는 짧은 이름입니다.

  • Contact 개체(contacts[])

    • personContactId – 연락처 레코드의 내부 숫자 식별자입니다.
    • contactInformationType – 연락처 유형을 설명하는 짧은 이름입니다(예: "Mobile", "Home Phone", "Work Email").
    • electronicAddress – "온라인 프로필" 스타일 연락처(예: 전자 메일 또는 기타 전자 주소)의 경우
    • contactNumber – 전화 스타일 연락처의 경우(예: 모바일 또는 유선 전화 번호)
    • country – 연락처와 연결된 국가 값(해당하는 경우).
    • effectiveStart – 이 연락처 정보의 유효 시작 날짜(사용 가능한 경우)입니다.

참고: 커넥터의 스크립트는 의도적으로 원시 Dayforce 페이로드를 필터링합니다.
위에 표시된 필드만 이 작업의 호출자에게 노출됩니다.

오류가 발생하면 API는 다음을 반환합니다.

  • 400 잘못된 요청 – 잘못된 요청 또는 잘못된 xRefCode요청의 경우 .
  • 500 내부 서버 오류 – 예기치 않은 서버 쪽 오류.

오류 응답에는 기본 Dayforce API의 진단 정보가 포함됩니다.

자격 증명 가져오기

이 커넥터는 기본 인증 을 사용하여 Dayforce API에 연결합니다.

필요한 자격 증명을 가져오려면 다음을 수행합니다.

  1. Dayforce에서 API 사용자 만들기 또는 식별

    • Dayforce 관리자 또는 구현 팀과 함께 작업합니다.
    • API 사용자가 사용자 환경에 대한 직원 개인 정보에 대한 읽기 권한이 있는지 확인합니다.

  2. 다음 값 수집

    • 사용자 이름 – Dayforce API 사용자 이름입니다.
    • 암호 – Dayforce API 암호입니다.
    • 클라이언트 네임스페이스 – Dayforce API URL에 사용되는 네임스페이스 값입니다.
      • 조직 또는 환경에 대한 짧은 식별자(예: 다음과 같은 URL에 표시되는 세그먼트)입니다.
        https://{environmentHost}/{clientNamespace}/V1/Employees/...;

  3. 커넥터 연결을 만들 때 이러한 값 사용

    • Power Platform 연결 대화 상자에서 다음을 수행합니다.
      • Dayforce API 사용자의 사용자 이름 및 암호를 입력합니다.
      • " 클라이언트 네임스페이스 " 필드에 Dayforce 클라이언트 네임스페이스를 입력합니다.
    • 커넥터는 이러한 값을 사용하여 요청을 올바른 Dayforce 테넌트에 라우팅하고 호출을 인증합니다.

클라이언트 네임스페이스 또는 API 사용자 세부 정보를 잘 모르는 경우 Dayforce 지원 또는 내부 Dayforce 관리자에게 문의하세요.

시작하기

이 커넥터를 테스트하고 사용하는 권장 방법은 Copilot Studio AI 에이전트에 도구로 추가하는 것입니다.

1. 연결 만들기

Copilot Studio에서 커넥터를 사용하기 전에 연결이 있는지 확인합니다.

  1. Power Platform 관리자 또는 작성자 환경에서 데이터>연결로 이동합니다.
  2. + 새 연결을 선택합니다.
  3. Dayforce HCM 커넥터(이 커넥터)를 검색합니다.
  4. 메시지가 표시되면 다음을 입력합니다.
    • 사용자 이름 – Dayforce API 사용자 이름입니다.
    • 암호 – Dayforce API 사용자 암호입니다.
    • 클라이언트 네임스페이스 – Dayforce 클라이언트 네임스페이스입니다.
  5. 연결을 저장합니다.

2. Copilot Studio에서 AI 에이전트를 만들고 커넥터를 도구로 추가

  1. Copilot Studio 엽니다.
  2. 새 AI 에이전트 를 만들거나 Dayforce 데이터를 사용하려는 기존 에이전트를 엽니다.
  3. 에이전트의 도구/플러그 인 (또는 커넥터) 섹션으로 이동합니다.
  4. Dayforce HCM 커넥터를 도구로 추가합니다.
  5. 커넥터가 이전에 만든 연결을 사용하는지 확인합니다.

3. AI 에이전트에서 커넥터 호출

  1. AI 에이전트 작성 환경에서 다음을 수행합니다.
    • 에이전트가 직원 정보를 검색할 토픽, 작업 또는 플러그 인 호출 을 만들거나 편집합니다.
  2. 직원 개인 정보 가져오기 작업을 사용하는 도구 호출을 구성합니다.
    • 사용자 입력(예: "직원 코드")을 매개 변수에 매핑합니다 xRefCode .
  3. 반환된 필드를 사용합니다.
    • firstName AI 에이전트의 응답에 사용할 수 있습니다 lastName (예: "John Smith의 주소 및 연락처 정보는 다음과 같습니다.").
    • contacts 에이전트 논리를 사용하여 addresses 직원의 주소 및 연락처 세부 정보를 표시하거나 추론합니다.

이 설정을 통해 AI 에이전트는 Dayforce HCM 커넥터를 도구로 안전하게 호출하고, 필터링된 필드만 검색하고, 이러한 결과를 응답 또는 의사 결정에 통합할 수 있습니다.

알려진 문제 및 제한 사항

  • 단일 직원 조회만
    이 작업은 XRefCode를 기반으로 한 번에 한 명의 직원에 대한 데이터를 검색합니다. 다른 특성(예: 이름 또는 전자 메일)의 대량 쿼리 또는 검색은 이 커넥터 정의에서 지원되지 않습니다.

  • 정확한 XRefCode 일치 필요
    매개 변수는 xRefCode 기존 직원의 외부 참조 코드와 정확히 일치해야 합니다. 값이 잘못되었거나 존재하지 않는 경우 서비스는 400 잘못된 요청 응답을 반환합니다.

  • 읽기 전용 작업
    이 버전의 커넥터는 읽기 전용입니다. 직원 정보 만들기, 업데이트 또는 삭제는 지원하지 않습니다.

  • 환경별 구성
    API 정의 및 라우팅 정책에는 유효한 Dayforce 환경 및 클라이언트 네임스페이스가 예상됩니다. 이러한 구성이 실제 Dayforce 환경 구성과 일치하지 않으면 연결 또는 라우팅 오류로 호출이 실패합니다.

  • 필터링된 페이로드
    기본 Dayforce API는 여기에 노출되는 것보다 더 많은 필드를 반환합니다. 커넥터의 스크립트는 의도적으로 이 데이터를 firstName필터링하고 모양을 , lastNameaddresses[]및 contacts[] 그로만 바꿉니다.

  • 데이터 표시 유형은 Dayforce 구성에 따라 달라집니다.
    직원에 대해 반환되는 필드 및 값은 Dayforce 환경이 구성된 방식(역할, 보안 및 사용 또는 채워진 데이터 요소)에 따라 달라집니다.

자주 묻는 질문

Q1: 사용되는 "클라이언트 네임스페이스" 필드는 무엇인가요?
클라이언트 네임스페이스는 Dayforce API URL 내에서 Dayforce 테넌트를 식별합니다. 커넥터는 이를 사용하여 요청을 올바른 고객 네임스페이스로 라우팅합니다. 예를 들면 다음과 같습니다.
https://{environmentHost}/{clientNamespace}/V1/Employees/{xRefCode}
이 값을 모르는 경우 Dayforce 관리자 또는 구현 팀에 문의하세요.

Q2: 잘못된 항목을 제공하면 어떻게 되나요 xRefCode?
xRefCode 기존 직원과 일치하지 않는 경우 서비스는 400 잘못된 요청 응답을 반환합니다. 기본 Dayforce API 오류가 커넥터를 통해 표시됩니다.

Q3: 한 번의 통화로 여러 직원을 검색할 수 있나요?
이 커넥터 정의가 없습니다. 현재 작업은 제공된 xRefCode사항에 따라 통화당 단일 직원의 개인 정보를 검색합니다.

배포 지침(CLI – paconn)

Power Platform Connectors CLI(paconn)를 사용하여 이 커넥터를 사용자 지정 커넥터로 배포할 수 있습니다.

1. 커넥터 아티팩트 준비

로컬 폴더에 다음 파일이 있는지 확인합니다(예: ./dayforce-hcm-connector).

  • apiDefinition.swagger.json
  • apiProperties.json
  • script.csx

Power Platform 사용자 지정 커넥터 프레임워크에서 예상하는 구조와 일치해야 합니다.

2. CLI 설치 및 구성

  1. 아직 설치하지 않은 경우 Power Platform Connectors CLI(paconn)를 설치합니다.
  2. Microsoft 설명서(예: paconn 사용 paconn login)에 따라 대상 환경/테넌트에 로그인합니다.

3. 커넥터 만들기

다음과 유사한 명령을 실행합니다.

paconn create   --api-def apiDefinition.swagger.json   --api-prop apiProperties.json --icon icon.png   --script script.csx
  • 커넥터 파일이 포함된 폴더에서 이 명령을 실행하거나 각 파일에 대한 전체 경로를 제공해야 합니다.
  • 만든 후에는 커넥터가 대상 환경에서 사용자 지정 커넥터로 표시됩니다.

4. 커넥터 업데이트(필요한 경우)

나중에 변경하거나 script.csx다음을 사용하여 apiDefinition.swagger.jsonapiProperties.json기존 커넥터를 업데이트할 수 있습니다.

paconn update   --api-def apiDefinition.swagger.json   --api-prop apiProperties.json   --script script.csx   --connector-id <your-connector-id>

만든 커넥터의 ID로 바꿉 <your-connector-id> 니다.

5. 연결 만들기 및 Copilot Studio에서 사용

커넥터가 배포되면 다음을 수행합니다.

  1. 데이터>연결로 이동하여 Dayforce 자격 증명 및 클라이언트 네임스페이스를 사용하여 Dayforce HCM 커넥터에 대한 새 연결을 만듭니다.
  2. Copilot Studio에서 이 커넥터를 AI 에이전트에 도구로 추가하고 시작 섹션에 설명된 대로 직원 개인 정보 가져오기 작업을 호출합니다.

6. 보안 및 연결 공유

이 커넥터는 공유 불가능한 연결 모델을 따르도록 합니다. 이 커넥터를 사용하는 Power App 또는 Copilot Studio 에이전트가 공유되면 커넥터 정의 만 공유되며 각 개별 사용자는 처음 사용할 때 자신의 자격 증명으로 고유한 Dayforce 연결을 명시적으로 만들어야 합니다 . 커넥터는 한 사용자의 Dayforce 권한을 다른 사용자가 다시 사용할 수 있도록 하는 방식으로 연결 공유를 허용해서는 안 됩니다(예: 앱 소유자 또는 연결 소유자의 Dayforce ID에서 앱 또는 에이전트가 실행되는 시나리오는 없음). 인증의 일환으로 이 커넥터에 대한 모든 인증 유형이 공유 불가능으로 구성되어 플랫폼 수준에서 연결 공유가 차단되고 모든 사용자가 항상 자신의 Dayforce 연결을 설정해야 합니다.

이 고지 사항을 포함합니다. 이 연결은 공유할 수 없습니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

Microsoft에서 인증하고 게시한 후에는 Dayforce HCM 커넥터를 인증된 커넥터로 사용할 수 있으며 일반적으로 연결을 만들어야 합니다(최종 사용자에게 CLI 배포가 필요하지 않음).

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 설명 필수
사용자 이름 시큐어스트링 (보안 문자열) 이 API의 사용자 이름 진실
암호 시큐어스트링 (보안 문자열) 이 API의 암호 진실
인증 유형 문자열 API에 연결하는 인증 유형 진실
클라이언트 네임스페이스 문자열 클라이언트 네임스페이스 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

actions

직원 개인 정보 가져오기

이 작업은 XRef Code에서 직원 및 개인 정보(예: 이름, 주소 및 연락처)와 관련된 데이터를 검색합니다.

직원 개인 정보 가져오기

작업 ID:
Get_Employee_Personal_Info

이 작업은 XRef Code에서 직원 및 개인 정보(예: 이름, 주소 및 연락처)와 관련된 데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
직원 참조 코드
 xRefCode True string

검색할 직원의 고유 식별자(외부 참조 코드)입니다. 제공된 값은 직원의 정확한 일치여야 합니다. 그렇지 않으면 잘못된 요청(400) 오류가 반환됩니다.

반품

몸
Payload_Employee

정의

ProcessResult

Name 경로 형식 Description
코드
 Code string
컨텍스트
 Context string
수준
 Level string
Message
 Message string

직원

Name 경로 형식 Description
직원ID
 EmployeeId integer
연락처
Contacts PersonContactCollection
주소
 Addresses PersonAddressCollection
GlobalPersonId
 GlobalPersonId string
XRefCode
 XRefCode string
NewXRefCode
 NewXRefCode string
일반 이름
 CommonName string
DisplayName
 DisplayName string
FirstName
 FirstName string
LastName
 LastName string
이니셜
 Initials string
메이든 이름
 MaidenName string
중간 이름
 MiddleName string
Title
 Title string
LastModifiedTimestamp
 LastModifiedTimestamp date-time

PersonContactCollection

Name 경로 형식 Description
아이템
 Items array of PersonContact

PersonAddressCollection

Name 경로 형식 Description
아이템
 Items array of PersonAddress

PersonContact

Name 경로 형식 Description
PersonContactId
 PersonContactId integer
ContactInformationType
 ContactInformationType ContactInformationType
ContactNumber
 ContactNumber string
국가
 Country Country
EffectiveEnd
 EffectiveEnd date-time
EffectiveStart
 EffectiveStart date-time
ElectronicAddress
 ElectronicAddress string
Extension
 Extension string
IsForSystemCommunications
 IsForSystemCommunications boolean
IsPreferredContactMethod
 IsPreferredContactMethod boolean
IsUnlistedNumber
 IsUnlistedNumber boolean
FormattedNumber
 FormattedNumber string
IsVerified
 IsVerified boolean
IsRejected
 IsRejected boolean
ShowRejectedWarning
 ShowRejectedWarning boolean
NumberOfVerificationRequests
 NumberOfVerificationRequests integer
LastModifiedTimestamp
 LastModifiedTimestamp date-time

PersonAddress

Name 경로 형식 Description
PersonAddressId
 PersonAddressId integer
Address1
 Address1 string
Address2
 Address2 string
Address3
 Address3 string
Address4
 Address4 string
Address5
 Address5 string
Address6
 Address6 string
도시
 City string
우편번호
 PostalCode string
국가
 Country Country
State(상태)
 State State
ContactInformationType
 ContactInformationType ContactInformationType
IsPayrollMailing
 IsPayrollMailing boolean
DisplayOnTaxForm
 DisplayOnTaxForm boolean
DisplayOnEarningStatement
 DisplayOnEarningStatement boolean
EffectiveStart
 EffectiveStart date-time
EffectiveEnd
 EffectiveEnd date-time
군/구
 County string
LastModifiedTimestamp
 LastModifiedTimestamp date-time

국가

Name 경로 형식 Description
이름
 Name string
XRefCode
 XRefCode string
쇼트네임
 ShortName string
LongName
 LongName string
LastModifiedTimestamp
 LastModifiedTimestamp date-time

ContactInformationType

Name 경로 형식 Description
ContactInformationTypeGroup
 ContactInformationTypeGroup ContactInformationTypeGroup
XRefCode
 XRefCode string
쇼트네임
 ShortName string
LongName
 LongName string
LastModifiedTimestamp
 LastModifiedTimestamp date-time

State(상태)

Name 경로 형식 Description
이름
 Name string
XRefCode
 XRefCode string
쇼트네임
 ShortName string
LongName
 LongName string
LastModifiedTimestamp
 LastModifiedTimestamp date-time

ContactInformationTypeGroup

Name 경로 형식 Description
XRefCode
 XRefCode string
쇼트네임
 ShortName string
LongName
 LongName string
LastModifiedTimestamp
 LastModifiedTimestamp date-time

Payload_Employee

Name 경로 형식 Description
데이터
 Data Employee
ProcessResults
 ProcessResults array of ProcessResult