CumulusCI と Robot Framework を用いた Salesforce の E2E テストの自動化

$ brew tap SFDO-Tooling/homebrew-sfdo && brew install cumulusci

$ pipx install cumulusci

$ sfdx force:project:create -n cci_demo
$ cd cci_demo
$ git init
$ cci project init
Project Info
The following prompts will collect general information about the project

Enter the project name.  The name is usually the same as your repository name.  NOTE: Do not use spaces in the project name!
Project Name [cci_demo]:

CumulusCI uses an unmanaged package as a container for your project's metadata.  Enter the name of the package you want to use.
Package Name [cci_demo]:

Is this a managed package project? [y/N]: N

Salesforce API Version [49.0]:

Salesforce metadata can be stored using Metadata API format or DX source format. Which do you want to use?
Source format (sfdx, mdapi) [sfdx]:
# Extend Project
CumulusCI makes it easy to build extensions of other projects configured for CumulusCI like Salesforce.org's NPSP and EDA.  If you are building an extension of another project using CumulusCI and have access to its Github repository, use this section to configure this project as an extension.
Are you extending another CumulusCI project such as NPSP or EDA? [y/N]: N

# Git Configuration
CumulusCI assumes the current git branch is your default branch, your feature branches are named feature/*, your beta release tags are named beta/*, and your release tags are release/*.  If you want to use a different branch/tag naming scheme, you can configure the overrides here.  Otherwise, just accept the defaults.
Default Branch [master]:
Feature Branch Prefix [feature/]:
Beta Tag Prefix [beta/]:
Release Tag Prefix [release/]:

# Apex Tests Configuration
The CumulusCI Apex test runner uses a SOQL where clause to select which tests to run.  Enter the SOQL pattern to use to match test class names.
Test Name Match [%_TEST%]:
Do you want to check Apex code coverage when tests are run? [Y/n]: n
Your project is now initialized for use with CumulusCI

$ cci org connect (任意のエイリアス)

*** Settings ***

Resource        cumulusci/robotframework/Salesforce.robot
Library         cumulusci.robotframework.PageObjects

Suite Setup     Open Test Browser
Suite Teardown  Delete Records and Close Browser


*** Test Cases ***

Via API
    ${first_name} =       Get fake data  first_name
    ${last_name} =        Get fake data  last_name

    ${contact_id} =       Salesforce Insert  Contact
    ...                     FirstName=${first_name}
    ...                     LastName=${last_name}

    &{contact} =          Salesforce Get  Contact  ${contact_id}
    Validate Contact      ${contact_id}  ${first_name}  ${last_name}

Via UI
    ${first_name} =       Get fake data  first_name
    ${last_name} =        Get fake data  last_name

    Go to page            Home  Contact
    Click Object Button   New
    Wait for modal        New  Contact

    Populate Form
    ...                   First Name=${first_name}
    ...                   Last Name=${last_name}
    Click Modal Button    Save

    Wait Until Modal Is Closed

    ${contact_id} =       Get Current Record Id
    Store Session Record  Contact  ${contact_id}
    Validate Contact      ${contact_id}  ${first_name}  ${last_name}


*** Keywords ***

Validate Contact
    [Arguments]          ${contact_id}  ${first_name}  ${last_name}
    [Documentation]
    ...  Given a contact id, validate that the contact has the
    ...  expected first and last name both through the detail page in
    ...  the UI and via the API.

    # Validate via UI
    Go to page             Detail   Contact  ${contact_id}
    Page Should Contain    ${first_name} ${last_name}

    # Validate via API
    &{contact} =     Salesforce Get  Contact  ${contact_id}
    Should Be Equal  ${first_name}  ${contact}[FirstName]
    Should Be Equal  ${last_name}  ${contact}[LastName]

$ cci task run robot --suites ./robot/cci_demo/tests/create_contact.robot --org (接続した組織のエイリアス)

*** Test Cases ***

商談成立後にお祝いのChatter投稿とフォローアップToDoが作成されている
    # テストデータの値
    Set Faker Locale            ja_JP
    ${name} =                   Get fake data  company
    ${closed_date} =            Get fake data  date  pattern=%Y-%m-%d

    # UIから新規商談をクローズで作成
    Go to page                  Home  Opportunity
    Click Object Button         新規
    Wait for modal              New  Opportunity
    Select Dropdown Value       フェーズ  Closed Won
    Populate Form
    ...                         商談名=${name}
    ...                         完了予定日=${closed_date}
    Click Modal Button          保存

    # レコード詳細画面への遷移を待つ
    Wait For Page Object        Detail  Opportunity

    Click Tab                   Chatter
    Page Should Contain         おめでとう！

    Click Tab                   活動
    Timeline Should Have Task   フォローアップToDo

*** Keywords ***

Click Tab
    [Arguments]           ${label}
    Click Element         //a[@role="tab" and text()='${label}']

Timeline Should Have Task
    [Arguments]                  ${subject}
    Page Should Contain Element  //a[contains(@class, subjectLink) and text()='${subject}']