c# - 在 Acumatica 中确认发货时如何旋转从承运人检索到的发货标签图像?
问题描述
我们在 Acumatica 中使用自定义装箱单报告,该报告适用于所有不同类型的承运人(UPS、FedEx、USPS 等),并且需要没有任何旋转的运输标签图像。
通过 Stamps.com 和 FedEx 检索的运输标签图像没有任何旋转,但通过 UPS 承运人集成的运输标签图像开箱即用时顺时针旋转 270 度,不适合固定/报告的指定区域(粘合剂) .
解决方案
UPS 运输标签 API 没有选项来指定运输标签图像的旋转度数。我们将通过自定义ShipmentEntry
图形/BLC来解决这个问题Shipment Entry screen (SO302000)
。
当前工作流程不会有任何变化(最终用户视角)。当在 Acumatica 中确认货件时,会生成标签并从 UPS 检索,在此过程中,我们的自定义将顺时针旋转检索到的标签(仅当 Ship-Via on Shipment 使用 UPS 插件且标签格式为 GIF 时)顺时针 90 度。此 UPS 标签将与通过其他插件(FedEx 和 Stamps.com)生成的标签对齐。并且不需要在报告级别进行调整。
Shipping Label 是通过Graph/BLCShipPackages
中的虚拟方法生成的。ShipmentEntry
因此,我们将ShipPackages
在 Graph/BLC 的 Graph/BLC 扩展中覆盖虚拟方法ShipmentEntry
。
public class SOShipmentEntryRotateGIFLabelExt : PXGraphExtension<SOShipmentEntry>
{
public delegate void ShipPackagesBaseDelegate(SOShipment shiporder);
[PXOverride]
public void ShipPackages(SOShipment shiporder, ShipPackagesBaseDelegate BaseInvoke)
{
//Custom code to rotate image if carrier is UPS and label format is GIF
//Invoke base method
BaseInvoke(shiporder);
}
}
Acumatica 中的文件附件是通过UploadFileMaintenance
Graph/BLC 执行的。我们将通过将DAC的RowInserted
事件处理程序添加到图中来扩展逻辑。UploadFileRevision
UploadFileMaintenance
因为UploadFileMaintenance
BLC 实例是在其中创建的,ShipPackages
并且在执行之前不可用,所以我们将InstanceCreated
在类的静态集合中添加一个委托PXGraph
。
在初始化 BLC 实例时执行的委托中UploadFileMaintenance
,我们将向Graph/BLC 实例的RowInserted
集合添加一个事件处理程序。UploadFileMaintenance
public class SOShipmentEntryRotateGIFLabelExt : PXGraphExtension<SOShipmentEntry>
{
public delegate void ShipPackagesBaseDelegate(SOShipment shiporder);
[PXOverride]
public void ShipPackages(SOShipment shiporder, ShipPackagesBaseDelegate BaseInvoke)
{
#region Custom-code-to-rotate-retrieved-Label
PXGraph.InstanceCreated.AddHandler<UploadFileMaintenance>((fileGraph) =>
{
fileGraph.RowInserted.AddHandler<UploadFileRevision>((sender, e) =>
{
UploadFileRevision fileData = (UploadFileRevision)e.Row;
});
});
#endregion
//Invoke base method
BaseInvoke(shiporder);
}
}
在RowInserted
事件处理程序中,我们获取UploadFileRevision
正在处理的数据记录并检索运输标签图像并旋转它。
最后我们调用基本方法。
using PX.Data;
using PX.Objects.CS;
using PX.Objects.SO;
using PX.SM;
using System.Drawing;
using System.IO;
namespace PX.RotateUPSLabelImage.Ext
{
public class SOShipmentEntryRotateGIFLabelExt : PXGraphExtension<SOShipmentEntry>
{
public delegate void ShipPackagesBaseDelegate(SOShipment shiporder);
[PXOverride]
public void ShipPackages(SOShipment shiporder, ShipPackagesBaseDelegate BaseInvoke)
{
#region Custom-code-to-rotate-retrieved-Label
//Identify specified Ship-Via/Carrier Shipment is working with
var carrier = Carrier.PK.Find(Base, shiporder.ShipVia);
//If specified Ship-Via/Carrier is API/Plug-In based
if (carrier?.IsExternal == true)
{
//Identify Connected Carrier Plug-In
var plugin = CarrierPlugin.PK.Find(Base, carrier.CarrierPluginID);
//If Plug-In is working with UPS
if (plugin?.PluginTypeName?.Trim() == typeof(PX.UpsCarrier.UpsCarrier).FullName)
{
PXGraph.InstanceCreated.AddHandler<UploadFileMaintenance>((fileGraph) =>
{
fileGraph.RowInserted.AddHandler<UploadFileRevision>((sender, e) =>
{
UploadFile fileInfo = (UploadFile)sender.Graph.Caches<UploadFile>()?.Current;
if (fileInfo != null)
{
if (fileInfo.Name.StartsWith("Label #") && (fileInfo.Extansion.ToUpper() == "GIF"))
{
UploadFileRevision fileData = (UploadFileRevision)e.Row;
using (MemoryStream fileMemoryStream = new MemoryStream(fileData?.Data))
{
Image labelImage = Image.FromStream(fileMemoryStream);
if (labelImage != null)
{
labelImage.RotateFlip(RotateFlipType.Rotate90FlipNone);
ImageConverter imgConverter = new ImageConverter();
fileData.Data = (byte[])imgConverter.ConvertTo(labelImage, typeof(byte[]));
}
}
}
}
});
});
}
}
#endregion
//Invoke base method
BaseInvoke(shiporder);
}
}
}
以下帮助文章可参考 Acumatica 定制指南
推荐阅读
- angular - 如何在 Ubuntu 的 localhost 中使用 Angular CLI 和自签名 SSL 证书通过 HTTPS 提供服务?
- css - 如何将箭头与相应的圆圈对齐?
- firebase - 除英语以外的其他语言的文本识别失败[firebase ml vision]
- .htaccess - 阿拉伯语作为获取参数在路线中不起作用
- laravel - 获取已删除的产品
- here-api - Here Maps:如何从 Here 车队遥测 api 获取 routeId?
- jenkins-pipeline - 管道项目中的Jenkins maven项目违规报告
- flutter - 颤振块。直接在 BlocBuilder 中使用时自动处理 cubit/bloc
- c++ - 访问定义为指针(C++)的(复杂)变量的数据的棘手问题
- php - 如何动态填充重力形式从谷歌表格数据的不同列中选择菜单项