Tiện ích Google Cloud Firestore

Thêm dữ liệu

Chính sách chú thích tiện ích sau đây sẽ thêm một tài liệu có tên là freewill@example.com vào bộ sưu tập users. Thuộc tính data chỉ định các trường và giá trị của tài liệu mới.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Add-User-Data">
    <DisplayName>Add User Data</DisplayName>
    <Connector>my-cloud-firestore-extension</Connector>
    <Action>setDocument</Action>
    <Input><![CDATA[{
        "colName" : "users",
        "docName" : "freewill@example.com",
        "data" : {
            "firstName": "Will",
            "lastName": "Witman",
            "address": "270-8243 Tempor St.",
            "city": "Fort Worth",
            "region": "TX",
            "postalCode": "86519",
            "email": "freewill@example.com",
            "username": "freewill444"
        }
    }]]></Input>
</ConnectorCallout>

Lấy dữ liệu

Trong ví dụ này, Chính sách tiện ích chú thích sẽ truy xuất giá trị của tài liệu freewill@example.com qua bộ sưu tập users. Ở đây, thuộc tính parsed của phần tử <Output> được thiết lập thành false để kết quả trả về sẽ là JSON dưới dạng chuỗi, thay vì JSON được phân tích cú pháp thành một đối tượng. Để biết thêm thông tin, hãy xem tài liệu tham khảo về phần tử <Output>.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Get-User-Data">
    <DisplayName>Get User Data</DisplayName>
    <Connector>straut-cloud-firestore-extension</Connector>
    <Action>getDocument</Action>
    <Input><![CDATA[{
        "colName" : "users",
        "docName" : "freewill@example.com"
    }]]></Input>
    <Output parsed="false">firestore.userdata.retrieved</Output>
</ConnectorCallout>

Chính sách Chỉ định thông báo sau đây sử dụng giá trị của biến lưu trữ phản hồi của tiện ích để chỉ định tải trọng phản hồi.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="CopyUserDataToResponse">
    <DisplayName>Copy User Data To Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{firestore.userdata.retrieved}</Payload>
    </Set>
</AssignMessage>

Xoá dữ liệu

Trong ví dụ này, Chính sách tiện ích chú thích sẽ xoá tài liệu lizzie@example.com khỏi bộ sưu tập users.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Delete-User-Data">
    <DisplayName>Delete User Data</DisplayName>
    <Connector>my-cloud-firestore-extension</Connector>
    <Action>deleteDocument</Action>
    <Input><![CDATA[{
        "colName" : "users",
        "docName" : "lizzie@example.com"
    }]]></Input>
</ConnectorCallout>

Dữ liệu truy vấn

Trong ví dụ này, Chính sách về tiện ích chú thích truy vấn một bộ sưu tập cities. Kết quả truy vấn được lọc theo các trường state và population. Ở đây, thuộc tính parsed của phần tử <Output> được thiết lập thành false để kết quả trả về sẽ là JSON dưới dạng chuỗi, thay vì JSON được phân tích cú pháp thành một đối tượng. Để biết thêm thông tin, hãy xem tài liệu tham khảo về phần tử <Output>.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Query-City-Data">
    <DisplayName>Query City Data</DisplayName>
    <Connector>cloud-firestore-extension</Connector>
    <Action>query</Action>
    <Input><![CDATA[{
        "colName":"cities",
        "queryArray":[
          ["state", "==", "CA"],
          ["population","<",1000000]
        ]
    }]]></Input>
    <Output parsed="false">compound-query-output</Output>
</ConnectorCallout>

Chính sách Chỉ định thông báo sau đây sử dụng giá trị của biến lưu trữ phản hồi của tiện ích để chỉ định tải trọng phản hồi.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="CopyQueryResultsToResponse">
    <DisplayName>Copy Query Results To Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{firestore.querydata.retrieved}</Payload>
    </Set>
</AssignMessage>

Cú pháp

<Input><![CDATA[{
  "colName" : "firestore-collection-name",
  "queryArray" : "queryArray": query-condition-array
}]]></Input>

Ví dụ:

Trong ví dụ này, tham số queryArray chỉ định hai điều kiện để lọc tập hợp cities do tham số colName chỉ định.

Một truy vấn có nhiều điều kiện phải được hỗ trợ trong Cloud Firestore bằng chỉ mục tổng hợp. Để biết thêm thông tin, hãy xem bài viết Các loại chỉ mục trong Cloud Firestore.

<Input><![CDATA[{
  "colName":"cities",
  "queryArray":[["state", "==", "CA"],["population","<",1000000]]
}]]></Input>

Trong thời gian chạy, hành động này được diễn giải là một truy vấn như sau:

Chọn tất cả thành phố có tiểu bang = 'CA' và dân số < 1000.000