Ir para o conteúdo

Conector Four51 Avançado

Os itens a seguir cobrem opções avançadas, dicas e links para outros materiais de referência que podem ser úteis para integrações Four51.

Propriedades Estendidas

A propriedade Extended Properties (XP) fornecida pela API OrderCloud permite a adição de campos customizados à maioria dos objetos.

No Jitterbit, se um objeto suportar a propriedade OrderCloud XP, o Conector Four51 gerará a propriedade XP nos esquemas de solicitação e resposta desse objeto. A propriedade XP pode ser usada em create, atualizar, atualização do patch ou excluir Atividades. Além disso, a propriedade XP está disponível para filtragem, classificação e pesquisa em todas as atividades de leitura para endpoints com vários registros (ou seja, inclui uma lista de registros, mas não um único registro).

Por exemplo, se você quiser usar a propriedade XP para adicionar um campo personalizado "Endereço Anterior", em sua transformação de solicitação, clique duas vezes na propriedade XP e adicione o seguinte ao script:

<trans>
"<PreviousAddress>
     <Street1>451 First Street</Street1>
     <Street2>West Gravino Blvd</Street2>
     <City>Alameda</City>
    <State>CA</State>
</PreviousAddress>"
</trans>

No exemplo acima, usamos XML dentro de uma string entre aspas duplas em um script Jitterbit padrão. Após implantar e executar a operação, você pode verificar o Console da API OrderCloud e encontre os dados incluídos.

anexo

Nota

Para obter informações adicionais sobre a propriedade XP, consulte a documentação do Four51 em Propriedades Estendidas.

Grandes Quantidades de Dados

Paginação

A paginação é suportada pelo conector Jitterbit Four51. As informações sobre a paginação retornadas da API OrderCloud serão fornecidas em Jitterbit no XML de resposta sob a meta tag. Um exemplo é fornecido abaixo. Se você tiver muitos registros sendo retornados e quiser ajustar a paginação, poderá fazer isso usando o metaobjeto.

<Meta>
<Page>1</Page>
<PageSize>20</PageSize>
<TotalCount>25</TotalCount>
<TotalPages>2</TotalPages>
<ItemRange>
<StartItem>1</StartItem>
<EndItem>20</EndItem>
</ItemRange>
</Meta>

Nota

Para obter informações adicionais sobre o uso de meta tags, consulte a documentação do Four51 em Paginação.

Procurando

A pesquisa é suportada pelo conector Jitterbit Four51. Você pode pesquisar grandes conjuntos de dados diretamente na API CloudOrder especificando o parâmetro de pesquisa. Um exemplo de pesquisa em todos os campos é fornecido abaixo.

<Parameters>
<search>smith<search>
</Parameters>

O exemplo a seguir limita a pesquisa a campos específicos disponíveis no recurso que você está pesquisando.

<Parameters>
<search>smith<search>
<searchOn>LastName,UserName<searchOn>
</Parameters>

Nota

Para obter informações adicionais sobre como pesquisar e combinar consultas, consulte a documentação do Four51 em Searching.

Filtragem

A filtragem é suportada pelo conector Jitterbit Four51. Você pode filtrar grandes listas de itens diretamente na API CloudOrder especificando um filtro.

<Filter>
    <key>lastname</key>
    <value>smith</value>
</Filter>

Os filtros suportam curinga, OR lógico, Negar, AND lógico e Maior que/Menos que em datas e valores numéricos. Exemplos são fornecidos abaixo.

Curinga

<Filter>
    <key>lastname</key>
    <value>*smith</value>
</Filter>

OU Lógico

<Filter>
    <key>lastname</key>
    <value>Smith|Jo</value>
</Filter>

Negar

<Filter>
    <key>lastname</key>
    <value>!Smith</value>
</Filter>

Nota

Para obter informações adicionais sobre filtragem, considerações de desempenho e combinação de consultas, consulte a documentação do Four51 em Filtragem.

Ordenação

A classificação é suportada pelo conector Jitterbit Four51. Você pode classificar grandes listas de itens diretamente na API CloudOrder especificando a ordem de classificação. Um exemplo é fornecido abaixo.

<Parameters>
<soryBy>LastName<sortBy>
</Parameters>

Nota

Para obter informações adicionais sobre classificação e combinação de consultas, consulte a documentação do Four51 em Classificação.

Representação do Usuário

Se desejar interagir com a API CloudOrder em nome de um usuário comprador existente, você poderá fazer isso com o recurso de "representação" do usuário fornecido pela API CloudOrder. Certifique-se de que o usuário comprador que você deseja representar tenha um aplicativo com ID de cliente associado e o perfil de segurança apropriado atribuído. Depois de fazer isso, você poderá configurar seu endpoint Four51 normalmente com as credenciais do usuário representado.

Nota

Mais informações sobre personificação são fornecidas na documentação do Four51 em Impersonation.

Padrões de Design

Os seguintes padrões de design podem ser úteis para integrações Four51: