공용 360
퍼블릭 360은 북유럽의 ECM 시스템을 선도하는 시장입니다. Public 360 커넥터를 사용하면 사례, 문서 및 파일을 Public 360으로 보관하는 흐름을 만들 수 있습니다. 공용 360 커넥터를 사용하면 사용자가 더 쉽게 보관할 수 있습니다. 여기에는 소셜 미디어 게시물, Outlook 항목 또는 OneDrive 문서 보관이 포함됩니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate (파워 오토메이트) | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | 360 지원 |
| URL | https://tieto.service-now.com/tsc |
| 전자 메일 | public360.support@tietoevry.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 티에토에브리 노르웨이 |
| 웹 사이트 | https://www.tietoevry.com/ |
| 개인 정보 보호 정책 | https://www.tietoevry.com/siteassets/files/privacy-notice/privacy-notice-public-360-power-automate-connetor.pdf |
| 카테고리 | 콘텐츠 및 파일; 생산력 |
퍼블릭 360°은 북유럽에서 시장을 선도하는 엔터프라이즈 콘텐츠 관리 시스템입니다. 공용 360° 커넥터는 SIF(Simple Integration Framework) API를 통해 시스템과 통합되며, 사례, 문서 및 파일을 Public 360°에서 직접 자동으로 만들 수 있습니다. 메일, 소셜 미디어 게시물 또는 클라우드 스토리지의 문서와 같은 정보는 일관되고 구조화된 방식으로 캡처 및 구성할 수 있습니다. 공용 360°에서 레코드 생성을 간소화함으로써 커넥터는 조직에서 디지털 프로세스를 확장하는 동시에 안정적이고 규정을 준수하는 레코드 보관을 보장하도록 지원합니다.
필수 조건
이 커넥터를 사용하려면 다음 요구 사항이 충족되는지 확인합니다.
- 활성 Azure 구독
- Microsoft Entra ID의 권한 있는 사용자 계정
- 공용 360°에서 데이터에 액세스하고 보관하는 데 필요한 권한
자격 증명을 가져오는 방법
공용 360° 커넥터는 AAD(Azure Active Directory)를 통해 전달자 토큰 인증을 사용합니다. 연결하려면 공용 360° 인스턴스에 활성 사용자 계정이 있어야 합니다. 공용 360° 자격 증명으로 로그인하면 AAD를 통해 인증되고 연결을 설정하는 데 필요한 전달자 토큰이 생성됩니다. 이 연결은 개인 연결이며 공유할 수 없습니다. 이 커넥터를 사용하는 Power App이 다른 사용자와 공유되면 해당 사용자에게 자신의 연결을 명시적으로 만들라는 메시지가 표시됩니다. 필요한 계정 또는 권한이 있는지 확실하지 않은 경우 공용 360° 관리자에게 문의하세요.
알려진 문제 및 제한
커넥터는 현재 공용 360°에서 새 사례 만들기, 기존 사례에 문서 업로드 및 보관, 문서 또는 Public 360°에서 직접 파일 첨부 등의 세 가지 작업을 지원합니다. 커넥터 인터페이스에서는 제한된 수의 매개 변수만 직접 사용할 수 있지만 나열되지 않은 매개 변수는 AdditionalFields 매개 변수를 통해 구성할 수 있습니다. 사용 가능한 서비스 범위를 확장하고 가까운 장래에 사용자 피드백에 따라 개선 사항을 도입할 계획입니다. 프로세스를 단순하게 유지하고 페이로드 크기를 줄이려면 Public 360°의 기본값 집합을 사용하는 것이 좋습니다. AdditionalFields를 통해 매개 변수를 설정하거나, 기본값 집합을 사용하거나, 커넥터의 다른 측면을 최적화하는 방법에 대한 지침은 360° 관리자에게 문의하여 도움을 받으세요.
일반적인 오류 및 해결
커넥터를 사용할 때 발생할 수 있는 문제는 다음과 같습니다.
-
401 Unauthorized: 인증에 실패할 때 발생합니다. SIF API에 액세스하기 위해 제공된 자격 증명이 유효하지 않거나 만료되었거나 누락되었거나 사용자에게 요청된 작업을 수행할 수 있는 충분한 권한이 없는 경우에 발생할 수 있습니다. -
502 Bad Gateway: 커넥터가 공용 360° 서비스와 통신할 수 없음을 나타냅니다. 일반적인 원인으로는 임시 서비스 중단, 네트워크 문제 또는 API 엔드포인트의 잘못된 구성이 있습니다. 자주 실수는 호스트 URL에 https:// 접두사를 포함하는 것입니다. 호스트를 지정하지 않고 지정해야 합니다(예: 대신 https://my360.commy360.com 사용). 다른 모든 경우에서 기본 SIF API 호출에 실패한 경우에도 HTTP 응답 코드는 200이 됩니다. SIF API 호출의 실제 결과는 응답 본문의 성공 속성으로 표시됩니다. 성공 값이 아니요이면 작업이 성공하지 못했습니다. 오류에 대한 자세한 내용은 ErrorMessage 및 ErrorDetails 속성에서 찾을 수 있습니다.
이 커넥터는 공용 360과의 통신에 SIF API를 사용합니다. 자세한 내용은 https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf 방문하세요.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 문서 만들기 |
이 작업은 SIF API를 사용하여 Public 360에서 문서를 만드는 데 사용되며 등록된 문서와 등록되지 않은 문서를 모두 지원합니다. 필수 필드에는 제목, 보관, 범주 및 상태가 포함됩니다. 등록된 문서에는 사례 번호가 포함되어야 합니다. 등록되지 않은 문서에는 대/소문자가 필요하지 않지만 ToOrigin, CF_ExtSystem 및 Commited의 세 가지 추가 필드가 포함되어야 합니다. 등록되지 않은 문서의 보관 파일은 "보관 가져오기"(기본 recno: 7)로 설정해야 합니다. 공용 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 |
| 파일 만들기 |
이 작업은 SIF API를 사용하여 공용 360에서 파일을 만듭니다. 자세한 내용은 다음을 참조하세요. https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf |
문서 만들기
이 작업은 SIF API를 사용하여 Public 360에서 문서를 만드는 데 사용되며 등록된 문서와 등록되지 않은 문서를 모두 지원합니다. 필수 필드에는 제목, 보관, 범주 및 상태가 포함됩니다. 등록된 문서에는 사례 번호가 포함되어야 합니다. 등록되지 않은 문서에는 대/소문자가 필요하지 않지만 ToOrigin, CF_ExtSystem 및 Commited의 세 가지 추가 필드가 포함되어야 합니다. 등록되지 않은 문서의 보관 파일은 "보관 가져오기"(기본 recno: 7)로 설정해야 합니다. 공용 360의 기본값 집합 기능을 사용하여 이러한 값을 미리 구성할 것을 권장합니다. 자세한 내용은 다음을 참조하세요. https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
호스트 URL
|
hosturl | True | string |
공용 360 솔루션을 가리키는 호스트 URL입니다. |
|
제목
|
Title | True | string |
문서의 제목입니다. |
|
케이스 번호
|
CaseNumber | string |
이 문서가 속한 사례의 사례 번호입니다. |
|
|
기본값 집합
|
DefaultValueSet | string |
전달되지 않은 경우 해당 값을 기본값으로 사용하여 문서를 만드는 데 사용되는 문서 엔터티에 대해 정의된 값 집합 |
|
|
비공식 제목
|
UnofficialTitle | string |
문서의 비공식 제목입니다. |
|
|
책임 있는 사람 전자 메일
|
ResponsiblePersonEmail | string |
문서에 대한 책임 있는 사람입니다. |
|
|
카테고리
|
Category | string |
문서의 범주입니다. 후속 작업 없이 내부 메모에 대한 F.ex. recno:60005 |
|
|
상태
|
Status | string |
문서의 상태입니다. F.ex. recno:1 for Reserved or recno:6 for Officially recorded |
|
|
아카이브
|
Archive | string |
이 문서의 문서 보관 파일 |
|
|
비고
|
Notes | string |
문서에 대한 참고 사항입니다. |
|
|
역할
|
Role | string |
특정 문서에 대한 연락처의 역할입니다. 코드 또는 recno일 수 있습니다. |
|
|
참조 번호
|
ReferenceNumber | string |
참조 번호는 개인 사용자의 개인 ID 번호이고 엔터프라이즈의 엔터프라이즈 번호입니다. |
|
|
이름
|
Name | string |
@FSHO2@필드의 이름입니다. 이 이름은 360° 메타 모델의 이름입니다(360° GUI에서 볼 수 있는 것과 항상 동일하지는 않음). |
|
|
가치
|
Value | string |
필드에 설정할 값입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Recno
|
Recno | integer |
Recno |
|
DocumentNumber
|
DocumentNumber | string |
DocumentNumber |
|
성공
|
Successful | boolean |
성공 |
|
오류 메시지
|
ErrorMessage | string |
오류 메시지 |
|
ErrorDetails
|
ErrorDetails | string |
ErrorDetails |
사례 만들기
이 작업은 SIF API를 사용하여 Public 360에서 사례를 만드는 데 사용됩니다. 필수 필드에는 제목, 대/소문자 유형, 책임자 전자 메일/ID 번호 또는 책임 있는 기업 번호가 포함됩니다. Public 360의 기본값 집합 기능을 사용하여 대/소문자, 문서 및 파일에 대해 이러한 값을 미리 구성할 것을 권장합니다. 이 기능은 양식에서 자동으로 문서를 만들거나 외부 시스템과의 통합을 통해 문서를 만들 때 특히 유용합니다. 자세한 내용은 다음을 참조하세요. https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
호스트 URL
|
hosturl | True | string |
공용 360 솔루션을 가리키는 호스트 URL입니다. |
|
제목
|
Title | True | string |
케이스의 제목입니다. |
|
기본값 집합
|
DefaultValueSet | string |
전달되지 않은 경우 기본값으로 대/소문자를 만드는 데 사용되는 Case 엔터티에 대해 정의된 값 집합입니다. |
|
|
비공식 제목
|
UnofficialTitle | string |
사건에 대한 비공식 제목. |
|
|
케이스 유형
|
CaseType | string |
코드 또는 recno 값(예: "Case" 또는 "recno:2")입니다. 사례 유형 코드 테이블을 참조합니다. |
|
|
책임 있는 사람 전자 메일
|
ResponsiblePersonEmail | string |
사건에 대한 책임 있는 사람. |
|
|
담당자 ID 번호
|
ResponsiblePersonIdNumber | string |
유효한 연락처 외부 ID를 참조합니다. 책임 있는 사용자 전자 메일의 대안입니다. |
|
|
책임 있는 엔터프라이즈 번호
|
ResponsibleEnterpriseNumber | string |
외부 ID 또는 참조 번호를 기준으로 엔터프라이즈를 찾습니다. 책임 있는 사용자 전자 메일 및 ID 번호 대신 |
|
|
진행률 계획 ID
|
ProgressPlanId | integer |
진행률 계획에 사례를 연결하는 진행률 계획 ID입니다. 진행률 계획 ID는 recno, workunit ID 또는 설명일 수 있습니다. |
|
|
이름
|
Name | string |
@FSHO2@필드의 이름입니다. 이 이름은 360° 메타 모델의 이름입니다(360° GUI에서 볼 수 있는 것과 항상 동일하지는 않음). |
|
|
가치
|
Value | string |
필드에 설정할 값입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Recno
|
Recno | integer |
Recno |
|
CaseNumber
|
CaseNumber | string |
CaseNumber |
|
성공
|
Successful | boolean |
성공 |
|
오류 메시지
|
ErrorMessage | string |
오류 메시지 |
|
ErrorDetails
|
ErrorDetails | string |
ErrorDetails |
파일 만들기
이 작업은 SIF API를 사용하여 공용 360에서 파일을 만듭니다. 자세한 내용은 다음을 참조하세요. https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
호스트 URL
|
hosturl | True | string |
공용 360 솔루션을 가리키는 호스트 URL입니다. |
|
제목
|
Title | True | string |
파일의 제목입니다. |
|
문서 번호
|
DocumentNumber | string |
이 파일이 속한 문서의 문서 번호입니다. 문서 번호 또는 문서 사각형을 제공해야 합니다. |
|
|
문서 Recno
|
DocumentRecno | integer |
이 파일이 속한 문서의 문서 Recno입니다. 문서 번호 또는 문서 사각형을 제공해야 합니다. |
|
|
포맷
|
Format | True | string |
파일을 만드는 동안 전달될 파일 형식입니다(예: "txt", "htm"). |
|
데이터
|
Base64Data | True | string |
파일 내용, "Base64"가 인코딩되었습니다. |
|
이름
|
Name | string |
@FSHO2@필드의 이름입니다. 이 이름은 360° 메타 모델의 이름입니다(360° GUI에서 볼 수 있는 것과 항상 동일하지는 않음). |
|
|
가치
|
Value | string |
필드에 설정할 값입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Recno
|
Recno | integer |
Recno |
|
성공
|
Successful | boolean |
성공 |
|
오류 메시지
|
ErrorMessage | string |
오류 메시지 |
|
ErrorDetails
|
ErrorDetails | string |
ErrorDetails |