에이전트 UI를 사용하여 대화형 통신 준비 및 보내기

에이전트는 에이전트 UI를 통해 대화형 통신을 준비하고 게시 프로세스로 보낼 수 있습니다. 에이전트는 필요에 따라 수정하고 대화형 커뮤니케이션을 이메일 또는 인쇄와 같은 사후 프로세스에 제출합니다.

개요

대화형 통신이 생성되면 에이전트는 에이전트 UI에서 대화형 통신을 열고 데이터를 입력하고 컨텐츠 및 첨부 파일을 관리하여 수신자 전용 사본을 준비할 수 있습니다. 마지막으로 에이전트는 대화형 통신을 사후 프로세스에 제출할 수 있습니다.

에이전트 UI를 사용하여 대화형 통신을 준비하는 동안 에이전트는 대화형 통신을 사후 프로세스에 제출하기 전에 에이전트 UI에서 다음 측면을 관리합니다.

• 데이터: 에이전트 UI의 데이터 탭에는 대화형 통신에서 에이전트가 편집 가능한 변수와 잠금 해제된 양식 데이터 모델 속성이 표시됩니다. 이러한 변수/속성은 대화형 통신에 포함된 문서 조각을 편집하거나 만드는 동안 만들어집니다. 데이터 탭에는 XDP/인쇄 채널 템플릿에 빌드된 필드도 포함됩니다. 데이터 탭은 에이전트가 편집할 수 있는 대화형 통신의 변수, 양식 데이터 모델 속성 또는 필드가 있는 경우에만 나타납니다.
• 콘텐츠: 콘텐츠 탭에서 에이전트는 대화형 통신의 문서 조각 및 콘텐츠 변수와 같은 콘텐츠를 관리합니다. 에이전트는 문서 조각의 속성에서 대화형 통신을 생성하는 동안 문서 조각을 허용되는 대로 변경할 수 있습니다. 또한 에이전트는 문서 조각을 재정렬하고 추가/제거하며 페이지 나누기를 추가할 수 있습니다(허용되는 경우).
• 첨부 파일: 첨부 파일 탭은 대화형 통신에 첨부 파일이 있거나 에이전트에 라이브러리 액세스 권한이 있는 경우에만 에이전트 UI에 표시됩니다. 에이전트는 첨부 파일을 변경하거나 편집하는 것이 허용되거나 허용되지 않을 수 있습니다.

에이전트 UI를 사용하여 대화형 통신 준비

1. 선택 Forms > Forms 및 문서.

2. 적절한 대화형 통신을 선택하고 을 누릅니다 에이전트 UI 열기.

   노트

   에이전트 UI는 선택한 대화형 통신에 인쇄 채널이 있는 경우에만 작동합니다.

   

   대화형 통신의 콘텐츠 및 속성을 기반으로 에이전트 UI에 데이터, 콘텐츠 및 첨부 파일의 세 가지 탭이 표시됩니다.

   

   데이터 입력, 컨텐츠 관리 및 첨부 파일 관리를 진행합니다.

데이터 입력

1. 데이터 탭에서 필요에 따라 변수, 양식 데이터 모델 속성 및 인쇄 템플릿(XDP) 필드에 대한 데이터를 입력합니다. 별표(*)로 표시된 모든 필수 필드를 채워 제출 단추를 클릭합니다.

   대화형 통신 미리 보기에서 데이터 필드 값을 탭하여 데이터 탭에서 또는 그 반대로 해당 데이터 필드를 강조 표시합니다.

컨텐츠 관리

콘텐츠 탭에서 대화형 통신의 문서 조각 및 콘텐츠 변수와 같은 콘텐츠를 관리합니다.

1. 선택 콘텐츠. 대화형 통신의 컨텐트 탭이 나타납니다.

   

2. 필요에 따라 콘텐츠 탭에서 문서 조각을 편집합니다. 컨텐츠 계층 구조의 관련 조각에 초점을 맞추려면 대화형 통신 미리 보기에서 관련 줄이나 단락을 탭하거나 컨텐츠 계층 구조에서 직접 조각을 탭할 수 있습니다.

   예를 들어 아래 그래픽의 미리 보기에서 "지금 온라인으로 결제…"라는 줄이 있는 문서 조각이 선택되고 콘텐츠 탭에서 동일한 문서 조각이 선택되었습니다.

   

   컨텐츠 또는 데이터 탭에서 컨텐츠에서 선택한 모듈 강조 표시( ) 미리보기의 왼쪽 상단에서 관련 텍스트, 단락 또는 데이터 필드를 탭/선택하면 문서 조각으로 이동하는 기능을 비활성화하거나 활성화할 수 있습니다.

   대화형 통신을 생성하는 동안 에이전트에서 편집할 수 있는 조각에는 선택한 콘텐츠 편집 이 있습니다. ) 아이콘. 선택한 컨텐츠 편집 아이콘을 탭하여 조각을 편집 모드로 실행하고 변경 작업을 수행합니다. 텍스트 서식 지정 및 관리를 위해 다음 옵션을 사용합니다.

   • 서식 옵션

     • 다른 응용 프로그램에서 붙여넣기 형식의 텍스트를 복사합니다.
     • 텍스트 부분 강조 표시

   • 특수 문자

   • 키보드 단축키

   에이전트 사용자 인터페이스의 다양한 문서 조각에 사용할 수 있는 작업에 대한 자세한 내용은 을 참조하십시오. 에이전트 사용자 인터페이스에서 사용할 수 있는 작업 및 정보.

3. 대화형 통신의 인쇄 출력에 페이지 나누기를 추가하려면 페이지 나누기를 삽입하려는 위치에 커서를 놓고 다음 페이지 나누기 또는 다음 페이지 나누기를 선택합니다( ).

   명시적 페이지 나누기 자리 표시자가 대화형 통신에 삽입됩니다. 명시적 페이지 나누기가 대화형 통신에 미치는 영향을 보려면 인쇄 미리 보기를 참조하십시오.

   

   대화형 통신의 첨부 파일 관리를 진행합니다.

첨부 파일 관리

1. 선택 첨부 파일. 에이전트 UI는 대화형 통신을 생성하는 동안 설정된 대로 사용 가능한 첨부 파일을 표시합니다.

   보기 아이콘을 탭하여 대화형 통신과 함께 첨부 파일을 제출하지 않도록 선택할 수 있으며, 대화형 통신에서 첨부 파일의 십자가를 탭하여 삭제할 수 있습니다(에이전트가 첨부 파일을 삭제하거나 숨길 수 있는 경우). 대화형 통신을 생성하는 동안 필수로 지정된 첨부 파일의 경우 보기 및 삭제 아이콘이 비활성화됩니다.

   

2. 라이브러리 액세스( )를 누릅니다. ) 아이콘을 클릭하여 컨텐츠 라이브러리에 액세스하여 DAM 자산을 첨부 파일로 삽입할 수 있습니다.

   노트

   라이브러리 액세스 아이콘은 대화형 통신을 만드는 동안(인쇄 채널의 문서 컨테이너 속성에서) 라이브러리 액세스가 활성화된 경우에만 사용할 수 있습니다.

3. 대화형 통신을 만드는 동안 첨부 파일의 순서가 잠겨 있지 않은 경우 첨부 파일을 선택하고 아래쪽 및 위쪽 화살표를 눌러 첨부 파일의 순서를 변경할 수 있습니다.

4. 웹 미리 보기 및 인쇄 미리 보기 를 사용하여 두 출력이 요구 사항에 맞는지 확인합니다.

   미리보기가 만족스러우면 을 누릅니다 제출 대화형 커뮤니케이션을 게시 프로세스에 제출/전송합니다. 또는 변경 내용을 적용하려면 미리보기를 종료하고 변경 내용으로 돌아갑니다.

텍스트 서식 지정

에이전트 UI에서 텍스트 조각을 편집하는 동안 선택한 편집 유형(글꼴, 단락 또는 목록)에 따라 도구 모음이 변경됩니다.

글꼴 도구 모음

단락 도구 모음

목록 도구 모음

텍스트 일부 강조/강조

편집 가능한 조각에서 텍스트 일부를 강조\강조하려면 텍스트를 선택하고 [색상 강조 표시]를 누릅니다.

서식 있는 텍스트 붙여넣기

텍스트에 특수 문자 삽입

에이전트 UI는 210개의 특수 문자를 지원합니다. 관리자는 다음을 수행할 수 있습니다. 사용자 정의별로 추가/사용자 정의 특수 문자에 대한 지원 추가.

첨부 파일 게재

• 대화형 통신이 서버측 API를 대화형 또는 비대화형 PDF으로 사용하여 렌더링될 때 렌더링된 PDF에 첨부 파일이 PDF 첨부 파일로 포함됩니다.
• 대화형 통신과 연결된 사후 프로세스가 에이전트 UI를 사용하여 제출의 일부로 로드되면 첨부 파일이 목록으로 전달됩니다<com.adobe.idp.document> inAttachmentDocs 매개 변수.
• 이메일 및 인쇄와 같은 게재 메커니즘 워크플로는 또한 대화형 통신의 PDF 버전과 함께 첨부 파일을 전달합니다.

