API de campaña de FDAC específicas gs-new-api

En el contexto de un Implementación empresarial (FDAC), Campaign v8 viene con dos API específicas para administrar los datos entre la base de datos local de Campaign y la base de datos en la nube. Los requisitos previos para utilizarlos son habilitar el mecanismo de ensayo en el esquema. Más información

  • API de ingesta: xtk.session.ingest

    Esta API está dedicada únicamente a la inserción de datos. Más información

  • API de actualización/eliminación de datos: xtk.session.ingestExt

    Esta API se utiliza para actualizar o eliminar datos. Más información

Un flujo de trabajo integrado dedicado sincronizará los datos en la base de datos en la nube.

Inserción de datos data-insert-api

El xtk.session.ingest La API solo está dedicada a la inserción de datos. Sin actualización ni eliminación.

Insertar sin reconciliación insert-no-reconciliation

En un flujo de trabajo

Utilice el siguiente código en una Código JavaScript actividad para insertar datos en la base de datos en la nube sin reconciliación:

var xmlStagingSampleTable = <sampleTableStg
                                testcol1="testValue1"
                                testcol2="testValue2"
                                xtkschema="dem:sampleTableStg">
                            </sampleTableStg>;
strUuid = xtk.session.Ingest(xmlStagingSampleTable);
logInfo(strUuid);

Una vez ejecutado el flujo de trabajo, la tabla de ensayo se alimenta según lo esperado.

Desde una llamada SOAP

  1. Obtenga el token de autenticación.

  2. Almacene en déclencheur la API. La carga útil es:

    code language-none
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:xtk:session">
    <soapenv:Header/>
    <soapenv:Body>
        <urn:Ingest>
            <urn:sessiontoken>___xxxxxxx-xxxx-xxx-xxx-xxxxxxxxxxx</urn:sessiontoken>
            <urn:domDoc>
                <sampleTableStg
                    testcol1="Test Value 1 (from SOAP)"
                    testcol2="Test Value 2 (from SOAP)"
                    xtkschema="dem:sampleTableStg">
                </sampleTableStg>
            </urn:domDoc>
        </urn:Ingest>
    </soapenv:Body>
    </soapenv:Envelope>
    
  3. UUID se devuelve a la respuesta SOAP:

    code language-none
    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns="urn:wpp:default" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <IngestResponse SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns="urn:wpp:default">
            <pstrSUuids xsi:type="xsd:string">e1e7c8b3-6f79-44da-a72d-49ed0f73db2c</pstrSUuids>
        </IngestResponse>
    </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

Como resultado, la tabla de ensayo se alimenta según lo esperado.

Insertar con reconciliación

En un flujo de trabajo

Utilice el siguiente código en una Código JavaScript actividad para insertar datos en la base de datos en la nube con reconciliación:

var xmlStagingSampleTable = <sampleTableStg  _key="@id" id="ABC12345"
                              testcol1="testValue1"
                              testcol2="testValue2"
                              xtkschema="dem:sampleTableStg">
                            </sampleTableStg>;
strUuid = xtk.session.Ingest(xmlStagingSampleTable);
logInfo(strUuid);

Una vez ejecutado el flujo de trabajo, la tabla de ensayo se alimenta según lo esperado.

Desde una llamada SOAP

  1. Obtenga el token de autenticación.

  2. Almacene en déclencheur la API. La carga útil es:

    code language-none
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:xtk:session">
    <soapenv:Header/>
    <soapenv:Body>
      <urn:Ingest>
         <urn:sessiontoken>___5e71f4bf-d38a-4ba8-ac15-35a958f7f138</urn:sessiontoken>
         <urn:domDoc>
            <sampleTableStg  _key="@id" id="ABDCD321"
                 testcol1="Test Value 1 (from SOAP)"
                 testcol2="Test Value 2 (from SOAP)"
                 xtkschema="dem:sampleTableStg">
             </sampleTableStg>
         </urn:domDoc>
      </urn:Ingest>
     </soapenv:Body>
    </soapenv:Envelope>
    
  3. En este caso, el UUID no se devuelve a la respuesta porque se ha proporcionado en la carga útil. La respuesta es:

    code language-none
    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns="urn:wpp:default" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <IngestResponse SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns="urn:wpp:default">
            <pstrSUuids xsi:type="xsd:string"/>
        </IngestResponse>
    </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

Como resultado, la tabla de ensayo se alimenta según lo esperado.

Actualización o eliminación de datos data-update-api

El xtk.session.IngestExt La API está optimizada para actualizar o eliminar datos. Para insertar sólo, preferir xtk.session.ingest. Insert funciona si la clave de registro no está en la tabla provisional.

Insertar/actualizar

En un flujo de trabajo

Utilice el siguiente código en una Código JavaScript actividad para actualizar datos en la base de datos en la nube:

var xmlStagingRecipient = <sampleTableStg  _key="@id" id="ABC12345"
                              testcol1="testValue A (updated)"
                              testcol2="testValue B (updated)"
                              xtkschema="dem:sampleTableStg">
                            </sampleTableStg>;
xtk.session.IngestExt(xmlStagingRecipient);

Una vez ejecutado el flujo de trabajo, la tabla de ensayo se actualiza según lo esperado.

Desde una llamada SOAP

  1. Obtenga el token de autenticación.

  2. Almacene en déclencheur la API. La carga útil es:

    code language-none
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:xtk:session">
    <soapenv:Header/>
    <soapenv:Body>
        <urn:IngestExt>
            <urn:sessiontoken>___444cd168-a1e2-4fb6-a2a8-73be9f133489</urn:sessiontoken>
            <urn:domDoc>
            <sampleTableStg  _key="@id" id="ABDCD321"
                    testcol1="Test Value E (from SOAP)"
                    testcol2="Test Value F (from SOAP)"
                    xtkschema="dem:sampleTableStg">
                </sampleTableStg>
            </urn:domDoc>
        </urn:IngestExt>
    </soapenv:Body>
    </soapenv:Envelope>
    
  3. La respuesta SOAP es:

    code language-none
    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns="urn:wpp:default" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <IngestExtResponse SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns="urn:wpp:default"/>
    </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

Como resultado, la tabla de ensayo se actualiza según lo esperado.

Administración de suscripciones sub-apis

La administración de suscripciones en Campaign se describe en esta página.

La inserción de los datos de suscripción y baja depende del Mecanismo de ensayo en la base de datos local de Campaign. La información del suscriptor se almacena temporalmente en tablas de ensayo de la base de datos local y el flujo de trabajo de sincronización envía estos datos desde la base de datos local a la base de datos en la nube. Como consecuencia, los procesos de suscripción y baja son asíncrono. Las solicitudes de inclusión y exclusión se procesan cada hora a través de un flujo de trabajo técnico específico. Más información

Temas relacionados

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b