Consulte os conectores compatíveis com a integração de aplicativos.

Atualizar matriz JSON em um índice especificado

Usando a tarefa de mapeamento de dados, atualize o valor de uma matriz JSON em um índice especificado usando uma variável de entrada. Armazene a saída em uma nova variável JSON.

Exemplo de código

{
  "triggerConfigs": [{
    "label": "API Trigger",
    "startTasks": [{
      "taskId": "1"
    }],
    "properties": {
      "Trigger name": "tkApplicationIntegrationSample1_API_1"
    },
    "triggerType": "API",
    "triggerNumber": "1",
    "triggerId": "api_trigger/tkApplicationIntegrationSample1_API_1"
  }],
  "taskConfigs": [{
    "task": "FieldMappingTask",
    "taskId": "1",
    "parameters": {
      "FieldMappingConfigTaskParameterKey": {
        "key": "FieldMappingConfigTaskParameterKey",
        "value": {
          "jsonValue": "{\n  \"@type\": \"type.googleapis.com/enterprise.crm.eventbus.proto.FieldMappingConfig\",\n  \"mappedFields\": [{\n    \"inputField\": {\n      \"fieldType\": \"JSON_VALUE\",\n      \"transformExpression\": {\n        \"initialValue\": {\n          \"referenceValue\": \"$jsonArray$\"\n        },\n        \"transformationFunctions\": [{\n          \"functionType\": {\n            \"jsonFunction\": {\n              \"functionName\": \"TO_STRING_ARRAY\"\n            }\n          }\n        }, {\n          \"functionType\": {\n            \"stringArrayFunction\": {\n              \"functionName\": \"SET\"\n            }\n          },\n          \"parameters\": [{\n            \"initialValue\": {\n              \"literalValue\": {\n                \"intValue\": \"2\"\n              }\n            }\n          }, {\n            \"initialValue\": {\n              \"referenceValue\": \"$jsonVar$\"\n            },\n            \"transformationFunctions\": [{\n              \"functionType\": {\n                \"jsonFunction\": {\n                  \"functionName\": \"TO_STRING\"\n                }\n              }\n            }]\n          }]\n        }, {\n          \"functionType\": {\n            \"stringArrayFunction\": {\n              \"functionName\": \"TO_JSON\"\n            }\n          }\n        }]\n      }\n    },\n    \"outputField\": {\n      \"referenceKey\": \"$outputJsonArray$\",\n      \"fieldType\": \"JSON_VALUE\",\n      \"cardinality\": \"OPTIONAL\"\n    }\n  }]\n}"
        }
      }
    },
    "taskExecutionStrategy": "WHEN_ALL_SUCCEED",
    "displayName": "Data Mapping"
  }],
  "integrationParameters": [{
    "key": "outputJsonArray",
    "dataType": "JSON_VALUE",
    "displayName": "outputJsonArray",
    "inputOutputType": "OUT",
    "jsonSchema": "{\n  \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n  \"type\": \"array\",\n  \"items\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"prop1\": {\n        \"type\": \"string\"\n      }\n    }\n  }\n}"
  }, {
    "key": "jsonArray",
    "dataType": "JSON_VALUE",
    "defaultValue": {
      "jsonValue": "[{\n  \"prop1\": \"val11\"\n}, {\n  \"prop1\": \"val21\"\n}, {\n  \"prop1\": \"val31\"\n}, {\n  \"prop1\": \"val41\"\n}]"
    },
    "displayName": "jsonArray",
    "jsonSchema": "{\n  \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n  \"type\": \"array\",\n  \"items\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"prop1\": {\n        \"type\": \"string\"\n      }\n    }\n  }\n}"
  }, {
    "key": "jsonVar",
    "dataType": "JSON_VALUE",
    "defaultValue": {
      "jsonValue": "{\n  \"prop1\": \"valUserDefined\"\n}"
    },
    "displayName": "jsonVar",
    "jsonSchema": "{\n  \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n  \"type\": \"object\",\n  \"properties\": {\n    \"prop1\": {\n      \"type\": \"string\"\n    }\n  }\n}"
  }]
}

Exemplo de fluxo de integração

A imagem a seguir mostra um exemplo de layout do editor de integração para esse exemplo de código de integração.

Fazer upload e executar a integração de amostra

Para fazer o upload e executar a integração de exemplo, siga estas etapas:

1. Salve o exemplo de integração como um arquivo .json no seu sistema.
2. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

3. No menu de navegação, clique em Integrações. A página Integrações será exibida.
4. Selecione uma integração existente ou clique em CRIAR INTEGRAÇÃO.

   Caso você esteja criando uma nova integração, siga estas etapas:

   1. Digite um nome e uma descrição na caixa de diálogo Criar integração.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas da integração.
      Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração para a região selecionada.
   4. Clique em Criar.

   Isso abre a integração na página do editor de integração.

5. No editor de integração, clique em Menu "Fazer upload/download" e selecione Fazer upload da integração.
6. Na caixa de diálogo do navegador de arquivos, selecione o arquivo que você salvou na etapa 1 e clique em Open.

   Uma nova versão da integração é criada usando o arquivo enviado.

7. No editor de integração, clique em Testar.
8. Clique em Testar integração. Isso executa a integração e mostra o resultado da execução no painel Testar integração.