에이전트 사용자 인터페이스에서 사용할 수 있는 작업 및 정보

문서 단편

• 위쪽/아래쪽 화살표: 대화형 통신에서 문서 조각을 위아래로 이동하는 화살표입니다.
• 삭제: 허용되는 경우 대화형 통신에서 문서 조각을 삭제합니다.
• 다음 항목 앞에 페이지 나누기 (대상 영역의 하위 조각에 적용 가능): 문서 조각 앞에 페이지 나누기를 삽입합니다.
• 들여쓰기: 문서 조각의 들여쓰기를 늘리거나 줄입니다.
• 뒤에 페이지 나누기 (대상 영역의 하위 조각에 적용 가능): 문서 조각 뒤에 페이지 나누기를 삽입합니다.

• 편집(텍스트 조각만): 텍스트 문서 조각을 편집하려면 리치 텍스트 편집기를 엽니다. 자세한 내용은 텍스트 서식 지정.

• 선택(눈 모양 아이콘): 대화형 커뮤니케이션에서 문서 단편을 포함합니다.\제외합니다.

• 채워지지 않은 값(정보): 문서 조각에 채워지지 않은 변수의 수를 나타냅니다.

문서 단편 나열

• 빈 줄 삽입: 새 빈 줄을 삽입합니다.
• 선택(눈 모양 아이콘): 대화형 커뮤니케이션에서 문서 단편을 포함합니다.\제외합니다.
• 글머리 기호/번호 매기기 건너뛰기: 목록 문서 조각에서 글머리 기호/번호 매기기를 건너뛰려면 활성화합니다.
• 채워지지 않은 값(정보): 문서 조각에 채워지지 않은 변수의 수를 나타냅니다.

대화형 커뮤니케이션을 초안으로 저장

에이전트 UI를 사용하여 각 대화형 커뮤니케이션에 대해 하나 이상의 초안을 저장하고 나중에 초안을 검색하여 계속 작업할 수 있습니다. 각 초안의 다른 이름을 지정하여 해당 초안을 식별할 수 있습니다.

Adobe은 대화형 커뮤니케이션을 초안으로 성공적으로 저장하기 위해 이러한 명령을 순서대로 실행하는 것을 권장합니다.

초안으로 저장 기능 활성화

초안으로 저장(Save as a Draft) 기능은 기본적으로 활성화되어 있지 않습니다. 기능을 활성화하려면 다음 단계를 수행하십시오.

1. 구현 ccrDocumentInstance SPI(서비스 공급자 인터페이스).

   SPI를 사용하면 대화형 통신의 초안 버전을 고유 식별자로 초안 ID를 사용하여 데이터베이스에 저장할 수 있습니다. 이러한 지침은 Maven 프로젝트를 사용하여 OSGi 번들을 작성하는 방법에 대한 사전 지식이 있다고 가정합니다.

   샘플 SPI 구현은 다음을 참조하십시오. ccrDocumentInstance SPI 구현 예.

2. 열기 http://<hostname>:<port>/ system/console/bundles 및 탭 설치/업데이트 를 클릭하여 OSGi 번들을 업로드하십시오. 업로드된 패키지의 상태가 (으)로 표시되는지 확인합니다. 활성. 패키지의 상태가 로 표시되지 않으면 서버를 다시 시작합니다. 활성.

3. https://'[server]:[port]'/system/console/configMgr로 이동합니다.

4. 누르기 서신 구성 만들기.

5. 선택 CCRDocumentInstanceService를 사용하여 저장 활성화 및 탭 저장.

대화형 커뮤니케이션을 초안으로 저장

대화형 통신을 초안으로 저장하려면 다음 단계를 수행하십시오.

1. Forms Manager에서 대화형 통신을 선택하고 에이전트 UI 열기.

2. 에이전트 UI에서 적절히 변경한 후 을 누릅니다 초안으로 저장.

3. 에서 초안의 이름을 지정합니다. 이름 필드 및 탭 완료.

대화형 통신을 초안으로 저장했으면 을 누릅니다. 변경 내용 저장 초안에 대한 추가 변경 사항을 저장합니다.

대화형 통신의 초안 검색

대화형 통신을 초안으로 저장한 후 검색하여 계속 작업할 수 있습니다. 다음을 사용하여 대화형 통신 검색:

https://server:port/aem/forms/createcorrespondence.hmtl?draftid=[draftid]

[빗장모양-] 대화형 통신을 초안으로 저장한 후 생성되는 초안 버전의 고유 식별자를 참조하십시오.

ccrDocumentInstance SPI 구현 예

구현 ccrDocumentInstance 대화형 커뮤니케이션을 초안으로 저장하는 SPI. 다음은 의 샘플 구현입니다. ccrDocumentInstance SPI.

package Implementation;

import com.adobe.fd.ccm.ccr.ccrDocumentInstance.api.exception.CCRDocumentException;
import com.adobe.fd.ccm.ccr.ccrDocumentInstance.api.model.CCRDocumentInstance;
import com.adobe.fd.ccm.ccr.ccrDocumentInstance.api.services.CCRDocumentInstanceService;
import org.apache.commons.lang3.StringUtils;
import org.osgi.service.component.annotations.Component;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.util.*;


@Component(service = CCRDocumentInstanceService.class, immediate = true)
public class CCRDraftService implements CCRDocumentInstanceService {

    private static final Logger logger = LoggerFactory.getLogger(CCRDraftService.class);

    private HashMap<String, Object> draftDataMap = new HashMap<>();

    @Override
    public String save(CCRDocumentInstance ccrDocumentInstance) throws CCRDocumentException {
        String documentInstanceName = ccrDocumentInstance.getName();
        if (StringUtils.isNotEmpty(documentInstanceName)) {
            logger.info("Saving ccrData with name : {}", ccrDocumentInstance.getName());
            if (!CCRDocumentInstance.Status.SUBMIT.equals(ccrDocumentInstance.getStatus())) {
                ccrDocumentInstance = mySQLDataBaseServiceCRUD(ccrDocumentInstance,null, "SAVE");
            }
        } else {
            logger.error("Could not save data as draft name is empty");
        }
        return ccrDocumentInstance.getId();
    }

    @Override
    public void update(CCRDocumentInstance ccrDocumentInstance) throws CCRDocumentException {
        String documentInstanceName = ccrDocumentInstance.getName();
        if (StringUtils.isNotEmpty(documentInstanceName)) {
            logger.info("Saving ccrData with name : {}", documentInstanceName);
            mySQLDataBaseServiceCRUD(ccrDocumentInstance, ccrDocumentInstance.getId(), "UPDATE");
        } else {
            logger.error("Could not save data as draft Name is empty");
        }
    }

    @Override
    public CCRDocumentInstance get(String id) throws CCRDocumentException {
        CCRDocumentInstance cCRDocumentInstance;
        if (StringUtils.isEmpty(id)) {
            logger.error("Could not retrieve data as draftId is empty");
            cCRDocumentInstance = null;
        } else {
            cCRDocumentInstance = mySQLDataBaseServiceCRUD(null, id,"GET");
        }
        return cCRDocumentInstance;
    }

    @Override
    public List<CCRDocumentInstance> getAll(String userId, Date creationTime, Date updateTime,
                                            Map<String, Object> optionsParams) throws CCRDocumentException {
        List<CCRDocumentInstance> ccrDocumentInstancesList = new ArrayList<>();

        HashMap<String, Object> allSavedDraft = mySQLGetALLData();
        for (String key : allSavedDraft.keySet()) {
            ccrDocumentInstancesList.add((CCRDocumentInstance) allSavedDraft.get(key));
        }
        return ccrDocumentInstancesList;
    }

    //The APIs call the service in the database using the following section.
    private CCRDocumentInstance mySQLDataBaseServiceCRUD(CCRDocumentInstance ccrDocumentInstance,String draftId, String method){
        if(method.equals("SAVE")){

            String autoGenerateId = draftDataMap.size() + 1 +"";
            ccrDocumentInstance.setId(autoGenerateId);
            draftDataMap.put(autoGenerateId, ccrDocumentInstance);
            return ccrDocumentInstance;

        }else if (method.equals("UPDATE")){

            draftDataMap.put(ccrDocumentInstance.getId(), ccrDocumentInstance);
            return ccrDocumentInstance;

        }else if(method.equals("GET")){

            return (CCRDocumentInstance) draftDataMap.get(draftId);

        }
        return null;
    }

    private HashMap<String, Object> mySQLGetALLData(){
        return draftDataMap;
    }
}

