DokumentationCampaignDokumentation om Campaign v8

Specifika FFDA Campaign-API:er gs-new-api

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Mellanliggande
  • Utvecklare

I samband med en Enterprise (FFDA)-distribution har Campaign v8 två specifika API:er för att hantera data mellan den lokala databasen i Campaign och molndatabasen. Förutsättningar för att använda dem är att aktivera mellanlagringsmekanismen i schemat. Läs mer

  • Ing-API: xtk.session.ingest

    Detta API är endast avsett för datainmatning. Läs mer

  • API för datauppdatering/borttagning: xtk.session.ingestExt

    Detta API används för att uppdatera eller ta bort data. Läs mer

Ett dedikerat inbyggt arbetsflöde synkroniserar data i molndatabasen.

Infoga data data-insert-api

API:t xtk.session.ingest är endast dedikerad till datainmatning. Ingen uppdatering/borttagning.

Infoga utan avstämning insert-no-reconciliation

I ett arbetsflöde

Använd följande kod i en JavaScript-kodsaktivitet för att infoga data i molndatabasen utan avstämning:

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

När arbetsflödet har körts matas mellanlagringstabellen som förväntat.

Från ett SOAP samtal

  1. Hämta autentiseringstoken.

  2. Utlös API:t. Nyttolasten är:

    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 skickas tillbaka till 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>

Därför matas mellanlagringstabellen som förväntat.

Infoga med avstämning

I ett arbetsflöde

Använd följande kod i en JavaScript-kodsaktivitet för att infoga data i molndatabasen med avstämning:

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

När arbetsflödet har körts matas mellanlagringstabellen som förväntat.

Från ett SOAP samtal

  1. Hämta autentiseringstoken.

  2. Utlös API:t. Nyttolasten är:

    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. I det här fallet skickas inte UUID tillbaka till svaret eftersom det har angetts i nyttolasten. Svar:

    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>

Därför matas mellanlagringstabellen som förväntat.

Uppdatera eller ta bort data data-update-api

API:t xtk.session.IngestExt är optimerad för datauppdatering/borttagning. Använd xtk.session.ingest om du bara vill infoga. Infoga fungerar oavsett om postnyckeln finns i mellanlagringstabellen.

Infoga/uppdatera

I ett arbetsflöde

Använd följande kod i en JavaScript-kodsaktivitet för att uppdatera data i molndatabasen:

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

När arbetsflödet har körts uppdateras mellanlagringstabellen som förväntat.

Från ett SOAP samtal

  1. Hämta autentiseringstoken.

  2. Utlös API:t. Nyttolasten är:

    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. 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>
    <IngestExtResponse SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns="urn:wpp:default"/>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Därför uppdateras mellanlagringstabellen som förväntat.

Prenumerationshantering sub-apis

Prenumerationshantering i Campaign beskrivs på den här sidan.

Inläggning av prenumerations- och prenumerationsdata är beroende av mellanlagringsmekanismen i den lokala Campaign-databasen. Prenumerationsinformation lagras tillfälligt i mellanlagringstabeller i den lokala databasen och synkroniseringsarbetsflödet skickar dessa data från den lokala databasen till molndatabasen. Detta innebär att prenumerations- och avprenumerationsprocesserna är asynkrona. Begäranden om avanmälan och avanmälan behandlas varje timme via ett specifikt tekniskt arbetsflöde. Läs mer

Relaterade ämnen

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