Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add extensibility examples to shopify #3330

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Add extensibility examples to shopify #3330

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
05112ea
Add Simple App.json
Jun 26, 2024
334caf9
Change hardcoded TableID
Jun 26, 2024
20e8850
Add Item and Variant Description Example
Jun 26, 2024
ae99b44
Add Customer Info Example
Jun 26, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 79 additions & 1 deletion dev-itpro/developer/devenv-extending-shopify.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,36 @@ The Shopify Connector offers a few points of extensibility. We're keeping the nu

## Extensibility examples

### Application manifest

To extend the Shopify Connector, create a new extension and add Shopify Connector as a dependency.

```json
{
"id": "a74041b2-f9d2-4899-b4bd-58388a10f169",
"name": "ExtendShopify",
"publisher": "Default Publisher",
"version": "1.0.0.0",
"dependencies": [
{
"id": "ec255f57-31d0-4ca2-b751-f2fa7c745abb",
"name": "Shopify Connector",
"publisher": "Microsoft",
"version": "25.0.0.0"
}
],
"platform": "1.0.0.0",
"application": "25.0.0.0",
"idRanges": [
{
"from": 50100,
"to": 50149
}
],
"runtime": "14.0"
}
```

### Order processing

How businesses process sales orders can vary greatly, depending on various factors. For example, depending on the type of products or services offered, the sales channels used, and policies and procedures for shipping and handling. You can subscribe to various events from the Shpfy Order Events codeunit.
Expand Down Expand Up @@ -452,7 +482,7 @@ codeunit 50109 "Shpfy Product Export Tag"
[EventSubscriber(ObjectType::Codeunit, Codeunit::"Shpfy Product Events", 'OnAfterCreateTempShopifyProduct', '', false, false)]
procedure AfterCreateTempShopifyProduct(Item: Record Item; var ShopifyProduct: Record "Shpfy Product"; var ShopifyVariant: Record "Shpfy Variant"; var ShopifyTag: Record "Shpfy Tag")
begin
ShopifyTag."Parent Table No." := 30127;
ShopifyTag."Parent Table No." := Database::"Shpfy Product";
ShopifyTag."Parent Id" := ShopifyProduct.Id;
ShopifyTag.Tag := Format(Item."Replenishment System");
if not ShopifyTag.Insert() then
Expand Down Expand Up @@ -487,6 +517,54 @@ codeunit 50108 "Shpfy Product Import Mapping"
}
```

#### Modify created Item or Item Variant description

The following example shows how to modify the description of an item or item variant that you created based on information received from Shopify. For example, you can build a name based on item and variant information.

```al
codeunit 50100 "Shpfy Custom Item Desc."
{

[EventSubscriber(ObjectType::Codeunit, Codeunit::"Shpfy Product Events", OnAfterCreateItemVariant, '', false, false)]
local procedure ModifyItemVariantDescription(Shop: Record "Shpfy Shop"; ShopifyProduct: Record "Shpfy Product"; var ShopifyVariant: Record "Shpfy Variant"; Item: Record Item; var ItemVariant: Record "Item Variant");
begin
// Build name based on Item and Variant info
ItemVariant.Description := CopyStr(Item.Description + ' - ' + ShopifyVariant."Display Name", 1, MaxStrLen(ItemVariant.Description));
ItemVariant.Modify(true);
end;


[EventSubscriber(ObjectType::Codeunit, Codeunit::"Shpfy Product Events", OnAfterCreateItem, '', false, false)]
local procedure ModifyItemDescription(Shop: Record "Shpfy Shop"; var ShopifyProduct: Record "Shpfy Product"; ShopifyVariant: Record "Shpfy Variant"; var Item: Record Item);
begin
Item.Description := CopyStr(ShopifyVariant."Display Name", 1, MaxStrLen(Item.Description));
Item."Description 2" := CopyStr(ShopifyVariant."Display Name", MaxStrLen(Item.Description) + 1, MaxStrLen(Item."Description 2"));
Item.Modify(true);
end;
}
```

### Customer properties

Customer information is essential for businesses to understand their customers, provide better service, and build long-term relationships. You can subscribe to various events from the **Shpfy Customer Events** codeunit.

#### Adjust created customer based on information received from Shopify

The following example shows how to adjust a created customer based on information received from Shopify. For example, you can remove all non-numeric characters from the phone number.

```al
codeunit 50101 "Shpfy Custom Customer Info"
{
[EventSubscriber(ObjectType::Codeunit, Codeunit::"Shpfy Customer Events", OnAfterCreateCustomer, '', false, false)]
local procedure ModifyCustomerPhoneNo(Shop: Record "Shpfy Shop"; var ShopifyCustomerAddress: Record "Shpfy Customer Address"; var Customer: Record Customer);
begin
// Remove all non-numeric characters from the phone number
Customer."Phone No." := DelChr(Customer."Phone No.", '=', DelChr(Customer."Phone No.", '=', '1234567890/+.()'));
Customer.Modify(true);
end;
}
```



## See also
Expand Down