다음 save, update, get, 및 getAll 작업은 데이터베이스 서비스를 호출하여 대화형 통신을 초안으로 저장하고, 대화형 통신을 업데이트하고, 데이터베이스에서 데이터를 검색하고, 데이터베이스에서 사용할 수 있는 모든 대화형 통신에 대한 데이터를 검색합니다. 이 샘플은 mySQLDataBaseServiceCRUD 를 데이터베이스 서비스의 이름으로 사용하십시오.

다음 표에서는 샘플을 설명합니다. ccrDocumentInstance SPI 구현. 다음 방법을 보여 줍니다 save, update, get, 및 getAll 작업은 샘플 구현에서 데이터베이스 서비스를 호출합니다.

작업	데이터베이스 서비스 예
대화형 커뮤니케이션용 초안을 만들거나 직접 제출할 수 있습니다. 저장 작업에 대한 API는 대화형 커뮤니케이션이 초안으로 제출되고 초안 이름이 포함되어 있는지 확인합니다. 그런 다음 API는 입력 메서드로 Save를 사용하여 mySQLDataBaseServiceCRUD 서비스를 호출합니다.	mySQLDataBaseServiceCRUD 서비스는 입력 메서드로 저장을 확인하고 자동 생성된 초안 ID를 생성하여 AEM에 반환합니다. 초안 ID를 생성하는 논리는 데이터베이스에 따라 달라질 수 있습니다.
업데이트 작업에 대한 API는 대화형 통신 초안의 상태를 검색하고 대화형 통신에 초안 이름이 포함되어 있는지 확인합니다. API는 mySQLDataBaseServiceCRUD 서비스를 호출하여 데이터베이스의 해당 상태를 업데이트합니다.	mySQLDataBaseServiceCRUD 서비스는 Update를 입력 방법으로 확인하고 대화형 통신 초안의 상태를 데이터베이스에 저장합니다.
가져오기 작업에 대한 API는 대화형 통신에 초안 ID가 포함되어 있는지 확인합니다. 그런 다음 API는 대화형 통신에 대한 데이터를 검색하기 위해 입력 메서드로 Get을 사용하여 mySQLDataBaseServiceCRUD 서비스를 호출합니다.	mySQLDataBaseServiceCRUD 서비스는 입력 메서드로 Get을 확인하고 초안 ID를 기반으로 대화형 통신에 대한 데이터를 검색합니다.
getAll 작업을 위한 API는 mySQLGetALLData 서비스를 호출하여 데이터베이스에 저장된 모든 대화형 통신에 대한 데이터를 검색합니다.	mySQLGetALLData 서비스는 데이터베이스에 저장된 모든 대화형 커뮤니케이션에 대한 데이터를 검색합니다.

다음은 의 예입니다 pom.xml 구현의 일부인 파일:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="https://maven.apache.org/POM/4.0.0"
         xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.adobe.livecycle</groupId>
    <artifactId>draft-sample</artifactId>
    <version>2.0.0-SNAPSHOT</version>

    <name>Interact</name>
    <packaging>bundle</packaging>

    <dependencies>
        <dependency>
            <groupId>com.adobe.aemfd</groupId>
            <artifactId>aemfd-client-sdk</artifactId>
            <version>6.0.160</version>
        </dependency>
    </dependencies>


    <!-- ====================================================================== -->
    <!-- B U I L D D E F I N I T I O N -->
    <!-- ====================================================================== -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.felix</groupId>
                <artifactId>maven-bundle-plugin</artifactId>
                <version>3.3.0</version>
                <extensions>true</extensions>
                <executions>
                    <!--Configure extra execution of 'manifest' in process-classes phase to make sure SCR metadata is generated before unit test runs-->
                    <execution>
                        <id>scr-metadata</id>
                        <goals>
                            <goal>manifest</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <exportScr>true</exportScr>
                    <instructions>
                        <!-- Enable processing of OSGI DS component annotations -->
                        <_dsannotations>*</_dsannotations>
                        <!-- Enable processing of OSGI metatype annotations -->
                        <_metatypeannotations>*</_metatypeannotations>
                        <Bundle-SymbolicName>${project.groupId}-${project.artifactId}</Bundle-SymbolicName>
                    </instructions>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>8</source>
                    <target>8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
    <profiles>
        <profile>
            <id>autoInstall</id>
            <build>
                <plugins>
                    <plugin>
                        <groupId>org.apache.sling</groupId>
                        <artifactId>maven-sling-plugin</artifactId>
                        <executions>
                            <execution>
                                <id>install-bundle</id>
                                <phase>install</phase>
                                <goals>
                                    <goal>install</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                </plugins>
            </build>
        </profile>
    </profiles>

</project>